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

.TH DPHYS3BOOT 1 "2005.04.15" "dphys3 Installation Tools"

.SH NAME

dphys3boot \- write dphys3 replacement boot floppy

.SH SYNOPSIS

.B dphys3boot
\fB-dir\fP [\fB-qvD\fP]
.PP
.B dphys3boot
\fB-h\fP

.SH DESCRIPTION

dphys3boot downloads, installs and removes automatic installer boot floppy
images.

.SH OPTIONS

.TP
.B \-d
download: Download dphys3 boot image file from own install server
.TP
.B \-i
install: install dphys3 boot image onto an floppy
.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-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
\fIdphys3\fP (particular project) allow the admin and users to set up the
working environment for dphys3boot (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.
Assignments relevant for dphys3preseed are:
.TP
.B CONF_DISKSVERSION
Subdirectory on server where download boot floppy image 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 floppy image from and. Defaults also to error
message generating
\fIhttp://not-configured-server/not/configured/directory\fP.
Your admin must set this.
.TP
.B CONF_INST_FLOPPY
Drive where to install boot floppy image onto. Defaults to \fI/dev/fd0\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 user can download and install on floppy and delete an boot image with:
.PP
\fIdphys3boot \-dir\fP
.PP
Or do this in 2 separate steps, 1 download, multiple installs, one remove.

.SH SEE ALSO

\fIdphys3\fP(7), \fIdphys3cd\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/