Ubuntu Manpage: dar_xform - disk archive "re-slicer"

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 followed 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: multiple 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 question to the user will be assumed a 'no' answer, which most of
the time will abort the program.

-j when virtual memory is exhausted, as user to make room before trying
to continue. By default, when memory is exhausted dar aborts.

-^ perm[:user[:group]]
defines the permission and ownership to use for created slices.

-3, --hash <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).

-; <src_num>[,<dst_num>]
Defines the minimum number of digit to use for the source archive and
for the destination archive. If you the source has not been defined
with a minimum number of digit and you want to define a value for the
destination archive, use zero (or one) as value for src. 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

KNOWN BUGS

       None actually.

AUTHOR

       http://dar.linux.free.fr/
       Denis Corbin
       France
       Europe