Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Sort sections, sort SEE ALSO, punctuation and miscellanous fixes.

This commit is contained in:
wiz 2001-09-16 02:13:26 +00:00
parent 79ae830243
commit 53d84b5c61
75 changed files with 338 additions and 341 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
lib/libc/sys/_exit.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: _exit.2,v 1.11 1999/12/02 21:42:35 kleink Exp $
.\" $NetBSD: _exit.2,v 1.12 2001/09/16 02:13:26 wiz Exp $
.\"
.\" Copyright (c) 1980, 1993
.\" The Regents of the University of California. All rights reserved.
@ -100,7 +100,7 @@ which flushes buffers, closes streams, unlinks temporary files, etc.,
before
calling
.Fn _exit .
.Sh RETURN VALUE
.Sh RETURN VALUES
.Fn _exit
can never return.
.Sh SEE ALSO

4
lib/libc/sys/accept.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: accept.2,v 1.16 2001/09/16 01:38:59 wiz Exp $
.\" $NetBSD: accept.2,v 1.17 2001/09/16 02:13:26 wiz Exp $
.\"
.\" Copyright (c) 1983, 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -149,7 +149,7 @@ The descriptor is invalid.
The socket has not been set up to accept connections (using
.Xr bind 2
and
.Xr listen 2 ).
.Xr listen 2 ) .
.It Bq Er ENOTSOCK
The descriptor references a file, not a socket.
.It Bq Er EOPNOTSUPP

6
lib/libc/sys/access.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: access.2,v 1.14 2001/09/16 01:38:59 wiz Exp $
.\" $NetBSD: access.2,v 1.15 2001/09/16 02:13:26 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -83,7 +83,7 @@ If a process has super-user privileges and indicates success for
.Dv X_OK ,
at least one of the user, group, or other execute bits is set.
(However, the file may still not be executable. See
.Xr execve 2 .)
.Xr execve 2 . )
.Sh RETURN VALUES
If
.Fa path
@ -134,7 +134,7 @@ The
.Fn access
function conforms to
.St -p1003.1-90 .
.Sh CAVEAT
.Sh BUGS
.Fn access
is a potential security hole and
should never be used.

6
lib/libc/sys/bind.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: bind.2,v 1.16 2001/09/16 01:38:59 wiz Exp $
.\" $NetBSD: bind.2,v 1.17 2001/09/16 02:13:27 wiz Exp $
.\"
.\" Copyright (c) 1983, 1993
.\" The Regents of the University of California. All rights reserved.
@ -129,9 +129,9 @@ An empty pathname was specified.
.El
.Sh SEE ALSO
.Xr connect 2 ,
.Xr getsockname 2 ,
.Xr listen 2 ,
.Xr socket 2 ,
.Xr getsockname 2
.Xr socket 2
.Sh HISTORY
The
.Fn bind

12
lib/libc/sys/brk.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: brk.2,v 1.25 2001/09/16 01:38:59 wiz Exp $
.\" $NetBSD: brk.2,v 1.26 2001/09/16 02:13:27 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -153,6 +153,11 @@ to support the expansion.
.Xr free 3 ,
.Xr malloc 3 ,
.Xr sysconf 3
.Sh HISTORY
A
.Fn brk
function call appeared in
.At v7 .
.Sh BUGS
Note that
mixing
@ -169,8 +174,3 @@ Setting the break may fail due to a temporary lack of swap space.
It is not possible to distinguish this from a failure caused by
exceeding the maximum size of the data segment without consulting
.Xr getrlimit 2 .
.Sh HISTORY
A
.Fn brk
function call appeared in
.At v7 .

3
lib/libc/sys/chdir.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: chdir.2,v 1.14 2001/09/16 01:39:00 wiz Exp $
.\" $NetBSD: chdir.2,v 1.15 2001/09/16 02:13:27 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -138,4 +138,3 @@ The
function call
appeared in
.Bx 4.2 .

4
lib/libc/sys/clock_settime.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: clock_settime.2,v 1.6 2001/09/16 01:39:00 wiz Exp $
.\" $NetBSD: clock_settime.2,v 1.7 2001/09/16 02:13:27 wiz Exp $
.\"
.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -70,7 +70,7 @@ is truncated to a multiple of the resolution.
function stores the time of the clock identified by
.Fa clock_id
into the location specified by
.Fa tp.
.Fa tp .
.Pp
The
.Fn clock_getres

21
lib/libc/sys/clone.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: clone.2,v 1.4 2001/09/16 01:39:00 wiz Exp $
.\" $NetBSD: clone.2,v 1.5 2001/09/16 02:13:27 wiz Exp $
.\"
.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -138,18 +138,27 @@ is not intended to be used for new native
applications. It is provided as a means to port software
originally written for the Linux operating system to
.Nx .
.Sh RETURN VALUES and ERRORS
.Sh RETURN VALUES
Same as for
.Xr fork 2 .
.Sh ERRORS
Same as for
.Xr fork 2 .
.Sh SEE ALSO
.Xr chdir 2 ,
.Xr chroot 2 ,
.Xr fork 2 ,
.Xr vfork 2 ,
.Xr sigaction 2 ,
.Xr sigprocmask 2 ,
.Xr umask 2 ,
.Xr vfork 2 ,
.Xr wait 2
.Sh HISTORY
The
.Fn clone
function call appeared in
.Nx 1.6 .
It is compatible with the Linux function call of the same name.
.Sh BUGS
The
.Nx
@ -166,9 +175,3 @@ implementation of
does not implement the
.Dv CLONE_PTRACE
option that is present in the Linux implementation.
.Sh HISTORY
The
.Fn clone
function call appeared in
.Nx 1.6 .
It is compatible with the Linux function call of the same name.

8
lib/libc/sys/connect.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: connect.2,v 1.17 2000/06/17 19:33:34 hubertf Exp $
.\" $NetBSD: connect.2,v 1.18 2001/09/16 02:13:27 wiz Exp $
.\"
.\" Copyright (c) 1983, 1993
.\" The Regents of the University of California. All rights reserved.
@ -154,11 +154,11 @@ Too many symbolic links were encountered in translating the pathname.
.El
.Sh SEE ALSO
.Xr accept 2 ,
.Xr getsockname 2 ,
.Xr getsockopt 2 ,
.Xr poll 2 ,
.Xr select 2 ,
.Xr socket 2 ,
.Xr getsockname 2 ,
.Xr getsockopt 2
.Xr socket 2
.Sh HISTORY
The
.Fn connect

4
lib/libc/sys/dup.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: dup.2,v 1.11 2001/09/16 01:39:00 wiz Exp $
.\" $NetBSD: dup.2,v 1.12 2001/09/16 02:13:27 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -120,9 +120,9 @@ Too many descriptors are active.
.El
.Sh SEE ALSO
.Xr accept 2 ,
.Xr open 2 ,
.Xr close 2 ,
.Xr fcntl 2 ,
.Xr open 2 ,
.Xr pipe 2 ,
.Xr socket 2 ,
.Xr socketpair 2 ,

24
lib/libc/sys/execve.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: execve.2,v 1.20 2001/09/16 01:39:00 wiz Exp $
.\" $NetBSD: execve.2,v 1.21 2001/09/16 02:13:27 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -112,7 +112,7 @@ The argument
is also a pointer to a null-terminated array of
character pointers to null-terminated strings.
A pointer to this array is normally stored in the global variable
.Va environ.
.Va environ .
These strings pass information to the
new process that is not directly an argument to the command (see
.Xr environ 7 ) .
@ -186,7 +186,8 @@ where
.Fa argc
is the number of elements in
.Fa argv
(the ``arg count'')
(the
.Dq arg count )
and
.Fa argv
points to the array of character pointers
@ -259,14 +260,6 @@ to an illegal address.
.It Bq Er EIO
An I/O error occurred while reading from the file system.
.El
.Sh CAVEAT
If a program is
.Em setuid
to a non-super-user, but is executed when
the real
.Em uid
is ``root'', then the program has some of the powers
of a super-user as well.
.Sh SEE ALSO
.Xr _exit 2 ,
.Xr fork 2 ,
@ -282,3 +275,12 @@ The
.Fn execve
function call appeared in
.Bx 4.2 .
.Sh BUGS
If a program is
.Em setuid
to a non-super-user, but is executed when
the real
.Em uid
is
.Dq root ,
then the program has some of the powers of a super-user as well.

6
lib/libc/sys/fcntl.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: fcntl.2,v 1.20 2001/09/16 01:39:00 wiz Exp $
.\" $NetBSD: fcntl.2,v 1.21 2001/09/16 02:13:27 wiz Exp $
.\"
.\" Copyright (c) 1983, 1993
.\" The Regents of the University of California. All rights reserved.
@ -493,8 +493,8 @@ the process ID given as argument is not in use.
.Xr execve 2 ,
.Xr flock 2 ,
.Xr open 2 ,
.Xr getdtablesize 3 ,
.Xr sigaction 2
.Xr sigaction 2 ,
.Xr getdtablesize 3
.Sh STANDARDS
The
.Fn fcntl

3
lib/libc/sys/fdatasync.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: fdatasync.2,v 1.7 2001/09/16 01:39:00 wiz Exp $
.\" $NetBSD: fdatasync.2,v 1.8 2001/09/16 02:13:27 wiz Exp $
.\"
.\" Copyright (c) 1998 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -62,7 +62,6 @@ This behaviour is commonly known as
.Bf -symbolic
synchronized I/O data integrity completion.
.Ef
.Pp
.Sh RETURN VALUES
A value of 0 is returned on success. Otherwise, a value -1 is returned and
.Va errno

10
lib/libc/sys/fhopen.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: fhopen.2,v 1.3 2000/03/13 22:59:21 soren Exp $
.\" $NetBSD: fhopen.2,v 1.4 2001/09/16 02:13:27 wiz Exp $
.\"
.\" Copyright (c) 1999 National Aeronautics & Space Administration
.\" All rights reserved.
@ -52,7 +52,7 @@
.Fn fhstatfs "const fhandle_t *fhp" "struct statfs *buf"
.Sh DESCRIPTION
These functions provide a means to access a file given the file handle
.Fa fhp.
.Fa fhp .
As this method bypasses directory access restrictions, these calls are
restricted to the superuser.
.Pp
@ -116,10 +116,10 @@ The file handle
is no longer valid.
.El
.Sh SEE ALSO
.Xr getfh 2 ,
.Xr open 2 ,
.Xr fstat 2 ,
.Xr fstatfs 2
.Xr fstatfs 2 ,
.Xr getfh 2 ,
.Xr open 2
.Sh HISTORY
The
.Fn fhopen ,

6
lib/libc/sys/flock.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: flock.2,v 1.12 2001/09/16 01:39:00 wiz Exp $
.\" $NetBSD: flock.2,v 1.13 2001/09/16 02:13:27 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -145,11 +145,11 @@ or
.Dv LOCK_UN .
.El
.Sh SEE ALSO
.Xr open 2 ,
.Xr close 2 ,
.Xr dup 2 ,
.Xr execve 2 ,
.Xr fork 2
.Xr fork 2 ,
.Xr open 2
.Sh HISTORY
The
.Fn flock

6
lib/libc/sys/getdents.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: getdents.2,v 1.7 2001/03/16 07:58:24 fair Exp $
.\" $NetBSD: getdents.2,v 1.8 2001/09/16 02:13:27 wiz Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -150,8 +150,8 @@ A directory was being read on NFS, but it was modified on the server while
it was being read.
.El
.Sh SEE ALSO
.Xr open 2 ,
.Xr lseek 2
.Xr lseek 2 ,
.Xr open 2
.Sh HISTORY
The
.Fn getdents

6
lib/libc/sys/getdirentries.3
View File

@ -1,4 +1,4 @@
.\" $NetBSD: getdirentries.3,v 1.5 2001/09/16 01:39:00 wiz Exp $
.\" $NetBSD: getdirentries.3,v 1.6 2001/09/16 02:13:28 wiz Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -153,8 +153,8 @@ An
error occurred while reading from or writing to the file system.
.El
.Sh SEE ALSO
.Xr open 2 ,
.Xr lseek 2
.Xr lseek 2 ,
.Xr open 2
.Sh HISTORY
The
.Fn getdirentries

4
lib/libc/sys/getfsstat.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: getfsstat.2,v 1.17 2001/09/16 01:39:00 wiz Exp $
.\" $NetBSD: getfsstat.2,v 1.18 2001/09/16 02:13:28 wiz Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -179,8 +179,8 @@ An
error occurred while reading from or writing to the file system.
.El
.Sh SEE ALSO
.Xr getmntinfo 3 ,
.Xr statfs 2 ,
.Xr getmntinfo 3 ,
.Xr fstab 5 ,
.Xr mount 8
.Sh HISTORY

6
lib/libc/sys/getitimer.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: getitimer.2,v 1.12 2001/09/16 01:39:00 wiz Exp $
.\" $NetBSD: getitimer.2,v 1.13 2001/09/16 02:13:28 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -159,10 +159,10 @@ parameter specified a time that was too large
to be handled.
.El
.Sh SEE ALSO
.Xr gettimeofday 2 ,
.Xr poll 2 ,
.Xr select 2 ,
.Xr sigaction 2 ,
.Xr gettimeofday 2
.Xr sigaction 2
.Sh HISTORY
The
.Fn getitimer

12
lib/libc/sys/getlogin.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: getlogin.2,v 1.10 1999/12/02 21:42:37 kleink Exp $
.\" $NetBSD: getlogin.2,v 1.11 2001/09/16 02:13:28 wiz Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -111,6 +111,11 @@ The
.Fn getlogin
function conforms to
.St -p1003.1-90 .
.Sh HISTORY
The
.Fn getlogin
function first appeared in
.Bx 4.4 .
.Sh BUGS
Login names are limited in length by
.Fn setlogin .
@ -129,8 +134,3 @@ In earlier versions of the system, the value returned by
.Fn getlogin
could not be trusted without checking the user ID.
Portable programs should probably still make this check.
.Sh HISTORY
The
.Fn getlogin
function first appeared in
.Bx 4.4 .

8
lib/libc/sys/getrusage.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: getrusage.2,v 1.10 2001/09/16 01:39:01 wiz Exp $
.\" $NetBSD: getrusage.2,v 1.11 2001/09/16 02:13:28 wiz Exp $
.\"
.\" Copyright (c) 1985, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -157,11 +157,11 @@ parameter is not in a valid part of the process address space.
.Sh SEE ALSO
.Xr gettimeofday 2 ,
.Xr wait 2
.Sh BUGS
There is no way to obtain information about a child process
that has not yet terminated.
.Sh HISTORY
The
.Fn getrusage
function call appeared in
.Bx 4.2 .
.Sh BUGS
There is no way to obtain information about a child process
that has not yet terminated.

12
lib/libc/sys/getsockname.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: getsockname.2,v 1.13 2001/09/16 01:39:01 wiz Exp $
.\" $NetBSD: getsockname.2,v 1.14 2001/09/16 02:13:28 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -81,14 +81,14 @@ parameter points to memory not in a valid part of the process address space.
.Sh SEE ALSO
.Xr bind 2 ,
.Xr socket 2
.Sh HISTORY
The
.Fn getsockname
function call appeared in
.Bx 4.2 .
.Sh BUGS
Names bound to sockets in the
.Ux
domain are inaccessible;
.Fn getsockname
returns a zero length name.
.Sh HISTORY
The
.Fn getsockname
function call appeared in
.Bx 4.2 .

14
lib/libc/sys/getsockopt.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: getsockopt.2,v 1.19 2001/05/19 17:23:39 jdolecek Exp $
.\" $NetBSD: getsockopt.2,v 1.20 2001/09/16 02:13:28 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -192,8 +192,8 @@ are queued on socket and a
.Xr close 2
is performed.
If the socket promises reliable delivery of data and
.Dv SO_LINGER is set,
the system will block the process on the
.Dv SO_LINGER
is set, the system will block the process on the
.Xr close 2
attempt until it is able to transmit the data or until it decides it
is unable to deliver the information (a timeout period, measured in
@ -359,15 +359,15 @@ is not in a valid part of the process address space.
.El
.Sh SEE ALSO
.Xr ioctl 2 ,
.Xr socket 2 ,
.Xr select 2 ,
.Xr poll 2 ,
.Xr select 2 ,
.Xr socket 2 ,
.Xr getprotoent 3 ,
.Xr protocols 5
.Sh BUGS
Several of the socket options should be handled at lower levels of the system.
.Sh HISTORY
The
.Fn getsockopt
system call appeared in
.Bx 4.2 .
.Sh BUGS
Several of the socket options should be handled at lower levels of the system.

4
lib/libc/sys/gettimeofday.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: gettimeofday.2,v 1.13 2001/09/16 01:39:01 wiz Exp $
.\" $NetBSD: gettimeofday.2,v 1.14 2001/09/16 02:13:28 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -105,7 +105,7 @@ Only the super-user may set the time of day.
.\" The system time can still be adjusted backwards using the
.\" .Xr adjtime 2
.\" system call even when the system is secure.
.Sh RETURN
.Sh RETURN VALUES
A 0 return value indicates that the call succeeded.
A -1 return value indicates an error occurred, and in this
case an error code is stored into the global variable

6
lib/libc/sys/ioctl.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: ioctl.2,v 1.10 2001/09/16 01:39:01 wiz Exp $
.\" $NetBSD: ioctl.2,v 1.11 2001/09/16 02:13:28 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -102,8 +102,8 @@ is not valid.
.Xr mt 1 ,
.Xr execve 2 ,
.Xr fcntl 2 ,
.Xr tty 4 ,
.Xr intro 4
.Xr intro 4 ,
.Xr tty 4
.Sh HISTORY
An
.Fn ioctl

4
lib/libc/sys/kill.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: kill.2,v 1.14 2001/09/16 01:39:01 wiz Exp $
.\" $NetBSD: kill.2,v 1.15 2001/09/16 02:13:28 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -75,7 +75,7 @@ to any descendant of the current process.
.It \&If Fa pid No \&is greater than zero :
.Fa sig
is sent to the process whose ID is equal to
.Fa pid.
.Fa pid .
.It \&If Fa pid No \&is zero :
.Fa sig
is sent to all processes whose group ID is equal

8
lib/libc/sys/ktrace.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: ktrace.2,v 1.9 2001/09/16 01:39:01 wiz Exp $
.\" $NetBSD: ktrace.2,v 1.10 2001/09/16 02:13:28 wiz Exp $
.\"
.\" Copyright (c) 1993
.\" The Regents of the University of California. All rights reserved.
@ -67,7 +67,7 @@ If tracing points are being disabled (see KTROP_CLEAR below),
may be NULL. If using
.Fn fktrace
then instead of passing a filename as
.Ar tracefile,
.Ar tracefile ,
a file descriptor is passed as
.Ar fd
and behaviour is otherwise the same.
@ -166,8 +166,8 @@ Too many symbolic links were encountered in translating the pathname.
An I/O error occurred while reading from or writing to the file system.
.El
.Sh SEE ALSO
.Xr ktrace 1 ,
.Xr kdump 1
.Xr kdump 1 ,
.Xr ktrace 1
.Sh HISTORY
A
.Nm ktrace

8
lib/libc/sys/lfs_bmapv.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: lfs_bmapv.2,v 1.2 2001/09/16 01:39:01 wiz Exp $
.\" $NetBSD: lfs_bmapv.2,v 1.3 2001/09/16 02:13:29 wiz Exp $
.\"
.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -54,7 +54,7 @@ fills in the bi_daddr field for every block listed in the block array
with the disk address corrseponding to the logical block
.Fa bi_lbn
of the file with inode
.Fa bi_inode.
.Fa bi_inode .
If
.Fa bi_lbn
is LFS_UNUSED_LBN, the disk location of the inode block containing the
@ -100,10 +100,10 @@ points outside the process's allocated address space.
does not specify a valid filesystem.
.El
.Sh SEE ALSO
.Xr lfs_cleanerd 8 ,
.Xr lfs_markv 2 ,
.Xr lfs_segclean 2 ,
.Xr lfs_segwait 2
.Xr lfs_segwait 2 ,
.Xr lfs_cleanerd 8
.Sh HISTORY
The
.Fn lfs_bmapv

25
lib/libc/sys/lfs_markv.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: lfs_markv.2,v 1.3 2001/09/16 01:39:01 wiz Exp $
.\" $NetBSD: lfs_markv.2,v 1.4 2001/09/16 02:13:29 wiz Exp $
.\"
.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -54,15 +54,15 @@ rewrites the blocks specified in
to new disk locations, for the purposes of grouping them next to one
another, or to move them out of a segment to clean it. All fields of
the BLOCK_INFO structure must be filled in, except for
.Fa bi_segcreate.
.Fa bi_segcreate .
If
.Fa bi_daddr
is not the correct current address for logical block
.Fa bi_lbn
of the file with inode number
.Fa bi_inode,
.Fa bi_inode ,
or if the file's version number does not match
.Fa bi_version,
.Fa bi_version ,
the block will not be written to disk, but no error will be returned.
.Pp
The
@ -115,10 +115,15 @@ One or more of the inodes whose blocks were to be written was locked,
and its blocks were not rewritten.
.El
.Sh SEE ALSO
.Xr lfs_cleanerd 8 ,
.Xr lfs_markv 2 ,
.Xr lfs_segclean 2 ,
.Xr lfs_segwait 2
.Xr lfs_segwait 2 ,
.Xr lfs_cleanerd 8
.Sh HISTORY
The
.Fn lfs_markv
function call appeared in
.Bx 4.4 .
.Sh BUGS
The functionality of
.Fn lfs_markv
@ -128,10 +133,4 @@ SF_IMMUTABLE
and
SF_APPEND
file flags (see
.Xr chflags 2
).
.Sh HISTORY
The
.Fn lfs_markv
function call appeared in
.Bx 4.4 .
.Xr chflags 2 ) .

6
lib/libc/sys/lfs_segclean.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: lfs_segclean.2,v 1.2 2001/09/16 01:39:01 wiz Exp $
.\" $NetBSD: lfs_segclean.2,v 1.3 2001/09/16 02:13:29 wiz Exp $
.\"
.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -72,10 +72,10 @@ does not specify a valid filesystem.
is marked SU_ACTIVE, meaning that it does not yet belong to a valid checkpoint.
.El
.Sh SEE ALSO
.Xr lfs_cleanerd 8 ,
.Xr lfs_bmapv 2 ,
.Xr lfs_markv 2 ,
.Xr lfs_segwait 2
.Xr lfs_segwait 2 ,
.Xr lfs_cleanerd 8
.Sh HISTORY
The
.Fn lfs_segclean

6
lib/libc/sys/lfs_segwait.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: lfs_segwait.2,v 1.2 2001/09/16 01:39:01 wiz Exp $
.\" $NetBSD: lfs_segwait.2,v 1.3 2001/09/16 02:13:29 wiz Exp $
.\"
.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -81,10 +81,10 @@ before a new segment was designated for writing.
The specified time limit is negative.
.El
.Sh SEE ALSO
.Xr lfs_cleanerd 8 ,
.Xr lfs_bmapv 2 ,
.Xr lfs_markv 2 ,
.Xr lfs_segclean 2
.Xr lfs_segclean 2 ,
.Xr lfs_cleanerd 8
.Sh HISTORY
The
.Fn lfs_segwait

4
lib/libc/sys/link.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: link.2,v 1.15 2001/09/16 01:39:01 wiz Exp $
.\" $NetBSD: link.2,v 1.16 2001/09/16 02:13:29 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -118,7 +118,7 @@ does not support links.
The link count of the file named by
.Fa name1
would exceed
.Dv {LINK_MAX}.
.Dv {LINK_MAX} .
.It Bq Er EEXIST
The link named by
.Fa name2

12
lib/libc/sys/listen.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: listen.2,v 1.10 1999/12/02 21:42:37 kleink Exp $
.\" $NetBSD: listen.2,v 1.11 2001/09/16 02:13:29 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -60,7 +60,7 @@ The
call applies only to sockets of type
.Dv SOCK_STREAM
or
.Dv SOCK_SEQPACKET.
.Dv SOCK_SEQPACKET .
.Pp
The
.Fa backlog
@ -94,12 +94,12 @@ The socket is not of a type that supports the operation
.Xr accept 2 ,
.Xr connect 2 ,
.Xr socket 2
.Sh BUGS
The
.Fa backlog
is currently limited (silently) to 128.
.Sh HISTORY
The
.Fn listen
function call appeared in
.Bx 4.2 .
.Sh BUGS
The
.Fa backlog
is currently limited (silently) to 128.

10
lib/libc/sys/lseek.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: lseek.2,v 1.14 2001/09/16 01:39:01 wiz Exp $
.\" $NetBSD: lseek.2,v 1.15 2001/09/16 02:13:29 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -128,12 +128,12 @@ is not a proper value, or the resulting file offset would be invalid.
.Sh SEE ALSO
.Xr dup 2 ,
.Xr open 2
.Sh BUGS
This document's use of
.Fa whence
is incorrect English, but is maintained for historical reasons.
.Sh STANDARDS
The
.Fn lseek
function conforms to
.St -p1003.1-90 .
.Sh BUGS
This document's use of
.Fa whence
is incorrect English, but is maintained for historical reasons.

14
lib/libc/sys/minherit.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: minherit.2,v 1.9 2001/09/16 01:39:01 wiz Exp $
.\" $NetBSD: minherit.2,v 1.10 2001/09/16 02:13:29 wiz Exp $
.\"
.\" Copyright (c) 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -75,11 +75,6 @@ Pages or regions marked
are shared between the address spaces, while pages or regions marked
.Dv MAP_INHERIT_NONE
will be unmapped in the child.
.Sh BUGS
If the a particular port does not support page-granularity
inheritance, there's no way to figure out how large a region is
actually affected by
.Fn minherit .
.Sh SEE ALSO
.Xr fork 2 ,
.Xr madvise 2 ,
@ -91,4 +86,9 @@ actually affected by
The
.Fn minherit
function first appeared in
.Bx Open .
.Ox .
.Sh BUGS
If the a particular port does not support page-granularity
inheritance, there's no way to figure out how large a region is
actually affected by
.Fn minherit .

4
lib/libc/sys/mknod.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: mknod.2,v 1.11 2001/09/16 01:39:01 wiz Exp $
.\" $NetBSD: mknod.2,v 1.12 2001/09/16 02:13:29 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -50,7 +50,7 @@ The device special file
.Fa path
is created with the major and minor
device numbers extracted from
.Fa mode.
.Fa mode .
The access permissions of
.Fa path
are descendant from the

6
lib/libc/sys/mount.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: mount.2,v 1.24 2001/09/16 01:39:01 wiz Exp $
.\" $NetBSD: mount.2,v 1.25 2001/09/16 02:13:29 wiz Exp $
.\"
.\" Copyright (c) 1980, 1989, 1993
.\" The Regents of the University of California. All rights reserved.
@ -356,8 +356,6 @@ mounted.
.Xr mount 8 ,
.Xr sysctl 8 ,
.Xr umount 8
.Sh BUGS
Some of the error codes need translation to more obvious messages.
.Sh HISTORY
The
.Fn mount
@ -367,3 +365,5 @@ and
.Fn unmount )
function calls appeared in
.At v6 .
.Sh BUGS
Some of the error codes need translation to more obvious messages.

8
lib/libc/sys/msgget.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: msgget.2,v 1.8 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: msgget.2,v 1.9 2001/09/16 02:13:29 wiz Exp $
.\"
.\" Copyright (c) 1995 Frank van der Linden
.\" All rights reserved.
@ -57,7 +57,7 @@ or
does not have a message queue identifier associated with it and the
.Dv IPC_CREAT
bit is set in
.Fa msgflg.
.Fa msgflg .
.Pp
If a new message queue is created, the data structure associated with it (the
.Va msqid_ds
@ -127,10 +127,10 @@ and no message queue associated with
was found.
.El
.Sh SEE ALSO
.Xr ftok 3 ,
.Xr msgctl 2 ,
.Xr msgrcv 2 ,
.Xr msgsnd 2
.Xr msgsnd 2 ,
.Xr ftok 3
.Sh STANDARDS
The
.Nm

11
lib/libc/sys/msync.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: msync.2,v 1.15 2001/04/25 02:19:48 simonb Exp $
.\" $NetBSD: msync.2,v 1.16 2001/09/16 02:13:29 wiz Exp $
.\"
.\" Copyright (c) 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -118,10 +118,6 @@ which are unmapped.
.Xr mlock 2 ,
.Xr mmap 2 ,
.Xr munlock 2
.Sh BUGS
Writes are currently done synchronously even if the
.Dv MS_ASYNC
flag is specified.
.Sh HISTORY
The
.Fn msync
@ -131,4 +127,7 @@ It was modified to conform to
.St -p1003.1b-93
in
.Nx 1.3 .
.P
.Sh BUGS
Writes are currently done synchronously even if the
.Dv MS_ASYNC
flag is specified.

4
lib/libc/sys/nanosleep.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: nanosleep.2,v 1.4 2000/07/10 06:44:35 kleink Exp $
.\" $NetBSD: nanosleep.2,v 1.5 2001/09/16 02:13:30 wiz Exp $
.\"
.\" Copyright (c) 1986, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -56,7 +56,7 @@ action is to invoke a signal catching function or to terminate the
process.
The suspension time may be longer than requested due to the
scheduling of other activity by the system.
.Sh RETURN VALUE
.Sh RETURN VALUES
If the
.Fn nanosleep
function returns because the requested time has elapsed, the value

6
lib/libc/sys/nfssvc.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: nfssvc.2,v 1.14 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: nfssvc.2,v 1.15 2001/09/16 02:13:30 wiz Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -212,8 +212,8 @@ as explained above.
The caller is not the super-user.
.El
.Sh SEE ALSO
.Xr nfsd 8 ,
.Xr mount_nfs 8
.Xr mount_nfs 8 ,
.Xr nfsd 8
.Sh HISTORY
The
.Nm

6
lib/libc/sys/open.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: open.2,v 1.20 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: open.2,v 1.21 2001/09/16 02:13:30 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -233,7 +233,7 @@ The named file is a character special or block
special file, and the device associated with this special file
does not exist, or
the named file is a
.Tn FIFO,
.Tn FIFO ,
.Dv O_NONBLOCK
and
.Dv O_WRONLY
@ -300,8 +300,8 @@ An attempt was made to open a socket (not currently implemented).
.Xr dup 2 ,
.Xr lseek 2 ,
.Xr read 2 ,
.Xr write 2 ,
.Xr umask 2 ,
.Xr write 2 ,
.Xr getdtablesize 3
.Sh STANDARDS
The

3
lib/libc/sys/pathconf.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: pathconf.2,v 1.10 1999/12/02 21:42:38 kleink Exp $
.\" $NetBSD: pathconf.2,v 1.11 2001/09/16 02:13:30 wiz Exp $
.\"
.\" Copyright (c) 1993
.\" The Regents of the University of California. All rights reserved.
@ -49,7 +49,6 @@
.Ft long
.Fn fpathconf "int fd" "int name"
.Sh DESCRIPTION
.Pp
The
.Fn pathconf
and

8
lib/libc/sys/pipe.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: pipe.2,v 1.12 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: pipe.2,v 1.13 2001/09/16 02:13:30 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -105,10 +105,10 @@ space.
.El
.Sh SEE ALSO
.Xr sh 1 ,
.Xr read 2 ,
.Xr write 2 ,
.Xr fork 2 ,
.Xr socketpair 2
.Xr read 2 ,
.Xr socketpair 2 ,
.Xr write 2
.Sh STANDARDS
The
.Fn pipe

12
lib/libc/sys/poll.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: poll.2,v 1.9 2001/04/25 02:19:48 simonb Exp $
.\" $NetBSD: poll.2,v 1.10 2001/09/16 02:13:30 wiz Exp $
.\"
.\" Copyright (c) 1998 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -180,6 +180,11 @@ The specified time limit is negative.
.Xr select 2 ,
.Xr send 2 ,
.Xr write 2
.Sh HISTORY
The
.Fn poll
function call appeared in
.At V.3 .
.Sh BUGS
The distinction between some of the fields in the
.Fa events
@ -187,8 +192,3 @@ and
.Fa revents
bitmasks is really not useful without STREAMS. The fields are
defined for compatibility with existing software.
.Sh HISTORY
The
.Fn poll
function call appeared in
.At V.3 .

4
lib/libc/sys/profil.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: profil.2,v 1.6 2000/10/24 19:32:34 erh Exp $
.\" $NetBSD: profil.2,v 1.7 2001/09/16 02:13:30 wiz Exp $
.\"
.\" Copyright (c) 1993
.\" The Regents of the University of California. All rights reserved.
@ -118,7 +118,7 @@ The buffer
contains an invalid address.
.El
.Sh SEE ALSO
.Xr gprof 1
.Xr gprof 1 ,
.Xr moncontrol 3
.\" .Sh HISTORY
.\" wish I knew... probably v7.

6
lib/libc/sys/ptrace.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: ptrace.2,v 1.14 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: ptrace.2,v 1.15 2001/09/16 02:13:30 wiz Exp $
.\"
.\" This file is in the public domain.
.Dd November 7, 1994
@ -53,9 +53,7 @@ that the process expects to be traced by its parent. All the other
arguments are ignored. (If the parent process does not expect to trace
the child, it will probably be rather confused by the results; once the
traced process stops, it cannot be made to continue except via
.Eo \&
.Fn ptrace
.Ec \&.)
.Fn ptrace . )
When a process has used this request and calls
.Xr execve 2
or any of the routines built on it

12
lib/libc/sys/quotactl.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: quotactl.2,v 1.16 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: quotactl.2,v 1.17 2001/09/16 02:13:30 wiz Exp $
.\"
.\" Copyright (c) 1983, 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -204,14 +204,14 @@ The call was privileged and the caller was not the super-user.
.Xr quotacheck 8 ,
.Xr quotaon 8 ,
.Xr repquota 8
.Sh HISTORY
The
.Fn quotactl
function call appeared in
.Bx 4.3 Reno .
.Sh BUGS
There should be some way to integrate this call with the resource
limit interface provided by
.Xr setrlimit 2
and
.Xr getrlimit 2 .
.Sh HISTORY
The
.Fn quotactl
function call appeared in
.Bx 4.3 Reno .

3
lib/libc/sys/read.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: read.2,v 1.15 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: read.2,v 1.16 2001/09/16 02:13:30 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -125,7 +125,6 @@ return the number of bytes actually read and placed in the buffer.
The system guarantees to read the number of bytes requested if
the descriptor references a normal file that has that many bytes left
before the end-of-file, but in no other case.
.Pp
.Sh RETURN VALUES
If successful, the
number of bytes actually read is returned. Upon reading end-of-file,

4
lib/libc/sys/readlink.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: readlink.2,v 1.13 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: readlink.2,v 1.14 2001/09/16 02:13:30 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -90,8 +90,8 @@ An I/O error occurred while reading from the file system.
extends outside the process's allocated address space.
.El
.Sh SEE ALSO
.Xr stat 2 ,
.Xr lstat 2 ,
.Xr stat 2 ,
.Xr symlink 2 ,
.Xr symlink 7
.Sh HISTORY

11
lib/libc/sys/recv.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: recv.2,v 1.17 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: recv.2,v 1.18 2001/09/16 02:13:30 wiz Exp $
.\"
.\" Copyright (c) 1983, 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -223,7 +223,6 @@ control data were discarded due to lack of space in the buffer
for ancillary data.
.Dv MSG_OOB
is returned to indicate that expedited or out-of-band data were received.
.Pp
.Sh RETURN VALUES
These calls return the number of bytes received, or -1
if an error occurred.
@ -239,7 +238,7 @@ The socket is associated with a connection-oriented protocol
and has not been connected (see
.Xr connect 2
and
.Xr accept 2 ).
.Xr accept 2 ) .
.It Bq Er ENOTSOCK
The argument
.Fa s
@ -274,10 +273,10 @@ or is greater than
.El
.Sh SEE ALSO
.Xr fcntl 2 ,
.Xr read 2 ,
.Xr poll 2 ,
.Xr select 2 ,
.Xr getsockopt 2 ,
.Xr poll 2 ,
.Xr read 2 ,
.Xr select 2 ,
.Xr socket 2
.Sh HISTORY
The

54
lib/libc/sys/rename.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: rename.2,v 1.14 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: rename.2,v 1.15 2001/09/16 02:13:31 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -80,32 +80,6 @@ and
are pathnames of the same existing file in the file system's name space,
.Fn rename
returns successfully and performs no other action.
.Sh CAVEAT
The system can deadlock if a loop in the file system graph is present.
This loop takes the form of an entry in directory
.Ql Pa a ,
say
.Ql Pa a/foo ,
being a hard link to directory
.Ql Pa b ,
and an entry in
directory
.Ql Pa b ,
say
.Ql Pa b/bar ,
being a hard link
to directory
.Ql Pa a .
When such a loop exists and two separate processes attempt to
perform
.Ql rename a/foo b/bar
and
.Ql rename b/bar a/foo ,
respectively,
the system may deadlock attempting to lock
both directories for modification.
Hard links to directories should be
replaced by symbolic links by the system administrator.
.Sh RETURN VALUES
A 0 value is returned if the operation succeeds, otherwise
.Fn rename
@ -238,3 +212,29 @@ function conforms to
.St -p1003.1-90
and
.St -xpg4.2 .
.Sh BUGS
The system can deadlock if a loop in the file system graph is present.
This loop takes the form of an entry in directory
.Ql Pa a ,
say
.Ql Pa a/foo ,
being a hard link to directory
.Ql Pa b ,
and an entry in
directory
.Ql Pa b ,
say
.Ql Pa b/bar ,
being a hard link
to directory
.Ql Pa a .
When such a loop exists and two separate processes attempt to
perform
.Ql rename a/foo b/bar
and
.Ql rename b/bar a/foo ,
respectively,
the system may deadlock attempting to lock
both directories for modification.
Hard links to directories should be
replaced by symbolic links by the system administrator.

12
lib/libc/sys/select.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: select.2,v 1.13 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: select.2,v 1.14 2001/09/16 02:13:31 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -162,6 +162,11 @@ negative or too large.
.Xr send 2 ,
.Xr write 2 ,
.Xr getdtablesize 3
.Sh HISTORY
The
.Fn select
function call appeared in
.Bx 4.2 .
.Sh BUGS
Although the provision of
.Xr getdtablesize 3
@ -188,8 +193,3 @@ Thus, it is unwise to assume that the timeout value will be unmodified
by the
.Fn select
call.
.Sh HISTORY
The
.Fn select
function call appeared in
.Bx 4.2 .

4
lib/libc/sys/semctl.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: semctl.2,v 1.9 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: semctl.2,v 1.10 2001/09/16 02:13:31 wiz Exp $
.\"
.\" Copyright (c) 1995 Frank van der Linden
.\" All rights reserved.
@ -168,7 +168,7 @@ is determined by the
.Va sem_perm.mode
field in the same way as is
done with files (see
.Xr chmod 2 ),
.Xr chmod 2 ) ,
but the effective uid can match either the
.Va sem_perm.cuid
field or the

10
lib/libc/sys/semget.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: semget.2,v 1.10 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: semget.2,v 1.11 2001/09/16 02:13:31 wiz Exp $
.\"
.\" Copyright (c) 1995 Frank van der Linden
.\" All rights reserved.
@ -58,7 +58,7 @@ or
does not have a semaphore set associated with it and the
.Dv IPC_CREAT
bit is set in
.Fa semflg.
.Fa semflg .
.Pp
If a new set of semaphores is created, the data structure associated with it
(the
@ -102,7 +102,7 @@ is set to reflect the error.
.Bl -tag -width Er
.It Bq Er EACCES
The caller has no permission to access a semaphore set already associated with
.Fa key.
.Fa key .
.It Bq Er EEXIST
Both
.Dv IPC_CREAT
@ -134,9 +134,9 @@ and no semaphore set associated with
was found.
.El
.Sh SEE ALSO
.Xr ftok 3 ,
.Xr semctl 2 ,
.Xr semop 2
.Xr semop 2 ,
.Xr ftok 3
.Sh STANDARDS
The
.Nm

4
lib/libc/sys/send.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: send.2,v 1.16 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: send.2,v 1.17 2001/09/16 02:13:31 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -178,9 +178,9 @@ or is greater than
.El
.Sh SEE ALSO
.Xr fcntl 2 ,
.Xr getsockopt 2 ,
.Xr recv 2 ,
.Xr select 2 ,
.Xr getsockopt 2 ,
.Xr socket 2 ,
.Xr write 2
.Sh HISTORY

4
lib/libc/sys/setregid.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: setregid.2,v 1.15 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: setregid.2,v 1.16 2001/09/16 02:13:31 wiz Exp $
.\"
.\" Copyright (c) 1998, 2000, 2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -110,7 +110,7 @@ IDs in set-group-ID programs to temporarily relinquish the set-group-ID
value. This purpose is now better served by the use of the
.Fn setegid
function (see
.Xr setgid 2 ).
.Xr setgid 2 ) .
.Pp
When setting the real and effective group IDs to the same value, this
function is equivalent to the

8
lib/libc/sys/setreuid.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: setreuid.2,v 1.15 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: setreuid.2,v 1.16 2001/09/16 02:13:31 wiz Exp $
.\"
.\" Copyright (c) 1998, 2000, 2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -110,7 +110,7 @@ IDs in set-user-ID programs to temporarily relinquish the set-user-ID
value. This purpose is now better served by the use of the
.Fn seteuid
function (see
.Xr setuid 2 ).
.Xr setuid 2 ) .
.Pp
When setting the real and effective user IDs to the same value, this
function is equivalent to the
@ -135,8 +135,8 @@ was specified.
.Sh SEE ALSO
.Xr getuid 2 ,
.Xr seteuid 2 ,
.Xr setuid 2 ,
.Xr setgid 2
.Xr setgid 2 ,
.Xr setuid 2
.Sh HISTORY
The
.Fn setreuid

7
lib/libc/sys/setuid.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: setuid.2,v 1.9 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: setuid.2,v 1.10 2001/09/16 02:13:31 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -94,7 +94,6 @@ may be toggled by switching to the real user ID, then re-enabled
by reverting to the set-user-ID value.
Similarly, the effective group ID may be set to the value
of the real group ID or the saved set-group-ID.
.Pp
.Sh RETURN VALUES
Upon success, these functions return 0;
otherwise \-1 is returned.
@ -103,8 +102,8 @@ If the user is not the super user, or the uid
specified is not the real, effective ID, or saved ID,
these functions return \-1.
.Sh SEE ALSO
.Xr getuid 2 ,
.Xr getgid 2
.Xr getgid 2 ,
.Xr getuid 2
.Sh STANDARDS
The
.Fn setuid

4
lib/libc/sys/shmctl.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: shmctl.2,v 1.10 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: shmctl.2,v 1.11 2001/09/16 02:13:31 wiz Exp $
.\"
.\" Copyright (c) 1995 Frank van der Linden
.\" All rights reserved.
@ -120,7 +120,7 @@ are determined by the
.Va shm_perm.mode
field in the same way as is
done with files (see
.Xr chmod 2 ),
.Xr chmod 2 ) ,
but the effective uid can match either the
.Va shm_perm.cuid
field or the

8
lib/libc/sys/shmget.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: shmget.2,v 1.12 2001/09/16 01:39:02 wiz Exp $
.\" $NetBSD: shmget.2,v 1.13 2001/09/16 02:13:31 wiz Exp $
.\"
.\" Copyright (c) 1995 Frank van der Linden
.\" All rights reserved.
@ -76,7 +76,7 @@ or
does not have a shared memory segment identifier associated with it, and the
.Dv IPC_CREAT
bit is set in
.Fa shmflg.
.Fa shmflg .
.Pp
If a new shared memory segment is created, the data structure
associated with it (the
@ -150,10 +150,10 @@ There is not enough memory left to create a shared memory segment of the
requested size.
.El
.Sh SEE ALSO
.Xr ftok 3 ,
.Xr mmap 2 ,
.Xr shmat 2 ,
.Xr shmctl 2
.Xr shmctl 2 ,
.Xr ftok 3
.Sh STANDARDS
The
.Nm

28
lib/libc/sys/sigaction.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: sigaction.2,v 1.24 2000/06/07 19:47:58 nathanw Exp $
.\" $NetBSD: sigaction.2,v 1.25 2001/09/16 02:13:31 wiz Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
.\" The Regents of the University of California. All rights reserved.
@ -245,7 +245,7 @@ signals that restart pending system calls continue to do so.
See
.Xr signal 7
for comprehensive list of supported signals.
.Sh NOTE
.Sh NOTES
The mask specified in
.Fa act
is not allowed to block
@ -258,7 +258,7 @@ A 0 value indicates that the call succeeded.
A \-1 return value indicates an error occurred and
.Va errno
is set to indicate the reason.
.Sh EXAMPLE
.Sh EXAMPLES
The handler routine can be declared:
.Bd -literal -offset indent
void
@ -313,6 +313,17 @@ An attempt is made to ignore or supply a handler for
or
.Dv SIGSTOP .
.El
.Sh SEE ALSO
.Xr kill 1 ,
.Xr kill 2 ,
.Xr ptrace 2 ,
.Xr sigaltstack 2 ,
.Xr sigprocmask 2 ,
.Xr sigsuspend 2 ,
.Xr setjmp 3 ,
.Xr sigsetops 3 ,
.Xr tty 4 ,
.Xr signal 7
.Sh STANDARDS
The
.Fn sigaction
@ -340,14 +351,3 @@ and
These signals are available on most
.Bx Ns \-derived
systems.
.Sh SEE ALSO
.Xr kill 1 ,
.Xr kill 2 ,
.Xr ptrace 2 ,
.Xr sigaltstack 2 ,
.Xr sigprocmask 2 ,
.Xr sigsuspend 2 ,
.Xr setjmp 3 ,
.Xr sigsetops 3 ,
.Xr tty 4 ,
.Xr signal 7

4
lib/libc/sys/sigsuspend.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: sigsuspend.2,v 1.11 1999/12/11 19:35:48 msaitoh Exp $
.\" $NetBSD: sigsuspend.2,v 1.12 2001/09/16 02:13:31 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -73,8 +73,8 @@ always terminates by being interrupted, returning -1 with
set to
.Er EINTR .
.Sh SEE ALSO
.Xr sigprocmask 2 ,
.Xr sigaction 2 ,
.Xr sigprocmask 2 ,
.Xr sigsetops 3 ,
.Xr signal 7
.Sh STANDARDS

8
lib/libc/sys/socket.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: socket.2,v 1.19 2001/09/16 01:39:03 wiz Exp $
.\" $NetBSD: socket.2,v 1.20 2001/09/16 02:13:31 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -237,20 +237,20 @@ The socket cannot be created until sufficient resources are freed.
.Xr accept 2 ,
.Xr bind 2 ,
.Xr connect 2 ,
.Xr getprotoent 3 ,
.Xr getsockname 2 ,
.Xr getsockopt 2 ,
.Xr ioctl 2 ,
.Xr listen 2 ,
.Xr poll 2 ,
.Xr read 2 ,
.Xr recv 2 ,
.Xr poll 2 ,
.Xr select 2 ,
.Xr send 2 ,
.Xr setsockopt 2 ,
.Xr shutdown 2 ,
.Xr socketpair 2 ,
.Xr write 2
.Xr write 2 ,
.Xr getprotoent 3
.Rs
.%T "An Introductory 4.3 BSD Interprocess Communication Tutorial"
.%O "reprinted in UNIX Programmer's Supplementary Documents Volume 1"

10
lib/libc/sys/socketpair.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: socketpair.2,v 1.11 1999/12/02 21:42:39 kleink Exp $
.\" $NetBSD: socketpair.2,v 1.12 2001/09/16 02:13:32 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -87,12 +87,12 @@ process address space.
.Xr pipe 2 ,
.Xr read 2 ,
.Xr write 2
.Sh BUGS
This call is currently implemented only for the
.Ux
domain.
.Sh HISTORY
The
.Fn socketpair
function call appeared in
.Bx 4.2 .
.Sh BUGS
This call is currently implemented only for the
.Ux
domain.

16
lib/libc/sys/stat.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: stat.2,v 1.22 2001/09/16 01:39:03 wiz Exp $
.\" $NetBSD: stat.2,v 1.23 2001/09/16 02:13:32 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993, 1994
.\" The Regents of the University of California. All rights reserved.
@ -269,13 +269,6 @@ An I/O error occurred while reading from or writing to the file system.
.Xr chown 2 ,
.Xr utimes 2 ,
.Xr symlink 7
.Sh BUGS
Applying
.Fn fstat
to a socket (and thus to a pipe)
returns a zero'd buffer,
except for the blocksize field,
and a unique device and inode number.
.Sh STANDARDS
The
.Fn stat
@ -288,3 +281,10 @@ A
.Fn lstat
function call appeared in
.Bx 4.2 .
.Sh BUGS
Applying
.Fn fstat
to a socket (and thus to a pipe)
returns a zero'd buffer,
except for the blocksize field,
and a unique device and inode number.

14
lib/libc/sys/swapctl.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: swapctl.2,v 1.21 2001/09/16 01:39:03 wiz Exp $
.\" $NetBSD: swapctl.2,v 1.22 2001/09/16 02:13:32 wiz Exp $
.\"
.\" Copyright (c) 1997 Matthew R. Green
.\" Copyright (c) 1980, 1991, 1993
@ -226,12 +226,7 @@ An I/O error occurred while opening the swap device.
points outside the process' allocated address space.
.El
.Sh SEE ALSO
.Xr swapctl 8 .
.Sh AUTHOR
The current swap system was designed and implemented by Matthew Green
<mrg@eterna.com.au>, with help from Paul Kranenburg <pk@NetBSD.ORG>
and Leo Weppelman <leo@NetBSD.ORG>, and insights from Jason R. Thorpe
<thorpej@NetBSD.ORG>.
.Xr swapctl 8
.Sh HISTORY
The
.Fn swapctl
@ -247,3 +242,8 @@ when the header file was also moved from
.Pa <vm/vm_swap.h> ,
to its current location in
.Pa <sys/swap.h> .
.Sh AUTHORS
The current swap system was designed and implemented by Matthew Green
<mrg@eterna.com.au>, with help from Paul Kranenburg <pk@NetBSD.ORG>
and Leo Weppelman <leo@NetBSD.ORG>, and insights from Jason R. Thorpe
<thorpej@NetBSD.ORG>.

6
lib/libc/sys/swapon.3
View File

@ -1,4 +1,4 @@
.\" $NetBSD: swapon.3,v 1.8 2001/09/16 01:39:03 wiz Exp $
.\" $NetBSD: swapon.3,v 1.9 2001/09/16 02:13:32 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -113,8 +113,6 @@ points outside the process's allocated address space.
.Xr swapctl 2 ,
.Xr swapctl 8 ,
.Xr swapon 8
.Sh BUGS
This call will be upgraded in future versions of the system.
.Sh HISTORY
The
.Fn swapon
@ -122,3 +120,5 @@ function call appeared in
.Bx 4.0
and was removed
.Nx 1.3
.Sh BUGS
This call will be upgraded in future versions of the system.

8
lib/libc/sys/sync.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: sync.2,v 1.9 2001/09/16 01:39:03 wiz Exp $
.\" $NetBSD: sync.2,v 1.10 2001/09/16 02:13:32 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -69,11 +69,11 @@ attributes.
.Sh SEE ALSO
.Xr fsync 2 ,
.Xr sync 8
.Sh BUGS
.Fn sync
may return before the buffers are completely flushed.
.Sh HISTORY
A
.Fn sync
function call appeared in
.At v6 .
.Sh BUGS
.Fn sync
may return before the buffers are completely flushed.

3
lib/libc/sys/sysarch.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: sysarch.2,v 1.9 1999/12/02 21:42:40 kleink Exp $
.\" $NetBSD: sysarch.2,v 1.10 2001/09/16 02:13:32 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991 Regents of the University of California.
.\" All rights reserved.
@ -67,7 +67,6 @@ system call should never be called directly by
user programs. Instead, they should access
its functions using the architecture-dependent
library.
.Pp
.Sh RETURN VALUES
See the manual pages for specific architecture-dependent function calls
for information about their return values.

12
lib/libc/sys/syscall.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: syscall.2,v 1.9 2000/01/31 15:15:07 christos Exp $
.\" $NetBSD: syscall.2,v 1.10 2001/09/16 02:13:32 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -69,6 +69,11 @@ In general, a 0 return value indicates success.
A -1 return value indicates an error,
and an error code is stored in
.Va errno .
.Sh HISTORY
The
.Fn syscall
function call appeared in
.Bx 4.0 .
.Sh BUGS
There is no way to simulate system calls that have multiple return values
such as
@ -82,8 +87,3 @@ conversion between passing structs and unions is handled normally
via userland stubs. The correct arguments for the kernel entry
points for each system call can be found in the header file
.Ao Pa sys/syscallargs.h Ac
.Sh HISTORY
The
.Fn syscall
function call appeared in
.Bx 4.0 .

10
lib/libc/sys/truncate.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: truncate.2,v 1.13 2001/09/16 01:39:03 wiz Exp $
.\" $NetBSD: truncate.2,v 1.14 2001/09/16 02:13:32 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -62,7 +62,7 @@ is discarded. If it was previously shorter than
.Fa length ,
its size is increased to the specified value and
the extended area appears as if it were zero-filled.
.Pp
With
.Fn ftruncate ,
the file must be open for writing; for
@ -122,9 +122,6 @@ is not open for writing.
.El
.Sh SEE ALSO
.Xr open 2
.Sh BUGS
These calls should be generalized to allow ranges
of bytes in a file to be discarded.
.Sh HISTORY
The
.Fn truncate
@ -132,3 +129,6 @@ and
.Fn ftruncate
function calls appeared in
.Bx 4.2 .
.Sh BUGS
These calls should be generalized to allow ranges
of bytes in a file to be discarded.

4
lib/libc/sys/utrace.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: utrace.2,v 1.5 2001/09/16 01:39:03 wiz Exp $
.\" $NetBSD: utrace.2,v 1.6 2001/09/16 02:13:32 wiz Exp $
.\"
.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -56,7 +56,7 @@ The record is identified by
and contains
.Fa len
bytes from memory pointed to by
.Fa addr.
.Fa addr .
This call has only effect if the caller process is being traced.
.Sh RETURN VALUES
Upon successful completion, a value of 0 is returned.

29
lib/libc/sys/vfork.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: vfork.2,v 1.15 2001/09/16 01:39:03 wiz Exp $
.\" $NetBSD: vfork.2,v 1.16 2001/09/16 02:13:32 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -97,14 +97,27 @@ parent processes standard I/O data structures (even with
it is wrong to call
.Xr exit 3
since buffered data would then be flushed twice).
.Sh RETURN VALUES and ERRORS
.Sh RETURN VALUES
Same as for
.Xr fork 2 .
.Sh ERRORS
Same as for
.Xr fork 2 .
.Sh SEE ALSO
.Xr fork 2 ,
.Xr execve 2 ,
.Xr fork 2 ,
.Xr sigaction 2 ,
.Xr wait 2
.Sh HISTORY
The
.Fn vfork
function call appeared in
.Bx 3.0 .
In
.Bx 4.4 ,
the semantics were changed to only suspend the parent.
The original semantics were reintroduced in
.Nx 1.4 .
.Sh BUGS
.\" XXX We reintroduced the original semantics.
.\" This system call will be eliminated when proper system sharing
@ -124,13 +137,3 @@ or
signals; rather, output or
.Xr ioctl 2
calls are allowed and input attempts result in an end-of-file indication.
.Sh HISTORY
The
.Fn vfork
function call appeared in
.Bx 3.0 .
In
.Bx 4.4 ,
the semantics were changed to only suspend the parent.
The original semantics were reintroduced in
.Nx 1.4 .

8
lib/libc/sys/wait.2
View File

@ -1,4 +1,4 @@
.\" $NetBSD: wait.2,v 1.15 2001/09/16 01:39:03 wiz Exp $
.\" $NetBSD: wait.2,v 1.16 2001/09/16 02:13:32 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993, 1994
.\" The Regents of the University of California. All rights reserved.
@ -306,6 +306,9 @@ will fail and return immediately if:
An invalid value was specified for
.Fa options .
.El
.Sh SEE ALSO
.Xr _exit 2 ,
.Xr sigaction 2
.Sh STANDARDS
The
.Fn wait
@ -325,9 +328,6 @@ macro
and the ability to restart a pending
.Fn wait
call are extensions to the POSIX interface.
.Sh SEE ALSO
.Xr _exit 2 ,
.Xr sigaction 2
.Sh HISTORY
A
.Fn wait