1DAR_XFORM(1) General Commands Manual DAR_XFORM(1)
2
6 dar_xform - disk archive "re-slicer"
7
9 dar_xform [options] [<path>/]source [<path>/]destination
10 dar_xform -h
12 dar_xform -V
14
16 dar_xform changes the size of slices of an existing archive.
17 Source is the basename of the existing archive, destination is the
19 basename of the archive to be created. If source basename is "-", the
20 archive is read from standard input. If the destination basename is
21 "-", the archive is written to standard output and -s option is not
22 available.
23
26 -h displays help usage.
27 -V displays version information.
29 -b make the terminal ring when user interaction is
31 required (like for example the creation of a new
32 slice when using the -p option)
33 -s <number> Size of the slices in bytes. If the number is fol‐
35 lowed by k (or K), M, G, T or P the size is in
36 kilobytes, megabytes, gigabytes, terabytes or
37 petabytes respectively. Example: by default "20M"
38 means 20 megabytes it is the same as giving
39 20971520 as argument (see also -aSI and -abinary
40 options). If -s is not present the backup will be
41 written to a single slice whatever the size of the
42 backup may be (there is probably some filesystem
43 limitation, thus you might expect problems with
44 file size over 2 gigabytes, depending on your
45 filesystem).
46 -S <number> -S gives the size of the first slice which may be
48 chosen independently of the size of following
49 slices. This option needs -s and by default, the
50 size of the first slice is the same as the one of
51 the following slices.
52 -p [<integer>] pauses before writing to a new slice (this requires
54 -s). By default there is no pause, all slices are
55 output in the same directory, up to the end of the
56 backup or until the filesystem is full. In this
57 later case, the user is informed of the lack of
58 disk space and dar stops for user interaction. As
59 soon as some disk space is available, the user can
60 continue the backup. The optional integer that this
61 option can receive tells dar to only pause very 'n'
62 slice. Giving 3 for 'n' will make dar pause only
63 after slices 3, 6, 9 and so on. If this integer is
64 not specified, the behavior is as if '1' was given
65 as argument which makes dar pause after each slice.
66 -n Do not allow overwriting of any slice.
68 -w Do not warn before overwriting slice. By default
70 (no -n and no -w) overwriting is allowed but a
71 warning is issued before proceeding.
72 -E <string> the string is a command-line to be launched between
74 the slices of the destination archive. See dar(1)
75 man page (same option) for more informations.
76 -F <string> the string is a command-line to be launched between
78 the slices of the source archive. See dar(1) man
79 page (same option) for more informations.
80 -aSI[-unit[s]] when using k M G T E Z Y prefixes to define a size,
82 use the SI meaning: multiple of 10^3 (a Mega is
83 1,000,000).
84 -abinary[-unit[s]] when using k M G T E Z Y prefixes to define a size,
86 use the historical computer science meaning: multi‐
87 ple of 2^10 (a Mega is 1,048,576).
88 -aSI and -abinary can be used several times, they affect all prefix
90 which follow even those found in file included by -B option up to the
91 next -a... occurrence. Note that if in a file included by -B option an
92 -abinary or -aSI is met, it affects all the following prefix even those
93 outside the included files (for example in the following "-B some.dcf
94 -s 1K" 1K may be equal to 1000 or 1024 depending on the presence of an
95 -aSI or -abinary in the file some.dcf. By default (before any
96 -aSI/binary argument has been reached), binary interpretation of suffix
97 is done (for compatibility with older versions).
98 -Q Do not display any message on stderr when not
100 launched from a terminal (for example when launched
101 from an at job or crontab). Remains that any ques‐
102 tion to the user will be assumed a 'no' answer,
103 which most of the time will abort the program.
104 -j when virtual memory is exhausted, as user to make
106 room before trying to continue. By default, when
107 memory is exhausted dar aborts.
108
111 Dar is not concerned by scrambling. It does not need to be aware of it
112 to be able to change the slice scheme. Thus, it is not able to scramble
113 a clear archive or unscramble an already scrambled archive.
114
117 dar_xform uses the same exit status as dar does, see dar(1) man page.
118
121 Any signal sent to dar_xform will abort the program immediately, there
122 is no way to have a proper termination before the end of the process
123
126 dar(1), dar_slave(1), dar_manager(1), dar_cp(1)
127
130 None actually.
131
134 http://dar.linux.free.fr/
135 Denis Corbin
136 France
137 Europe
1383rd Berkeley Distribution JAN 8, 2006 DAR_XFORM(1)