version 4, including all changes.
.
Rev |
Author |
# |
Line |
1 |
perry |
1 |
dpkg-split |
|
|
2 |
!!!dpkg-split |
|
|
3 |
NAME |
|
|
4 |
SYNOPSIS |
|
|
5 |
DESCRIPTION |
|
|
6 |
ACTION OPTIONS |
|
|
7 |
OTHER OPTIONS |
|
|
8 |
EXIT STATUS |
|
|
9 |
BUGS |
|
|
10 |
FILES |
|
|
11 |
SEE ALSO |
|
|
12 |
AUTHOR |
|
|
13 |
---- |
|
|
14 |
!!NAME |
|
|
15 |
|
|
|
16 |
|
|
|
17 |
dpkg-split - Debian package archive split/join tool |
|
|
18 |
!!SYNOPSIS |
|
|
19 |
|
|
|
20 |
|
|
|
21 |
__dpkg-split -s__|__--split__ ''complete-archive'' |
|
|
22 |
[[''prefix'']__ |
|
|
23 |
dpkg-split -j__|__--join__ ''part part'' ...__ |
|
|
24 |
dpkg-split -I__|__--info__ ''part part'' ...__ |
|
|
25 |
dpkg-split -a__|__--auto -o__ ''complete-output |
|
|
26 |
part''__ |
|
|
27 |
dpkg-split -l__|__--listq |
|
|
28 |
dpkg-split -d__|__--discard__ [[''package package'' |
|
|
29 |
...] |
|
|
30 |
!!DESCRIPTION |
|
|
31 |
|
|
|
32 |
|
|
|
33 |
__dpkg-split__ splits Debian binary package files into |
|
|
34 |
smaller parts and reassembles them again, to support the |
|
|
35 |
storage of large package files on small media such as floppy |
|
|
36 |
disks. |
|
|
37 |
|
|
|
38 |
|
|
|
39 |
It can be operated manually using the __--split__, |
|
|
40 |
__--join__ and __--info__ options. |
|
|
41 |
|
|
|
42 |
|
|
|
43 |
It also has an automatic mode, invoked using the |
|
|
44 |
__--auto__ option, where it maintains a queue of parts |
|
|
45 |
seen but not yet reassembled and reassembles a package file |
|
|
46 |
when it has seen all of its parts. The __--listq__ and |
|
|
47 |
__--discard__ options allow the management of the |
|
|
48 |
queue. |
|
|
49 |
|
|
|
50 |
|
|
|
51 |
All splitting, joining and queueing operations produce |
|
|
52 |
informative messages on standard output; these may safely be |
|
|
53 |
ignored. |
|
|
54 |
!!ACTION OPTIONS |
|
|
55 |
|
|
|
56 |
|
|
|
57 |
__--split__, __-s__ |
|
|
58 |
|
|
|
59 |
|
|
|
60 |
Splits a single Debian binary package into several |
|
|
61 |
parts. |
|
|
62 |
|
|
|
63 |
|
|
|
64 |
The parts are named |
|
|
65 |
''prefix''__.__''N''__of__''M''__.deb__ |
|
|
66 |
where ''N'' is the part number, starting at 1, and |
|
|
67 |
''M'' is the total number of parts (both in |
|
|
68 |
decimal). |
|
|
69 |
|
|
|
70 |
|
|
|
71 |
If no ''prefix'' is supplied then the |
|
|
72 |
''complete-archive'' filename is taken, including |
|
|
73 |
directory, with any trailing __.deb__ |
|
|
74 |
removed. |
|
|
75 |
|
|
|
76 |
|
|
|
77 |
__--join__, __-j__ |
|
|
78 |
|
|
|
79 |
|
|
|
80 |
Joins the parts of a package file together, reassembling the |
|
|
81 |
original file as it was before it was split. |
|
|
82 |
|
|
|
83 |
|
|
|
84 |
The part files given as arguments must be all the parts of |
|
|
85 |
exactly the same original binary file. Each part must occur |
|
|
86 |
exactly once in the argument list, though the parts to not |
|
|
87 |
need to be listed in order. |
|
|
88 |
|
|
|
89 |
|
|
|
90 |
The parts must of course all have been generated with the |
|
|
91 |
same part size specified at split time, which means that |
|
|
92 |
they must usually have been generated by the same invocation |
|
|
93 |
of __dpkg-split --split__. |
|
|
94 |
|
|
|
95 |
|
|
|
96 |
The parts' filenames are not significant for the reassembly |
|
|
97 |
process. |
|
|
98 |
|
|
|
99 |
|
|
|
100 |
By default the output file is called |
|
|
101 |
''package''__-__''version''__.deb__. |
|
|
102 |
|
|
|
103 |
|
|
|
104 |
__--info__, __-I__ |
|
|
105 |
|
|
|
106 |
|
|
|
107 |
Prints information, in a human-readable format, about the |
|
|
108 |
part file(s) specified. Arguments which are not binary |
|
|
109 |
package parts produce a message saying so instead (but still |
|
|
110 |
on standard output). |
|
|
111 |
|
|
|
112 |
|
|
|
113 |
__--auto__, __-a__ |
|
|
114 |
|
|
|
115 |
|
|
|
116 |
Automatically queue parts and reassemble a package if |
|
|
117 |
possible. |
|
|
118 |
|
|
|
119 |
|
|
|
120 |
The ''part'' specified is examined, and compared with |
|
|
121 |
other parts of the same package (if any) in the queue of |
|
|
122 |
packages file parts. |
|
|
123 |
|
|
|
124 |
|
|
|
125 |
If all parts of the package file of which ''part'' is a |
|
|
126 |
part are available then the package is reassembled and |
|
|
127 |
written to ''complete-output'' (which should not usually |
|
|
128 |
already exist, though this is not an error). |
|
|
129 |
|
|
|
130 |
|
|
|
131 |
If not then the ''part'' is copied into the queue and |
|
|
132 |
''complete-output'' is not created. |
|
|
133 |
|
|
|
134 |
|
|
|
135 |
If ''part'' is not a split binary package part then |
|
|
136 |
__dpkg-split__ will exit with status 1; if some other |
|
|
137 |
trouble occurs then it will exit with status 2. |
|
|
138 |
|
|
|
139 |
|
|
|
140 |
The __--output__ or __-o__ option must be supplied |
|
|
141 |
when using __--auto__. (If this were not mandatory the |
|
|
142 |
calling program would not know what output file to |
|
|
143 |
expect.) |
|
|
144 |
|
|
|
145 |
|
|
|
146 |
__--listq__, __-l__ |
|
|
147 |
|
|
|
148 |
|
|
|
149 |
Lists the contents of the queue of packages to be |
|
|
150 |
reassembled. |
|
|
151 |
|
|
|
152 |
|
|
|
153 |
For each package file of which parts are in the queue the |
|
|
154 |
output gives the name of the package, the parts in the |
|
|
155 |
queue, and the total number of bytes stored in the |
|
|
156 |
queue. |
|
|
157 |
|
|
|
158 |
|
|
|
159 |
__--discard__, __-d__ |
|
|
160 |
|
|
|
161 |
|
|
|
162 |
This discards parts from the queue of those waiting for the |
|
|
163 |
remaining parts of their packages. |
|
|
164 |
|
|
|
165 |
|
|
|
166 |
If no ''package'' is specified then the queue is cleared |
|
|
167 |
completely; if any are specified then only parts of the |
|
|
168 |
relevant package(s) are deleted. |
|
|
169 |
|
|
|
170 |
|
|
|
171 |
__--help__, __-h__ |
|
|
172 |
|
|
|
173 |
|
|
|
174 |
Prints __dpkg-split__'s usage message, giving a summary |
|
|
175 |
of its options and their uses. |
|
|
176 |
|
|
|
177 |
|
|
|
178 |
__--version__ |
|
|
179 |
|
|
|
180 |
|
|
|
181 |
Prints __dpkg-split__'s version number. |
|
|
182 |
|
|
|
183 |
|
|
|
184 |
__--licence__ |
|
|
185 |
|
|
|
186 |
|
|
|
187 |
Prints information about __dpkg-split__'s copyright |
|
|
188 |
licensing and lack of warranty. (The American spelling |
|
|
189 |
__--license__ is also supported.) |
|
|
190 |
!!OTHER OPTIONS |
|
|
191 |
|
|
|
192 |
|
|
|
193 |
__--depotdir__ ''directory'' |
|
|
194 |
|
|
|
195 |
|
|
|
196 |
Specifies an alternative directory for the queue of parts |
|
|
197 |
awaiting automatic reassembly. The default is |
|
|
198 |
__/var/lib/dpkg__. |
|
|
199 |
|
|
|
200 |
|
|
|
201 |
__--partsize__|__-S__ ''kbytes'' |
|
|
202 |
|
|
|
203 |
|
|
|
204 |
Specifies the maximum part size when splitting, in kilobytes |
|
|
205 |
(1024 bytes). The default is 450Kb. |
|
|
206 |
|
|
|
207 |
|
|
|
208 |
__--output__|__-O__ |
|
|
209 |
''complete-output'' |
|
|
210 |
|
|
|
211 |
|
|
|
212 |
Specifies the output file name for a |
|
|
213 |
reassembly. |
|
|
214 |
|
|
|
215 |
|
|
|
216 |
This overrides the default for a manual reassembly |
|
|
217 |
(__--join__) and is mandatory for an automatic |
|
|
218 |
queue-or-reassemble (__--auto__). |
|
|
219 |
|
|
|
220 |
|
|
|
221 |
__--npquiet__, __-Q__ |
|
|
222 |
|
|
|
223 |
|
|
|
224 |
When doing automatic queue-or-reassembly __dpkg-split__ |
|
|
225 |
usually prints a message if it is given a ''part'' that |
|
|
226 |
is not a binary package part. This option suppresses this |
|
|
227 |
message, to allow programs such as __dpkg__ to cope with |
|
|
228 |
both split and unsplit packages without producing spurious |
|
|
229 |
messages. |
|
|
230 |
|
|
|
231 |
|
|
|
232 |
__--msdos__ |
|
|
233 |
|
|
|
234 |
|
|
|
235 |
Forces the output filenames generated by __--split__ to |
|
|
236 |
be msdos-compatible. |
|
|
237 |
|
|
|
238 |
|
|
|
239 |
This mangles the prefix - either the default derived from |
|
|
240 |
the input filename or the one supplied as an argument: |
|
|
241 |
alphanumerics are lowercased, plus signs are replaced by |
|
|
242 |
__x__'s and all other characters are |
|
|
243 |
discarded. |
|
|
244 |
|
|
|
245 |
|
|
|
246 |
The result is then truncated as much as is necessary, and |
|
|
247 |
filenames of the form |
|
|
248 |
''prefixN''__of__''M''__.deb__ are |
|
|
249 |
generated. |
|
|
250 |
!!EXIT STATUS |
|
|
251 |
|
|
|
252 |
|
|
|
253 |
An exit status of 0 indicates that the requested split, |
|
|
254 |
merge, or other command succeeded. __--info__ commands |
|
|
255 |
count as successful even if the files are not binary package |
|
|
256 |
parts. |
|
|
257 |
|
|
|
258 |
|
|
|
259 |
An exit status of 1 occurs only with __--auto__ and |
|
|
260 |
indicates that the ''part'' file was not a binary package |
|
|
261 |
part. |
|
|
262 |
|
|
|
263 |
|
|
|
264 |
An exit status of 2 indicates some kind of trouble, such as |
|
|
265 |
a system call failure, a file that looked like a package |
|
|
266 |
part file but was corrupted, a usage error or some other |
|
|
267 |
problem. |
|
|
268 |
!!BUGS |
|
|
269 |
|
|
|
270 |
|
|
|
271 |
__dpkg-split__ uses some rather out-of-date conventions |
|
|
272 |
for the the filenames of Debian packages. |
|
|
273 |
|
|
|
274 |
|
|
|
275 |
Full details of the packages in the queue are impossible to |
|
|
276 |
get without digging into the queue directory |
|
|
277 |
yourself. |
|
|
278 |
|
|
|
279 |
|
|
|
280 |
There is no easy way to test whether a file that may be a |
|
|
281 |
binary package part is one. |
|
|
282 |
|
|
|
283 |
|
|
|
284 |
The architecture is not represented in the part files' |
|
|
285 |
header, only in the control information of the contained |
|
|
286 |
binary package file, and it is not present in the filenames |
|
|
287 |
generated. |
|
|
288 |
!!FILES |
|
|
289 |
|
|
|
290 |
|
|
|
291 |
__/var/lib/dpkg/parts__ |
|
|
292 |
|
|
|
293 |
|
|
|
294 |
The default queue directory for part files awaiting |
|
|
295 |
automatic reassembly. |
|
|
296 |
|
|
|
297 |
|
|
|
298 |
The filenames used in this directory are in a format |
|
|
299 |
internal to __dpkg-split__ and are unlikely to be useful |
|
|
300 |
to other programs, and in any case the filename format |
|
|
301 |
should not be relied upon. |
|
|
302 |
!!SEE ALSO |
|
|
303 |
|
|
|
304 |
|
4 |
perry |
305 |
deb(5), deb-control(5), __dpkg-deb__(1), |
1 |
perry |
306 |
dpkg(8) |
|
|
307 |
!!AUTHOR |
|
|
308 |
|
|
|
309 |
|
|
|
310 |
__dpkg-split__ and this manpage were written by Ian |
|
|
311 |
Jackson. They are Copyright (C) 1995-1996 by him and |
|
|
312 |
released under the GNU General Public Licence; there is NO |
|
|
313 |
WARRANTY. See __/usr/share/dpkg/copyright__ and |
|
|
314 |
__/usr/share/common-licenses/GPL__ for |
|
|
315 |
details. |
|
|
316 |
---- |