dar_xform(1) dar_xform(1)
NAME
dar_xform - disk archive "re-slicer"
SYNOPSIS
dar_xform [options] [<path>/]source [<path>/]destination
dar_xform -h
dar_xform -V
DESCRIPTION
dar_xform changes the size of slices of an existing archive.
Source is the basename of the existing archive, destination is the
basename of the archive to be created. If source basename is "-", the
archive is read from standard input. If the destination basename is
"-", the archive is written to standard output and -s option is not
available.
OPTIONS
-h displays help usage.
-V displays version information.
-b make the terminal ring when user interaction is
required (like for example the creation of a new
slice when using the -p option)
-s <number> Size of the slices in bytes. If the number is fol-
lowed by k (or K), M, G, T or P the size is in
kilobytes, megabytes, gigabytes, terabytes or
petabytes respectively. Example: by default "20M"
means 20 megabytes it is the same as giving
20971520 as argument (see also -aSI and -abinary
options). If -s is not present the backup will be
written to a single slice whatever the size of the
backup may be (there is probably some filesystem
limitation, thus you might expect problems with
file size over 2 gigabytes, depending on your
filesystem).
-S <number> -S gives the size of the first slice which may be
chosen independently of the size of following
slices. This option needs -s and by default, the
size of the first slice is the same as the one of
the following slices.
-p [<integer>] pauses before writing to a new slice (this requires
-s). By default there is no pause, all slices are
output in the same directory, up to the end of the
backup or until the filesystem is full. In this
later case, the user is informed of the lack of
disk space and dar stops for user interaction. As
soon as some disk space is available, the user can
continue the backup. The optional integer that this
option can receive tells dar to only pause very 'n'
slice. Giving 3 for 'n' will make dar pause only
after slices 3, 6, 9 and so on. If this integer is
not specified, the behavior is as if '1' was given
as argument which makes dar pause after each slice.
-n Do not allow overwriting of any slice.
-w Do not warn before overwriting slice. By default
(no -n and no -w) overwriting is allowed but a
warning is issued before proceeding.
-E <string> the string is a command-line to be launched between
the slices of the destination archive. See dar(1)
man page (same option) for more information.
-F <string> the string is a command-line to be launched between
the slices of the source archive. See dar(1) man
page (same option) for more information.
-aSI[-unit[s]] when using k M G T E Z Y prefixes to define a size,
use the SI meaning: multiple of 10^3 (a Mega is
1,000,000).
-abinary[-unit[s]] when using k M G T E Z Y prefixes to define a size,
use the historical computer science meaning: multi-
ple of 2^10 (a Mega is 1,048,576).
-aSI and -abinary can be used several times, they affect all prefix
which follow even those found in file included by -B option up to the
next -a... occurrence. Note that if in a file included by -B option an
-abinary or -aSI is met, it affects all the following prefix even those
outside the included files (for example in the following "-B some.dcf
-s 1K" 1K may be equal to 1000 or 1024 depending on the presence of an
-aSI or -abinary in the file some.dcf. By default (before any
-aSI/binary argument has been reached), binary interpretation of suffix
is done (for compatibility with older versions).
-Q Do not display any message on stderr when not
launched from a terminal (for example when launched
from an at job or crontab). Remains that any ques-
tion to the user will be assumed a 'no' answer,
which most of the time will abort the program.
-^ perm[:user[:group]]
defines the permission and ownership to use for
created slices.
-3 <algo> Beside each created slice is generated an on-fly
hash file using the specified algorithm. Available
algorithm are "md5" and "sha1", by default no hash
file is generated. This option description is more
detailed in dar man page (where it has the same
designation as here).
-9 <src_num>[,<dst_num>]
Defines the minimum number of digit to use for the
source archive and eventually for the destination
archive. If the source has not been defined with a
minimum number of digits and you want to specify a
number of digits for the destination archive, use
zero (or one) as value for src_num. If dst_num is
not provided, it defaults to 1. See the same option
in dar man page for more details.
NOTES
Dar_xform is not concerned by encryption or compression. It does not
need to be aware of it to be able to change the slice scheme. Thus, it
is not able to uncompress or uncipher an archive.
EXIT CODES
dar_xform uses the same exit status as dar does, see dar(1) man page.
SIGNALS
Any signal sent to dar_xform will abort the program immediately, there
is no way to have a proper termination before the end of the process
SEE ALSO
dar(1), dar_slave(1), dar_manager(1), dar_cp(1), dar_split(1)
KNOWN BUGS
http://sourceforge.net/p/dar/bugs/
AUTHOR
http://dar.linux.free.fr/
Denis Corbin
France
Europe
3rd Berkeley Distribution Sept 29th, 2016 dar_xform(1)
dar 2.5.9 - Generated Fri Feb 10 19:01:35 CST 2017