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

.TH DPHYS2CD 1 "2004.10.08" "dphys2 Installation Tools"

.SH NAME

dphys2cd \- generate and automatic install boot CDs

.SH SYNOPSIS

.B dphys2cd
\fB-dir\fP [\fB-D\fP]
.PP
.B dphys2cd
\fB-g\fP [\fB-w\fP \fIworkdir\fP] [\fB-D\fP]
.PP
.B dphys2cd
\fB-h\fP

.SH DESCRIPTION

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

.SH OPTIONS

.TP
.B \-d
download: Download original Debian or dphys2 rescue and root image
files from an Debian distribution server or mirror or own install server
.TP
.B \-g
generate: Generate dphys2 CD image including rescue image and root inside it
.TP
.BI \-w \ workdir
workdir: Select work directory for doing all compiling and image generating.
Defaults to \fI./.dphys2cd\fP
.TP
.B \-n
nodelete: Do not delete work directory after generating. Usefull for debugging
.TP
.B \-i
install: install/burn CD image onto an CD-R or CD-RW
.TP
.B \-r
remove: Delete Debian and dphys2 files, after installing
.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 \fB-r\fP or
\fB-i\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/dphys2\fP (normal style), \fI/etc/default/dphys2\fP
(Debian style), \fI~/.dphys2\fP (personal) and \fI./dphys2\fP (particular
project) allow the admin and users to set up the working environment for
dphys2cd (and all other dphys2 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.
Assignments relevant for dphys2cd are:
.TP
.B CONF_DEBSERVER
Base URL from which all Debian stuff can be downloaded. Defaults to
\fIhttp://ftp.debian.org/debian\fP. Needs to be set if you want to use an
mirror.
.TP
.B CONF_KERNEL_24
Whether we are generating an 2.2 (no) or 2.4 (yes) style kernel. Defaults to
\fIno\fP. Needs to be set if you are using any form of 2.4 based stuff, leave
it for 2.2 based
.TP
.B CONF_KERNEL_OWN
Filename used by \fBdphys2rescue\fP to compile the custom kernel. Here it just
indicates to use the custom kernels rescue floppy image and drivers archive
instead of Debians ones. Defaults to empty (= use original Debian kernels).
.TP
.B CONF_OWNSERVER
Base URL to download dphys2 rescue 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_DISKSVERSION
Subdirectory on server where to upload and download rescue and root floppy
images. Defaults to \fIcustom\fP. Can be left if you only have one
configuration, else needs to be set different for each.
.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/dphys2
normal style site config
.TP
.B /etc/default/dphys2
Debian style site config
.TP
.B ~/.dphys2
users personal config
.TP
.B ./dphys2
individual projects config

.SH EXAMPLES

The following allows the sysadmin to tell all users how to get Debian stuff:
.PP
In \fI/etc/dphys2\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 rescue and root images for this are:
.PP
In \fI./dphys2\fP:
.PP
.nf
  CONF_KERNEL_24=yes
  CONF_KERNEL_OWN=anything-here-for-custom
  CONF_DISKSVERSION=user-foo
.fi
.PP
The following then allows the user to specify where and how to burn a CD:
.PP
In \fI./dphys2\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
\fIdphys2cd \-dgir\fP

.SH SEE ALSO

\fIdphys2\fP(7), \fIdphys2rescue\fP(1), \fIdphys2root\fP(1), \fIdphys2pxe\fP(1)

.SH AUTHOR

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