[src/trunk]: src/sbin/init Document that the kernel may try several paths for...

[apb <apb%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/cba452cb05cf
branches:  trunk
changeset: 790300:cba452cb05cf
user:      apb <apb%NetBSD.org@localhost>
date:      Wed Oct 02 22:01:47 2013 +0000

description:
Document that the kernel may try several paths for init.

XXX: This should be in the kernel documentation, not in the init(8) man page.

diffstat:

 sbin/init/init.8 |  20 ++++++++++++++++----
 1 files changed, 16 insertions(+), 4 deletions(-)

diffs (43 lines):

diff -r 700da1c66fa5 -r cba452cb05cf sbin/init/init.8
--- a/sbin/init/init.8  Wed Oct 02 21:48:55 2013 +0000
+++ b/sbin/init/init.8  Wed Oct 02 22:01:47 2013 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: init.8,v 1.57 2009/05/18 14:17:31 wiz Exp $
+.\"    $NetBSD: init.8,v 1.58 2013/10/02 22:01:47 apb Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -32,7 +32,7 @@
 .\"
 .\"     @(#)init.8     8.6 (Berkeley) 5/26/95
 .\"
-.Dd November 10, 2008
+.Dd October 2, 2013
 .Dt INIT 8
 .Os
 .Sh NAME
@@ -43,10 +43,22 @@
 .Sh DESCRIPTION
 The
 .Nm
-program is the last stage of the boot process (after the kernel loads
-and initializes all the devices).
+program is the last stage of the boot process.
 It normally begins multi-user operation.
 .Pp
+.Nm
+is executed automatically by the kernel,
+after the kernel has initialised all devices
+and mounted the root file system.
+The kernel may try multiple possible paths for
+.Nm ,
+including
+.Pa /sbin/init ,
+.Pa /sbin/oinit ,
+.Pa /sbin/init.bak ,
+and
+.Pa /rescue/init .
+.Pp
 The following table describes the state machine used by
 .Nm :
 .Bl -enum