diff options
| author | Scott James Remnant <scott@netsplit.com> | 2005-03-11 09:00:14 +0000 |
|---|---|---|
| committer | Scott James Remnant <scott@netsplit.com> | 2005-03-11 09:00:14 +0000 |
| commit | 841a630143cd3a35dbf8bce0a111ebd39dd12f44 (patch) | |
| tree | 0f85bbcb279f41e840bfcf6faceaab43770d2447 /doc | |
| parent | ac8c6923a8654da81cbc6730213147961026eb8f (diff) | |
| download | dpkg-841a630143cd3a35dbf8bce0a111ebd39dd12f44.tar.gz | |
dpkg (1.13.1.0.1) experimental; urgency=low
* Bin-MU; recompile against Debian unstable, to make dselect actually
installable.
-- Scott James Remnant <scott@netsplit.com> Fri, 11 Mar 2005 09:00:14 +0000
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/ChangeLog | 153 | ||||
| -rw-r--r-- | doc/Makefile.in | 49 | ||||
| -rw-r--r-- | doc/database-structure.fig | 487 | ||||
| -rw-r--r-- | doc/en/reference.sgml | 976 | ||||
| -rw-r--r-- | doc/internals.sgml | 544 |
5 files changed, 0 insertions, 2209 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog deleted file mode 100644 index 6ebe82a0e..000000000 --- a/doc/ChangeLog +++ /dev/null @@ -1,153 +0,0 @@ -debian-manuals (2.1.2.3) unstable; - - * internals.sgml: converted to debiandoc format - - -- Ben Collins <bcollins@debian.org> Sat, 23 Oct 1999 23:32:48 -0400 - -debian-manuals (2.1.2.2) frozen unstable; - - * Fixed even more typographical and grammatical errors in Policy and - Programmer's manual - * Corrected the contact email addresses again. - * Added a paragraph to Policy 6.3 on taking over an old package (Guy Maor) - * Added a paragraph to Programmer 4.2.14 on listing distributions to load - a package into. (Guy Maor) - * Further clarification of use of absolute pathnames in scripts in - Programmer 6.1. - - -- David Morris <bweaver@worf.netins.net> Tue, 3 Dec 1996 23:28:04 -0600 - -debian-manuals (2.1.2.1) frozen unstable; - - * Many editorial and formatting revisions with suggestions from Ian Jackson, - Guy Maor and others - * correction of chiark address in Policy 6.2 - * footnote in Programmers chapter 2 pointing to deb(5) manpage for - description of deb file format. - * addition of more dpkg examples in Programmer chapter 2 - * Replace paragraph in Policy 4.1 outlining compiling parameters for - shared libraries. - * Added paragraph in Programmer 6.1 on paths in maintainer scripts - (Bug #2481) - * Cleaned up language and formatting of Programmer's 12.2, shlibs - * Corrected contact addresses for listmaster and override-change - - -- David Morris <bweaver@worf.netins.net> Wed, 27 Nov 1996 08:17:16 -0600 - -debian-manuals (2.1.2.0) frozen unstable; - - * Mostly editorial changes in Policy Manual. - * Added summary of distribution criteria to Introduction - * Added section headings for copyright criteria - * Fixed typos (Bugs #4485, #4622) - * Added paragraph in Compilation Options related to use of shared and - static libraries. (Bug #5299) - * Paragraph added about where to find PGP and other export restricted - packages in section on Procedure - * Change in List administrator and in the contact address for becoming - a package maintainer - * A paragraph added related to who to contact for package maintainer changes. - * Changed where to send upload announcements: uploads destined for unstable, - frozen, or experimental go to debian-devel-changes. - - * Made some mostly editorial changes to Programmers Manual. - * Added a recommendation to debmake in Introduction. - * A further interpretation of the various Distributions is added with - the intent of helping people decide which one to choose. (section 4.2.14) - * Section 12 on Shared Libraries expanded with further technical information - on various shlib files - * Section in 2.2 on format of shlib file moved to new subsection within 12. - * Paragraph on adding a symlink without version number added to Shared - Library Section (Guy Maor, Bug #5299) - - -- David Morris <bweaver@worf.netins.net> Fri, 22 Nov 1996 23:41:39 -0600 - -debian-manuals (2.1.1.0) unstable; - - * Hard links are forbidden in source packages (they didn't work anyway, - and can't easily be made to work reliably). - * Do not use dpkg-divert or update-alternatives without consultation. - - * Do not need to declare dependencies on Essential packages. - * Restrictions on Pre-Depends stated in policy manual. - * debian/substvars file is now almost always auto-generated. - * Shared libraries must be installed stripped. - * Essential and Pre-Depends put together in policy manual. - - * Explained component-wise (file-wise) vs. package-wise dependencies. - - -- Ian Jackson <ian@chiark.greenend.org.uk> Thu, 12 Sep 1996 01:00:41 +0100 - -debian-manuals (2.1.0.0) unstable; - - * Upstream changelog must be installed too (was just recommended). - - * Modification to use dpkg-shlibdeps added to conversion instructions. - * Packages which are buggy and orphaned but which are preserved for - compatibility go in contrib. - - * Programmers' manual source package section refers to conversion - instructions in policy manual. - * Make it clear that recommending a non-free or contrib package puts a - package in contrib. - - -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sun, 1 Sep 1996 17:47:18 +0100 - -debian-manuals (2.0.1.0) unstable; - - * varargs.h and libtermcap are obsolete - use stdarg.h and ncurses. - * Shared library link/library ordering corrected (aargh). - * When to byte-compile Elisp files. - * Missing final newlines not represented by dpkg-source. - - * Must post upload announcements to debian-changes. - * Moved some sections into new `configuring and building' chapter. - * Typo fixes. - - -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sat, 31 Aug 1996 20:07:22 +0100 - -debian-manuals (2.0.0.0) unstable; - - * Footnote added OK'ing copyrights which require name changes. - * More detail about changelog format names. - - * Problematic licence restrictions are formatted as lists. - * Mentioned 822-date utility as way to generate RFC822 format dates. - * Typos corrected. - * Released. - - -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Mon, 26 Aug 1996 14:27:34 +0100 - -debian-manuals (0.2.1.1) unstable; - - * Can't overwrite directories in one package with files in another. - - -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sat, 24 Aug 1996 18:44:54 +0100 - -debian-manuals (0.2.1.0) unstable; - - * Policy says when and how to include original source in upload. - - * Need -sa on dpkg-genchanges/dpkg-buildpackage when converting. - - * Use minor patchlevel for meaning changes which don't affect packages. - * More verbosity about netiquette. - * Reorganised participation and upload policy: merged with mailing lists. - - -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Fri, 23 Aug 1996 12:48:09 +0100 - -debian-manuals (0.2.0.1) experimental; - - * Said that system administrators' manual does not exist. - - -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Fri, 23 Aug 1996 04:05:36 +0100 - -debian-manuals (0.2.0.0) experimental; - - * Draft releases. - - -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Wed, 21 Aug 1996 15:07:53 +0100 - -Local variables: -mode: debian-changelog -End: diff --git a/doc/Makefile.in b/doc/Makefile.in deleted file mode 100644 index b06d3d01e..000000000 --- a/doc/Makefile.in +++ /dev/null @@ -1,49 +0,0 @@ -VPATH = @srcdir@ -srcdir = @srcdir@ -top_srcdir = @top_srcdir@ - -default: all - -include ../Makefile.conf - -ifeq (@USE_SGML_DOC@, true) -all: internals.html/index.html -else -all: -endif - -clean: - $(RM) $(srcdir)/manuals-version - $(RM) -rf internals.html/ - -distclean: clean - $(RM) Makefile - -install: install-doc - -manuals-version: $(top_srcdir)/version-nr - set -e ; v=`sed -ne '1s/.*(\(.*\)).*/\1/' $(srcdir)/ChangeLog` ; \ - echo "<!entity manuals-version \"$$v\">" > $@ - echo "<!entity dpkg-version \"$(VERSION)\">" >> $@ - -internals.html/index.html: internals.sgml manuals-version - debiandoc2html -n -D. $< - -install-doc: -ifeq (@USE_SGML_DOC@, true) - $(mkinstalldirs) $(DESTDIR)$(docdir)/internals/ - set -e ; for i in internals.html/* ; do \ - bn=`basename $$i` ; \ - $(INSTALL_DATA) $$i $(DESTDIR)$(docdir)/internals/$$bn ; \ - done -endif - $(mkinstalldirs) $(DESTDIR)$(docdir)/ - $(INSTALL_DATA) $(srcdir)/ChangeLog $(DESTDIR)$(docdir)/ChangeLog.manuals - set -e ; for i in ChangeLog THANKS TODO ; do \ - $(INSTALL_DATA) $(top_srcdir)/$$i $(DESTDIR)$(docdir) ; \ - done - $(INSTALL_DATA) $(top_srcdir)/COPYING $(DESTDIR)$(copyingfile) - - -.PHONY: all clean distclean install install-doc -.PHONY: install-doc-recursive diff --git a/doc/database-structure.fig b/doc/database-structure.fig deleted file mode 100644 index 462e2f6c2..000000000 --- a/doc/database-structure.fig +++ /dev/null @@ -1,487 +0,0 @@ -#FIG 2.1 -80 2 -6 59 74 199 169 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 69 129 199 129 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 69 149 199 149 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 69 129 69 169 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 59 109 199 109 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 139 129 139 169 9999 9999 -2 2 0 1 -1 0 0 0 0.000 0 0 0 - 199 169 199 89 59 89 59 169 199 169 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 139 89 139 109 9999 9999 -4 0 12 10 0 -1 0 0.000 4 5 24 64 104 name -4 0 12 10 0 -1 0 0.000 4 9 84 64 122 pkginfoperfile -4 0 12 10 0 -1 0 0.000 4 9 42 74 144 depends -4 0 12 10 0 -1 0 0.000 4 9 48 74 162 depended -4 0 12 10 0 -1 0 0.000 4 9 42 59 84 pkginfo --6 -6 59 394 199 489 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 69 449 199 449 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 69 469 199 469 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 69 449 69 489 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 59 429 199 429 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 139 449 139 489 9999 9999 -2 2 0 1 -1 0 0 0 0.000 0 0 0 - 199 489 199 409 59 409 59 489 199 489 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 139 409 139 429 9999 9999 -4 0 12 10 0 -1 0 0.000 4 5 24 64 424 name -4 0 12 10 0 -1 0 0.000 4 9 84 64 442 pkginfoperfile -4 0 12 10 0 -1 0 0.000 4 9 42 74 464 depends -4 0 12 10 0 -1 0 0.000 4 9 48 74 482 depended -4 0 12 10 0 -1 0 0.000 4 9 42 59 404 pkginfo --6 -6 59 234 199 329 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 69 289 199 289 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 69 309 199 309 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 69 289 69 329 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 59 269 199 269 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 139 289 139 329 9999 9999 -2 2 0 1 -1 0 0 0 0.000 0 0 0 - 199 329 199 249 59 249 59 329 199 329 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 139 249 139 269 9999 9999 -4 0 12 10 0 -1 0 0.000 4 5 24 64 264 name -4 0 12 10 0 -1 0 0.000 4 9 84 64 282 pkginfoperfile -4 0 12 10 0 -1 0 0.000 4 9 42 74 304 depends -4 0 12 10 0 -1 0 0.000 4 9 48 74 322 depended -4 0 12 10 0 -1 0 0.000 4 9 42 59 244 pkginfo --6 -6 559 74 699 169 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 569 129 699 129 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 569 149 699 149 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 569 129 569 169 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 559 109 699 109 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 639 129 639 169 9999 9999 -2 2 0 1 -1 0 0 0 0.000 0 0 0 - 699 169 699 89 559 89 559 169 699 169 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 639 89 639 109 9999 9999 -4 0 12 10 0 -1 0 0.000 4 5 24 564 104 name -4 0 12 10 0 -1 0 0.000 4 9 84 564 122 pkginfoperfile -4 0 12 10 0 -1 0 0.000 4 9 42 574 144 depends -4 0 12 10 0 -1 0 0.000 4 9 48 574 162 depended -4 0 12 10 0 -1 0 0.000 4 9 42 559 84 pkginfo --6 -6 399 119 499 214 -2 2 0 1 -1 0 0 0 0.000 0 0 0 - 499 214 499 134 399 134 399 214 499 214 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 399 154 499 154 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 399 174 499 174 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 399 194 499 194 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 439 134 439 214 9999 9999 -4 0 12 10 0 -1 0 0.000 4 7 12 404 149 up -4 0 12 10 0 -1 0 0.000 4 7 24 404 169 next -4 0 12 10 0 -1 0 0.000 4 7 24 404 189 list -4 0 12 10 0 -1 0 0.000 4 9 24 404 209 type -4 0 12 10 0 -1 0 0.000 4 9 60 399 129 dependency --6 -6 654 224 754 319 -2 2 0 1 -1 0 0 0 0.000 0 0 0 - 754 319 754 239 654 239 654 319 754 319 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 654 259 754 259 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 654 279 754 279 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 654 299 754 299 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 694 239 694 319 9999 9999 -4 0 12 10 0 -1 0 0.000 4 7 12 659 254 up -4 0 12 10 0 -1 0 0.000 4 7 24 659 274 next -4 0 12 10 0 -1 0 0.000 4 7 24 659 294 list -4 0 12 10 0 -1 0 0.000 4 9 24 659 314 type -4 0 12 10 0 -1 0 0.000 4 9 60 654 234 dependency --6 -6 164 294 174 304 -2 1 0 1 1 0 0 0 0.000 7 0 0 - 164 294 174 304 9999 9999 -2 1 0 1 1 0 0 0 0.000 7 0 0 - 164 304 174 294 9999 9999 --6 -6 164 454 174 464 -2 1 0 1 1 0 0 0 0.000 7 0 0 - 164 454 174 464 9999 9999 -2 1 0 1 1 0 0 0 0.000 7 0 0 - 164 464 174 454 9999 9999 --6 -6 464 159 474 169 -2 1 0 1 1 0 0 0 0.000 7 0 0 - 464 159 474 169 9999 9999 -2 1 0 1 1 0 0 0 0.000 7 0 0 - 464 169 474 159 9999 9999 --6 -6 719 264 729 274 -2 1 0 1 1 0 0 0 0.000 7 0 0 - 719 264 729 274 9999 9999 -2 1 0 1 1 0 0 0 0.000 7 0 0 - 719 274 729 264 9999 9999 --6 -6 164 154 174 164 -2 1 0 1 5 0 0 0 0.000 7 0 0 - 164 154 174 164 9999 9999 -2 1 0 1 5 0 0 0 0.000 7 0 0 - 164 164 174 154 9999 9999 --6 -6 354 339 364 349 -2 1 0 1 5 0 0 0 0.000 7 0 0 - 354 339 364 349 9999 9999 -2 1 0 1 5 0 0 0 0.000 7 0 0 - 354 349 364 339 9999 9999 --6 -6 269 259 389 394 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 269 294 389 294 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 269 314 389 314 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 269 334 389 334 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 269 354 389 354 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 329 274 329 394 9999 9999 -2 2 0 1 -1 0 0 0 0.000 0 0 0 - 389 394 389 274 269 274 269 394 389 394 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 269 374 389 374 9999 9999 -4 0 12 10 0 -1 0 0.000 4 9 48 269 269 deppossi -4 0 12 10 0 -1 0 0.000 4 7 12 274 289 up -4 0 12 10 0 -1 0 0.000 4 7 24 274 309 next -4 0 12 10 0 -1 0 0.000 4 7 12 274 329 ed -4 0 12 10 0 -1 0 0.000 4 7 42 274 389 version -4 0 12 10 0 -1 0 0.000 4 7 42 274 349 nextrev -4 0 12 10 0 -1 0 0.000 4 7 42 274 369 backrev --6 -6 354 359 364 369 -2 1 0 1 5 0 0 0 0.000 7 0 0 - 354 359 364 369 9999 9999 -2 1 0 1 5 0 0 0 0.000 7 0 0 - 354 369 364 359 9999 9999 --6 -6 74 564 194 599 -4 0 12 12 0 -1 0 0.000 4 12 84 74 579 Package: foo -4 0 12 12 0 -1 0 0.000 4 12 119 74 595 Depends: a | b, c --6 -6 389 449 399 459 -2 1 0 1 2 0 0 0 0.000 7 0 0 - 389 449 399 459 9999 9999 -2 1 0 1 2 0 0 0 0.000 7 0 0 - 389 459 399 449 9999 9999 --6 -6 389 509 399 519 -2 1 0 1 5 0 0 0 0.000 7 0 0 - 389 509 399 519 9999 9999 -2 1 0 1 5 0 0 0 0.000 7 0 0 - 389 519 399 509 9999 9999 --6 -6 304 409 424 544 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 304 444 424 444 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 304 464 424 464 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 304 484 424 484 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 304 504 424 504 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 364 424 364 544 9999 9999 -2 2 0 1 -1 0 0 0 0.000 0 0 0 - 424 544 424 424 304 424 304 544 424 544 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 304 524 424 524 9999 9999 -4 0 12 10 0 -1 0 0.000 4 9 48 304 419 deppossi -4 0 12 10 0 -1 0 0.000 4 7 12 309 439 up -4 0 12 10 0 -1 0 0.000 4 7 24 309 459 next -4 0 12 10 0 -1 0 0.000 4 7 12 309 479 ed -4 0 12 10 0 -1 0 0.000 4 7 42 309 539 version -4 0 12 10 0 -1 0 0.000 4 7 42 309 499 nextrev -4 0 12 10 0 -1 0 0.000 4 7 42 309 519 backrev --6 -6 259 119 359 214 -2 2 0 1 -1 0 0 0 0.000 0 0 0 - 359 214 359 134 259 134 259 214 359 214 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 259 154 359 154 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 259 174 359 174 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 259 194 359 194 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 299 134 299 214 9999 9999 -4 0 12 10 0 -1 0 0.000 4 7 12 264 149 up -4 0 12 10 0 -1 0 0.000 4 7 24 264 169 next -4 0 12 10 0 -1 0 0.000 4 7 24 264 189 list -4 0 12 10 0 -1 0 0.000 4 9 24 264 209 type -4 0 12 10 0 -1 0 0.000 4 9 60 259 129 dependency --6 -6 479 279 599 414 -6 564 359 574 369 -2 1 0 1 5 0 0 0 0.000 7 0 0 - 564 359 574 369 9999 9999 -2 1 0 1 5 0 0 0 0.000 7 0 0 - 564 369 574 359 9999 9999 --6 -6 564 319 574 329 -2 1 0 1 2 0 0 0 0.000 7 0 0 - 564 319 574 329 9999 9999 -2 1 0 1 2 0 0 0 0.000 7 0 0 - 564 329 574 319 9999 9999 --6 -6 479 279 599 414 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 479 314 599 314 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 479 334 599 334 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 479 354 599 354 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 479 374 599 374 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 539 294 539 414 9999 9999 -2 2 0 1 -1 0 0 0 0.000 0 0 0 - 599 414 599 294 479 294 479 414 599 414 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 479 394 599 394 9999 9999 -4 0 12 10 0 -1 0 0.000 4 9 48 479 289 deppossi -4 0 12 10 0 -1 0 0.000 4 7 12 484 309 up -4 0 12 10 0 -1 0 0.000 4 7 24 484 329 next -4 0 12 10 0 -1 0 0.000 4 7 12 484 349 ed -4 0 12 10 0 -1 0 0.000 4 7 42 484 409 version -4 0 12 10 0 -1 0 0.000 4 7 42 484 369 nextrev -4 0 12 10 0 -1 0 0.000 4 7 42 484 389 backrev --6 -6 564 379 574 389 -2 1 0 1 5 0 0 0 0.000 7 0 0 - 564 379 574 389 9999 9999 -2 1 0 1 5 0 0 0 0.000 7 0 0 - 564 389 574 379 9999 9999 --6 -1 3 0 1 4 0 0 0 0.000 1 0.000 569 304 5 5 569 304 574 309 -1 3 0 1 6 0 0 0 0.000 1 0.000 569 344 5 5 569 344 574 349 -4 0 0 12 0 -1 0 0.000 4 6 5 589 289 c --6 -6 644 409 764 544 -6 729 489 739 499 -2 1 0 1 5 0 0 0 0.000 7 0 0 - 729 489 739 499 9999 9999 -2 1 0 1 5 0 0 0 0.000 7 0 0 - 729 499 739 489 9999 9999 --6 -6 729 449 739 459 -2 1 0 1 2 0 0 0 0.000 7 0 0 - 729 449 739 459 9999 9999 -2 1 0 1 2 0 0 0 0.000 7 0 0 - 729 459 739 449 9999 9999 --6 -6 644 409 764 544 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 644 444 764 444 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 644 464 764 464 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 644 484 764 484 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 644 504 764 504 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 704 424 704 544 9999 9999 -2 2 0 1 -1 0 0 0 0.000 0 0 0 - 764 544 764 424 644 424 644 544 764 544 9999 9999 -2 1 2 1 -1 0 0 0 3.000 -1 0 0 - 644 524 764 524 9999 9999 -4 0 12 10 0 -1 0 0.000 4 9 48 644 419 deppossi -4 0 12 10 0 -1 0 0.000 4 7 12 649 439 up -4 0 12 10 0 -1 0 0.000 4 7 24 649 459 next -4 0 12 10 0 -1 0 0.000 4 7 12 649 479 ed -4 0 12 10 0 -1 0 0.000 4 7 42 649 539 version -4 0 12 10 0 -1 0 0.000 4 7 42 649 499 nextrev -4 0 12 10 0 -1 0 0.000 4 7 42 649 519 backrev --6 -1 3 0 1 4 0 0 0 0.000 1 0.000 734 434 5 5 734 434 739 439 -1 3 0 1 6 0 0 0 0.000 1 0.000 734 474 5 5 734 474 739 479 -1 3 0 1 5 0 0 0 0.000 1 0.000 734 514 5 5 734 514 739 519 -4 0 0 12 0 -1 0 0.000 4 9 6 744 419 b -4 0 12 12 0 7 0 0.000 4 9 28 719 539 >1.0 --6 -6 449 564 589 599 -4 0 12 12 0 -1 0 0.000 4 12 70 449 579 Package: c -4 0 12 12 0 -1 0 0.000 4 11 140 449 595 Recommends: b (>1.0) --6 -1 3 0 1 1 0 0 0 0.000 1 0.000 169 139 5 5 169 139 174 144 -1 3 0 1 1 0 0 0 0.000 1 0.000 669 139 5 5 669 139 674 144 -1 3 0 1 1 0 0 0 0.000 1 0.000 329 164 5 5 329 164 334 169 -1 3 0 1 2 0 0 0 0.000 1 0.000 329 184 5 5 329 184 334 189 -1 3 0 1 2 0 0 0 0.000 1 0.000 469 184 5 5 469 184 474 189 -1 3 0 1 2 0 0 0 0.000 1 0.000 724 289 5 5 724 289 729 294 -1 3 0 1 5 0 0 0 0.000 1 0.000 169 479 5 5 169 479 174 484 -1 3 0 1 5 0 0 0 0.000 1 0.000 669 159 5 5 669 159 674 164 -1 3 0 1 4 0 0 0 0.000 1 0.000 724 249 5 5 724 249 729 254 -1 3 0 1 4 0 0 0 0.000 1 0.000 329 144 5 5 329 144 334 149 -1 3 0 1 4 0 0 0 0.000 1 0.000 469 144 5 5 469 144 474 149 -1 3 0 1 5 0 0 0 0.000 1 0.000 169 319 5 5 169 319 174 324 -1 3 0 1 2 0 0 0 0.000 1 0.000 359 304 5 5 359 304 364 309 -1 3 0 1 4 0 0 0 0.000 1 0.000 359 284 5 5 359 284 364 289 -1 3 0 1 6 0 0 0 0.000 1 0.000 359 324 5 5 359 324 364 329 -1 3 0 1 5 0 0 0 0.000 1 0.000 394 494 5 5 394 494 399 499 -1 3 0 1 4 0 0 0 0.000 1 0.000 394 434 5 5 394 434 399 439 -1 3 0 1 6 0 0 0 0.000 1 0.000 394 474 5 5 394 474 399 479 -2 1 0 1 5 0 0 0 0.000 7 1 0 - 0 0 1.000 4.000 8.000 - 169 479 299 479 9999 9999 -2 1 0 1 1 0 0 0 0.000 -1 0 1 - 0 0 1.000 4.000 8.000 - 394 164 329 164 9999 9999 -3 2 0 1 1 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 169 139 199 139 219 144 239 149 254 149 9999 9999 - 0.000 -190.000 186.321 138.362 193.821 138.362 203.746 139.584 - 214.444 142.861 223.556 145.139 234.254 148.416 241.590 149.319 - 245.340 149.319 0.000 -190.000 -3 2 0 1 1 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 669 139 704 144 719 154 734 234 9999 9999 - 0.000 -190.000 689.270 140.465 698.020 141.715 708.066 145.553 - 716.306 149.925 728.121 167.798 731.871 187.798 0.000 -190.000 -3 2 0 1 2 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 329 184 319 184 314 184 304 194 304 199 304 259 9999 9999 - 0.000 0.000 323.209 184.000 320.709 184.000 317.861 184.000 - 315.246 183.484 310.477 185.460 305.459 190.476 303.484 195.246 - 304.000 197.861 304.000 209.251 304.000 224.251 0.000 0.000 -3 2 0 1 2 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 359 304 389 309 399 339 404 384 404 419 9999 9999 - 0.000 0.000 376.183 303.206 383.683 304.456 396.372 315.299 - 397.434 331.869 401.243 349.210 403.427 373.663 404.332 389.993 - 404.332 398.743 0.000 0.000 -3 2 0 1 2 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 469 184 504 189 534 229 549 289 9999 9999 - 0.000 0.000 489.097 184.107 497.847 185.357 515.602 195.870 - 528.871 218.224 538.758 238.997 542.508 253.997 0.000 0.000 -3 2 0 1 2 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 724 289 709 299 704 414 9999 9999 - 0.000 0.000 714.657 293.115 710.907 295.615 696.821 320.614 - 695.571 349.364 0.000 0.000 -3 2 0 1 5 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 394 494 444 499 569 499 639 499 9999 9999 - 0.000 0.000 422.899 497.321 435.399 498.571 472.526 500.423 - 540.524 499.000 580.960 499.000 598.460 499.000 0.000 0.000 -3 2 0 1 5 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 669 159 649 159 634 164 604 204 579 289 9999 9999 - 0.000 0.000 657.478 158.436 652.478 158.436 645.334 159.595 - 637.243 161.663 623.745 171.392 609.302 193.426 596.954 218.053 - 590.704 239.303 0.000 0.000 -3 2 0 1 4 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 394 434 414 429 419 424 414 279 364 219 9999 9999 - 0.000 0.000 405.666 432.138 410.666 430.888 415.525 428.137 - 418.291 425.798 433.545 387.100 427.322 313.905 408.621 264.907 - 396.121 249.907 0.000 0.000 -3 2 0 1 4 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 569 304 554 234 529 189 504 174 9999 9999 - 0.000 0.000 562.162 263.254 558.412 245.754 549.770 222.731 - 537.823 198.122 525.252 185.125 519.002 181.375 0.000 0.000 -3 2 0 1 4 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 359 284 359 249 354 219 9999 9999 - 0.000 0.000 359.497 263.759 359.497 255.009 358.568 243.779 - 357.318 236.279 0.000 0.000 -3 2 0 1 4 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 734 434 724 379 724 324 9999 9999 - 0.000 0.000 727.366 402.355 724.866 388.605 723.148 369.549 - 723.148 355.799 0.000 0.000 -3 2 0 1 4 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 724 249 719 209 699 174 9999 9999 - 0.000 -190.000 722.530 225.840 721.280 215.840 716.720 202.160 - 711.720 193.410 0.000 -190.000 -3 2 0 1 4 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 329 144 304 144 269 139 219 124 204 124 9999 9999 - 0.000 -190.000 314.537 144.305 308.287 144.305 295.917 143.426 - 276.919 140.743 257.308 136.426 231.067 125.771 216.399 123.618 - 212.649 123.618 0.000 -190.000 -3 2 0 1 5 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 169 319 189 319 229 324 254 329 264 329 9999 9999 - 0.000 0.000 180.574 318.787 185.574 318.787 198.208 319.573 - 219.921 322.527 234.742 324.932 248.152 328.421 255.720 329.170 - 258.220 329.170 0.000 0.000 -3 2 0 1 6 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 394 474 339 469 299 469 259 469 234 469 204 469 9999 9999 - 0.000 0.000 362.200 470.679 348.450 469.429 329.874 468.586 - 308.112 469.000 289.888 469.000 268.112 469.000 253.305 469.000 - 239.695 469.000 228.874 469.000 221.374 469.000 0.000 0.000 -3 2 0 1 6 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 734 474 659 469 434 484 299 489 204 489 9999 9999 - 0.000 0.000 690.661 470.250 671.911 469.000 607.354 469.001 - 485.316 481.339 403.258 485.594 329.783 488.430 282.765 489.301 - 259.015 489.301 0.000 0.000 -3 2 0 1 6 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 569 344 594 339 619 304 634 204 644 174 9999 9999 - 0.000 0.000 583.473 343.015 589.723 341.765 603.620 332.780 - 615.079 313.689 628.219 281.222 628.581 226.603 635.271 198.699 - 637.771 191.199 0.000 0.000 -3 2 0 1 6 0 0 0 0.000 1 0 - 0 0 1.000 4.000 8.000 - 359 324 294 319 204 309 9999 9999 - 0.000 0.000 321.344 321.293 305.094 320.043 278.591 317.552 - 256.091 315.052 0.000 0.000 -3 2 0 1 5 0 0 0 0.000 0 1 - 0 0 1.000 4.000 8.000 - 429 514 564 519 714 519 734 514 9999 9999 - 0.000 0.000 507.163 517.323 540.913 518.573 598.180 519.633 - 679.471 523.251 717.559 518.562 722.559 517.312 0.000 0.000 -3 2 0 1 4 0 0 0 0.000 0 1 - 0 0 1.000 4.000 8.000 - 204 99 364 109 414 139 469 144 9999 9999 - 0.000 0.000 296.049 97.811 336.049 100.311 377.555 113.214 - 400.605 134.627 423.515 142.106 437.265 143.356 0.000 0.000 -4 0 0 12 0 -1 0 0.000 4 9 15 159 104 foo -4 0 0 12 0 -1 0 0.000 4 6 5 479 129 c -4 0 0 12 0 -1 0 0.000 4 12 42 309 209 depends -4 0 0 12 0 -1 0 0.000 4 12 42 449 209 depends -4 0 0 12 0 -1 0 0.000 4 9 6 744 234 b -4 0 0 12 0 -1 0 0.000 4 6 18 714 314 rec. -4 0 0 12 0 -1 0 0.000 4 6 6 164 264 a -4 0 0 12 0 -1 0 0.000 4 9 6 164 424 b -4 0 0 12 0 -1 0 0.000 4 6 5 664 104 c -4 0 0 18 0 -1 0 0.000 4 17 632 64 54 example of the structures (in the C code) which contain related packages information -4 0 12 12 0 -1 0 0.000 4 12 70 284 589 Package: a -4 0 0 12 0 -1 0 0.000 4 6 6 374 269 a -4 0 0 12 0 -1 0 0.000 4 9 6 384 419 b -4 0 0 12 0 -1 0 0.000 4 9 15 339 129 a|b -4 0 12 12 0 -1 0 0.000 4 12 70 674 589 Package: b diff --git a/doc/en/reference.sgml b/doc/en/reference.sgml deleted file mode 100644 index fe35c7b87..000000000 --- a/doc/en/reference.sgml +++ /dev/null @@ -1,976 +0,0 @@ -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ - <!ENTITY debian "<productname>Debian</productname>"> - <!ENTITY dpkg "<command>dpkg</command>"> - <!ENTITY dselect "<command>dselect</command>"> - <!ENTITY deb "<filename>.deb</filename>"> -]> -<book id="reference"> -<bookinfo> - <title>dpkg reference Manual</title> - <edition>draft</edition> - - <authorgroup> - <author> - <firstname>Wichert</firstname> - <surname>Akkerman</surname> - <affiliation> - <address> - <email>wichert@deephackmode.org</email> - </address> - </affiliation> - </author> - </authorgroup> - - <copyright> - <year>2001</year> - <year>2002</year> - <holder>Wichert Akkerman</holder> - </copyright> - - <legalnotice> - <para> - Permission is granted to copy, distribute and/or modify this document - under the terms of the GNU Free Documentation License, Version 1.1 or any - later version published by the Free Software Foundation. There are - no invariant sections. A copy of the license is included in the section - entitled "GNU Free Documentation License". - </para> - </legalnotice> -</bookinfo> - -<preface> - <title>Preface</title> - - <para> - This manual is a reference to the &debian; package management system. - </para> - - <para> - This manual is currently being written based on the previous packaging - manual and as such is a work in progress. - </para> -</preface> - -<chapter id="intro"> - <title>Introduction</title> - - <para> - The Debian package management system is build up from various seperate - tools that work together form a comprehensive system to manage your - system. - </para> - - <para> - This document describes all the tools that used to handle and produce - them as well as the file formats used. - </para> -</chapter> - - -<chapter id="versions"> - <title>Version numbers</title> - - <para> - It is essential for a packaging system to have a documented method to - compare version numbers. Unfortunately there are different ways of - dealing with them, each with their own good and bad sides. This chapter - describes how &dpkg; compares version numbers. - </para> - - <para> - Version numbers are ASCII strings made up from alphanumeric characters - (letters and digits) and the hyphen (<keycap>-</keycap>), dot - (<keycap>.</keycap>), plus (<keycap>+</keycap>), minus - (<keycap>-</keycap>) and colon (<keycap>:</keycap>) characters. - </para> - - <para> - A version number consists of two parts: the upstream version, and - optionally the package revision, which are seperated by a hyphen. - If there is no seperate package revision then the upstream version is - not allowed to contain a hyphen. - </para> - - <para> - Comparing version numbers is done by breaking them into pieces and - comparing those from left to right. Pieces are seperated by a - transition from numbers to letters and by non-alphanumeric - characters. Starting from &dpkg; 1.10 numbers of unlimited length may - be used. Olders versions converted numbers to integers before comparing - them and as a result can not handle numbers that do not fit into the C - type int (2^31-1 on 32bit architectures and 2^63-1 on 64bit - architectures). - </para> -</chapter> - - -<chapter id="diversions"> - <title>Managing diversions</title> - - <para> - Diversions are a method to instruct &dpkg; to use a different filename - when installing a file. This can be useful to prevent conflicts between - related packages or when a system administator wants to replace a file - with another version. - </para> - - <para> - Diversions are specific to either a package or the local system. A - package specific diversion will only divert a file if it does not - belongs to a specific package that was given when the diversion was - created. This allow a package to divert a file from other packages and - replacing them with its own copy. Local diversions are applied to all - packages and can be used by the system administrator. - </para> - - <section> - <title>Managing diversions with dpkg-divert</title> - - <tip> - <para> - The official documentation for <command>dpkg-divert</command> can always - be found online in the - <citerefentry><refentrytitle>dpkg-divert</refentrytitle> - <manvolnum>8</manvolnum></citerefentry> manual page. - </para> - </tip> - - <section> - <title>Adding new diversions</title> - - <para>New options can be added using the <emphasis>--add</emphasis> - option for <command>dpkg-divert</command>. Its syntax is: - </para> - - </section> - - </section> -</chapter> - -<chapter id="permissions"> - <title>Managing file permissions / ownership</title> - - <para> - When you install a package &dpkg; will use the ownership and permissions - that are used inside the package. In some situations you might not agree - with those defaults and would like to use other settings. To support this - a feature called statoverrides was introduced in &dpkg; 1.8.0, and an - accompanying tool called <command>dpkg-statoverride</command>. - </para> - - <note> - <para> - Even though we use the word file here, this applies to all filesystem - objects that &dpkg; handles, including directories, - devices, etc. - </para> - </note> - - <caution> - <para> - If you look at the &dpkg; changelog you will see that statoverrides - were actually added in version 1.7.0. However that version had - some problems both in <command>dpkg-statoverrides</command> which - broke adding and removing of overrides and in &dpkg; itself which - made it only apply overrides to normal files. Both problems - were fixed in version 1.8.0. - </para> - </caution> - - <section> - <title>How permissions and ownership are applied</title> - - <para> - &dpkg; uses the following logic to determine the ownership and - permissions to use when installing a file: - </para> - - <orderedlist> - <listitem><para>Check if there is a statoverride registered for this file - </para></listitem> - - <listitem><para>If an override is present use the ownership and permission - specified in the override.</para></listitem> - - <listitem><para>If no override is present:</para> - - <orderedlist> - <listitem><para>Check if there is a system account with the same name - as the owner used inside the archive. If so use that as owner, - otherwise use the uid as used in the package. - </para></listitem> - - <listitem><para>Check if there is a system group with the same name - as the group used inside the archive. If so use that as group, - otherwise use the gid as used in the package. - </para></listitem> - - <listitem><para>Use the permissions as used in the package. - </para></listitem> - </orderedlist> - </listitem> - </orderedlist> - - <para> - The exact method that &dpkg; uses to set the ownership and permissions - depends on the type of file that is being created: - </para> - - <variablelist> - <varlistentry> - <term>regular files</term> - <listitem><para>Created with owner and group set to - <filename>root</filename> and with mode 0. After the data has - been written to the file the ownership and mode are set to their - final values. - </para></listitem> - </varlistentry> - - <varlistentry> - <term>FIFOs</term> - <term>character and block devices</term> - <term>directories</term> - <listitem><para>Created with owner and group set to - <filename>root</filename> and with mode 0, and then updated - to set the ownership and mode to their final values. - </para></listitem> - </varlistentry> - - <varlistentry> - <term>Hardlinks</term> - <listitem><para>After the link has been made its ownership and - permissions are setup. <emphasis>This means the original file - will also be changed!</emphasis> - </para></listitem> - </varlistentry> - </variablelist> - </section> - - <section> - <title>Managing overrides with dpkg-statoverride</title> - - <tip> - <para> - The official documentation for <command>dpkg-statoverride</command> can - always be found online in the - <citerefentry><refentrytitle>dpkg-statoverride</refentrytitle> - <manvolnum>8</manvolnum></citerefentry> manual page. - </para> - </tip> - - <section> - <title>Listing overrides</title> - - <para> - You can get a list of all overrides present in the database by using the - <option>--list</option> option: - </para> - - <blockquote><para> - <synopsis><command>dpkg-statoverride</command> <option>--list</option> <parameter><glob></parameter></synopsis> -</para></blockquote> - - <para> - There is an optional glob option that restricts the output from - <option>--list</option> to overrides for files that match the glob - expression. - <para> - - <footnote> - <para> - Please see the <citerefentry><refentrytitle>sh</refentrytitle> - <manvolnum>1</manvolnum></citerefentry> or - <citerefentry><refentrytitle>glob</refentrytitle><manvolnum>7</manvolnum> - </citerefentry> for a description of glob syntax. - </para> - </footnote> - - <example> - <title>Listing overrides</title> - <programlisting> -[fog;~]-1# dpkg-statoverride --list -root root 0755 /bin/mount -root root 0755 /bin/ping -[fog;~]-2# dpkg-statoverride --list '*mount*' -root root 0755 /bin/mount -</programlisting> - </example> - </section> - - <section> - <title>Adding new overrides</title> - - <para> - New options can be added using the <option>--add</option> option - for <command>dpkg-statoverride</command>. Its syntax is: - </para> - - <blockquote><para> - <synopsis><command>dpkg-statoverride</command> <option>--add</option> <parameter><user></parameter> <parameter><group></parameter> <parameter><mode></parameter> <parameter><file></parameter> -</synopsis></para></blockquote> - - <para> - This will add an override for <filename><file></filename> by - telling &dpkg; to use the user, group and mode given to - <command>dpkg-statoverride</command>. The user and group can be - specified in two ways: either by using the name as found in the - system account database (ie <filename>/etc/passwd</filename>, NIS or - another source configured in - <filename>/etc/nsswitch.conf</filename>), or by using a number - prefixed with <computeroutput>#</computeroutput>. - </para> - - <example> - <title>Adding an override</title> - - <programlisting> - -[fog;~]-1# ls -l /bin/mount --rwsr-xr-x 1 root root 56284 Nov 23 06:14 /bin/mount -[fog;~]-2# dpkg-statoverride --add root root 0755 /bin/mount -[fog;~]-3# ls -l /bin/mount --rwsr-xr-x 1 root root 56284 Nov 23 06:14 /bin/mount -</programlisting> - </example> - - <para> - Adding an override does not update the file on the filesystem, unless - you also specify the <option>--update</option> option. - </para> - - <example> - <title>Adding an override using --update</title> - - <programlisting> -[fog;~]-1# ls -l /bin/mount --rwsr-xr-x 1 root root 56284 Nov 23 06:14 /bin/mount -[fog;~]-2# dpkg-statoverride --update --add root root 0755 /bin/mount -[fog;~]-3# ls -l /bin/mount --rwxr-xr-x 1 root root 56284 Nov 23 06:14 /bin/mount -</programlisting> - </example> - - <para> - If an override already exists and you want to replace it you can - use the <option>--force</option> to force <command>dpkg-statoverride - </command> to replace the existing override. - </para> - - <example> - <title>Replacing an existing override</title> - <programlisting> -[fog;~/sources/play/pkg-manual]-1# dpkg-statoverride --add root root 0755 /bin/mount -An override for "/bin/mount" already exists, aborting -[fog;~]-2# dpkg-statoverride --force --add root root 0755 /bin/mount -An override for "/bin/mount" already exists, but --force specified so lets ignore it. -[fog;~]-3# dpkg-statoverride --list /bin/mount -root root 0755 /bin/mount -</programlisting> - </example> - </section> - - <section> - <title>Removing overrides</title> - <para> - Overrides can be removed using the <option>--remove</option> option, - which takes a single filename as argument: - </para> - - <blockquote><para> - <synopsis><command>dpkg-statoverride</command> <option>--remove</option> <parameter><file></parameter></synopsis> -</para></blockquote> - - <para> - This will remove the override for <filename><file></filename> - from the database. - </para> - - <note> - <para>When an override for a file is removed its ownership and permission - are <emphasis>not</emphasis> restored to the original value. - </para> - </note> - - <example> - <title>Removing an override</title> - <programlisting> -[fog;~]-1# dpkg-statoverride --list -root root 0755 /bin/mount -[fog;~]-2# dpkg-statoverride --remove /bin/mount -[fog;~]-3# dpkg-statoverride --list -[fog;~]-4# -</programlisting> - </example> - </section> - - </section> -</chapter> - - -<chapter id="formats"> - <title>File formats</title> - <para> - This chapter describes all the file formats used by the package tools. - All files are text files which you can view and modify using any normal - text editor if needed. - </para> - - <para> - Most file formats are based on the RFC822 format, which is best known - as the format used in e-mail headers. - </para> - - <para> - Each format has a version number which indicates the revision of the - format being used. This version is always of the form "X.Y". The - first number (X) is the major version. Within a major version the only - allowed changes in format are the addition of new fields. This guarantees - that tools will always be fully backwards and upwards compatible within - a major version. - </para> - - <section> - <title>RFC822</title> - <para> - A RFC822 style messages consists of one or more blocks, seperated by - null lines (an empty line). Each block is made up of fields. Fields - can be folded over multiple lines by inserting a 'newline whitespace' - pair. This combination is interpreted as a single whitespace. - </para> - - <para> - Each fiels is a single line consisting of a field-name and a - field-body, seperated by a colon (:). The field-name is made up - from printable ASCII characters minus the colon. The field-body - may be composed of all ASCII characters except CR or LF (they - are automatically removed when unfolding lines). - </para> - - <example> - <title>RFC822 style file</title> - - <programlisting> -Header: value -Description: this is an example of an RFC822 style message - -Section: new -Name: body -Description: this is block 2 of the example -X-Fortune: - To be excellent when engaged in administration is to be like the North - Star. As it remains in its one position, all the other stars surround it. - -- Confucius -</programlisting> - </example> - </section> - - <section> - <title>changes file</title> - - <para> - The <filename>.changse</filename> file is used to describe a set of - files that is going to be installed in an archive. All files have to - belong to the same source package. The data in a - <filename>changes</filename> include the changes made since the - previous revision, version and architecture information and the list - of files that form the change set along with a checksum - </para> - - <para> - Just like other dpkg datafiles this file is formated using RFC822 - syntax. In addition the file can signed as an OpenPGP ASCII armored - message (see RFC2440). The table below lists the allowed fields - in a <filename>.dsc</filename> file. The order used is not important, - although <command>dpkg-genchanges</command> will output the fields using - the ordering used in the table. - </para> - - <table> - <title>Fields in a <filename>.changes</filename> file</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Field</entry> - <entry>Description</entry> - </row> - </thead> - - <tbody> - <row> - <entry>Format</entry> - <entry> - Version of the file format used. Currently 1.7. - </entry> - </row> - <row> - <entry>Date</entry> - <entry> - The date (in RFC822 format) when the change set was build. - </entry> - </row> - <row> - <entry>Source</entry> - <entry> - The name of the source package from which the changes were - build. - </entry> - </row> - <row> - <entry>Binary</entry> - <entry> - The binary packages (ie &deb; files) that are part of the - change set. - </entry> - </row> - <row> - <entry>Architecture</entry> - <entry> - A space seperate list of architectures for which files are - included in the set. - </entry> - </row> - <row> - <entry>Version</entry> - <entry> - Version number of the source from which the files were built. - </entry> - </row> - <row> - <entry>Distribution</entry> - <entry> - Distribution in which the changes should be installed, as taken from - <filename>debian/changelog</filename>. - </entry> - </row> - <row> - <entry>Urgency</entry> - <entry> - Urgency of the changes, as taken from - <filename>debian/changelog</filename>. - </entry> - </row> - <row> - <entry>Maintainer</entry> - <entry> - The maintainer of the package, as listed in - <filename>debian/control</filename>. - </entry> - </row> - <row> - <entry>Changed-By</entry> - <entry> - The person who made the last changes to the sources, as - listed in <filename>debian/changelog</filename>. - </entry> - </row> - <row> - <entry>Description</entry> - <entry> - Multi-line field describing the &deb; files in the package. - Each line describes a single package in the format - "packagename - short description". - </entry> - </row> - <row> - <entry>Closes</entry> - <entry> - Space seperate list of bugreports which are closed by this - change set. (Optional) - </entry> - </row> - <row> - <entry>Changes</entry> - <entry> - Multi-line field with the changes made since the previous - version, as taken from <filename>debian/changelog</filename>. - Can possibly mention changes for multiple versions. - </entry> - </row> - <row> - <entry>Files</entry> - <entry> - Multi-line field with the list of files in the change set. - Each line describes a single file in the format "MD5 filesize - filename". - </entry> - </row> - </tbody> - </tgroup> - </table> - </section> - - <section> - <title>dsc file</title> - - <para> - The <filename>.dsc</filename> file describes the source for a Debian - package: it contains general information over the source such as the - name of the package and which binary package it produces as well as - the files that contain the sourcecode. - </para> - - <para> - Just like other dpkg datafiles this file is formated using RFC822 - syntax. In addition the file can signed as an OpenPGP ASCII armored - message (see RFC2440). The table below lists the allowed fields - in a <filename>.dsc</filename> file. The order used is not important, - although <command>dpkg-source</command> will output the fields using - the ordering used in the table. - </para> - - <table> - <title>Fields in a <filename>.dsc</filename> file</title> - <tgroup cols="2"> - <thead> - <row><entry>Field</entry><entry>Description</entry></row> - </thead> - <tbody> - <row><entry>Format</entry> - <entry>Version of the file format used. Currently 1.0. - </entry></row> - <row><entry>Source</entry> - <entry>Name of the source package</entry></row> - <row><entry>Version</entry> - <entry>Version number of the source</entry></row> - <row><entry>Binary</entry> - <entry>comma seperated list of binary packages build from this - source</entry></row> - <row><entry>Origin</entry> - <entry>Name of the organization that procuded this package - </entry></row> - <row><entry>Maintainer</entry> - <entry>Maintainer of this package</entry></row> - <row><entry>Uploaders</entry> - <entry>Multi-line field with list of people authorized to make - uploads of a package (optional)</entry> - <row><entry>Architecture</entry> - <entry>Space seperated list of architectures for which package - are build from this source</entry></row> - <row><entry>Standards-Version</entry> - <entry>Version of &debian; policy this package is complient - with</entry></row> - <row><entry>Files</entry> - <entry>Multi-line field with list of files with the actual source - code</entry></row> - </tbody> - </tgroup> - </table> - - <para> - The Files field contains one line for each file that is - contains source for this package (only 2 files are supported: a - <filename>.tar.gz</filename> file with the (original) source, and - an optional <filename>.diff.gz</filename> with Debian changes to the - source). Each file description consists of 3 items, seperated by - a single space: - - <orderedlist> - <listitem><para>A MD5 checksum of the file</para></listitem> - <listitem><para>The filesize in bytes</para></listitem> - <listitem><para>The filename</para></listitem> - </orderedlist> - </para> - - <example> - <title>modutils .dsc file</title> - - <programlisting> ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA1 - -Format: 1.0 -Source: modutils -Version: 2.4.1-1 -Binary: modutils -Origin: debian -Maintainer: Wichert Akkerman <wakkerma@debian.org> -Architecture: any -Standards-Version: 3.2.0 -Files: - 6d69ff476c964e703659d950999e411c 246022 modutils_2.4.1.orig.tar.gz - 3de7100460662472404f8a83cccde6da 17219 modutils_2.4.1-1.diff.gz - ------BEGIN PGP SIGNATURE----- -Version: GnuPG v1.0.4 (GNU/Linux) -Comment: For info see http://www.gnupg.org - -iEYEARECAAYFAjpbNIAACgkQPLiSUC+jvC1CFQCePvKBH6qT7/BKXVHCamKXZvZq -Be8An1QDPcyDFtMddYJw/BwTVphbwzU6 -=Zl3g ------END PGP SIGNATURE----- -</programlisting> - </example> - </section> - - <section> - <title>control</title> - - <table> - <title>Fields in the source section of the <filename>control</filename> - file</title> - <tgroup cols="2"> - <thead> - <row><entry>Field</entry> - <entry>required</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row><entry>Source</entry><entry>yes</entry> - <entry>Name of the source package</entry></row> - <row><entry>Section</entry><entry>no</entry> - <entry>Package category for this package, used by frontends. - </entry></row> - <row><entry>Priority</entry><entry>no</entry> - <entry>Indication of package importance. Legal values are - extra, important, optional, required and standard. - </entry></row> - <row><entry>Maintainer</entry><entry>yes</entry> - <entry>Name of the source package</entry></row> - <row><entry>Standards-Version</entry><entry>no</entry> - <entry>Version of &debian; policy this package is complient - with</entry></row> - <row><entry>Build-Depends, Build-Conflicts, - Build-Depends-Indep, Build-Conflicts-Indep</entry><entry>no</entry> - <entry>Specify demands on the build environment</entry></row> - <row><entry>Bugs</entry><entry>no</entry> - <entry>Name of the source package</entry></row> - <row><entry>Origin</entry><entry>no</entry> - <entry>Name of the source package</entry></row> - </tbody> - </tgroup> - </table> - - - <table> - <title>Fields in the package section of the <filename>control</filename> - file</title> - <tgroup cols="2"> - <thead> - <row><entry>Field</entry> - <entry>required</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row><entry>Package</entry><entry>yes</entry> - <entry>Name of the package</entry></row> - <row><entry>Architecture</entry><entry>yes</entry> - <entry>Space seperated list of architectures for which package - are build from this source</entry></row> - <row><entry>Essential</entry><entry>no</entry> - <entry>Indicates if a package is essential to the system - </entry></row> - <row><entry>Pre-Depends, Depends, Recommends, Suggests, Replaces, - Conflicts</entry><entry>no</entry> - <entry>Specify relations to other packages</entry></row> - <row><entry>Description</entry><entry>yes</entry> - <entry>Description of the package</entry></row> - </tbody> - </tgroup> - </table> - </section> - - <section> - <title>diversions</title> - - <para> - The <filename>diversions</filename> file contains all the alternatives - defined on this system. It is located in the &dpkg; admin directory. - </para> - - <note> - <para> - This is an internal &dpkg; file: do not edit it by hand unless really - needed, but use the <command>dpkg-divert</command> tool instead. - </para> - </note> - - <para> - For each diversion there are 3 lines in the diversions file: - <orderedlist> - <listitem><para> - The name of the file that will be diverted. - </para></listitem> - - <listitem><para> - The filename that the diverted file will be diverted to. - </para></listitem> - - <listitem><para> - The name of the package that made this diversion. If it is a - local (ie user) diversion the magic packagename `:' is used - instead. - </para></listitem> - </orderedlist> - </para> - - <example> - <title>Example <filename>diversions</filename> file</title> - - <programlisting> -/sbin/modprobe -/sbin/modprobe.orig -: -/usr/bin/locate -/usr/bin/locate.notslocate -slocate -</programlisting> - </example> - </section> - - <section> - <title>statoverrides</title> - <para> - This file contains the list of all statoverrides that &dpkg; uses - when unpacking packages. It is located in the &dpkg; admin - directory. Each line in the file represents one override, and - comments are not allowed. - </para> - - <note> - <para> - This is an internal &dpkg; file: do not edit it by hand unless really - needed, but use the <command>dpkg-statoverride</command> tool instead. - </para> - </note> - - <para> - Each line contains 4 items, seperated by whitespace: - <orderedlist> - <listitem><para> - The owner to use. This can be either an accountname that must - be present on the system, or a numerical uid. Uids are prefixed - with a <computeroutput>#</computeroutput>. - </para></listitem> - - <listitem><para> - The group to use. This can be either a group that must be present on - the system, or a numerical gid. Gids are prefixed - with a <computeroutput>#</computeroutput>. - </para></listitem> - - <listitem><para> - Mode to use for this file. This is an octal number. - </para></listitem> - - <listitem><para> - The filesystem object (file, directory, device, FIFO or link) - to which this override should be applied. Since this is the - last item on a line it may contain whitespace. - </para></listitem> - </orderedlist> - </para> - - <example> - <title>Example <filename>statoverride</filename> file</title> - <programlisting> -root wheel 04750 /bin/su -root adm 0750 /var/log/apache -</programlisting> - - <para> - This will tell &dpkg; to do the following: - </para> - - <itemizedlist> - <listitem><para><filename>/bin/su</filename> is installed owned by - user <computeroutput>root</computeroutput> and group - <computeroutput>wheel</computeroutput> with mode 04750. This means - that only people in the <computeroutput>wheel</computeroutput> - group are allowed to run <command>su</command>. - </para></listitem> - - <listitem><para><filename>/var/log/apache</filename> is installed - owned by user <computeroutput>root</computeroutput> and group - <computeroutput>adm</computeroutput> with mode 0750. This - restricts the ability to view the - <productname>apache</productname> to people in the - <computeroutput>adm</computeroutput> group by disallowing others - to access the <filename>/var/log/apache</filename> directory. - </para></listitem> - </itemizedlist> - </example> - </section> - - <section> - <title>alternatives</title> - - <para> - The configuration for alternatives is spread over two places: the - symlink to the selected alternative is stored in /etc/alternatives - and the list of available alternatives is kept in a series of files - in <filename>/var/lib/dpkg/alternatives/</filename>. - </para> - - <para> - For each alternative there is a single file in - <filename>/var/lib/dpkg/alternatives/</filename> named after the - the alternative it describes. The file is a normal text file: - </para> - - <itemizedlist> - <listitem> - <para> - The first line lists the state of the alternative, either - `manual' or `auto'. - </para> - </listitem> - - <listitem> - <para> - The second line is the filename that the alternative will - provide. - </para> - </listitem> - - <listitem> - <para> - A list of zero or more slave links. For each slave there are - two lines: the first contains the name of the slave and the - second contains the filename. - </para> - </listitem> - - <listitem> - <para> - An empty line - </para> - </listitem> - - <listitem> - <para> - A list of one or more alternatives. Each alternative is made up - as follows: - </para> - - <itemizedlist> - <listitem> - <para> - The filename of the file providing the alternative. - </para> - </listitem> - - <listitem> - <para> - The priority - </para> - </listitem> - - <listitem> - <para> - For each slave link a single line with the file providing - the link. An empty line can be used to indicate an - alternative does not provide a slave. - </para> - </listitem> - </itemizedlist> - </listitem> - </itemizedlist> - </section> -</chapter> - -</book> - -<!-- vi: sw=2 tw=75 ---> diff --git a/doc/internals.sgml b/doc/internals.sgml deleted file mode 100644 index 53c99a6c2..000000000 --- a/doc/internals.sgml +++ /dev/null @@ -1,544 +0,0 @@ -<!doctype debiandoc system [ -<!entity % manuals-version-def system "manuals-version"> -%manuals-version-def; -]> -<debiandoc><book> - -<titlepag> -<title>dpkg Internals Manual</title> -<author> - <name>Klee Dienes</name> - <email>klee@mit.edu</email> -</author> -<version>Version &manuals-version; (dpkg &dpkg-version;)</version> -<abstract> -This manual describes the internal structure of the <prgn>dpkg</prgn> package -management system. -</abstract> - -<copyright> -<copyrightsummary> -Copyright ©1997 Klee Dienes <klee@mit.edu> -</copyrightsummary> -<p> -This manual is free software; you may redistribute it and/or modify it -under the terms of the GNU General Public License as published by the -Free Software Foundation; either version 2, or (at your option) any -later version. -<p> -This is distributed in the hope that it will be useful, but -<em>without any warranty</em>; without even the implied warranty of -merchantability or fitness for a particular purpose. See the GNU -General Public License for more details. -<p> -You should have received a copy of the GNU General Public License with -your Debian system, in <file>/usr/share/common-licenses/GPL</file>, or -with the <prgn>dpkg</prgn> source package as the file <file>COPYING</file>. If -not, write to the Free Software Foundation, Inc., 675 Mass Ave, -Cambridge, MA 02139, USA. -</copyright> -</titlepag> - -<toc detail="sect"> - -<chapt id=build> -<heading>Build Notes</heading> - <sect id=automake> - <heading>Automake</heading> -<p> -This section by Tom Lees <tom@lpsg.demon.co.uk> on Tue, 4 Mar 1997 -21:34:57 +0000, with subsequent modifications by Klee Dienes <klee@debian.org> - -<p> -This chapter contains general notes about the conversion to -<prgn>automake</prgn>. If you plan on doing anything with <prgn>dpkg</prgn>, you -should probably read all of this file first. You have been warned. - -<p> -Automake has several significant advantages, including: - -<list> -<item>it supports emacs lisp properly -<item>It supports libtool properly -<item>it includes the aclocal utility -</list> - -<p> -The <prgn>aclocal</prgn> utility is a very useful program which will automatically -build an <file>aclocal.m4</file> file from the <file>configure.in</file> file to include the -appropriate macros. - -<p> -This doesn't affect anything other than rebuilding the <file>Makefile.in</file> files -from the sources. - -<p> -Probably the main difference which is noticable is that instead of -using proprietary directory names, it now supports <em>configure ---sharedstatedir</em>, and <em>configure --localstatedir</em>. To set these -to the Debian defaults, you should use <em>./configure ---localstatedir=/etc --sharedstatedir=/var/lib</em>. - -<p> -I have also customized the canonicalizing macros found in -<em>autoconf</em> to include the old way of finding the <prgn>dpkg</prgn> -``architecture'', i.e. to be a bit more smart. Instead of it trying to -determine the architecture only, I changed it to use the `host', -`build', and `target' system types. The target CPU type is checked -against the archtable to find the architecture on which dpkg will run. - -<p> -It uses <em>gcc --print-libgcc-file-name</em> to find out the build -architecture if possible (used later to determine ELF or <em>a.out</em> -format), and also uses <em>dpkg --print-architecture</em> if possible to -modify the <em>cpu</em> field before it passes on the target alias to -config.sub. If you want to specify the architecture, you should now -use "--target=", rather than <em>--with-arch</em>, which was essentially -a hack anyway. The old <em/--with-arch/ is still there, but it is -somewhat less functional. I have also moved the -<em/DPKG_CACHED_/ macros into dpkg.m4 to make configure.in a bit -more readable. - -<p> -I also converted to libtool (which can be found in the Debian -distribution now). Essentially, this means that all the dpkg tools can -be compiled against a shared <em>libdpkg</em> without much hassle (in -fact, it is the default). You do not need to install libtool to use -this feature (it works like autoconf), and generally, it should not be -needed much at all. - -<p> -The new <em>dist</em> targets will build a distribution including all -files built by the <prgn>debiandoc2html</prgn>, <prgn>debiandoc2ps</prgn>, etc., -which are included in the distribution so that people may build <prgn>dpkg</prgn> -without these (especially useful to porters). - -<p> -A target <em/make debian/ has been added, which will build the -Debian files from a working directory (does a <em/make dist/ -first). Now all we need is a modified dpkg-source so that the -<file/dpkg-1.4.0.8.tar.gz/ GNU-distribution file can be used as part -of the Debian distribution. I'm working on this, but it doesn't work -too well at the moment (find it in examples). - -<p> -I removed the <em/make portable/ target - it doesn't do anything useful. - -<p> -I have added <em/make uninstall/ targets to aid non-Debian users who simply -want to try out certain Debian packages, and the "dist" targets are also -useful to build a "distribution" of the dpkg tool. Note that since automake -automatically includes dependencies into the Makefiles in a distribution, -if you want to modify the C files, it would be advisable to get and install -automake, and then re-run it in the base dpkg distribution directory, so that -automatic dependency generation will be switched back on, and any -dependencies which change will be taken account of. The "make maintainer-clean" -targets will remove all files which any of the following utilities create: - -<list> -<item>automake -<item>autoconf -<item>aclocal -<item>autoheader -<item>gettextize -<item>libtoolize -</list> - -<p> -If you want to modify any of the sources, I recommend that you do the following -first (after having installed the appropriate utilities, of course):- - -<list> -<item> -make maintainer-clean -<item> -aclocal -<item> -autoheader -<item> -autoconf -<item> -gettextize -<item> -libtoolize (do not let automake run this, as it will cause it not to -include the libtool files in the dist targets) -<item> -for i in COPYING INSTALL; do ln -s /usr/share/automake/$i .; done -<item> -automake -</list> - -<p> -I have also incorporated the patches originally made by Galen -Hazelwood to internationalize dpkg using GNU gettext - see the file -"NOTES.intl" for more information about this. - -<p> -Other minor changes are: - -<list> -<item> -The version number is now determined from debian/changelog, not from -the directory name. -<item> -Creation of version.h now handled from configure script, not Makefile. -<item> -include/dpkg.h is now generated from include/dpkg.h.in by a sed -script, inserting the appropriate directory definitions - so now it -supports changing the dpkg directories (can install in /usr/local) -<item> -Updated the COPYING (1 very minor change) and INSTALL files to those -distributed with automake-1.1l -<item> -Since the shared libdpkg is now installed, I also made -include/Makefile install dpkg.h and dpkg-db.h into /usr/include by -default -</list> - -Questions: - -<list> -<item> -Should I use <em/localstatedir/ and <em/sharedstatedir/ instead of -<em/sysconfdir/ and <em/datadir/? -</list> - -</sect> - -<sect id=i18n> -<heading>Internationalization</heading> - -<p> -This section by Galen Hazelwood. - -<p> -Dpkg is, to say the least, generous in its error reporting. The vast -majority of the output strings are error messages of one kind or another. -And if you feel that you've stumbled into the Department of Redundancy -Department, you would be absolutely correct. Many of the error messages -in dpkg.pot are duplicates, used at different points in the program. - -<p> -To avoid swamping the translators completely, I made some executive decisions -on what kinds of strings to translate. All the strings sent to debug() are -left alone, on the grounds that these are for dpkg developers, and not for -the general public. Most interal error messages were very cryptic, and -would probably confuse the translators when seen just sitting there in -the dpkg.pot file, and are also left alone. (I did mark some of the more -verbose ones for translation.) - -<p> -If others disagree with me about the necessity of translating these strings, -it's easy enough to just go through and mark them later. - -<p> -I added the startup gettext code to the main routine in dselect, which was -necessary as many of the strings in lib are translated. Dselect is otherwise -unchanged. - -<p> -Changes: - -<list> -<item> -The files in intl and po were taken from gettext 0.10.26, by way of -the gettextize program. I altered the makefiles to remove the VERSION -symbol, which is only used in targets which dpkg does not support. -<item> -aclocal.m4 was stolen from the textutils package, configure.in was -altered to use these new tests, symbols were added to acconfig.h, and -the two new directories were added to Makefile.in. -<item> -The dpkg, dpkg-deb, md5sum, split, and dselect Makefiles now look for -headers in ../intl, and try to link with whatever i18n libraries -configure finds. They also now define LOCALEDIR in CFLAGS. -<item> -include/dpkg.h has the necessary NLS boilerplate, and the only file -which dosen't include this (md5sum/md5sum.c) had it added directly. -<item> -The most intrusive change is due to a disagreement between xgettext -and the dpkg coding style. Although xgettext understands string -constant concatenation, it can't handle the case where preprocessor -symbols are used as well. The dpkg code uses this a lot, especially -in cases like this: -<example> -ohshite("error reading from " BACKEND " pipe"); -</example> -where BACKEND is defined as "dpkg-deb". Because xgettext can't handle -this, I have changed this usage in all cases to something like: -<example> -ohshite(_("error reading from dpkg-deb pipe"); -</example> -This isn't very kind to Ian, I know. But what can I do? -</list> - -</sect> - -</chapt> - -<chapt id=code> -<heading>Code Internals</heading> - -<sect id=defs> -<heading>Structure Definitons</heading> - -<sect1 id=versionrevision> -<heading>versionrevision</heading> -<p> -<example> -struct versionrevision { - unsigned long epoch; - char *version; - char *revision; -}; -</example> - -<p> -The <tt/versionrevision/ structure is used to store a Debian version specification -</sect1> - -</sect> - -<sect id=functions> -<heading>Functions</heading> - -<sect1 id=parsing> -<heading>Parsing translation tables</heading> -<p> -Each of these tables is used to associate a set of strings with a -corresponding set of integers. - -Current tables are: - -<p> -<example> -const struct namevalue booleaninfos[]; -</example> - -<p> -Maps boolean strings (<em/"yes"/,<em/"no"/) to their binary values. - -<sect2> -<heading>priorityinfos[]</heading> - -<p> -<example> -const struct namevalue priorityinfos[]; -</example> - -<p> -Maps priority strings to and from values of -type <em/enum pkgpriority/. -Current priority values are: - -<list> -<item><em/required/ - required -<item><em/important/ - important -<item><em/standard/ - standard -<item><em/recommended/ - recommended -<item><em/optional/ - optional -<item><em/extra/ - extra -<item><em/contrib/ - contrib -<item><em/other/ - other -<item><em/unknown/ - unknown -<item><em/base/ - -This is obsolete, but is accepted as an alias for <em/required/. -</item> -</list> -</sect2> - -<sect2> -<heading>statusinfos[]</heading> - -<p> -<example> -const struct namevalue statusinfos[]; -</example> - -Maps package status strings to values of type <em/enum ???/. - -Package status strings are: - -"not-installed" "unpacked" "half-configured" "installed" -"half-installed" "config-files" "postinst-failed" "removal-failed" -</sect2> - -<sect2> -<heading>eflaginfos[]</heading> - -<p> -<example> -const struct namevalue eflaginfos[]; -</example> -</sect2> - -<sect2> -<heading>wantinfos[]</heading> - -<p> -<example> -const struct namevalue wantinfos[]; -</example> -</sect2> - -<sect2> -<heading>nicknames[]</heading> - -<p> -<example> -const struct nickname nicknames[]; -</example> - -Maps obsolete control fields to their current versions. - -</sect2> - -</sect1> - -<sect1 id=parsef> -<heading>Parsing functions</heading> - -<sect2> -<heading>parseerr()</heading> - -<p> -<example> -void parseerr -(FILE *file, const char *filename, int lno, - FILE *warnto, int *warncount, const struct pkginfo *pigp, - int warnonly, const char *fmt, ...); -</example> - -Report an error parsing a control data stream. Checks <var/file/ for -error status on <var/file/, printing an error message to stderr and -exiting with error status if an error is present on the stream. -Formats the variable arguments according to the <em/printf/-style -string in <var/fmt/, preceding the result with <var/filename/, -<var/lno/, and <var/pigp/ (if not NULL). If <var/warnonly/ is 0, -writes the result to stderr and exits with error status. Otherwise, -increments <var/warncount/ and returns normally. -</sect2> - -<sect2> -<heading>illegal_packagename()</heading> - -<p> -<em> -const char *illegal_packagename -(const char *p, const char **ep) -</em> - -Checks the package name at <var/p/ for proper syntax. Returns NULL in -case of success, setting <var/*ep/ to point after the last character -in the package name, including any trailing whitespace (as defined by -isspace()). In case of error, returns the error message as a pointer -to a static buffer. -</sect2> - -<sect2> -<heading>informativeversion()</heading> - -<p> -<em> -int informativeversion(const struct versionrevision *version) -</em> - -<p> -Returns true if and only if the <em/versionrevision/ is non-empty; -otherwise returns false. -</sect2> - -<sect2> -<heading>varbufversion()</heading> - -<p> -<example> -void varbufversion -(struct varbuf *vb, - const struct versionrevision *version, - enum versiondisplayepochwhen vdew); -</example> - -Writes a human-readable representation of <var/version/ to <var/vb/. -Possible values of <var/vdew/: - -<list> -<item><tt/vdew_never/ - never include epoch -<item><tt/vdew_nonambig/ - include epoch string if non-zero -<item><tt/vdew_always/ - always include epoch string -</list> -</sect2> - -<sect2> -<heading>versiondescribe()</heading> - -<p> -<example> -const char *versiondescribe -(const struct versionrevision *version, - enum versiondisplayepochwhen vdew); -</example> - -<p> -Return a human-readable representation of <var/version/ as a pointer -to a static buffer. If the version structure is empty, return -<em/"<none>"/. Static buffers are allocated from a set of 10 -in round-robin fashion (they will be re-used after 10 successive calls -to <em/versiondescribe/). -</sect2> - -<sect2> -<heading>parseversion()</heading> - -<p> -<example> -const char *parseversion -(struct versionrevision *rversion, const char *string); -</example> - -<p> -Parse the contents of <var/string/ into <var/rversion/. If -successful, returns NULL, otherwise returns a pointer to a static -error string. -</sect2> - -<sect2> -<heading>parsemustfield()</heading> - -<p> -<example> -void parsemustfield -(FILE *file, const char *filename, int lno, - FILE *warnto, int *warncount, - const struct pkginfo *pigp, int warnonly, - char **value, const char *what); -</example> -</sect2> - -<sect2> -<heading>skip_slash_dotslash()</heading> - -<p> -<example> -const char *skip_slash_dotslash (const char *p); -</example> -</sect2> - -<sect2> -<heading>convert_string()</heading> - -<p> -<example> -static int convert_string -(const char *filename, int lno, const char *what, int otherwise, - FILE *warnto, int *warncount, const struct pkginfo *pigp, - const char *startp, const struct namevalue *nvip, - const char **endpp) -</example> -</sect2> - -</sect1> - -</sect> -</chapt> -</book></debiandoc> |