Provided by: pbuilder-uml_0.189ubuntu1_i386 bug

NAME

       pbuilder-user-mode-linux - personal package builder in UML

SYNOPSIS

       pbuilder-user-mode-linux create [options]

       pbuilder-user-mode-linux update [options]

       pbuilder-user-mode-linux build [options] .dsc-file

       pbuilder-user-mode-linux execute [options] script

       pbuilder-user-mode-linux login [options]

DESCRIPTION

       Front  end program to the pbuilder suite of programs, used for creating
       and maintaining user-mode-linux environment and building Debian package
       within the user-mode-linux virtual machine environment.

       Unlike  pbuilder  ,  pbuilder-user-mode-linux  does  not  require  root
       privilege to run.  It should be ran under a normal user.

OPTIONS

       create Creates  a  user-mode-linux  root  image   for   the   specified
              distribution using rootstrap software

       update Updates   the  user-mode-linux  root  image  for  the  specified
              distribution.  Also, by specifying the --distribution option, it
              is  possible  to  switch  the  distribution.   Specify  a  dummy
              distribution value even for custom apt config files.

       build  Builds the package specified by .dsc-file within the  user-mode-
              linux environment.

       login  Invokes shell within UML.

       dumpconfig
              dumps  configuration information about user-mode-linux, used for
              debugging.

       execute
              Invokes a command or script inside UML.  execute will  copy  the
              specified file into the UML system, and run it.

              The  remaining  command-line  arguments  are  passed  on  to the
              script.

       --uml-image [UML image]
              Specify the UML image to use.

       --eth0 [uml option for eth0]
              Specify this option as parameter to UML.

              Specify --eth0=slirp,12345,/usr/bin/slirp-fullbolt  to  use  the
              slirp connection.

       --uml-ip [IP inside UML]
              Specify this to set the IP inside UML.

              This can be set to dhcp for obtaining IP address through DHCP.

       --uml-netmask [netmask]
              The netmask.

       --uml-network [network]
              The network address.

       --uml-broadcast [broadcast]
              The broadcast address.

       --uml-gateway [gateway]
              The gateway address.

       --mount-tmpfs [yes]
              Specify whether to mount tmpfs inside UML chroot.

       --uml-hostname [uml-host]
              The hostname inside uml.

       --distribution [sid]
              Specify the distribution.  see pbuilder(8)

       --binary-arch
              Specify only to build binary-arch targets.  see pbuilder(8)

       --timeout timeouttime
              Timeout build after specified time.  see pbuilder(8)

       --configfile config file to read
              Makes  pbuilder  to  read the config file inside UML.  pbuilder-
              user-mode-linux itself would be affected by the contents of  the
              config file.

       --hookdir location of hooks
              Makes pbuilder use the specified hookdir inside UML.

       --aptconfdir apt configuretion directory
              Makes  pbuilder  to  use  specified  apt configuration directory
              instead of other settings. See pbuilder(8)

       --override-config
              Specify  this  option  along  with  --distribution   to   switch
              distribution using pbuilder-user-mode-linux update

       --logfile logfilename
              Specify this option to make the output go to logfilename as well
              as standard output.

       --buildresult /dir/to/build/result
              The directory where build result is placed to

       --uml-debugmode
              Enable     tracing     of     shell     scripts     used      by
              pbuilder-user-mode-linux.

       --bindmounts /dir/to/bind-mount
              Bind-mount the directory inside the chroot inside the user-mode-
              linux.

       --buildplace place-to-put-COW-file
              Specify the directory to place the COW file.  The user needs  to
              be  able to access that directory, and the directory must exist.

       --uml-login-nocow
              Do not use COW filesystem  when  using  pbuilder-user-mode-linux
              login so that changes made in the log in session will persist.

              Effective in login and exec options.

       --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 favourite 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.

       --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 .

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

NOTES

       For  build  and login targets, pbuilder-user-mode-linux will try to use
       COW devices.

       Inside user-mode-linux, pbuilder-user-mode-linux will  mount  tmpfs  as
       /tmp to avoid temporary file race conditions with outside of UML.  This
       may cause problems trying to use files in /tmp directory.

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.

       /etc/pbuilder/pbuilder-uml.conf
              System-wide  configuration  file  for pbuilder-uml, it will take
              priority over pbuilder configurations.

       /usr/share/pbuilder/pbuilder-uml.conf
              Software-default configuration file for pbuilder-uml.

       ${HOME}/.pbuilderrc
              User-default configuration file.

SEE ALSO

       /usr/share/doc/pbuilder/pbuilder-doc.html,  pdebuild(1),   pbuilder(8),
       rootstrap(1), linux(1), pbuilderrc(5), pbuilder-uml.conf(5)