525 lines
16 KiB
Groff
525 lines
16 KiB
Groff
.TH BOOT 8
|
|
.SH NAME
|
|
boot \- from power on to the login prompt
|
|
.SH DESCRIPTION
|
|
.de SP
|
|
.if t .sp 0.4
|
|
.if n .sp
|
|
..
|
|
At power on the machine reads the first sector of the boot device into memory
|
|
and executes it. This bootstrap code loads
|
|
.BR /boot/boot ,
|
|
the MINIX 3 Boot Monitor. The monitor loads the kernel binaries from
|
|
.BR /boot/image ,
|
|
or the newest file in
|
|
.B /boot/image
|
|
if it is a directory.
|
|
.PP
|
|
The MINIX 3 system is now running, the different tasks initialize themselves
|
|
and control is transferred to the last one,
|
|
.BR init .
|
|
.PP
|
|
.B Init
|
|
is the grandparent of all MINIX 3 processes, it is responsible for starting
|
|
login processes on each terminal, but first it runs
|
|
.BR /etc/rc .
|
|
.PP
|
|
.B /etc/rc
|
|
checks the state of the system and starts daemons. First it sets the
|
|
keyboard translation to the mapping in
|
|
.B /etc/keymap
|
|
if present, followed by a call to
|
|
.BR readclock (8)
|
|
to set MINIX 3 time from the hardware clock. Next the file systems are checked
|
|
if necessary and the
|
|
.B /usr
|
|
file system is mounted.
|
|
.PP
|
|
The system is now ready for multiuser startup,
|
|
.B /etc/rc
|
|
calls
|
|
.B /usr/etc/rc
|
|
that cleans out /tmp, /usr/tmp, and resets or cycles log files by running
|
|
.BR /usr/etc/daily ,
|
|
starts the
|
|
.BR update (8)
|
|
and
|
|
.BR cron (8)
|
|
daemons, and initializes the network services.
|
|
.B /etc/rc
|
|
finally runs
|
|
.BR /usr/local/etc
|
|
to initialize the system in a site or host dependent way.
|
|
.PP
|
|
.B Init
|
|
reads
|
|
.B /etc/ttytab
|
|
and starts a
|
|
.BR getty (8)
|
|
for each enabled terminal line to allow a user to log in.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B bootopts=\-s
|
|
The value of the boot variable
|
|
.B bootopts
|
|
is passed to
|
|
.BR /etc/rc .
|
|
If it contains
|
|
.B \-s
|
|
then the system will run a single user shell before continuing with multiuser
|
|
startup. (Note that one normally uses
|
|
.B boot \-s
|
|
instead of setting
|
|
.BR bootopts .)
|
|
.TP
|
|
.B bootopts=\-a
|
|
This flag tells that
|
|
.B /etc/fstab
|
|
must be ignored. The system asks for a device to use as /usr instead. This
|
|
will also be done if the root device is not as mentioned in
|
|
.BR /etc/fstab .
|
|
.TP
|
|
.B bootopts=\-f
|
|
Force a file system check, even if the system was shut down properly. (Do
|
|
this once in a while to be sure about the state of the file systems.)
|
|
.TP
|
|
.BI servers= program\fR[,\fIprogram\fR...]
|
|
Names the special servers that must be started in /usr/etc/rc. The setting
|
|
.BR "servers=inet"
|
|
will start the TCP/IP server.
|
|
.SH "BOOT ENVIRONMENT"
|
|
Many features of the drivers inside the kernel are controlled by settings in
|
|
the boot environmenti, like
|
|
.B bootopts
|
|
above does for
|
|
.BR /etc/rc .
|
|
The values of these variables are usually colon or comma separated
|
|
numbers configuring the driver.
|
|
.B "DPETH0 = 300:10"
|
|
tells the DP ethernet driver to use I/O address 0x300, interrupt request
|
|
10, and the default memory address (0xD0000, values may be omitted) for the
|
|
first ethernet board. (Note that IRQ 2 is redirected to IRQ 9 on AT's and
|
|
PS/2's, so use 9 if a device is jumpered for 2.)
|
|
.PP
|
|
Variables that are special to both the monitor and the kernel are described
|
|
in
|
|
.BR monitor (8).
|
|
This section lists extra variables or variable settings:
|
|
.TP
|
|
\fBc\fIn\fR = \fBat\fR | \fBbios\fR | \fBesdi\fR | \fBxt\fR | \fBaha1540\fR | \fBdosfile\fR | \fBfatfile\fR
|
|
Choose the driver that is to be used as controller
|
|
.IR n ,
|
|
in order: IBM/AT (classic AT or newer IDE), BIOS (any disk), ESDI
|
|
(some PS/2s), IBM/XT, Adaptec 154x, MINIX 3 under DOS "file as disk",
|
|
FAT file system "file as disk".
|
|
By default
|
|
.B at
|
|
is used on AT bus systems,
|
|
.B bios
|
|
on PS/2s and XTs, and
|
|
.B dosfile
|
|
when running under DOS.
|
|
Most drivers are present in the kernel as distributed, but may be taken out
|
|
by modifying
|
|
.BR /usr/include/minix/config.h .
|
|
See
|
|
.BR controller (4).
|
|
(An XT should always use the BIOS driver, not the XT driver, because BIOS
|
|
calls are cheap on an XT. The XT driver can be used on AT machines with an
|
|
old XT controller.)
|
|
.TP
|
|
\fBDPETH\fIn\fR = \fBon\fR | \fBoff\fR
|
|
Turn an ethernet board on or off. The driver is by default in "sink" mode
|
|
for all boards. The sink mode allows one to use the driver without an
|
|
ethernet board installed. The driver will play /dev/null for that device,
|
|
i.e. nothing comes in, and anything send out is dropped on the floor. If
|
|
the board is turned on then the driver will use it to send out packets, if
|
|
it is turned off then the driver will fail for that board.
|
|
.PP
|
|
.if n .ta \w'DPETHn = I/O-addr:irq:mem_addr:mem_size'u+2m
|
|
.if t .ta \w'\fBDPETH\fIn\fR = \fII/O-addr\fR:\fIirq\fR:\fImem_addr\fR:\fImem_size\fR'u+2m
|
|
\fBDPETH\fIn\fR = \fII/O-addr\fR:\fIirq\fR:\fImem_addr\fR:\fImem_size\fR (WD80x3)
|
|
.br
|
|
\fBDPETH\fIn\fR = \fII/O-addr\fR:\fIirq\fR:\fB0\fR (NE2000)
|
|
.br
|
|
\fBDPETH\fIn\fR = \fII/O-addr\fR:\fIirq\fR:\fIflags\fR (3c503)
|
|
.RS
|
|
Set the I/O address (hex), IRQ (decimal), memory address (hex), memory
|
|
size (hex), or flags (hex) of the
|
|
.IR n -th
|
|
ethernet board and turn it on. By default they are configured as
|
|
280:3:D0000 and 300:5:C8000 with the memory size set to 2000, 4000, or 8000
|
|
depending on the type of board found.
|
|
For the Western Digital cards the IRQ must be what the board expects,
|
|
but the memory address is programmed into the board by the driver.
|
|
The SMC EtherEZ board, a WD8013 successor, has only 8K
|
|
memory. This confuses the driver, so you need to explicitly specify the
|
|
board size as being 2000.
|
|
The memory address and size have no meaning for the Novell ethernet boards,
|
|
but the address may be explicitly set to zero to indicate that the board
|
|
.B is
|
|
a Novell ethernet board.
|
|
For the 3Com 3c503 the third parameter are flags, with the low bit indicates
|
|
that the on-board tranceiver must be used if 0 (thin ethernet), or that an
|
|
external tranceiver is used on the AUI port if set to 1.
|
|
The IRQ is software settable, and must be specified as 2 (XT), 3, 4, 5,
|
|
or 9 (AT). The memory address is set on the board by jumpers. The driver
|
|
does not support I/O mode for the 3c503.
|
|
(Note the little differences between board types. For the 8003/8013 and
|
|
NE1000/NE2000 the IRQ is fixed and the memory address variable, for the
|
|
3c503 the IRQ is variable and the memory address is fixed, but need not be
|
|
specified. Messy.)
|
|
.RE
|
|
.TP
|
|
\fBDPETH\fIn\fB_EA\fR = \fIe0\fR:\fIe1\fR:\fIe2\fR:\fIe3\fR:\fIe4\fR:\fIe5\fR
|
|
Set the ethernet address of the
|
|
.IR n -th
|
|
ethernet board. The address is normally obtained from the ethernet board,
|
|
so only in exceptional circumstances is this setting ever needed. (Use the
|
|
address of the main server if you want a career change.)
|
|
.TP
|
|
\fBAHA0\fR = \fII/O-addr\fR:\fIbus-on\fR:\fIbus-off\fR:\fItr-speed\fR
|
|
Configure the Adaptec 154xA SCSI host adapter to use the given I/O address
|
|
(hex), Bus-on time (decimal), Bus-off time (decimal) and transfer speed
|
|
(hex). The default is 330:15:1:00. The default transfer speed is always
|
|
5.0 Mb/s (code 00) ignoring the jumper settings.
|
|
.TP
|
|
\fBaha1540-d\fIn\fR = \fIsleep-time\fR:\fItarget\fR,\fIlun\fR
|
|
Program SCSI disk
|
|
.I n
|
|
to have the given target and logical unit number. The target and lun
|
|
of a tape or other SCSI device may be changed by setting the
|
|
.BI aha1540-d n
|
|
variable that would be used had it been a disk. So tape device c0t7 can be
|
|
set to target 4, lun 1 with aha1540-d7=:4,1.
|
|
(The
|
|
.I sleep-time
|
|
parameter is present but ignored to be compatible with Minix-vmd.)
|
|
.TP
|
|
\fBdosfile-d\fIn\fR = \fIfile\fR
|
|
Tells the DOS virtual disk driver for disk
|
|
.I n
|
|
to use a given file as a disk. The file is a DOS file name that the
|
|
boot monitor must be able to open.
|
|
.TP
|
|
\fBfatfile-d\fIn\fR = \fIdriver:minor:file\fR
|
|
Tells the FAT virtual disk driver for disk
|
|
.I n
|
|
to use a given file as a disk. The
|
|
.I driver
|
|
parameter is the name of driver that handles the disk, and
|
|
.I minor
|
|
is the device number of the partition where the file is found. See
|
|
.BR controller (4)
|
|
for names and numbers.
|
|
The
|
|
.I file
|
|
argument is the path to the file from the root directory down. The driver
|
|
named must also be tied to a controller with a
|
|
.BI c n
|
|
variable, so that the FAT file driver can find it.
|
|
A handy way to find the proper minor number is to run
|
|
.B "ls\ \-l"
|
|
on the device where the file is found. As a example, we assume the most
|
|
common situation of a disk file on the first partition of the first drive
|
|
on an ATA (IDE) controller:
|
|
.SP
|
|
.in +5
|
|
.ft B
|
|
.nf
|
|
c0 = fatfile
|
|
c1 = at
|
|
fatfile-d0 = at:1:/minix/minix.mnx
|
|
.fi
|
|
.ft P
|
|
.in -5
|
|
.TP
|
|
.BR TZ " = " GMT0
|
|
This sets the time zone the hardware clock is running in.
|
|
.B Readclock
|
|
uses this to correctly obtain the time of the clock. The timezone of the
|
|
system is set in
|
|
.BR /etc/profile .
|
|
This boot variable is normally not set, only a few UNIX die-hards who
|
|
don't care about the time Windows sees and don't want to change the clock
|
|
twice a year for daylight savings use this option. (Set Windows time to the
|
|
time zone of Casablanca to match.)
|
|
.SH "TCP/IP CONFIGURATION"
|
|
To use TCP/IP you need to run the
|
|
.B inet
|
|
server, and unless you are running standalone you have to enable the
|
|
ethernet driver. See the
|
|
.B servers
|
|
and
|
|
.BI DPETH n
|
|
boot variables above. The driver supports these ethernet cards: Western
|
|
Digital 8003, Western Digital 8013, SMC Elite Ultra 16,
|
|
Novell NE1000 and NE2000, 3Com Etherlink II (3c503). Many newer
|
|
variants of the WD8013, now under the SMC brand, may also work.
|
|
A common PCI reimplementation of the NE2000 using the Realtek 80 chipset is
|
|
also supported. Make sure it's just a 10 mbit device and that it has a
|
|
chip marked "RTL 8029".
|
|
.PP
|
|
You are likely to use TCP/IP in one of three situations:
|
|
.PP
|
|
.RS
|
|
Standalone with no connection to a network.
|
|
.SP
|
|
In a small network with no support from a "big" host.
|
|
.SP
|
|
Connected to a large network with address and name servers.
|
|
.RE
|
|
.PP
|
|
In each situation you need a different set of configuration files.
|
|
.SS Standalone
|
|
All you need is a name and an IP address. Suppose the name is "flotsam"
|
|
and the IP address is 192.168.0.1 from the private IP space, then this is
|
|
put in
|
|
.BR /etc/hosts :
|
|
.PP
|
|
.RS
|
|
.ta +\w'192.168.0.1'u+3n
|
|
192.168.0.1 flotsam
|
|
.RE
|
|
.PP
|
|
And this in
|
|
.BR /etc/dhcp.conf :
|
|
.PP
|
|
.RS
|
|
.nf
|
|
host 192.168.0.0/24 {};
|
|
interface ip0 flotsam;
|
|
.fi
|
|
.RE
|
|
.SS "Small Network"
|
|
A network requires an ethernet driver. You need to enable one in
|
|
<minix/config.h> and you need to tell
|
|
.B inet
|
|
that it should use that driver by making
|
|
.B /etc/inet.conf
|
|
look like this:
|
|
.PP
|
|
.RS
|
|
.nf
|
|
eth0 DP8390 0 { default; };
|
|
.fi
|
|
.RE
|
|
.PP
|
|
The second word (DP8390) must the name of the ethernet driver you've enabled.
|
|
It can also be seen among the drivers in the output of
|
|
.BR "ps ax" .
|
|
See also
|
|
.BR inet (8).
|
|
.PP
|
|
In a small network there may not be a DHCP server for MINIX 3 to obtain its IP
|
|
address and name from, so you need specify the ethernet address of your machine
|
|
and host names of all machines in the hosts and DHCP configuration files.
|
|
Suppose your machine is to be named "flotsam", and another machine in the
|
|
network is named "jetsam", and let's use network 192.168.0.0/24 again. The
|
|
file
|
|
.B /etc/hosts
|
|
now looks like this:
|
|
.PP
|
|
.RS
|
|
.ta +\w'192.168.0.1'u+3n
|
|
.nf
|
|
192.168.0.1 flotsam
|
|
192.168.0.2 jetsam
|
|
.fi
|
|
.RE
|
|
.PP
|
|
And
|
|
.B /etc/dhcp.conf
|
|
like this:
|
|
.PP
|
|
.RS
|
|
.nf
|
|
host 192.168.0.0/24 {};
|
|
client 0:1:1b:a:68:ce flotsam;
|
|
.fi
|
|
.RE
|
|
.PP
|
|
Use
|
|
.B hostaddr \-e
|
|
to find out what the ethernet address of your network card is. (The address
|
|
above is an example.)
|
|
.PP
|
|
A host needs to have all hostnames used on your little network in its
|
|
host file. In the DHCP configuration you only need the client entry of the
|
|
system itself, but it may be useful to add all client entries to make them all
|
|
the same.
|
|
.PP
|
|
If one of the machines is always on when any of the others is, then you can let
|
|
it be a DHCP server. The other machines don't need a hosts or DHCP file
|
|
anymore. If flotsam is the server then its
|
|
.BR /etc/dhcp.conf
|
|
looks like this:
|
|
.PP
|
|
.RS
|
|
.nf
|
|
.ta +4m
|
|
host 192.168.0.0/24 {
|
|
DNSserver flotsam;
|
|
};
|
|
client 0:1:1b:a:68:ce flotsam { option server; };
|
|
client 0:0:c0:3a:12:10 jetsam;
|
|
.fi
|
|
.RE
|
|
.SS "Large Network"
|
|
In a network with a central network administration your machine's IP address
|
|
and name are given by the DHCP server. You don't need any configuration
|
|
files. If you want your machine to do more, like being a router or
|
|
something, then see
|
|
.BR inet (8)
|
|
on setting up more than one network interface.
|
|
.PP
|
|
.SS "Simpler configuration tools"
|
|
The
|
|
.BR dhcpd
|
|
and
|
|
.BR nonamed
|
|
daemons are complex little programs that try to obtain information about
|
|
their surroundings automatically to tell the machine what its place in the
|
|
network is. It should come as no surprise that there are simpler utilities
|
|
to configure a machine. On a memory starved machine it may even be wise to
|
|
configure a machine statically to get rid of the daemons. The first daemon,
|
|
.BR dhcpd ,
|
|
can be replaced by:
|
|
.PP
|
|
.RS
|
|
.B ifconfig \-h
|
|
.I host-IP-address
|
|
.B \-n
|
|
.I netmask
|
|
.br
|
|
.B add_route \-g
|
|
.I gateway-IP-address
|
|
.RE
|
|
.PP
|
|
to set the IP address and netmask of the machine. Note that you can only
|
|
do this if the machine has a static IP address, or chaos will follow. Remove
|
|
.BR /usr/adm/dhcp.cache
|
|
if the DHCP daemon has run before.
|
|
.PP
|
|
The name daemon,
|
|
.BR nonamed ,
|
|
can be replaced by an entry in
|
|
.B /etc/resolv.conf
|
|
that specifies an external name daemon:
|
|
.PP
|
|
.RS
|
|
.B nameserver
|
|
.I nameserver-IP-address
|
|
.RE
|
|
.PP
|
|
The
|
|
.B ifconfig
|
|
and
|
|
.B add_route
|
|
calls can be placed in the file
|
|
.BR /etc/rc.net .
|
|
Check
|
|
.B /usr/etc/rc
|
|
to see how
|
|
.BR /etc/rc.net
|
|
can be used to override running the normal series of network deamons.
|
|
Note that
|
|
.BR /etc/rc.net
|
|
is sourced, so you can use the same variables and functions that
|
|
.BR /usr/etc/rc
|
|
uses.
|
|
These changes undo all the efforts to make MINIX 3 TCP/IP
|
|
autoconfigurable. Make very sure that all the IP addresses are correct, and
|
|
that the IP address of your machine is unique. (Mistakenly using the
|
|
address of a main server will make all other machines look at your machine,
|
|
and will make all the users of all other machines look at you.)
|
|
.SH FILES
|
|
.TP 20n
|
|
/boot
|
|
MINIX 3 Boot Monitor.
|
|
.TP
|
|
/minix
|
|
Kernel image, or directory containing them.
|
|
.TP
|
|
/etc/rc
|
|
Basic system initialization.
|
|
.TP
|
|
/usr/etc/rc
|
|
Complete system initialization.
|
|
.TP
|
|
/etc/rc.net
|
|
Specialized network initialization.
|
|
.TP
|
|
/usr/local/etc/rc
|
|
Per site initialization.
|
|
.TP
|
|
/etc/hosts
|
|
Name to IP address mapping.
|
|
.TP
|
|
/etc/dhcp.conf
|
|
Network initialization.
|
|
.TP
|
|
/etc/resolv.conf
|
|
Name resolver configuration.
|
|
.SH "SEE ALSO"
|
|
.BR monitor (8),
|
|
.BR init (8),
|
|
.BR inet (8),
|
|
.BR loadkeys (8),
|
|
.BR readclock (8),
|
|
.BR fsck (1),
|
|
.BR fstab (5),
|
|
.BR update (8),
|
|
.BR cron (8),
|
|
.BR ttytab (5),
|
|
.BR getty (8),
|
|
.BR hostaddr (1),
|
|
.BR ifconfig (8),
|
|
.BR dhcpd (8),
|
|
.BR nonamed (8),
|
|
.BR tcpd (8),
|
|
.BR hosts (5),
|
|
.BR ethers (5),
|
|
.BR resolv.conf (5),
|
|
.BR inet (8).
|
|
.SH DIAGNOSTICS
|
|
.TP 5n
|
|
Checking File Systems.
|
|
If the system has crashed then
|
|
.B fsck
|
|
is called for the root and /usr file systems. It is wise to reboot if the
|
|
root file system must be fixed.
|
|
.TP
|
|
Finish the name of device to mount as /usr: /dev/
|
|
The prompt for the
|
|
.B \-a
|
|
option, or if the name of the /usr file system has not been set in /etc/fstab.
|
|
You can type a device name, say
|
|
.BR fd0 .
|
|
.TP
|
|
Unable to obtain an IP address after 10 seconds.
|
|
TCP/IP misconfiguration. The DHCP daemon may have failed because the ethernet
|
|
address of the machine is not known to the DHCP server, the DHCP
|
|
configuration is not filled in properly, or the DHCP server can not be reached.
|
|
Either talk to your Network Administrator, or make a dhcp.conf
|
|
and a hosts file.
|
|
.TP
|
|
1.2.3.4 login:
|
|
If you see an IP address instead of a host name then the system failed to
|
|
translate the IP address. Either talk to your Network Administrator to
|
|
have the reverse address translation tables fixed, or make a hosts file.
|
|
.SH NOTES
|
|
The 10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16 networks can be used for
|
|
private networks. (This so-called CIDR notation names an IP address and
|
|
the number of bits in the network number. So 172.16.0.0/12 includes all
|
|
addresses from 172.16.0.0 to 172.31.255.255.)
|
|
RFC-1597 will tell you why private networks are good, and RFC-1627 why
|
|
they are bad.
|
|
.SH BUGS
|
|
Indefinite hangs are possible if I/O addresses or IRQ's are wrong. A driver
|
|
may babble about addresses and IRQ's, but that does not mean that what it
|
|
says is true, it may just be configured that way. It is very difficult to
|
|
find peripherals on a PC automatically, and MINIX 3 doesn't even try.
|
|
.SH AUTHOR
|
|
Kees J. Bot <kjb@cs.vu.nl>
|