8000 minix/minix/man/man8/usage.8 at master · kishoredbn/minix · GitHub
[go: up one dir, main page]

Skip to content

Latest commit

 

History

History
941 lines (941 loc) · 32.2 KB

usage.8

File metadata and controls

941 lines (941 loc) · 32.2 KB
.PP
The numbers 010 indicate the device (disk or partition) that must be booted,
i.e.
.B /dev/c0d0p1s0
in this example. Take the name of the device, and use the disk, partition
and subpartition numbers, or less. So c0d1p2s0 -> 120, c0d3 -> 3,
c0d2p0 -> 20.)
.SS "11. DEVICES"
A crash course on the MINIX devices in
.BR /dev :
The first two hard disks are named
.BR c0d0
and
.BR c0d1 .
These devices address the entire hard disk, from the
first to the last byte. Each disk has four partitions, for disk 0 they are
.BR c0d0p0 ,
.BR c0d0p1 ,
.BR c0d0p2 ,
and
.BR c0d0p3 .
And for disk 1 they are named
.BR c0d1p0
to
.BR c0d1p3 .
These partitions may contain file systems,
.B c0d0p0
often contains the
.3A MS-DOS
or Windows "C:" file system. MINIX can use these partitions
for file systems too, but you can also partition one of these "primary
partitions" into four so-called "subpartitions". The subpartitions of
.B c0d0p0
are named
.BR c0d0p0s0 ,
.BR c0d0p0s1 ,
.BR c0d0p0s2 ,
and
.BR c0d0p0s3 .
The other partitions may have four subpartitions that are named in the same
way. See
.BR controller (4)
for an elaborate description.
.PP
You may need to add devices to
.BR /dev ,
because not all devices are present to keep down the clutter.
The command
.3B MAKEDEV
knows how to make devices, and
.3B DESCRIBE
can tell you what an unknown device may be, or even what all devices in
.B /dev
may be if called without arguments. Devices are described in
.BR dev (4),
with pointers to more specific pages.
.SS "12. EDITORS"
The editors available are
.B elvis
(a
.B vi
clone)
and the old MINIX
.B mined
editor. Of these editors only elvis can recover your file after a system
crash. Only
.B mined
is available at installation time. (All you need to know about mined right
now is that CTRL-X gets you out of it.)
.SS "13. BOOT MONITOR VS. MINIX"
The Boot Monitor uses the
.3A BIOS
to address disks, so it has no idea of controllers, it just lumps everything
together and ignores controller numbers. So what the monitor thinks are
.BR d0 ,
.BR d1 ,
and
.BR d2 ,
may be
.BR c0d0
(IDE primary master),
.BR c0d2
(IDE secondary master), and
.BR c1d3
(SCSI disk at target 3).
One must keep this in mind when MINIX is installed on a disk other than the
very first. So if MINIX is installed in the third partition of the SCSI disk,
then
.B "boot d2p2"
will boot it, and
.B "rootdev=c1d3p2s0"
will tell MINIX where its root file system is.
.SS "14. NATIONAL KEYBOARDS"
The directory
.B /usr/lib/keymaps
contains keymap tables for several national keyboards. If you have a German
keyboard for instance, then
.PP
.XB "loadkeys\0/usr/lib/keymaps/german.map"
.PP
will load the German key translation table into the keyboard driver. Copy
the map to
.B /etc/keymap
once MINIX is installed on the hard disk, because having to type a key
sequence like one of these:
.PP
.XB "loadkezs\0\-usr\-lib\-kezmaps\-german.map"
.XB "loqdkeys\0=usr=lib=key,qps=french.,qp"
.PP
on a reboot gets a bit annoying after a while. Send corrections and new
keymaps to the person named below. (Do not send a Dutch keymap, buy
yourself a real keyboard instead.)
.SH SUGGESTIONS
Below are a few useful suggestions. Some of the information can be of use
in other situations than described here.
.SS "15. VIRTUAL CONSOLES"
Hold down the ALT key and press the left or right arrow key, F1, or F2.
This switches the console between two login sessions. (Unless you have
an old mono adapter, because virtual consoles sit in video memory, and
a mono adapter only has memory for one.)
.PP
Note that kernel messages, including function key output, only appear on
the first console. This may be confusing, but it keeps the other consoles
clean.
.SS "16. LOW ON MEMORY"
The normal installation requires that you have enough memory for a large RAM
disk. You can still install MINIX normally if you either have a high density
diskette drive for a combined root+usr floppy, or you have two floppy drives
of at least 720 kb. Before booting you have to set the variable
.B rootdev
to the same value as
.BR ramimagedev .
This is slower then a RAM disk, but saves a lot of memory.
.PP
The automatic installation script knows how to handle this new situation.
If you install manually then you have to use
.PP
.XB "pax -rw -pe\0\-vx\0/\0/mnt"
.PP
to copy the root device to disk. When it is time to fill /usr and you only
have one floppy drive then hit DEL to get out of the installation script and
reboot as described in "TESTING". You can then finish the installation
manually.
.ig
See the XT640K.TXT file for more advice on small machines.
..
.SS "17. LOW ON MEMORY AND ONLY ONE 720 KB FLOPPY DRIVE"
If you only have one 720 kb floppy drive and your system is low on memory
then you can use the \s-2TINYROOT.MNX\s+2 boot image. This image contains a
small kernel with only the BIOS disk driver, and a small root file system.
You can use this disk to boot your machine. Use the normal \s-2ROOT.MNX\s+2 to
install the root file system. Keep booting your machine with
\s-2TINYROOT\s+2 until you have compiled a small kernel for your system.
Use the
.B rootdev
boot variable to select the hard disk root file system. Do
.B not
use \s-2TINYROOT\s+2 for anything other than booting, always use
\s-2ROOT\s+2 when mentioned.
.SS "18. FLOPPY DRIVE 1 IS A HIGH DENSITY DRIVE"
If you would like to install from floppy drive 1 then you need to copy at
least one sector from the \s-2USR\s+2 image onto a diskette for drive 0.
The \s-2USR\s+2 bootstrap has been rigged to boot the other drive.
.SS "19. INSTALLING ON A SECOND HARD DISK"
MINIX doesn't care if it is installed on the second disk of a system with
two disks. The only problem is to get it booted. You can either rig up
a diskette to boot MINIX as shown earlier, or you can use the same trick
on the first disk. The command
.PP
.XB "installboot\0\-m\0/dev/c0d0\0/usr/mdec/jumpboot\01"
.PP
will lock the first disk into booting the second disk. Note that this
command modifies the disk outside a MINIX partition, overwriting a bit of
code that has likely been put there by Windows fdisk. First verify that the
Boot Monitor can boot a Windows partition, because then the MINIX master
bootstrap can do it too.
.SS "20. LOTS OF MEMORY ON A 286"
You will have a hard time making MINIX use up 3 MB memory. Memory you
can spare can be used for a "second level block cache" on the RAM disk. The
File System uses the second level cache to store copies of disk blocks that
are pushed out of the normal (primary) block cache. The size of the primary
cache is compiled into the FS server, but the size of the second level cache
can be set with the
.B ramsize
boot variable. Set it to a number between 0 and 512. 512 kilobytes is
enough to keep most of the compiler cached.
.SS "21. LOTS OF MEMORY ON A 386+"
Processes can be as big as you would like on a 386, but in practice 4 MB is
a lot, and 8 MB is infinite.
The installation script sets up a second level cache for MINIX-386
of up to 1024 kilobytes. This is because the default file system cache
is only 80 kb. Your first point of call is to get rid of the poorly
performing second level cache by setting
.B ENABLE_CACHE2
to 0 and to assign the memory used by it to the
normal block cache by enlarging the appropriate
.B NR_BUFS
and
.B NR_BUF_HASH
constants in <minix/config.h> with as much as you can spare. (1024 for
NR_BUFS is the minimum to keep
.B "cc \-c"
cached. 2048 is then a nice value for NR_BUF_HASH.)
Disable the second level cache, compile a new kernel, reboot and set
.B ramsize
to 0.
.SS "22. LOTS OF DISK SPACE"
The maximum file system size is 1 GB for MINIX-386 and 128 MB for
MINIX-86. (MINIX-86 can handle larger file systems, but
.B fsck
can't check them.) Note that a MINIX file system can only contain 65535
inodes (files), so the average file should be 16 kb to completely fill it.
It may be better to make two smaller file systems. Besides, fsck takes
forever on a large file system.
.SH SYSTEM ADMINISTRATION
The system has been set up with the idea that working as root is a bad thing
to do. As root you are in no way protected from doing stupid things. So
don't do development as root, but work as
.BR bin !
Only in exceptional cases do you want to become root. Being root is fun for
wannabe hackers; administrators know better.
.PP
To make life easier for bin, some programs like
.BR su (1),
.BR install (1)
and
.BR shutdown (8)
treat bin and other members of the operator group as special and allow them
the privileges of root. (One is an operator if one's
group id is zero.) Operators should share the shadow password of root by
having
.B ##root
in their password field. This way they all have one face (password)
to the outside world, forming no greater security risk than root alone.
.PP
The home directory of bin contains one important Makefile. You can use it
to recompile all the commands and libraries of the system. Type
.B make
to see the usage message. If you want to compile just one command then you
can simply type
.B make
to do so. To put it in its proper place you have to type
.BR "make install" .
Read the Makefiles in the
.B commands
and
.B lib
subdirectories to understand how everything is put together. If you are
tight on memory then
.B make
may fail to traverse down the source tree and also compile things. You will
have to type
.B make
in each subdirectory. You can run make in /usr/src at the end to see if
you've missed something or not.
.PP
The shell used by MINIX is a minimal version of
.BR ash ,
the BSD shell. It has been modified to offer simple line editing using the
.BR editline (3)
library.
.PP
The kernel is not compiled from the master Makefile. To make a new kernel
you have to step into the
.B tools
directory. There you can run four different make commands:
.PP
.TP
.B make
This makes all the different kernel parts and combines them in the file
named
.BR image .
.TP
.B make hdboot
First makes the image file and then copies it into the directory
.BR /minix .
If there are already two images in that directory then the newest image will
be removed to make space for this newer image. It is assumed that the
oldest image is the most stable system image, one that always works, and
that the newest image is experimental. Check beforehand what
.B /minix
contains before you run
.BR "make hdboot" .
Remove the oldest image if you want another image to become the stable
image. The Boot Monitor chooses the newest image in
.B /minix
to boot. You can use the monitor command
.B ls minix
to view the images present, and set the
.B image
variable to the full name of the image you want to use instead if the newest
doesn't work. The images in
.B /minix
are named using the MINIX release and version numbers with an extra revision
number added to distinguish the images.
.PP
The first new kernel you would like to make is one configured for your
system. The kernel you are running now contains several drivers
you don't need, or may be missing drivers that you might want.
In <minix/config.h> you can find a number of
.BI ENABLE_ XXX
variables that can be set to
.B 0
to exclude, or
.B 1
to include a particular driver. The full list of configurable parameters
and what they do are described in
.BR config (8).
It is invaluable in figuring out what to change and how in <minix/config.h>.
.PP
Configuring a new kernel is sometimes not enough to enable new devices, you
sometimes need to use the
.B MAKEDEV
command to make new device files in
.BR /dev .
For pseudo-ttys you also have to check if
.B /etc/ttytab
mentiones the new devices.
.PP
New additions to the system can be made in the
.B /usr/local
tree. An empty directory tree has been set up for you and binaries and
manual pages are already in the search paths. You can make a new user entry
with the
.B adduser
command.
.PP
The
.B TZ
variable in
.B /etc/profile
tells the time zone offset from the wall clock time to GMT. You have to
change it for your time zone. (See
.BR TZ (5).)
.PP
The function keys produce debug dumps, showing various interesting data
about the system. F1 lists processes and F5 shows ethernet stats, which
may be of use now. Read
.BR console (4)
to know all the details of the screen and keyboard.
.SS "23. SYSTEM SHUTDOWN"
You can't just turn a MINIX system off. MINIX must be told to flush the
modified data in the file system cache first. The following
commands/keystrokes can be used to exit MINIX properly:
.TP
.B shutdown
First alert all users and then all processes of the impending shutdown
then halt or reboot the system in one of various ways. See
.BR shutdown (8).
.TP
.B reboot / halt
Alert all processes of the system shutdown then reboot or halt.
.TP
.B \s-2CTRL\-ALT\-DEL\s+2
Halt the system by running
.BR "shutdown \-h now" .
.PP
MINIX halts by returning to the Boot Monitor, MINIX reboots by instructing
the monitor to reboot MINIX. (MINIX is just a subprocess to the monitor.)
Either halt MINIX and use monitor commands to escape MINIX, or use
.B shutdown \-R
to reset the system.
.PP
When exiting MINIX running under DOS the Boot Monitor's
.B exit
command will return you to the DOS prompt. The Boot Monitor and MINIX
are together just a pretty big DOS program as far DOS is concerned.
.SH FILES
.TP 12
.B /usr/ast
Honorary home directory of Andrew S. Tanenbaum. Doubles as the place where
the default setup for a new user is found.
.SH "SEE ALSO"
.BR dosminix (8),
.BR monitor (8),
.BR boot (8),
.BR part (8),
.BR mkfs (1),
.BR mount (8),
.BR M (8),
.BR fstab (5),
.BR hier (7),
.BR config (8),
.BR console (4),
.BR dev (4),
.BR adduser (8),
.BR TZ (5),
.BR shutdown (8).
.br
"Operating Systems \- Design and Implementation 2/e" by Andrew S. Tanenbaum
and Albert S. Woodhull.
.SH NOTES
The notation
.BI < file .h>
refers to a C language include file in /usr/include.
.PP
.B Root
and
.B bin
do not have the current directory in their program search path to avoid
executing programs left around by malicious people. This means that to run
.B foo
from the current directory,
.B ./foo
must be typed.
.SH BUGS
There are many PS/2 models, all different. Some will run MINIX, some won't,
some crippled if you lie to MINIX by setting
.B processor
to
.BR 86 .
Almost no PS/2 has a standard disk, so setting
.B c0
to
.B esdi
or
.B bios
will be necessary.
.PP
Except for the floppy driver, none of the DMA based drivers know about DMA
being limited to a 24 bits address, i.e. the first 16 MB. So under MINIX-386
you run a slight risk that a
.B tar
or
.B dd
command may use a buffer above 16 MB for reading or writing to a character
device. This only happens if the low 16 MB is taken by some huge processes,
and you have more than 16 MB, of course.
.SH AUTHOR
Kees J. Bot <kjb@cs.vu.nl>
0