summaryrefslogtreecommitdiff
path: root/sbin/init/init.8
diff options
context:
space:
mode:
authorAaron Campbell <aaron@cvs.openbsd.org>1998-11-28 19:56:38 +0000
committerAaron Campbell <aaron@cvs.openbsd.org>1998-11-28 19:56:38 +0000
commitcd366aedac3a1a3126d77df58d0a0861c63e8147 (patch)
tree4ddb2966604fee83a4b374b411294c1952e0a4ad /sbin/init/init.8
parentb77e710b77930242c29b776114492ab08aa2f1c9 (diff)
kill redundant .Nm macro arguments; other misc fixes
Diffstat (limited to 'sbin/init/init.8')
-rw-r--r--sbin/init/init.850
1 files changed, 25 insertions, 25 deletions
diff --git a/sbin/init/init.8 b/sbin/init/init.8
index deac786a93c..e71b8e2845f 100644
--- a/sbin/init/init.8
+++ b/sbin/init/init.8
@@ -1,4 +1,4 @@
-.\" $OpenBSD: init.8,v 1.12 1998/11/11 22:19:57 aaron Exp $
+.\" $OpenBSD: init.8,v 1.13 1998/11/28 19:56:21 aaron Exp $
.\" $NetBSD: init.8,v 1.6 1995/03/18 14:56:31 cgd Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
@@ -44,21 +44,21 @@
.Nm init
.Nd process control initialization
.Sh SYNOPSIS
-.Nm init
+.Nm
.Sh DESCRIPTION
The
-.Nm init
+.Nm
program
is the last stage of the boot process.
It normally runs the automatic reboot sequence as described in
.Xr reboot 8 ,
and if this succeeds, begins multi-user operation.
If the reboot scripts fail,
-.Nm init
+.Nm
commences single-user operation by giving
the super-user a shell on the console.
The
-.Nm init
+.Nm
program may be passed parameters
from the boot program to
prevent the system from going multi-user and to instead execute
@@ -68,29 +68,29 @@ later be made to go to multi-user by exiting the
single-user shell (with ^D).
This
causes
-.Nm init
+.Nm
to run the
.Pa /etc/rc
startup command file in fastboot mode (skipping disk checks).
.Pp
If the
-.Nm console
+.Ar console
entry in the
.Xr ttys 5
file is marked
.Dq insecure ,
then
-.Nm init
+.Nm
will require that the super-user password be
entered before the system will start a single-user shell.
The password check is skipped if the
-.Nm console
+.Ar console
is marked as
.Dq secure .
.Pp
The kernel runs with four different levels of security.
Any super-user process can raise the security level, but only
-.Nm init
+.Nm
can lower it.
Security levels are defined as follows:
.Bl -tag -width flag
@@ -133,11 +133,11 @@ the administrator must build a kernel with
in the config file.
.Pp
In multi-user operation,
-.Nm init
+.Nm
maintains
processes for the terminal ports found in the file
.Xr ttys 5 .
-.Nm init
+.Nm
reads this file, and executes the command found in the second field.
This command is usually
.Xr getty 8 ;
@@ -154,7 +154,7 @@ executes a shell for that user. When this shell
dies, either because the user logged out
or an abnormal termination occurred (a signal),
the
-.Nm init
+.Nm
program wakes up, deletes the user
from the
.Xr utmp 5
@@ -163,7 +163,7 @@ file of current users and records the logout in the
file.
The cycle is
then restarted by
-.Nm init
+.Nm
executing a new
.Xr getty
for the line.
@@ -175,17 +175,17 @@ may be changed in the
file without a reboot by sending the signal
.Dv SIGHUP
to
-.Nm init
+.Nm
with the command
.Dq Li "kill \-s HUP 1" .
On receipt of this signal,
-.Nm init
+.Nm
re-reads the
.Xr ttys
file.
When a line is turned off in
.Xr ttys ,
-.Nm init
+.Nm
will send a
.Dv SIGHUP
signal to the controlling process
@@ -193,18 +193,18 @@ for the session associated with the line.
For any lines that were previously turned off in the
.Xr ttys
file and are now on,
-.Nm init
+.Nm
executes a new
.Xr getty
to enable a new login.
If the getty or window field for a line is changed,
the change takes effect at the end of the current
login session (e.g., the next time
-.Nm init
+.Nm
starts a process on the line).
If a line is commented out or deleted from
.Xr ttys ,
-.Nm init
+.Nm
will not do anything at all to that line.
However, it will complain that the relationship between lines
in the
@@ -214,7 +214,7 @@ file and records in the
file is out of sync,
so this practice is not recommended.
.Pp
-.Nm init
+.Nm
will terminate multi-user operations and resume single-user mode
if sent a terminate
.Pq Dv TERM
@@ -222,11 +222,11 @@ signal, for example,
.Dq Li "kill \-s TERM 1" .
If there are processes outstanding that are deadlocked (because of
hardware or software failure),
-.Nm init
+.Nm
will not wait for them all to die (which might take forever), but
will time out after 30 seconds and print a warning message.
.Pp
-.Nm init
+.Nm
will cease creating new
.Xr getty Ns 's
and allow the system to slowly die away, if it is sent a terminal stop
@@ -241,11 +241,11 @@ and
.Xr halt 8 .
.Pp
The role of
-.Nm init
+.Nm
is so critical that if it dies, the system will reboot itself
automatically.
If, at bootstrap time, the
-.Nm init
+.Nm
process cannot be located, the system will panic with the message
.Dq panic: "init died (signal %d, exit %d) .
.Sh DIAGNOSTICS