
   #Using Debian From Scratch Command Reference Command Reference Links
   to Related Resources

   Prev Up Home Using Debian From Scratch Next 

                                   dfsbuild

Name

   dfsbuild -- Generate custom Debian From Scratch CD images

Synopsis

   dfsbuild [-a arch] [-R] [-v | -V] -c config_file -w working_dir

Description

   dfsbuild is a program to generate Debian From Scratch (DFS) CD images.
   It is highly configurable and can generate images far different from
   the standard DFS image.

   The output from dfsbuild is an ISO image that is bootable on i386 and
   amd64, powerpc, or alpha systems. It uses Grub for the bootloader (on
   i386/amd64), and in the default configuration, generates DFS ISOs that
   are bootable and can be used to repair a Linux system or install a new
   one.

   dfsbuild requires about twice the eventual size of the ISO image to
   run. That is, if you are building a 600MB ISO image, you will need
   approximately 1.2GB free on the disk that holds working_dir.

   Configuration is accomplished through the config file given with -c.
   An example is available in /etc/dfsbuild/dfs.cfg. That example is
   commented and shows all the available options.

   dfsbuild must be run as root.

Options

   These are the command-line options for dfsbuild. Please note that you
   must always specify at least -c and -w.

   -a architecture

   Specify the Debian architecture of the destination image. Normally,
   this defaults to the architecture of the host system. This option may
   be useful to, for instance, build an i386 image from your amd64 host.
   -c configfile  

   Specifies the path for the configuration file to use.
   -R

   Resume an existing build. If your build failed, you may be able to
   restart it from where it left off by using this option. Resuming is
   not supported from every point, so do not be surprised if this option
   doesn't work for you everywhere. This option is still experimental and
   may disappear in future versions of dfsbuild.
   -v             

   Enable verbose mode for dfsbuild messages only.
   -V

   Enable verbose mode for both dfsbuild messages and messages from
   external programs when possible.
   -w directory

   Specifies a directory for dfsbuild to use as its "work" directory. It
   will create its temporary files, and place the resulting ISO9660
   image, in this directory.

   It is an error if this directory already exists, unless -R is given,
   in which case it is an error if this directory does not exist.

Copyright

   dfsbuild, all associated scripts and programs, this manual, and all
   build scripts are Copyright  2004-2006 John Goerzen.

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or (at
   your option) any later version.

   This program is distributed in the hope that it will be useful, but
   WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
   General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
   USA

Author

   dfsbuild, its modules, documentation, executables, and all included
   files, except where noted, was written by John Goerzen
   <jgoerzen@complete.org> and copyright is held as stated in the
   COPYRIGHT section.

See Also

   Other related references include: DFS Manual at
   /usr/share/doc/dfsbuild, mkisofs(1), cdebootstrap(1). Pre-build DFS
   ISOs for various architectures are available from John Goerzen's DFS
   page at http://people.debian.org/~jgoerzen/dfs/.

   <<< Command Reference Links to Related Resources >>>
