cowbuilder(8)

NAME

   cowbuilder - a pbuilder wrapper for cowdancer.

SYNOPSIS

   cowbuilder [commands] [options]

DESCRIPTION

   cowbuilder Executes the specified pbuilder operation with cowdancer

COMMANDS

   Most commands invoke pbuilder with the specified commands, see pbuilder
   manual for details.

   --create

          Create the base.cow image.  The directory for base.cow should be
          empty, or this command will fail.

   --update

          Update the base.cow image.

   --build .dsc-file

          Build a package given a .dsc file

   --login

          Start a session within the base.cow.

   --execute

          Execute a command within the base.cow.

   --dumpconfig

          dump configuration information.

OPTIONS

   Most  options  are the same as pbuilder, except for the following which
   are handled specially

   --buildplace

          The place where COW operation takes place.

   --basepath
          has a very different meaning  to  basetgz  option  of  pbuilder,
          since  there  is no tgz.  This option specifies the directory in
          which  the  COW  master  data  is  stored,  the  default   being
          /var/cache/pbuilder/base.cow

   --configfile [configuration file to load]
          Additional   configuration   file   to   read  after  all  other
          configuration files have been read.

   --no-cowdancer-update

          Do not use cowdancer on cowbuilder  --update.  Please  use  this
          option  when  cowdancer  is interfering with upgrade process, or
          cowdancer itself is being upgraded within chroot.

   --debian-etch-workaround

          Work around on Debian etch compatibility. cow-shell will  search
          for all files in chroot, but will work.

CONFIGURATION FILES

   cowbuilder reads the following configuration files per default.

   /usr/share/pbuilder/pbuilderrc
          Application default, not to be changed.

   /etc/pbuilderrc
          System-wide default.

   ~/.pbuilderrc
          User default

   anything specified with --configfile option
          Additional configuration at runtime.

CONFIGURATION FILE OPTIONS

   The possible configuration options are as follows.  Others are ignored.

   DISTRIBUTION=distribution

   BUILDRESULT=directory

   BUILDPLACE=directory

   BASEPATH=path

   MIRRORSITE=http://mirror

   NO_COWDANCER_UPDATE=1

          See --no-cowdancer-update

   DEBIAN_ETCH_WORKAROUND=1

          See --debian-etch-workaround

EXAMPLES

   cowbuilder --create
          Create a base.cow image.

          # cowbuilder --create --hookdir /usr/share/doc/pbuilder/examples/workaround/ --distribution etch --debootstrap debootstrap --basepath /var/cache/pbuilder/base-test.cow
          bash: /root/.pbuilderrc: No such file or directory
          W: /home/dancer/.pbuilderrc does not exist
          I: Running in no-targz mode
          Distribution is etch.
          Building the build environment
          I: running debootstrap
          /usr/sbin/debootstrap
          I: Retrieving Release
               .
               .

   cowbuilder --update
          Update the base.cow image.

          # cowbuilder --update
          bash: /root/.pbuilderrc: No such file or directory
          I: Copying COW directory
          I: Invoking pbuilder
          W: /home/dancer/.pbuilderrc does not exist
          I: Running in no-targz mode
          I: copying local configuration
          I: mounting /proc filesystem
          I: mounting /dev/pts filesystem
          I: policy-rc.d already exists
          Refreshing the base.tgz
          I: upgrading packages
               .
               .

   cowbuilder --build test_0.1.dsc
          Build the package specified in dsc file, with the base.cow image.

   pdebuild --pbuilder cowbuilder
          Run
          cowbuilder --build
          against the current directory.
          The current directory should be an extracted Debian source package directory.

          Edit
          /etc/pbuilderrc
          to have
          PDEBUILD_PBUILDER=cowbuilder
          to make this the default behavior for
          pdebuild.

   cowbuilder --login --bindmounts /home/dancer
          Start a cow-shell session inside base.cow, with
          /home/dancer
           being bind-mounted to within chroot.

          Note that cowbuilder will not cow-protect what is inside
          /home/

          # cowbuilder --login --bindmount ${HOME}
          bash: /root/.pbuilderrc: No such file or directory
          I: Copying COW directory
          I: Invoking pbuilder
          W: /home/dancer/.pbuilderrc does not exist
          I: Running in no-targz mode
          I: copying local configuration
          I: mounting /proc filesystem
          I: mounting /dev/pts filesystem
          I: Mounting /home/dancer
          I: policy-rc.d already exists
          I: entering the shell
          #

   cowbuilder --create --distribution sid --basepath /var/cache/pbuilder/base-test.cow
          Create a base.cow image with the path
          /var/cache/pbuilder/base-test.cow
          and distribution sid.

AUTHOR

   Junichi Uekawa ([email protected])

SEE ALSO

   /usr/share/doc/pbuilder/pbuilder-doc.html, pbuilder (8), pdebuild (1)

Opportunity

Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.

Education

Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.