Provided by: pbuilder_0.145ubuntu4_all bug

NAME

       pbuilder - personal package builder

SYNOPSIS

       pbuilder create [options]

       pbuilder update [options]

       pbuilder build [options] .dsc-file

       pbuilder execute [options] script

       pbuilder clean

       pbuilder login [options]

DESCRIPTION

       Front  end program to the pbuilder suite of programs, used for creating
       and maintaining chroot environment and building Debian package  in  the
       chroot environment.

COMMANDS

       create Creates a base.tgz for the specified distribution.

       update Updates  the  base.tgz for the specified distribution.  Also, by
              specifying the  --override-config  option,  it  is  possible  to
              install  a  new apt-line using the given options and settings in
              the configuration file for the base.tgz.

              For example, to switch the distribution of an existing  base.tgz
              to  etch,  specify  the  --distribution  etch  --override-config
              options to update.

       build  Builds  the  package  specified  by  .dsc-file  in  the   chroot
              environment created using the base.tgz

       clean  Cleans   up   the   directory  specified  by  the  configuration
              BUILDPLACE and APTCACHE specified in /etc/pbuilderrc

       login  Logs into the chroot, and cleaned up  afterwards.   Any  changes
              you  make  will  not  be  kept.  Only use this for temporary and
              debugging purposes.   Do  not  bind-mount  filesystems  directly
              inside the chroot.  Use --bindmounts option to mount.

       execute
              Execute  a  script  or  command  inside the chroot, in a similar
              manner to login

              The file specified in the command-line argument will  be  copied
              into the chroot, and invoked.

              The remaining arguments are passed on to the script.

       dumpconfig
              Dumps configuration information, used for debugging.

       debuild
              Builds a Debian package from the Debian source directory.  There
              needs to be a debian/ directory in the current directory.

              This command is a convenience script, and  it  does  not  accept
              most command-line options.  This may change in the future.

OPTIONS

       The command is followed by options of the form --option name which will
       modify the semantics as explained below.  They are applied  from  left-
       to-right, and when there are conflicting options, the rightmost options
       will have effect.

       --basetgz [basetgz-location]
              Specifies the location of base.tgz

              This option will define the default distribution  and  apt-lines
              when used in pbuilder update and pbuilder create

       --buildplace [location of build]
              Specifies  the location where building and base.tgz updating and
              creation takes place. This is a temporary work directory.

              A subdirectory of that directory using the current  PID  of  the
              process is used.

       --buildresult [location to put build result]
              Specifies   the  location  the  build  result  gets  into  after
              building.  The deb files and other files that have resulted from
              build  is  copied there.  Note that the default value is not the
              current directory, or ..  but somewhere else entirely.  This  is
              to  avoid  overwriting already existing deb files with the newly
              generated ones.

       --mirror [mirror location]
              Specifies  the  url  of  Debian  mirror  to  be   specified   in
              sources.list  inside the chroot.  This option is only valid when
              distribution is being specified, for update and  build  targets.
              The  format  is something like: http://http.us.debian.org/debian
              which should point to your favorite mirror.

              This option can optionally be omitted, and left blank, in  which
              case, this part is skipped.

              Note  that  these  URLs  specified to pbuilder will be used from
              within the chroot, and  specifying  file:/somewhere/  will  most
              probably fail.

       --nonusmirror [mirror location]
              The non-US mirror, specified like the --mirror option

       --othermirror [deb http://xxx/xxx/ ./ | other deb lines... ]
              The  lines  which is added to the sources.list, delimited with |
              Like      deb      http://local/mirror      stable      main|deb
              file:/usr/local/mirror ./

              The  deb  lines here are the ones that will appear at the top of
              the sources.list inside the  chroot.   Be  sure  to  follow  the
              syntax  rules  of  sources.list  (5).  These lines appear at the
              beginning of the constructed sources file, so this is the  place
              to  list  your  local  mirror  sites;  apt will then use them in
              preference to the ones listed in --mirror and --nonusmirror .

              These options are only valid when  --override-config  option  is
              specified  in  update  target,  or when pbuilder create is being
              called.

       --http-proxy [proxy]
              Specifies    the    http    proxy    url.     Something     like
              http://xxx.xxx.xxx.xxx:8080/ should do.

       --distribution [distribution]
              Specifies  the distribution used. Currently the supported values
              are sid sarge woody etch and experimental .

              This option is  only  effective  for  pbuilder  create  or  when
              pbuilder update is specified with --override-config option.

       --aptcache [location of retrieved package files]
              Specifies  the  location  where  the  packages downloaded by apt
              should be cached. Use --aptcache "" if you want  caching  to  be
              turned off.

       --removepackages [packages to remove]
              Removes  the packages on creating the base.tgz.  Use this option
              to remove potentially dangerous or  undesirable  packages,  like
              lilo which nobody will need to have inside a chroot.

              Packages  should  be  specified  in  a  space-delimited  manner,
              surrounded in double quotations, like "lilo gcc mawk"

       --extrapackages [packages to add]
              Adds packages specified as an addition to the default, which  is
              build-essential  by  default.   This is used in build and create
              (after successfully creating the initial chroot) and update.

              The packages should be specified as a space-delimited list.

       --configfile [configuration file to load]
              Loads the configuration file.

       --hookdir [location of user scripts]
              Specifies the  location  where  scripts  for  user  intervention
              during  the  create  and  update  process  are stored. Currently
              scripts are executed  at  only  one  point,  on  exit  from  the
              chrooted  environment,  just  before  either a create or a build
              regenerated the base.tgz file. The script names must be  in  the
              form   X<digit><digit><whatever-else-you-want>  much  like  boot
              scripts. The scripts  must  be  executable  and  may  be  either
              binaries or interpreted scripts. If it is a script in other than
              Bourne Shell or Perl, it  is  up  to  the  user  to  ensure  the
              interpreter   was   previously   installed   in   the   chrooted
              environment. Files ending in ~ or .bak are ignored.

              Although it may not seem necessary,  pbuilder  update  does  not
              invoke  the hooks if --hookdir is empty, so if you want to avoid
              running hooks, run pbuilder with --hookdir ""

              If there is a distribution hook, for example,  if  there  was  a
              file  sid inside the hook directory, and the script was creating
              the chroot for sid distribution, pbuilder will call  debootstrap
              with  that  as the 4th parameter in the chroot creation process.
              This allows for use of custom debootstrap hook script.

              A<digit><digit><whatever-else-you-want> is for build target.  It
              is  executed  before  build  starts;  after  unpacking the build
              system, and unpacking the  source,  and  satisfying  the  build-
              dependency.

              B<digit><digit><whatever-else-you-want>  is executed after build
              system finishes building, successfully, before copying back  the
              build result.

              C<digit><digit><whatever-else-you-want>  is executed after build
              failure, before cleanup.

              D<digit><digit><whatever-else-you-want>   is   executed   before
              unpacking  the  source  inside  the chroot, after setting up the
              chroot environment.  Create $TMP, and $TMPDIR if necessary.

              This is  called  before  build-dependency  is  satisfied.   Also
              useful for calling apt-get update

              E<digit><digit><whatever-else-you-want>    is   executed   after
              pbuilder update
               and pbuilder create finishes  apt-get  work  with  the  chroot,
              before  umounting  kernel  file systems (/proc) and creating the
              tarball from the chroot.

              F<digit><digit><whatever-else-you-want> is executed just  before
              user  logs  in,  or  program  starts  executing, after chroot is
              created in login or execute target.

       --debemail [maintainer-name <email-address>]

              Specifies that dpkg-buildpackage be  called  with  -mmaintainer-
              name  <email-address>  instead of default value specified in the
              environment variable, or pbuilderrc

              This option is almost obsolete, use --debbuildopts instead

       --debbuildopts [options]

              List  of  options  that  are  passed  on  to  dpkg-buildpackage.
              Overrides  any  value  given  in  DEBBUILDOPTS  as  specified in
              pbuilderrc.

       --logfile [file to log]
              Specifies the logfile to create.  The messages generated  during
              execution  will  be  written  to  the  file, instead of messages
              coming to the standard output.

       --pkgname-logfile
              Alternative option to --logfile option.  Automatically creates a
              logfile  that  is  named  by  the  .dsc  file  name, only really
              applicable for build target

       --aptconfdir [APT configuration directory to use]
              Uses the apt configuration file found in the specified directory
              as  the  chroot configuration.  /etc/apt is one example, so that
              the same configuration can be used inside the chroot.

              This  option  overrides  other  options,  and  may  cause   some
              inconsistency problems.

       --timeout [timeout in sleep time]
              Time  out  building  after sleeping set time.  Specify something
              like --timeout 10h in the command line.  Default is no  timeout.

       --override-config

              Specify  to  use  different apt set up inside the chroot than it
              was used for creating the base.tgz.  Specify this when you  want
              to  do  pbuilder update with a different distribution target set
              up.

       --binary-arch

              Specify to build architecture specific targets  instead  of  all
              targets.   Setting  --debbuildopts after this option will re-set
              some parts of the effect.

              Use this option rather than using --debbuildopts -B

       --no-targz
              Not using base.tgz for operation.  The --buildplace will not  be
              deleted  and  reconstructed from a .tar.gz file.  Also, pbuilder
              will not add its process ID to the --buildplace  as  it  usually
              would.

              Useful  when  experimenting  with  chroots,  or trying to create
              chroots outside control of pbuilder.

       --preserve-buildplace
              Do not clean the --buildplace if it has the same contents as the
              .tar.gz file, and no modifications are done.

              For  preserving  the  build place for create and update targets,
              see --debug option.

              As with --no-targz, suppresses appending pbuilder’s  process  ID
              to the --buildplace.

              This is useful if you want to attempt to build a large number of
              packages successively, but you expect that many of  them  cannot
              have their build dependencies satisfied.

              It  will  clean  up  the  build  place  on  failure,  or after a
              successful build.

       --bindmounts bind-mount-points
              Bind-mount the  specified  directories  to  inside  the  chroot.
              bind-mount-points  is  a  space-delimited list of directories to
              bind-mount.

       --debug

              Turn on Debug mode of pbuilder, to be verbose about errors,  and
              try to avoid cleanup processing when error happens in update
               and create targets.

       --debootstrapopts --variant=buildd
              Add extra command-line options to debootstrap.

       --debootstrap debootstrap
              Use  specified debootstrap implementation as debootstrap.  Known
              implementations are cdebootstrap and debootstrap

       --save-after-login

       --save-after-exec
              Save the chroot image after exiting from the chroot  instead  of
              deleting changes.  Effective for login and execute session.

       --autocleanaptcache
              Clean  apt cache automatically, to run apt-get autoclean to only
              keep the packages which are required for the version of  Debian.
              This  is  useful  when  you  keep  a aptcache directory for each
              distribution and want to keep the size of the aptcache down.

       --help  Show a brief help message.

FILES

       /etc/pbuilderrc
              The system-wide configuration file for pbuilder.

       /usr/share/pbuilder/pbuilderrc
              The default settings for pbuilder,  used  as  fallback  for  all
              values that is not specified in /etc/pbuilderrc.

       ${HOME}/.pbuilderrc
              The  personal  configuration  file for pbuilder, which overrides
              settings set in other configuration files.

BUGS

       This program is starting to have too many options already.

AUTHOR

       Initial  coding,  and  main  maintenance  is  done  by  Junichi  Uekawa
       <dancer@debian.org>.  User hooks code added by Dale Amon <amon@vnl.com>

       The           homepage            is            available            at
       http://www.netfort.gr.jp/~dancer/software/pbuilder.html

SEE ALSO

       pdebuild (1), pbuilderrc (5)