dfsbuild

Langue: en

Version: 04 February 2008 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

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.

dfsbuild, all associated scripts and programs, this manual, and all build scripts are Copyright (C) 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 <URL:http://people.debian.org/~jgoerzen/dfs/>.