dpkg-deb man page on Darwin

Man page or keyword search:  
man Server   23457 pages
apropos Keyword Search (all sections)
Output format
Darwin logo
[printable version]

DPKG-DEB(1)			  dpkg suite			   DPKG-DEB(1)

NAME
       dpkg-deb - Debian package archive (.deb) manipulation tool

SYNOPSIS
       dpkg-deb -b|--build directory [archive|directory]
       dpkg-deb -I|--info archive [control-file-name ..]
       dpkg-deb -f|--field archive [control-field-name ...]
       dpkg-deb -c|--contents archive
       dpkg-deb -x|--extract|-X|--vextract archive directory
       dpkg-deb --fsys-tarfile archive
       dpkg-deb --control archive directory

DESCRIPTION
       dpkg-deb packs, unpacks and provides information about Debian archives.

       Use dpkg to install and remove packages from your system.

       You  can also invoke dpkg-deb by calling dpkg with whatever options you
       want to pass to dpkg-deb.  dpkg will spot that you wanted dpkg-deb  and
       run it for you.

ACTION OPTIONS
       --build, -b
	      Creates  a  debian  archive  from	 the filesystem tree stored in
	      directory.  directory must have  a  DEBIAN  subdirectory,	 which
	      contains	the control information files such as the control file
	      itself.  This directory will not appear in the binary  package's
	      filesystem  archive,  but instead the files in it will be put in
	      the binary package's control information area.

	      You can specify  the  compressionlevel  used  by	adding	a  -z#
	      option.  dpkg-deb will pass that option on to gzip.

	      Unless  you specify --nocheck, dpkg-deb will read DEBIAN/control
	      and parse it.  It will check it  for  syntax  errors  and	 other
	      problems,	 and  display  the  name  of  the binary package being
	      built.  dpkg-deb will also check the permissions	of  the	 main‐
	      tainer  scripts  and  other  files  found	 in the DEBIAN control
	      information directory.

	      If no archive is specified then dpkg-deb will write the  package
	      into the file directory.deb.

	      If the archive to be created already exists it will be overwrit‐
	      ten.

	      If the second argument is a directory then dpkg-deb  will	 write
	      to  the file package_version_arch.deb, or package_version.deb if
	      no Architecture field is present in the  package	control	 file.
	      When  a  target  directory is specified, rather than a file, the
	      --nocheck option may not be used (since dpkg-deb needs  to  read
	      and  parse  the package control file to determine which filename
	      to use).

       --info, -I
	      Provides information about a binary package archive.

	      If no control-file-names are specified then it will print a sum‐
	      mary of the contents of the package as well as its control file.

	      If any control-file-names are specified then dpkg-deb will print
	      them in the order they were specified; if any of the  components
	      weren't  present	it will print an error message to stderr about
	      each one and exit with status 2.

       --field, -f
	      Extracts control file information from a binary package archive.

	      If no control-file-fields are specified then it will  print  the
	      whole control file.

	      If any are specified then dpkg-deb will print their contents, in
	      the order in which they appear in the  control  file.   If  more
	      than one control-file-field is specified then dpkg-deb will pre‐
	      cede each with its field name (and a colon and space).

	      No errors are reported for fields requested but not found.

       --contents, -c
	      Lists the contents of the filesystem tree archive portion of the
	      package  archive.	 It is currently produced in the format gener‐
	      ated by tar's verbose listing.

       --extract, -x, --vextract, -X
	      Extracts the filesystem tree from a  package  archive  into  the
	      specified directory.

	      --vextract  (-X)	prints	a listing of the files extracted as it
	      goes, while --extract (-x) is silent unless an error occurs.

	      Note that extracting a package to the root  directory  will  not
	      result  in  a  correct installation !  Use dpkg to install pack‐
	      ages.

	      directory (but not its parents) will be created if necessary.

       --fsys-tarfile
	      Extracts the filesystem tree data	 from  a  binary  package  and
	      sends  it	 to  standard output in tar format.  Together with tar
	      this can be used to extract a particular file from a package ar‐
	      chive.

       --control, -e
	      Extracts	the  control  information files from a package archive
	      into the specified directory.

	      If no directory is specified then a subdirectory DEBIAN  in  the
	      current directory is used.

	      The  target  directory  (but not its parents) will be created if
	      necessary.

       --help, -h
	      Prints dpkg-deb's usage message, giving a summary of its options
	      and their uses.

       --version
	      Prints dpkg-deb's version number.

       --licence
	      Prints information about dpkg-deb's copyright licensing and lack
	      of warranty.  (The American  spelling  --license	is  also  sup‐
	      ported.)

OTHER OPTIONS
       --new  Ensures  that  dpkg-deb  builds a `new' format archive.  This is
	      the default.

       --old  Forces dpkg-deb to build an `old' format archive.	 This old  ar‐
	      chive  format  is	 less easily parsed by non-Debian tools and is
	      now obsolete; its only use  is  when  building  packages	to  be
	      parsed  by versions of dpkg older than 0.93.76 (September 1995),
	      which was released as i386 a.out only.

       --nocheck
	      Inhibits dpkg-deb --build's usual checks on  the	proposed  con‐
	      tents  of	 an  archive.	You can build any archive you want, no
	      matter how broken, this way.

       --debug, -D
	      Enables debugging output.	 This is not very interesting.

BUGS
       dpkg-deb -I package1.deb package2.deb does the wrong thing.

       There is no authentication on .deb files; in fact, there isn't  even  a
       straightforward checksum.

       Do not attempt to use just dpkg-deb to install software !  You must use
       dpkg proper to ensure that all the files are correctly placed  and  the
       package's scripts run and its status and contents recorded.

SEE ALSO
       deb(5), deb-control(5), dpkg(8), dselect(8).

AUTHOR
       dpkg-deb	 and this manpage were written by Ian Jackson.	They are Copy‐
       right (C)1995-1996 by him and released under  the  GNU  General	Public
       Licence;	 there	is  NO WARRANTY.  See /sw/share/doc/dpkg/copyright and
       /sw/share/common-licenses/GPL for details.  Paths modified  by  Carsten
       Klapp to reflect fink distribution, December 2002.

Debian Project			 1st June 1996			   DPKG-DEB(1)
[top]

List of man pages available for Darwin

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net