[src/trunk]: src/share/man/man8 * Sync in a few changes from OpenBSD's latest...

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

details:   https://anonhg.NetBSD.org/src/rev/989434ecb54d
branches:  trunk
changeset: 580702:989434ecb54d
user:      hubertf <hubertf%NetBSD.org@localhost>
date:      Wed May 04 20:54:25 2005 +0000

description:
* Sync in a few changes from OpenBSD's latest version of this file
 * Add licence by Marshall M. Midden
 * Various minor edits and additions.

diffstat:

 share/man/man8/afterboot.8 |  313 ++++++++++++++++++++++++++++++--------------
 1 files changed, 215 insertions(+), 98 deletions(-)

diffs (truncated from 564 to 300 lines):

diff -r b38875973e93 -r 989434ecb54d share/man/man8/afterboot.8
--- a/share/man/man8/afterboot.8        Wed May 04 18:26:14 2005 +0000
+++ b/share/man/man8/afterboot.8        Wed May 04 20:54:25 2005 +0000
@@ -1,6 +1,11 @@
-.\"    $NetBSD: afterboot.8,v 1.13 2004/07/22 03:44:12 atatat Exp $
+.\"    $NetBSD: afterboot.8,v 1.14 2005/05/04 20:54:25 hubertf Exp $
+.\"    $OpenBSD: afterboot.8,v 1.72 2002/02/22 02:02:33 miod Exp $
 .\"
-.\" Copyright (c) 2002-2003 The NetBSD Foundation, Inc.
+.\" Originally created by Marshall M. Midden -- 1997-10-20, m4%umn.edu@localhost
+.\" Adapted to NetBSD by Julio Merino -- 2002-05-10, jmmv%hispabsd.org@localhost
+.\"
+.\"
+.\" Copyright (c) 2002-2005 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -31,12 +36,37 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\"    $OpenBSD: afterboot.8,v 1.72 2002/02/22 02:02:33 miod Exp $
+.\"
+.\" Copyright (c) 1997 Marshall M. Midden
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
 .\"
-.\" Originally created by Marshall M. Midden -- 1997-10-20, m4%umn.edu@localhost
-.\" Adapted to NetBSD by Julio Merino -- 2002-05-10, jmmv%hispabsd.org@localhost
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by Marshall M. Midden.
+.\" 4. The name of the author may not be used to endorse or promote products
+.\"    derived from this software without specific prior written permission.
 .\"
-.Dd July 21, 2004
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd May 4, 2005
 .Dt AFTERBOOT 8
 .Os
 .Sh NAME
@@ -76,8 +106,8 @@
 .Dq Ic root .
 You can do so on the console, or over the network using
 .Xr ssh 1 .
-If you wish to allow root logins over the network (if you have
-enabled the ssh daemon), edit the
+If you have enabled the ssh daemon and wish to allow root logins over
+the network, edit the
 .Pa /etc/ssh/sshd_config
 file and set
 .Cm PermitRootLogin
@@ -88,7 +118,6 @@
 The default is to not permit root logins over the network
 after fresh install in
 .Nx .
-Note defaults on other operating systems might be different.
 .Pp
 Upon successful login on the console, you may see the message
 .Dq We recommend creating a non-root account... .
@@ -99,10 +128,8 @@
 user, add said user to the
 .Dq wheel
 group, then use the
-.Ic su
-and
-.Ic sudo
-commands when root privileges are required.
+.Xr su 1
+command when root privileges are required.
 This process is described in more detail later.
 .Ss Root password
 Change the password for the root user.
@@ -135,7 +162,7 @@
 command.
 If needed, change the date, and/or change the symbolic link of
 .Pa /etc/localtime
-to appropriate time zone in the
+to the correct time zone in the
 .Pa /usr/share/zoneinfo
 directory.
 .Pp
@@ -169,10 +196,9 @@
 .Pa /etc/rc.conf
 or edit the
 .Pa /etc/myname
-file
-to have it stick around for the next reboot.
-Note that hostname is supposed to be FQDN commonly and should
-not be confused with YP
+file to have it stick around for the next reboot.
+Note that hostname is supposed include a domainname, and that this should
+not be confused with YP (NIS)
 .Xr domainname 1 .
 .Ss Verify network interface configuration
 The first thing to do is an
@@ -180,6 +206,10 @@
 to see if the network interfaces are properly configured.
 Correct by editing
 .Pa /etc/ifconfig. Ns Ar interface
+or the corresponding
+.Dq Va ifconfig_ Ns Ar interface
+variable in
+.Xr rc.conf 5
 (where
 .Ar interface
 is the interface name, e.g.,
@@ -188,6 +218,11 @@
 .Xr ifconfig 8
 to manually configure it
 if you do not wish to reboot.
+.Pp
+You can add new
+.Dq virtual interfaces
+by adding the required entries to
+.Pa /etc/ifconfig. Ns Ar interface .
 Read the
 .Xr ifconfig.if 5
 man page for more information on the format of
@@ -208,7 +243,7 @@
        inet6 fe80::5ef0:f0f0%le0 prefixlen 64 scopeid 0x1
 .Ed
 .Pp
-and, a PPP interface something like:
+and a PPP interface something like:
 .Bd -literal -offset indent
 ppp0: flags=8051\*[Lt]UP,POINTOPOINT,RUNNING,MULTICAST\*[Gt]
         inet 203.3.131.108 --\*[Gt] 198.181.0.253 netmask 0xffff0000
@@ -250,12 +285,11 @@
 ff01::/32          ::1           U        0     0   32972  lo0
 ff02::%le0/32      link#1        UC       0     0    1500  le0
 ff02::%lo0/32      fe80::1%lo0   UC       0     0   32972  lo0
-
 .Ed
 .Pp
 The default gateway address is stored in the
 .Dq Va defaultroute
-variable
+variable in
 .Pa /etc/rc.conf ,
 or in the file
 .Pa /etc/mygate .
@@ -280,26 +314,26 @@
 .Ed
 after you flush the routes.
 .Pp
-If you wish to route packets between interfaces, add the directive
+If you wish to route packets between interfaces, add one or both
+of the following directives (depending on whether IPv4 or IPv6 routing
+is required) to
+.Pa /etc/sysctl.conf :
+.Pp
 .Dl net.inet.ip.forwarding=1
-and/or
 .Dl net.inet6.ip6.forwarding=1
 .Pp
-to
-.Pa /etc/sysctl.conf ,
-or compile a new kernel with the
+As an alternative, compile a new kernel with the
 .Cm GATEWAY
 option.
 Packets are not forwarded by default, due to RFC requirements.
-.Pp
-You can add new
-.Dq virtual interfaces
-by adding the required entries to
-.Pa /etc/ifconfig.if .
 .Ss Secure Shell (ssh)
-By default, all services are disabled (and ssh is no exception).
+By default, all services are disabled in a fresh
+.Nx
+installation, and ssh is no exception.
 You may wish to enable it so you can remotely control your system.
-Set "sshd=yes" in
+Set
+.Dq Va sshd=yes
+in
 .Pa /etc/rc.conf
 and then starting the server with the command
 .Bd -literal -offset indent
@@ -343,7 +377,19 @@
 .Xr named 8
 is running
 (otherwise there are long waits for resolver timeouts).
-.Ss YP Setup
+.Ss RPC-based network services
+Several services depend on the RPC portmapper
+.Xr rpcbind 8 
+- formerly known as
+.Xr portmap 8 -
+being running for proper operation.
+This includes YP (NIS) and NFS exports, among other services.
+To get the RPC portmapper to start automatically on boot,
+you will need to have this line in
+.Pa /etc/rc.conf :
+.Pp
+.Dl portmap=YES
+.Ss YP (NIS) Setup
 Check the YP domain name with the
 .Xr domainname 1
 command.
@@ -367,13 +413,15 @@
 and
 .Xr group 5 .
 .Pp
-In particular, to enable YP passwd support, you'd need to update
+In particular, to enable YP passwd support, you'll need to update
 .Pa /etc/nsswitch.conf
 to include
 .Dq nis
 for the
 .Dq passwd
-entry.
+and
+.Dq group
+entries.
 A traditional way to accomplish the same thing is to
 add following entry to local passwd database via
 .Xr vipw 8 :
@@ -389,6 +437,7 @@
 which is
 .Dq compat .
 .Pp
+There are many more YP man pages available to help you.
 You can find more information by starting with
 .Xr yp 8 .
 .Ss Check disk mounts
@@ -403,18 +452,20 @@
 Example:
 .Bd -literal -offset indent
 .Li # Ic cat /etc/fstab
-/dev/sd0a / ffs rw 1 1
-/dev/sd0b none swap sw 0 0
-/dev/sd0e /usr ffs rw 1 2
-/dev/sd0f /var ffs rw 1 3
-/dev/sd0g /tmp ffs rw 1 4
-/dev/sd0h /home ffs rw 1 5
+/dev/sd0a / ffs     rw              1 1
+/dev/sd0b none swap sw 
+/dev/sd0e /usr ffs  rw,nodev        1 2
+/dev/sd0f /var ffs  rw,nodev,nosuid 1 3
+/dev/sd0g /tmp ffs  rw,nodev,nosuid 1 4
+/dev/sd0h /home ffs rw,nodev,nosuid 1 5
+
 .Li # Ic mount
 /dev/sd0a on / type ffs (local)
-/dev/sd0e on /usr type ffs (local)
-/dev/sd0f on /var type ffs (local)
-/dev/sd0g on /tmp type ffs (local)
-/dev/sd0h on /home type ffs (local)
+/dev/sd0e on /usr type ffs (local, nodev)
+/dev/sd0f on /var type ffs (local, nodev, nosuid)
+/dev/sd0g on /tmp type ffs (local, nodev, nosuid)
+/dev/sd0h on /home type ffs (local, nodev, nosuid)
+
 .Li # Ic df
 Filesystem  1024-blocks     Used    Avail Capacity  Mounted on
 /dev/sd0a         22311    14589     6606    69%    /
@@ -422,6 +473,7 @@
 /dev/sd0f         10447      682     9242     7%    /var
 /dev/sd0g         18823        2    17879     0%    /tmp
 /dev/sd0h          7519     5255     1888    74%    /home
+
 .Li # Ic pstat -s
 Device      512-blocks     Used    Avail Capacity  Priority
 /dev/sd0b       131072    84656    46416    65%    0
@@ -458,9 +510,38 @@
 and edit
 .Pa /etc/fstab
 as needed.
-.Ss CHANGING /etc FILES
-The system should be usable now, but you may wish to do more
-customization, such as adding users, etc.
+.Ss Automounter daemon (AMD)
+To use the
+.Xr amd 8
+automounter, create the
+.Pa /etc/amd
+directory, copy example config files from
+.Pa /usr/share/examples/amd
+to