345 lines
8.5 KiB
HTML
345 lines
8.5 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of dpkg-split</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>dpkg-split</H1>
|
|
Section: dpkg suite (1)<BR>Updated: 2020-03-23<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
dpkg-split - Debian package archive split/join tool
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>dpkg-split</B>
|
|
|
|
[<I>option</I>...] <I>command</I>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>dpkg-split</B>
|
|
|
|
splits Debian binary package files into smaller parts and reassembles
|
|
them again, to support the storage of large package files on small
|
|
media such as floppy disks.
|
|
<P>
|
|
It can be operated manually using the
|
|
<B>--split</B>, <B>--join</B> and <B>--info</B>
|
|
|
|
options.
|
|
<P>
|
|
It also has an automatic mode, invoked using the
|
|
<B>--auto</B>
|
|
|
|
option, where it maintains a queue of parts seen but not yet
|
|
reassembled and reassembles a package file when it has seen all of its
|
|
parts. The
|
|
<B>--listq</B> and <B>--discard</B>
|
|
|
|
options allow the management of the queue.
|
|
<P>
|
|
All splitting, joining and queueing operations produce informative
|
|
messages on standard output; these may safely be ignored.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>COMMANDS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-s</B>, <B>--split</B> <I>complete-archive</I> [<I>prefix</I>]
|
|
|
|
<DD>
|
|
Splits a single Debian binary package into several parts.
|
|
<P>
|
|
The parts are named
|
|
<I>prefix</I><B>.</B><I>N</I><B>of</B><I>M</I><B>.deb</B>
|
|
|
|
where
|
|
<I>N</I>
|
|
|
|
is the part number, starting at 1, and
|
|
<I>M</I>
|
|
|
|
is the total number of parts (both in decimal).
|
|
<P>
|
|
If no
|
|
<I>prefix</I>
|
|
|
|
is supplied then the
|
|
<I>complete-archive</I>
|
|
|
|
filename is taken, including directory, with any trailing
|
|
<B>.deb</B>
|
|
|
|
removed.
|
|
<DT id="2"><B>-j</B>, <B>--join</B> <I>part</I>...
|
|
|
|
<DD>
|
|
Joins the parts of a package file together, reassembling the original
|
|
file as it was before it was split.
|
|
<P>
|
|
The part files given as arguments must be all the parts of exactly the
|
|
same original binary file. Each part must occur exactly once in the
|
|
argument list, though the parts to not need to be listed in order.
|
|
<P>
|
|
The parts must of course all have been generated with the same part
|
|
size specified at split time, which means that they must usually have
|
|
been generated by the same invocation of
|
|
<B>dpkg-split --split</B>.
|
|
|
|
<P>
|
|
The parts' filenames are not significant for the reassembly process.
|
|
<P>
|
|
By default the output file is called
|
|
<I>package</I><B>_</B><I>version</I><B>_</B><I>arch</I><B>.deb</B>.
|
|
|
|
<P>
|
|
<DT id="3"><B>-I</B>, <B>--info</B> <I>part</I>...
|
|
|
|
<DD>
|
|
Prints information, in a human-readable format, about the part file(s)
|
|
specified. Arguments which are not binary package parts produce a
|
|
message saying so instead (but still on standard output).
|
|
<DT id="4"><B>-a</B>, <B>--auto -o</B> <I>complete-output part</I>
|
|
|
|
<DD>
|
|
Automatically queue parts and reassemble a package if possible.
|
|
<P>
|
|
The
|
|
<I>part</I>
|
|
|
|
specified is examined, and compared with other parts of the same
|
|
package (if any) in the queue of packages file parts.
|
|
<P>
|
|
If all parts of the package file of which
|
|
<I>part</I>
|
|
|
|
is a part are available then the package is reassembled and written to
|
|
<I>complete-output</I>
|
|
|
|
(which should not usually already exist, though this is not an
|
|
error).
|
|
<P>
|
|
If not then the
|
|
<I>part</I>
|
|
|
|
is copied into the queue and
|
|
<I>complete-output</I>
|
|
|
|
is not created.
|
|
<P>
|
|
If
|
|
<I>part</I>
|
|
|
|
is not a split binary package part then
|
|
<B>dpkg-split</B>
|
|
|
|
will exit with status <B>1</B>; if some other trouble occurs then it will
|
|
exit with status <B>2</B>.
|
|
<P>
|
|
The
|
|
<B>--output</B> or <B>-o</B>
|
|
|
|
option must be supplied when using
|
|
<B>--auto</B>.
|
|
|
|
(If this were not mandatory the calling program would not know what
|
|
output file to expect.)
|
|
<DT id="5"><B>-l</B>, <B>--listq</B>
|
|
|
|
<DD>
|
|
Lists the contents of the queue of packages to be reassembled.
|
|
<P>
|
|
For each package file of which parts are in the queue the output gives
|
|
the name of the package, the parts in the queue, and the total number
|
|
of bytes stored in the queue.
|
|
<DT id="6"><B>-d</B>, <B>--discard</B> [<I>package</I>...]
|
|
|
|
<DD>
|
|
This discards parts from the queue of those waiting for the remaining
|
|
parts of their packages.
|
|
<P>
|
|
If no
|
|
<I>package</I>
|
|
|
|
is specified then the queue is cleared completely; if any are
|
|
specified then only parts of the relevant package(s) are deleted.
|
|
<DT id="7"><B>-?</B>, <B>--help</B>
|
|
|
|
<DD>
|
|
Show the usage message and exit.
|
|
<DT id="8"><B>--version</B>
|
|
|
|
<DD>
|
|
Show the version and exit.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="9"><B>--depotdir</B><I> directory</I>
|
|
|
|
<DD>
|
|
Specifies an alternative directory for the queue of parts awaiting
|
|
automatic reassembly. The default is
|
|
<B>/var/lib/dpkg</B>.
|
|
|
|
<DT id="10"><B>-S</B>, <B>--partsize</B> <I>kibibytes</I>
|
|
|
|
<DD>
|
|
Specifies the maximum part size when splitting, in kibibytes (1024
|
|
bytes). The default is 450 KiB.
|
|
<DT id="11"><B>-o</B>, <B>--output</B> <I>complete-output</I>
|
|
|
|
<DD>
|
|
Specifies the output file name for a reassembly.
|
|
<P>
|
|
This overrides the default for a manual reassembly
|
|
(<B>--join</B>)
|
|
|
|
and is mandatory for an automatic queue-or-reassemble
|
|
(<B>--auto</B>).
|
|
|
|
<DT id="12"><B>-Q</B>, <B>--npquiet</B>
|
|
|
|
<DD>
|
|
When doing automatic queue-or-reassembly
|
|
<B>dpkg-split</B>
|
|
|
|
usually prints a message if it is given a
|
|
<I>part</I>
|
|
|
|
that is not a binary package part. This option suppresses this
|
|
message, to allow programs such as
|
|
<B>dpkg</B>
|
|
|
|
to cope with both split and unsplit packages without producing
|
|
spurious messages.
|
|
<DT id="13"><B>--msdos</B>
|
|
|
|
<DD>
|
|
Forces the output filenames generated by
|
|
<B>--split</B>
|
|
|
|
to be msdos-compatible.
|
|
<P>
|
|
This mangles the prefix - either the default derived from the input
|
|
filename or the one supplied as an argument: alphanumerics are
|
|
lowercased, plus signs are replaced by
|
|
<B>x</B>'s
|
|
|
|
and all other characters are discarded.
|
|
<P>
|
|
The result is then truncated as much as is necessary, and filenames of
|
|
the form
|
|
<I>prefixN</I><B>of</B><I>M</I><B>.deb</B>
|
|
|
|
are generated.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>EXIT STATUS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="14"><B>0</B>
|
|
|
|
<DD>
|
|
The requested split, merge, or other command succeeded.
|
|
<B>--info</B>
|
|
|
|
commands count as successful even if the files are not binary package
|
|
parts.
|
|
<DT id="15"><B>1</B>
|
|
|
|
<DD>
|
|
Only occurs with
|
|
<B>--auto</B>
|
|
|
|
and indicates that the
|
|
<I>part</I>
|
|
|
|
file was not a binary package part.
|
|
<DT id="16"><B>2</B>
|
|
|
|
<DD>
|
|
Fatal or unrecoverable error due to invalid command-line usage,
|
|
a file that looked like a package part file but was corrupted, or
|
|
interactions with the system, such as accesses to the database,
|
|
memory allocations, etc.
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="17"><B>DPKG_COLORS</B>
|
|
|
|
<DD>
|
|
Sets the color mode (since dpkg 1.18.5).
|
|
The currently accepted values are: <B>auto</B> (default), <B>always</B> and
|
|
<B>never</B>.
|
|
<DT id="18"><B>SOURCE_DATE_EPOCH</B>
|
|
|
|
<DD>
|
|
If set, it will be used as the timestamp (as seconds since the epoch) in
|
|
the <B><A HREF="/cgi-bin/man/man2html?5+deb-split">deb-split</A></B>(5)'s <B><A HREF="/cgi-bin/man/man2html?5+ar">ar</A></B>(5) container.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="19"><I>/var/lib/dpkg/parts</I>
|
|
|
|
<DD>
|
|
The default queue directory for part files awaiting automatic
|
|
reassembly.
|
|
<P>
|
|
The filenames used in this directory are in a format internal to
|
|
<B>dpkg-split</B>
|
|
|
|
and are unlikely to be useful to other programs, and in any case the
|
|
filename format should not be relied upon.
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
Full details of the packages in the queue are impossible to get
|
|
without digging into the queue directory yourself.
|
|
<P>
|
|
There is no easy way to test whether a file that may be a binary
|
|
package part is one.
|
|
<A NAME="lbAK"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb">deb</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-control">deb-control</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+dpkg-deb">dpkg-deb</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+dpkg">dpkg</A></B>(1).
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="20"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="21"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="22"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="23"><A HREF="#lbAE">COMMANDS</A><DD>
|
|
<DT id="24"><A HREF="#lbAF">OPTIONS</A><DD>
|
|
<DT id="25"><A HREF="#lbAG">EXIT STATUS</A><DD>
|
|
<DT id="26"><A HREF="#lbAH">ENVIRONMENT</A><DD>
|
|
<DT id="27"><A HREF="#lbAI">FILES</A><DD>
|
|
<DT id="28"><A HREF="#lbAJ">BUGS</A><DD>
|
|
<DT id="29"><A HREF="#lbAK">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:11 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|