[src/trunk]: src/lib/libc/sys Fix a few things that were out of date or just ...

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

details:   https://anonhg.NetBSD.org/src/rev/e3d56ec7487a
branches:  trunk
changeset: 467425:e3d56ec7487a
user:      mycroft <mycroft%NetBSD.org@localhost>
date:      Wed Mar 24 16:36:10 1999 +0000

description:
Fix a few things that were out of date or just plain wrong, and clean up some
formatting glitches.

diffstat:

 lib/libc/sys/intro.2 |  52 +++++++++++++++++++++++++++-------------------------
 1 files changed, 27 insertions(+), 25 deletions(-)

diffs (150 lines):

diff -r 9eab680acdf2 -r e3d56ec7487a lib/libc/sys/intro.2
--- a/lib/libc/sys/intro.2      Wed Mar 24 16:02:41 1999 +0000
+++ b/lib/libc/sys/intro.2      Wed Mar 24 16:36:10 1999 +0000
@@ -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 @@
 .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 @@
 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 @@
 .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 @@
 <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 @@
 .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 @@
 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 @@
 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 @@
 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 @@
 .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 @@
 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 @@
 .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