NAME

       build - build SuSE Linux RPMs in a chroot environment

SYNOPSIS

       build   [--clean|--no-init]   [--rpms  path1:path2:...]   [--arch  arch1:arch2:...]   [--root  buildroot]
       [specfile|srcrpm]
       build --help
       build --verify

DESCRIPTION

       build is a tool to build SuSE Linux RPMs in a safe and clean way.  build  will  install  a  minimal  SuSE
       Linux  as  build  system into some directory and will chroot to this system to compile the package.  This
       way you don't risk to corrupt your working system (due to a broken spec file for example),  even  if  the
       package does not use BuildRoot.

       build  searches  the spec file for a BuildRequires: line; if such a line is found, all the specified rpms
       are installed.  Otherwise a selection of default packages are used. Note that build doesn't automatically
       resolve missing dependencies, so the specified rpms have to be sufficient for the build.

       If a spec file is specified on the command line, build will use this file and  all  other  files  in  the
       directory  for  building  the  package.  If a srcrpm is specified, build automatically unpacks it for the
       build.  If neither is given, build will use all the specfiles in the current directory.

OPTIONS

       --clean
              remove the build system and reinitialize it from scratch.

       --no-init
              skip the build system initialization and start with build immediately.

       --list-state
              list rpms that would be used to create a fresh build root.  Does not  create  the  build  root  or
              perform a build.

       --rpms path1:path2:path3...
              Where  build can find the SuSE Linux RPMs needed to create the build system. This option overrides
              the BUILD_RPMS environment variable.

       --arch arch1:arch2:arch3...
              What architectures to select from the RPMs.  build automatically sets this to a sensible value for
              your host if you don't specify this option.

       --repo url_or_dir
              Also use the specified repository to create the build system.  The repositories may be  either  of
              type  rpmmd,  yast2 (susetags), or a simple directory. Multiple --repo options may be given.  As a
              special form, 'zypp://reponame' can be used to specify a system repository. 'zypp://' selects  all
              enabled  system  repositories.  This is also the default if BUILD_RPMS is not set and no --rpms or
              --repo option is used.

       --root buildroot
              Specifies where the build system is set up. Overrides the BUILD_ROOT enviroment variable.

       --useusedforbuild
              Tell build not to do dependency expansion, but to extract the list of packages to install from  "#
              usedforbuild"  lines or, if none are found, from all "BuildRequires" lines.  This option is useful
              if you want to re-build a package from a srcrpm with exactly the same packages used for the srcrpm
              build.

       --norootforbuild

       --help Print a short help text.

       --verify
              verify the files in an existing build system.

       ---dist distribution
              Set the distribution. If this option is not given, build tries to calculate  the  distribution  by
              looking  at  the rpm package used in the build.  The specified distribution can either be a string
              like "11.2" or "sles9", or the pathname of the build configuration to use.

.spec FILE OPTIONS

       The build command interprets some special control comments in the specfile:

       # norootforbuild
       # needsrootforbuild
              build uses either user root or user abuild in the build system to  do  the  build.   For  non-SUSE
              distros  as  well  as since SUSE 10.2, the default build user is abuild.  For 10.2 and before, the
              default build user is root.  These two flags in the spec file allow to deviate from  the  defaults
              and  force-set  the  build  user  to abuild and root (for # norootforbuild and # needsrootforbuild
              respectively.

       # needsbinariesforbuild
              provide the binary rpms that have been used to set up the build root  in  /.build.binaries  within
              the build root.

ENVIRONMENT

       BUILD_ROOT
              The directory where build should install the chrooted build system.  "/var/tmp/build-root" is used
              by default.

       BUILD_RPMS
              Where build can find the SuSE Linux RPMs.  build needs them to create the build system.

       BUILD_RPM_BUILD_STAGE
              The  rpm  build  stage (-ba, -bb, ...).  This is just passed through to rpm, check the rpm manpage
              for a complete list and descriptions.  "-ba" is the default.  You can use this to add more options
              to RPM.

SEE ALSO

       rpm(8),

       Maximum RPM:
              http://www.rpm.org/max-rpm/

       cross distribution packaging:
              http://en.opensuse.org/openSUSE:Build_Service_cross_distribution_howto

       openSUSE packaging standards and guidelines:
              http://en.opensuse.org/Portal:Packaging

                                 (c) 1997-2008 SuSE Linux AG Nuernberg, Germany                         build(1)