Penguin
Blame: dpkg-split(8)
EditPageHistoryDiffInfoLikePages
Annotated edit history of dpkg-split(8) version 4, including all changes. View license author blame.
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 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.