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 information.
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 information.
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 -^ perm[:user[:group]]
106 defines the permission and ownership to use for
107 created slices.
108 -3 <algo> Beside each created slice is generated an on-fly
110 hash file using the specified algorithm. Available
111 algorithm are "md5" and "sha1", by default no hash
112 file is generated. This option description is more
113 detailed in dar man page (where it has the same
114 designation as here).
115 -9 <src_num>[,<dst_num>]
117 Defines the minimum number of digit to use for the
118 source archive and eventually for the destination
119 archive. If the source has not been defined with a
120 minimum number of digits and you want to specify a
121 number of digits for the destination archive, use
122 zero (or one) as value for src_num. If dst_num is
123 not provided, it defaults to 1. See the same option
124 in dar man page for more details.
125
127 Dar_xform is not concerned by encryption or compression. It does not
128 need to be aware of it to be able to change the slice scheme. Thus, it
129 is not able to uncompress or uncipher an archive.
130
133 dar_xform uses the same exit status as dar does, see dar(1) man page.
134
137 Any signal sent to dar_xform will abort the program immediately, there
138 is no way to have a proper termination before the end of the process
139
142 dar(1), dar_slave(1), dar_manager(1), dar_cp(1), dar_split(1)
143
146 http://sourceforge.net/p/dar/bugs/
147
150 http://dar.linux.free.fr/
151 Denis Corbin
152 France
153 Europe
1543rd Berkeley Distribution August 18th, 2018 DAR_XFORM(1)