dpkg (1.2.8); priority=LOW

  * dpkg --record-avail puts data in Size field.
  * strip / for rmdir(2) in cleanup to work around kernel bug.  (Bug#3275.)
  * dpkg-split --msdos no longer allows `-' and other chars in filenames.

  * manual dpkg-split(8) written.
  * dpkg-split minor typo in --auto usage error message fixed.
  * dpkg-deb(8) very minor cosmetic fix to --build option.

 -- Ian Jackson <ian@chiark.chu.cam.ac.uk>  Tue, 25 Jun 1996 03:00:14 +0100

TODO

@@ -20,6 +20,7 @@ urgent
  * remove old docs from /usr/doc/dpkg.
 
 other stuff unlikely to get done soon
+ * Filename field generated by --record-avail handle split packages somehow.
  * understand Replaces in dselect
  * provide way for package to declare ownership of files for dpkg -S
    and -L without having dpkg act on this
@@ -44,6 +45,7 @@ other stuff unlikely to get done soon
  * `fake' or `null' packages
  * --purge remove empty directories which used too contain conffiles
  * conffiles handling options, including `replace removed files'
+ * `diff' option at conffile prompt
 
 done
  * highlight or pre-sort or something new or changed packages,

debian.Changelog

@@ -1,3 +1,15 @@
+dpkg (1.2.8); priority=LOW
+
+  * dpkg --record-avail puts data in Size field.
+  * strip / for rmdir(2) in cleanup to work around kernel bug.  (Bug#3275.)
+  * dpkg-split --msdos no longer allows `-' and other chars in filenames.
+
+  * manual dpkg-split(8) written.
+  * dpkg-split minor typo in --auto usage error message fixed.
+  * dpkg-deb(8) very minor cosmetic fix to --build option.
+
+ -- Ian Jackson <ian@chiark.chu.cam.ac.uk>  Tue, 25 Jun 1996 03:00:14 +0100
+
 dpkg (1.2.7); priority=LOW
 
   * dpkg-scanpackages syntax errors fixed.

debian.rules

@@ -1,7 +1,7 @@
 #!/usr/bin/make -f
 
 package=dpkg
-version=1.2.7
+version=1.2.8
 
 archi=$(shell dpkg --print-architecture)
 DIR:=$(shell pwd)

doc/sgml/programmer.sgml

@@ -46,7 +46,6 @@ way they interact with packages.
 It documents the utility programs which are provided with <tt/dpkg/
 for managing various system configuration and similar issues (such as
 <tt/update-rc.d/ and <tt/install-info/.
-<p>
 
 It also documents the interaction between <tt/dselect/'s core and the
 access method scripts it uses to actually install the selected
@@ -88,14 +87,18 @@ some packages by way of documentation).
 
 The binary package has two main sections: the first part consists of
 various control information files and scripts used by <tt/dpkg/ when
-installing and removing, and the second part is an archive (currently
-a <tt/tar/ archive) containing files and directories to be installed.
+installing and removing.
+<p>
+
+The second part is an archive (currently a <tt/tar/ archive)
+containing files and directories to be installed.  See <ref
+id="controlarea">.
+<p>
+
 In the future binary packages may also contain other components, such
 as checksums and digital signatures.
 <p>
 
-The control information files are described in <ref id="controlarea"
-name="the control information section">.
 
 <sect1>Creating package files -- <tt/dpkg-deb/
 
@@ -124,8 +127,7 @@ system where the package is built and the one where it is installed.
 You need to add one special directory to the root of the miniature
 filesystem tree you're creating: <tt/DEBIAN/.  It should contain the
 control information files, notably the main package control file (see
-<ref id="controlarea" name="later"> for details of what files to put
-here.
+<ref id="controlarea">).
 <p>
 
 The <tt/DEBIAN/ directory will not appear in the filesystem archive of
@@ -175,9 +177,8 @@ and a summary of what they're used for.
 
 This is the key description file used by <tt/dpkg/.  It specifies the
 package's name and version, gives its description for the user, states
-its relationships with other packages, and so forth.  Its format is
-described in more detail in <ref id="controlfile"
-name="its own section">.
+its relationships with other packages, and so forth.
+See <ref id="controlfile">.
 
 <tag><tt/postinst/, <tt/preinst/, <tt/postrm/, <tt/prerm/</tag>
 
@@ -185,15 +186,14 @@ These are exectuable files (usually scripts) which <tt/dpkg/ runs
 during installation, upgrade and removal of packages.  They allow the
 package to deal with matters which are particular to that package or
 require more complicated processing than that provided by <tt/dpkg/.
-Details of when and how they are called are in <ref
-id="maintainerscripts">.
+Details of when and how they are called are in
+<ref id="maintainerscripts">.
 
 <tag/<tt/conffiles//
 
 This file contains a list of configuration files which are to be
-handled automatically by <tt/dpkg/.  Details of this mechanism are in
-<ref id="conffiles" name="a separate section">.  Note that not all a
-package's configuration files should be listed here.
+handled automatically by <tt/dpkg/ (see <ref id="conffiles">).  Note
+that not necessarily every configuration file should be listed here.
 
 </descrip>
 
@@ -256,8 +256,7 @@ This field is mandatory.
 
 <tag/<tt/Version//
 
-This lists the package's version number.  See the section on version
-numbers <ref id="versions" name="later"> for details.
+This lists the package's version number - see <ref id="versions">.
 
 This field is mandatory.
 
@@ -311,8 +310,7 @@ This feature is optional as far as <tt/dpkg/ is concerned, but
 <tt/Conflicts/, <tt/Provides/, <tt/Replaces/</tag>
 
 These fields describe the package's relationships with other packages.
-Their syntax and semantics are described in the package relationships
-section <ref id="depconoverwr" name="later">.
+Their syntax and semantics are described in <ref id="depconoverwr">.
 
 <tag/<tt/Source//
 
@@ -328,8 +326,7 @@ This field is optional as far as <tt/dpkg/ is concerned.
 This field contains a description of the package, in a special format.
 <p>
 
-It is very important that you read the section <ref id="descriptions"
-name="later"> on how to write a description.
+It is very important that you read <ref id="descriptions">.
 
 <tag/<tt/Essential//
 
@@ -623,8 +620,8 @@ the <tt/prerm/ before (a version of) a package is removed and the
 <tt/postrm/ afterwards.
 <p>
 
-See <ref id="maintscripts-instact" name="later"> for details of
-exactly when and how these scripts are called and with what arguments.
+See <ref id="maintscripts-instact"> for details of exactly when and
+how these scripts are called and with what arguments.
 
 <sect>Declaring relationships between packages<label id="depconoverwr">
 
@@ -635,7 +632,7 @@ depend on the presence of others.
 <p>
 
 This is done using the <tt/Depends/, <tt/Recommends/, <tt/Suggests/,
-<tt/Conflicts/, <tt/Provides/ and <tt/Replaces control file fields.
+<tt/Conflicts/, <tt/Provides/ and <tt/Replaces/ control file fields.
 <p>
 
 <sect>Syntax of relationship fields
@@ -655,8 +652,7 @@ All the fields except <tt/Provides/ may restrict their applicability
 to particular versions of each named package.  This is done in
 parentheses after each individual package name; the parentheses should
 contain a relation from the list below followed by a version number,
-in the format described in <ref id="versions" name="the version number
-section, above">.
+in the format described in <ref id="versions">.
 <p>
 
 The relations allowed are
@@ -748,6 +744,8 @@ This declares a
 
 **** WRITE THIS
 
+</descrip>
+
 <sect1>Alternative packages - <tt/Conflicts/
 
 **** WRITE THIS
@@ -756,16 +754,10 @@ This declares a
 
 **** WRITE THIS
 
-<sect1>Overwriting files - <tt/Replaces/
+<sect1>Overwriting files - <tt/Replaces/<label id="replaces">
 
 **** WRITE THIS
 
-<tt/&lt;&lt;/
-<tt/&lt;&lt;/
-<tt/&lt;&lt;/
-<descrip>
-<tag>&lt
-
 <sect>Order of processing steps and maintainer script arguments<label id="maintscripts-instact">
 
 <sect1>Summary of ways maintainer scripts are called
@@ -918,10 +910,10 @@ as part of the error unwind).
 <p>
 
 It is an error for a package to contains files which are on the system
-in another package, unless <tt/Replaces/ is used (see <ref
-id="replaces" name="earlier">).  Currently the <tt/--force-overwrite/
-flag is enabled, downgrading it to a warning, but this will not always
-be the case.
+in another package, unless <tt/Replaces/ is used
+(see <ref id="replaces">).  Currently the <tt/--force-overwrite/ flag
+is enabled, downgrading it to a warning, but this will not always be
+the case.
 <p>
 
 Packages which overwrite each other's files produce behaviour which

dpkg-deb/dpkg-deb.8

@@ -48,7 +48,7 @@ will spot that you wanted
 and run it for you.
 .SH ACTION OPTIONS
 .TP
-.BR -b ", " --build
+.BR --build ", " -b
 Creates a debian archive from the filesystem tree stored in
 .IR directory ".  " directory
 must have a

main/archives.c

@@ -643,7 +643,7 @@ void check_conflict(struct dependency *dep, struct pkginfo *pkg,
 void cu_cidir(int argc, void **argv) {
   char *cidir= (char*)argv[0];
   char *cidirrest= (char*)argv[1];
-  *cidirrest= 0;
+  cidirrest[-1]= 0;
   ensure_pathname_nonexisting(cidir);
 }  
 

main/processarc.c

@@ -101,6 +101,8 @@ void process_archive(const char *filename) {
     pfilename= filename;
   }
 
+  if (stat(filename,&stab)) ohshite("existence check failed");
+
   if (!f_noact) {
     /* We can't `tentatively-reassemble' packages. */
     if (!reasmbuf) {
@@ -167,6 +169,11 @@ void process_archive(const char *filename) {
 
   parsedb(cidir, pdb_recordavailable|pdb_rejectstatus|pdb_weakclassification,
           &pkg,0,0);
+  pkg->files= nfmalloc(sizeof(struct filedetails));
+  pkg->files->next= 0;
+  pkg->files->name= pkg->files->msdosname= pkg->files->md5sum= 0;
+  pkg->files->size= nfmalloc(30);
+  sprintf(pkg->files->size,"%lu",(unsigned long)stab.st_size);
 
   if (cipaction->arg == act_avail) {
     printf("Recorded info about %s from %s.\n",pkg->name,pfilename);

split/dpkg-split.8

@@ -1,19 +1,260 @@
 .\" Hey, Emacs!  This is an -*- nroff -*- source file.
-.TH DPKG\-SPLIT 8 "29th November 1995" "Debian Project" "Debian GNU/Linux"
+.\" Authors: Ian Jackson
+.TH dpkg-split 1 "23rd June 1996" "Debian Linux"
 .SH NAME
-dpkg\-split \- Debian multipart package manipulation tool
+dpkg\-split \- Debian package archive split/join tool
+.SH SYNOPSIS
+.B dpkg-split
+.BR -s | --split
+.IR complete\-archive " [" prefix ]
+.br
+.B dpkg-split
+.BR -j | --join
+.IR "part part " ...
+.br
+.B dpkg-split
+.BR -I | --info
+.IR "part part " ...
+.br
+.B dpkg-split
+.BR -a | --auto
+.BI -o " complete\-output part"
+.br
+.B dpkg-split
+.BR -l | --listq
+.br
+.B dpkg-split
+.BR -d | --discard
+.RI [ "package package " ...]
 .SH DESCRIPTION
+.B dpkg-split
+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.
+
+It can be operated manually using the
+.BR --split ", " --join " and " --info
+options.
+
+It also has an automatic mode, invoked using the
+.B --auto
+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
+.BR --listq " and " --discard
+options allow the management of the queue.
+
+All splitting, joining and queueing operations produce informative
+messages on standard output; these may safely be ignored.
+.SH ACTION OPTIONS
+.TP
+.BR --split ", " -s
+Splits a single Debian binary package into several parts.
+
+The parts are named
+.IB prefix . N of M .deb
+where
+.I N
+is the part number, starting at 1, and
+.I M
+is the total number of parts (both in decimal).
+
+If no
+.I prefix
+is supplied then the
+.I complete\-archive
+filename is taken, including directory, with any trailing
+.B .deb
+removed.
+.TP
+.BR --join ", " -j
+Joins the parts of a package file together, reassembling the original
+file as it was before it was split.
+
+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.
+
+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
+.BR "dpkg-split --split" .
+
+The parts' filenames are not significant for the reassembly process.
+
+By default the output file is called
+.IB package - version .deb
+\&.
+.TP
+.BR --info ", " -I
+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).
+.TP
+.BR --auto ", " -a
+Automatically queue parts and reassemble a package if possible.
+
+The
+.I part
+specified is examined, and compared with other parts of the same
+package (if any) in the queue of packages file parts.
+
+If all parts of the package file of which
+.I part
+is a part are available then the package is reassembled and written to
+.I complete\-output
+(which should not usually already exist, though this is not an
+error).
+
+If not then the
+.I part
+is copied into the queue and
+.I complete\-output
+is not created.
+
+If
+.I part
+is not a split binary package part then
 .B dpkg\-split
-does not have a useful man page.  Please do not report this as a bug,
-as this has already been done many times.
+will exit with status 1; if some other trouble occurs then it will
+exit with status 2.
 
-Instead, if you are a competent and accurate writer and are willing to
-spend the time reading the source code and writing good manpages
-please write a better man page than this one.
+The
+.BR --output " or " -o
+option must be supplied when using
+.BR --auto .
+(If this were not mandatory the calling program would not know what
+output file to expect.)
+.TP
+.BR --listq ", " -l
+Lists the contents of the queue of packages to be reassembled.
 
-Type
-.B dpkg\-split \-\-help
-for a brief summary of how to use dpkg.
+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.
+.TP
+.BR --discard ", " -d
+This discards parts from the queue of those waiting for the remaining
+parts of their packages.
 
+If no
+.I package
+is specified then the queue is cleared completely; if any are
+specified then only parts of the relevant package(s) are deleted.
+.TP
+.BR --help ", " -h
+Prints
+.BR dpkg\-split 's
+usage message, giving a summary of its options and their uses.
+.TP
+.BR --version
+Prints
+.BR dpkg\-split 's
+version number.
+.TP
+.BR --licence
+Prints information about
+.BR dpkg\-split 's
+copyright licensing and lack of warranty.  (The American spelling
+.B \-\-license
+is also supported.)
+.SH OTHER OPTIONS
+.TP
+.BI --depotdir " directory"
+Specifies an alternative directory for the queue of parts awaiting
+automatic reassembly.  The default is
+.BR /var/lib/dpkg .
+.TP
+.BI --partsize\fR|\fB-S " kbytes"
+Specifies the maximum part size when splitting, in kilobytes (1024
+bytes).  The default is 450Kb.
+.TP
+.BI --output\fR|\fB-O " complete\-output"
+Specifies the output file name for a reassembly.
+
+This overrides the default for a manual reassembly
+.RB ( \-\-join )
+and is mandatory for an automatic queue-or-reassemble
+.RB ( \-\-auto ).
+.TP
+.BR --npquiet ", " -Q
+When doing automatic queue-or-reassembly
+.B dpkg\-split
+usually prints a message if it is given a
+.I part
+that is not a binary package part.  This option suppresses this
+message, to allow programs such as
+.B dpkg
+to cope with both split and unsplit packages without producing
+spurious messages.
+.TP
+.BR --msdos
+Forces the output filenames generated by
+.B \-\-split
+to be msdos-compatible.
+
+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
+.BR x 's
+and all other characters are discarded.
+
+The result is then truncated as much as is necessary, and filenames of
+the form
+.IB "prefixN" of M .deb
+are generated.
+.SH EXIT STATUS
+An exit status of 0 indicates that the requested split, merge, or
+other command succeeded.
+.B \-\-info
+commands count as successful even if the files are not binary package
+parts.
+
+An exit status of 1 occurs only with
+.B \-\-auto
+and indicates that the
+.I part
+file was not a binary package part.
+
+An exit status of 2 indicates some kind of trouble, such as a system
+call failure, a file that looked like a package part file but was
+corrupted, a usage error or some other problem.
+.SH BUGS
+.B dpkg\-split
+uses some rather out-of-date conventions for the the filenames of
+Debian packages.
+
+Full details of the packages in the queue are impossible to get
+without digging into the queue directory yourself.
+
+There is no easy way to test whether a file that may be a binary
+package part is one.
+
+The architecture is not represented in the part files' header, only in
+the control information of the contained binary package file, and it
+is not present in the filenames generated.
+.SH FILES
+.TP
+.B /var/lib/dpkg/parts
+The default queue directory for part files awaiting automatic
+reassembly.
+
+The filenames used in this directory are in a format internal to
+.B dpkg\-split
+and are unlikely to be useful to other programs, and in any case the
+filename format should not be relied upon.
+.SH SEE ALSO
+.BR dpkg\-split (5),
+.BR dpkg\-deb (5),
+.BR dpkg\-deb (8),
+.BR dpkg (8)
 .SH AUTHOR
-Ian Jackson <ijackson@gnu.ai.mit.edu>.
+.B dpkg\-split
+and this manpage were written by Ian Jackson.  They are
+Copyright (C) 1995-1996
+by him and released under the GNU General Public Licence; there is NO
+WARRANTY.  See
+.B /usr/doc/copyright/dpkg
+and
+.B /usr/doc/copyright/GPL
+for details.

split/mksplit

@@ -47,7 +47,8 @@ $msdos= ($msdos eq 'yes');
 if ($msdos) {
     $prefixdir= $prefix; $prefixdir =~ s:(/?)/*[^/]+$:$1:;
     $cleanprefix= $prefix; $cleanprefix =~ s:^.*/+::;
-    $cleanprefix =~ y/-A-Za-z0-9+/-a-za-z0-9x/d;
+    $cleanprefix =~ y/A-Za-z0-9+/a-za-z0-9x/;
+    $cleanprefix =~ y/a-z0-9//cd;
 }
 
 sub add {

split/mksplit.pl

@@ -47,7 +47,8 @@ $msdos= ($msdos eq 'yes');
 if ($msdos) {
     $prefixdir= $prefix; $prefixdir =~ s:(/?)/*[^/]+$:$1:;
     $cleanprefix= $prefix; $cleanprefix =~ s:^.*/+::;
-    $cleanprefix =~ y/-A-Za-z0-9+/-a-za-z0-9x/d;
+    $cleanprefix =~ y/A-Za-z0-9+/a-za-z0-9x/;
+    $cleanprefix =~ y/a-z0-9//cd;
 }
 
 sub add {

split/queue.c

@@ -104,7 +104,7 @@ void do_auto(const char *const *argv) {
 
   if (!outputfile) badusage("--auto requires the use of the --output option");
   if (!(partfile= *argv++) || *argv)
-    badusage("--auto requires exactly one part file arguments");
+    badusage("--auto requires exactly one part file argument");
 
   refi= nfmalloc(sizeof(struct partqueue));
   part= fopen(partfile,"r");

version.h

@@ -1 +1 @@
-#define DPKG_VERSION "1.2.5" /* This line modified by Makefile */
+#define DPKG_VERSION "1.2.8" /* This line modified by Makefile */