337271/man/make-fai-bootfloppy.8

.\"                                      Hey, EMACS: -*- nroff -*-
.if \n(zZ=1 .ig zZ
.if \n(zY=1 .ig zY
.TH make-fai-bootfloppy 8 "26 February 2004" "FAI 2.5.4"
.de }1
.ds ]X \&\\*(]B\\
.nr )E 0
.if !"\\$1"" .nr )I \\$1n
.}f
.ll \\n(LLu
.in \\n()Ru+\\n(INu+\\n()Iu
.ti \\n(INu
.ie !\\n()Iu+\\n()Ru-\w\\*(]Xu-3p \{\\*(]X
.br\}
.el \\*(]X\h|\\n()Iu+\\n()Ru\c
.}f
..
.\"
.\" File Name macro.  This used to be `.PN', for Path Name,
.\" but Sun doesn't seem to like that very much.
.\"
.de FN
\fI\|\\$1\|\fP
..
.SH NAME
make-fai-bootfloppy \- create a FAI boot floppy
.SH SYNOPSIS
.B make-fai-bootfloppy
[OPTIONS] [<kernel parameters>]
.SH DESCRIPTION
Creates a boot floppy for the Fully Automatic Installation (FAI)
package. This shell-script wrapper simplifies the complexities of
creating a FAI boot disk for use with DHCP or BOOTP protocols.  It
creates a bootfloppy using grub (default) or lilo as boot loader. The
installation kernel is also put onto the floppy disk which supports
DHCP, BOOTP protocol and a fixed IP address for the installation
server. All parameters are used as additional kernel parameters.

The exit code returned is 0 if all commands to build the root directory exited
successfully and >0 if an error occurs.
.SH OPTIONS

.TP
.B \-c CFDIR
Use CFDIR instead of /etc/fai for reading the config file fai.conf.
.TP
.B \-d LABEL

Use LABEL when selection the default boot kernel (and parameters).
Possible values of LABEL:
  a for any: the linux kernel will try all compiled in protocols in turn, until one succeeds;
  b for BOOTP;
  d for DHCP;
  f for using a fixed IP address on the FAI client (see option '-s');
  r for RARP.

Without this option, the kernel setting 'ip=dhcp is used.
.TP
.B \-F
Append default flags to kernel parameters. Same as
"FAI_FLAGS=verbose,sshd,createvt,syslogd"
.TP
.B \-f FILE
Make a 1440k floppy image in FILE.
.TP
.B \-i FILE
Make a 1440k iso9660 image in FILE (requires also -f FILE).
.TP
.B \-I CLIF
Use CLIF as client interface (default: eth0).
.TP
.B \-g
Use GRUB as boot loader (default).
.TP
.B \-l
Use LILO as boot loader.
.TP
.B \-m DIR
Use DIR as mountpoint for either floppy device or file.  Defaults to /floppy.
.TP
.B \-s HOST
Prepare a host specific bootfloppy which will boot the kernel with the fixed
IP of HOST (i.e., insert network configuration into kernel command line's
"ip=" statement).  All necessary data are gethered by DNS A lookup.
.TP
.B "-v"
Print verbose output

.SH EXAMPLES

Create a generic boot floppy

make-fai-bootfloppy 

Create a generic boot floppy for James ;-)
  
# make-fai-bootfloppy "FAI_FLAGS=sshd,createvt BOND=007"
  
Make a common floppy which uses the DHCP protocol as default, some common flags and action sysinfo

Create a bootable cdrom image, that can be burned using cdrecord(1)

# make-fai-bootfloppy -f /tmp/fai_floppy.img -i /tmp/fai_iso.img "FAI_FLAGS=sshd,createvt"

Make a common floppy which uses the DHCP protocol as default, some common flags and action sysinfo

# make-fai-bootfloppy -vF FAI_ACTION=sysinfo

Make a boot floppy with fixed IP adress, enable verbose messages and
additional terminals.

# make-fai-bootfloppy -l -d f "10.0.2.5:10.0.2.1:10.0.0.1: 255.255.0.0:client5:eth0:off FAI_FLAGS=verbose,createvt"

To make a boot floppy for my old SMC EtherCard Plus Elite 16T, I use

# make-fai-bootfloppy "reserve=0x300,32 ether=10,0x300,eth0"
.fi

.SH NOTES
.PD 0
make-fai-bootfloppy will attempt to access /dev/fd0 unless the option
-f is used.  IT IS NOT DEVFSD compatible unless your devfsd
installation remaps the floppy device to the common device alias /dev/fd0.
.PD
.SH SEE ALSO
.PD 0
This program is part of FAI (Fully Automatic Installation).  See the FAI manual
for more information on how to use make-fai-bootfloppy.  The FAI homepage is
http://www.informatik.uni-koeln.de/fai.
.PD
.SH FILES
.PD 0
.TP
.FN /etc/fai/fai.conf
.TP
.FN CFDIR/fai.conf
The FAI configuration file. CFDIR is set with option -c

.SH AUTHOR
Thomas Lange <lange@informatik.uni-koeln.de>
1	.\" Hey, EMACS: -- nroff --
2	.if \n(zZ=1 .ig zZ
3	.if \n(zY=1 .ig zY
4	.TH make-fai-bootfloppy 8 "26 February 2004" "FAI 2.5.4"
5	.de }1
6	.ds ]X \&\\*(]B\\
7	.nr )E 0
8	.if !"\\$1"" .nr )I \\$1n
9	.}f
10	.ll \\n(LLu
11	.in \\n()Ru+\\n(INu+\\n()Iu
12	.ti \\n(INu
13	.ie !\\n()Iu+\\n()Ru-\w\\(]Xu-3p \{\\(]X
14	.br\}
15	.el \\*(]X\h\|\\n()Iu+\\n()Ru\c
16	.}f
17	..
18	.\"
19	.\" File Name macro. This used to be `.PN', for Path Name,
20	.\" but Sun doesn't seem to like that very much.
21	.\"
22	.de FN
23	\fI\\|\\$1\\|\fP
24	..
25	.SH NAME
26	make-fai-bootfloppy \- create a FAI boot floppy
27	.SH SYNOPSIS
28	.B make-fai-bootfloppy
29	[OPTIONS] [<kernel parameters>]
30	.SH DESCRIPTION
31	Creates a boot floppy for the Fully Automatic Installation (FAI)
32	package. This shell-script wrapper simplifies the complexities of
33	creating a FAI boot disk for use with DHCP or BOOTP protocols. It
34	creates a bootfloppy using grub (default) or lilo as boot loader. The
35	installation kernel is also put onto the floppy disk which supports
36	DHCP, BOOTP protocol and a fixed IP address for the installation
37	server. All parameters are used as additional kernel parameters.
38
39	The exit code returned is 0 if all commands to build the root directory exited
40	successfully and >0 if an error occurs.
41	.SH OPTIONS
42
43	.TP
44	.B \-c CFDIR
45	Use CFDIR instead of /etc/fai for reading the config file fai.conf.
46	.TP
47	.B \-d LABEL
48
49	Use LABEL when selection the default boot kernel (and parameters).
50	Possible values of LABEL:
51	a for any: the linux kernel will try all compiled in protocols in turn, until one succeeds;
52	b for BOOTP;
53	d for DHCP;
54	f for using a fixed IP address on the FAI client (see option '-s');
55	r for RARP.
56
57	Without this option, the kernel setting 'ip=dhcp is used.
58	.TP
59	.B \-F
60	Append default flags to kernel parameters. Same as
61	"FAI_FLAGS=verbose,sshd,createvt,syslogd"
62	.TP
63	.B \-f FILE
64	Make a 1440k floppy image in FILE.
65	.TP
66	.B \-i FILE
67	Make a 1440k iso9660 image in FILE (requires also -f FILE).
68	.TP
69	.B \-I CLIF
70	Use CLIF as client interface (default: eth0).
71	.TP
72	.B \-g
73	Use GRUB as boot loader (default).
74	.TP
75	.B \-l
76	Use LILO as boot loader.
77	.TP
78	.B \-m DIR
79	Use DIR as mountpoint for either floppy device or file. Defaults to /floppy.
80	.TP
81	.B \-s HOST
82	Prepare a host specific bootfloppy which will boot the kernel with the fixed
83	IP of HOST (i.e., insert network configuration into kernel command line's
84	"ip=" statement). All necessary data are gethered by DNS A lookup.
85	.TP
86	.B "-v"
87	Print verbose output
88
89	.SH EXAMPLES
90
91	Create a generic boot floppy
92
93	make-fai-bootfloppy
94
95	Create a generic boot floppy for James ;-)
96
97	# make-fai-bootfloppy "FAI_FLAGS=sshd,createvt BOND=007"
98
99	Make a common floppy which uses the DHCP protocol as default, some common flags and action sysinfo
100
101	Create a bootable cdrom image, that can be burned using cdrecord(1)
102
103	# make-fai-bootfloppy -f /tmp/fai_floppy.img -i /tmp/fai_iso.img "FAI_FLAGS=sshd,createvt"
104
105	Make a common floppy which uses the DHCP protocol as default, some common flags and action sysinfo
106
107	# make-fai-bootfloppy -vF FAI_ACTION=sysinfo
108
109	Make a boot floppy with fixed IP adress, enable verbose messages and
110	additional terminals.
111
112	# make-fai-bootfloppy -l -d f "10.0.2.5:10.0.2.1:10.0.0.1: 255.255.0.0:client5:eth0:off FAI_FLAGS=verbose,createvt"
113
114	To make a boot floppy for my old SMC EtherCard Plus Elite 16T, I use
115
116	# make-fai-bootfloppy "reserve=0x300,32 ether=10,0x300,eth0"
117	.fi
118
119	.SH NOTES
120	.PD 0
121	make-fai-bootfloppy will attempt to access /dev/fd0 unless the option
122	-f is used. IT IS NOT DEVFSD compatible unless your devfsd
123	installation remaps the floppy device to the common device alias /dev/fd0.
124	.PD
125	.SH SEE ALSO
126	.PD 0
127	This program is part of FAI (Fully Automatic Installation). See the FAI manual
128	for more information on how to use make-fai-bootfloppy. The FAI homepage is
129	http://www.informatik.uni-koeln.de/fai.
130	.PD
131	.SH FILES
132	.PD 0
133	.TP
134	.FN /etc/fai/fai.conf
135	.TP
136	.FN CFDIR/fai.conf
137	The FAI configuration file. CFDIR is set with option -c
138
139	.SH AUTHOR
140	Thomas Lange <lange@informatik.uni-koeln.de>
Name	Value
svn:eol-style	native
svn:keywords	Author Date Id Revision