Fix a few things that were out of date or just plain wrong, and clean up some

formatting glitches.

lib/libc/sys/intro.2

@@ -1,4 +1,4 @@
-.\"	$NetBSD: intro.2,v 1.18 1999/03/24 13:40:51 hubertf Exp $
+.\"	$NetBSD: intro.2,v 1.19 1999/03/24 16:36:10 mycroft Exp $
 .\"
 .\" Copyright (c) 1980, 1983, 1986, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -55,7 +55,7 @@ variable
 .Va errno ,
 which is defined as:
 .Pp
-.Dl extern int errno
+.Dl extern int errno;
 .Pp
 When a system call detects an error,
 it returns an integer value
@@ -110,11 +110,13 @@ a tape drive is not online or no disk pack is
 loaded on a drive.
 .It Er 7 E2BIG Em "Arg list too long" .
 The number of bytes used for the argument and environment
-list of the new process exceeded the current limit
-of 20480 bytes
-.Pf ( Dv NCARGS
+list of the new process exceeded the current limit of
+.if t 2\u\s-218\s+2\d
+.if n 2**18
+bytes
+.Pf ( Dv ARG_MAX
 in
-.Aq Pa sys/param.h ) .
+.Aq Pa sys/syslimits.h ) .
 .It Er 8 ENOEXEC Em "Exec format error" .
 A request was made to execute a file
 that, although it has the appropriate permissions,
@@ -130,7 +132,6 @@ or a
 .Xr write 2 )
 request was made to a file that was
 only open for writing (or reading).
-.sp
 .It Er 10 ECHILD Em "\&No child processes" .
 A
 .Xr wait 2
@@ -191,8 +192,10 @@ until at least one has been closed.
 <As released, the limit on the number of
 open files per process is 64.>
 The
-.Xr getdtablesize 3
-call will obtain the current limit.
+.Xr getrlimit 3
+call with the
+.Ar RLIMIT_NOFILE
+resource will obtain the current limit.
 .It Er 25 ENOTTY Em "Inappropriate ioctl for device" .
 A control function (see
 .Xr ioctl 2 )
@@ -205,10 +208,11 @@ while the pure procedure file was being executed an
 .Xr open 2
 call requested write access.
 .It Er 27 EFBIG Em "File too large" .
-The size of a file exceeded the maximum (about
-.if t 2\u\s-231\s+2\d
-.if n 2.1E9
-bytes).
+The size of a file exceeded the maximum.  (The system-wide maximum file size is
+.if t 2\u\s-263\s+2\d
+.if n 2**63
+bytes.  Each file system may impose a lower limit for files contained within
+it.)
 .It Er 28 ENOSPC Em "Device out of space" .
 A
 .Xr write 2
@@ -228,8 +232,9 @@ An attempt was made to modify a file or directory
 was made
 on a file system that was read-only at the time.
 .It Er 31 EMLINK Em "Too many links" .
-Maximum allowable hard links to a single file has been exceeded (limit
-of 32767 hard links per file).
+The number of hard links to a single file has exceeded the maximum.  (The
+system-wide maximum number of hard links is 32767.  Each file system may
+impose a lower limit for files contained within it.)
 .It Er 32 EPIPE Em "Broken pipe" .
 A write on a pipe, socket or
 .Tn FIFO
@@ -299,7 +304,6 @@ addresses with
 Internet protocols.
 .It Er 48 EADDRINUSE Em "Address already in use" .
 Only one usage of each address is normally permitted.
-.sp
 .It Er 49 EADDRNOTAVAIL Em "Cannot assign requested address" .
 Normally results from an attempt to create a socket with an
 address not on this machine.
@@ -380,7 +384,6 @@ entry failed because the user's quota of disk blocks was
 exhausted, or the allocation of an inode for a newly
 created file failed because the user's quota of inodes
 was exhausted.
-.ne 1i
 .It Er 70 ESTALE Em "Stale NFS file handle" .
 An attempt was made to access an open file (on an
 .Tn NFS
@@ -472,18 +475,18 @@ A session leader with a controlling terminal is a controlling process.
 .It Controlling terminal
 A terminal that is associated with a session is known as the controlling
 terminal for that session and its members.
-.ne 1i
 .It  "Terminal Process Group ID"
 A terminal may be acquired by a session leader as its controlling terminal.
 Once a terminal is associated with a session, any of the process groups
 within the session may be placed into the foreground by setting
 the terminal process group ID to the ID of the process group.
 This facility is used
-to arbitrate between multiple jobs contending for the same terminal;
-(see
+to arbitrate between multiple jobs contending for the same terminal.
+(See
 .Xr csh 1
 and
-.Xr tty 4 ) .
+.Xr tty 4
+for more information on job control.)
 .It  "Orphaned Process Group"
 A process group is considered to be
 .Em orphaned
@@ -550,14 +553,14 @@ for the super-user.)
 A process is recognized as a
 .Em super-user
 process and is granted special privileges if its effective user ID is 0.
-.ne 1i
 .It  Special Processes
-The processes with process IDs of 0, 1, and 2 are special.
+The processes with process IDs of 0, 1, 2 and 3 are special.
 Process 0 is the scheduler.  Process 1 is the initialization process
 .Xr init 8 ,
 and is the ancestor of every other process in the system.
 It is used to control the process structure.
-Process 2 is the paging daemon.
+Process 2 is the paging daemon.  Process 3 is the reaper, which handles
+deallocating resources for exiting processes.
 .It  Descriptor
 An integer assigned by the system when a file is referenced
 by
@@ -678,7 +681,6 @@ but the permissions for ``other users'' allow access.
 .Pp
 Otherwise, permission is denied.
 .It  Sockets and Address Families
-.Pp
 A socket is an endpoint for communication between processes.
 Each socket has queues for sending and receiving data.
 .Pp