.\" /usr/share/man/man1/dphys3cd.1(.gz)
.\" author Neil Franklin, last modification 2005.10.21
.\" copyright ETH Zuerich Physics Departement
.\"   use under either modified/non-advertising BSD or GPL license

.TH DPHYS3CD 1 "2005.10.21" "dphys3 Installation Tools"

.SH NAME

dphys3cd \- generate and automatic install boot CDs

.SH SYNOPSIS

.B dphys3cd
\fB-dgir\fP [\fB-qvD\fP]
.PP
.B dphys3cd
\fB-h\fP

.SH DESCRIPTION

dphys3cd downloads, generates, installs and removes automatic installer
boot CDs, including custom kernel based boot floppy images, those including
automatic installer root floppy images including drivers subsets.

.SH OPTIONS

.TP
.B \-d
download: Download dphys3 boot and root image file from own install server
.TP
.B \-g
generate: Generate dphys3 CD image including boot image and root inside it
.TP
.B \-i
install: install/burn CD image onto an CD-R or CD-RW
.TP
.B \-r
remove: Delete dphys3 files, after installing
.TP
.B \-q
quiet: Don't produce an running report of activities
.TP
.B \-v
verbose: Give large volume output, where sensible
.TP
.B \-D
Debug: Activate an debug option. See source for how to use this.
.TP
.B \-h
help: Output help text, and then abort operation
.PP
If multiple of \fB-d\fP \fB-g\fP \fB-i\fP or \fB-r\fP are used, they are
processed in the order they appear here in the man page section, not the order
they are typed on the command line. Other options modify behaviour.

.SH CONFIG

The config files \fI/etc/dphys3\fP (sitewide), \fI~/.dphys3\fP (personal) and
\fI./dphys3\fP (particular project) allow the admin and users to set up the
working environment for dphys3cd (and all other dphys3 tools).
.PP
These config files are sh script fragments full of assignments, which are
sourced, in above row, later config files assignments overriding earlier ones.
Standard sh syntax rules apply. Assignments relevant for dphys3cd are:
.TP
.B CONF_DISKSVERSION
Subdirectory on server where to download boot and root floppy images from.
Defaults to \fIcustom\fP. Can be left if you only have one configuration, else
needs to be set different for each.
.TP
.B CONF_OWNSERVER
Base URL to download dphys3 boot and root floppy images from. Defaults also
to error message generating
\fIhttp://not-configured-server/not/configured/directory\fP.
Your admin must set this.
.TP
.B CONF_INST_CD
Drive where to install/burn CD image onto. Defaults to \fIdev=0,0,0\fP

.SH FILES

.TP
.B /etc/dphys3
site admin config
.TP
.B ~/.dphys3
users personal config
.TP
.B ./dphys3
individual projects config

.SH EXAMPLES

The following allows the sysadmin to tell all users how to get Debian stuff:
.PP
In \fI/etc/dphys3\fP:
.PP
.nf
  CONF_DEBSERVER=http://debian.ethz.ch/mirror/debian
.fi
.PP
The following then allows the user to specify using an custom kernel and
where on the server the boot and root images for this are:
.PP
In \fI./dphys3\fP:
.PP
.nf
  CONF_DISKSVERSION=user-foo
.fi
.PP
The following then allows the user to specify where and how to burn a CD:
.PP
In \fI./dphys3\fP:
.PP
.nf
  CONF_INST_CD="-driveropts=burnfree blank=fast dev=0,0,0"
.fi
.PP
The user now can generate and install on CD and delete an CD image with:
.PP
\fIdphys3cd \-dgir\fP

.SH SEE ALSO

\fIdphys3\fP(7), \fIdphys3boot\fP(1), \fIdphys3kernel\fP(1),
\fIdphys3preseed\fP(1), \fIdphys3pxe\fP(1), \fIdphys3root\fP(1)

.SH AUTHOR

franklin@phys.ethz.ch, http://www.phys.ethz.ch/~franklin/