summaryrefslogtreecommitdiff
path: root/lib/libc/sys
diff options
context:
space:
mode:
authorJason McIntyre <jmc@cvs.openbsd.org>2003-06-01 21:23:16 +0000
committerJason McIntyre <jmc@cvs.openbsd.org>2003-06-01 21:23:16 +0000
commit5bb8532920b9cdcd0f69a42ea2ec1d729c9c78a0 (patch)
treec49661b7b449e0d9f658a26488fe656d5b547e98 /lib/libc/sys
parent6cad64ba11b340a6a8a2838ee73a6ed19c7781e0 (diff)
- section reorder
- macro cleanup
Diffstat (limited to 'lib/libc/sys')
-rw-r--r--lib/libc/sys/msync.210
-rw-r--r--lib/libc/sys/quotactl.212
-rw-r--r--lib/libc/sys/read.236
-rw-r--r--lib/libc/sys/rfork.24
-rw-r--r--lib/libc/sys/select.214
-rw-r--r--lib/libc/sys/setpgid.212
-rw-r--r--lib/libc/sys/setreuid.24
-rw-r--r--lib/libc/sys/sigaction.234
-rw-r--r--lib/libc/sys/sigsuspend.24
-rw-r--r--lib/libc/sys/socketpair.222
10 files changed, 76 insertions, 76 deletions
diff --git a/lib/libc/sys/msync.2 b/lib/libc/sys/msync.2
index 06e6eb78905..1b85b2ba85e 100644
--- a/lib/libc/sys/msync.2
+++ b/lib/libc/sys/msync.2
@@ -1,4 +1,4 @@
-.\" $OpenBSD: msync.2,v 1.15 1999/06/29 14:10:10 aaron Exp $
+.\" $OpenBSD: msync.2,v 1.16 2003/06/01 21:23:15 jmc Exp $
.\" $NetBSD: msync.2,v 1.8 1995/10/12 15:41:09 jtc Exp $
.\"
.\" Copyright (c) 1991, 1993
@@ -112,10 +112,6 @@ which are unmapped.
.It Bq Er EIO
An I/O error occurred while writing.
.El
-.Sh BUGS
-Writes are currently done synchronously even if the
-.Dv MS_ASYNC
-flag is specified.
.Sh SEE ALSO
.Xr madvise 2 ,
.Xr mincore 2 ,
@@ -129,3 +125,7 @@ function first appeared in
.Bx 4.4 .
It was modified to conform to
.St -p1003.1b-93
+.Sh BUGS
+Writes are currently done synchronously even if the
+.Dv MS_ASYNC
+flag is specified.
diff --git a/lib/libc/sys/quotactl.2 b/lib/libc/sys/quotactl.2
index 24cadbb6f08..3ffa4a3c70f 100644
--- a/lib/libc/sys/quotactl.2
+++ b/lib/libc/sys/quotactl.2
@@ -1,4 +1,4 @@
-.\" $OpenBSD: quotactl.2,v 1.8 2000/04/24 05:19:01 deraadt Exp $
+.\" $OpenBSD: quotactl.2,v 1.9 2003/06/01 21:23:15 jmc Exp $
.\" $NetBSD: quotactl.2,v 1.8 1995/02/27 12:35:43 cgd Exp $
.\"
.\" Copyright (c) 1983, 1990, 1991, 1993
@@ -207,14 +207,14 @@ The call was privileged and the caller was not the superuser.
.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 .
diff --git a/lib/libc/sys/read.2 b/lib/libc/sys/read.2
index acbaf4b6c8f..7b5962c66d3 100644
--- a/lib/libc/sys/read.2
+++ b/lib/libc/sys/read.2
@@ -1,4 +1,4 @@
-.\" $OpenBSD: read.2,v 1.22 2003/02/28 21:34:37 jmc Exp $
+.\" $OpenBSD: read.2,v 1.23 2003/06/01 21:23:15 jmc Exp $
.\" $NetBSD: read.2,v 1.6 1995/02/27 12:35:47 cgd Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
@@ -228,6 +228,23 @@ and
.Fn pread
functions conform to
.St -xpg4.2 .
+.Sh HISTORY
+The
+.Fn preadv
+function first appeared in
+.Ox 2.7 .
+The
+.Fn pread
+function appeared in
+.At V.4 .
+The
+.Fn readv
+function call appeared in
+.Bx 4.2 .
+The
+.Fn read
+function call appeared in
+.At v2 .
.Sh CAVEATS
Error checks should explicitly test for \-1.
Code such as
@@ -248,20 +265,3 @@ Proper loops should use
.Bd -literal
while ((nr = read(fd, buf, sizeof(buf))) != -1 && nr != 0)
.Ed
-.Sh HISTORY
-The
-.Fn preadv
-function first appeared in
-.Ox 2.7 .
-The
-.Fn pread
-function appeared in
-.At V.4 .
-The
-.Fn readv
-function call appeared in
-.Bx 4.2 .
-The
-.Fn read
-function call appeared in
-.At v2 .
diff --git a/lib/libc/sys/rfork.2 b/lib/libc/sys/rfork.2
index 544d41db4bc..3039c3f2187 100644
--- a/lib/libc/sys/rfork.2
+++ b/lib/libc/sys/rfork.2
@@ -1,4 +1,4 @@
-.\" $OpenBSD: rfork.2,v 1.17 2002/11/28 21:50:13 brad Exp $
+.\" $OpenBSD: rfork.2,v 1.18 2003/06/01 21:23:15 jmc Exp $
.\"
.\" This manual page is taken directly from Plan9, and modified to
.\" describe the actual OpenBSD implementation. Permission for
@@ -89,7 +89,7 @@ will sleep, if necessary, until required process resources are available.
.Pp
.Fn fork
can be implemented as a call to
-.Xr rfork 2
+.Fn rfork
using "RFFDG|RFPROC"
but isn't for backwards compatibility.
If a process has file descriptor table sharing active, setuid or setgid
diff --git a/lib/libc/sys/select.2 b/lib/libc/sys/select.2
index 9c9c5a9f66c..bf0753139e3 100644
--- a/lib/libc/sys/select.2
+++ b/lib/libc/sys/select.2
@@ -1,4 +1,4 @@
-.\" $OpenBSD: select.2,v 1.21 2002/11/19 20:57:13 millert Exp $
+.\" $OpenBSD: select.2,v 1.22 2003/06/01 21:23:15 jmc Exp $
.\" $NetBSD: select.2,v 1.5 1995/06/27 22:32:28 cgd Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
@@ -167,6 +167,11 @@ One of its components is 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
@@ -241,7 +246,7 @@ call, and the caller should reinitialize it on each invocation.
Calculating the delta is easily done by calling
.Xr gettimeofday 2
before and after the call to
-.Fn select Ns ,
+.Fn select ,
and using
.Fn timersub
(as described in
@@ -253,8 +258,3 @@ works poorly if multiple processes wait on the same file descriptor.
Given that, it is rather surprising to see that many daemons are
written that way (i.e.,
.Xr httpd 8 ) .
-.Sh HISTORY
-The
-.Fn select
-function call appeared in
-.Bx 4.2 .
diff --git a/lib/libc/sys/setpgid.2 b/lib/libc/sys/setpgid.2
index 3408259db30..69ef2d151e7 100644
--- a/lib/libc/sys/setpgid.2
+++ b/lib/libc/sys/setpgid.2
@@ -1,4 +1,4 @@
-.\" $OpenBSD: setpgid.2,v 1.8 2000/04/15 11:46:04 aaron Exp $
+.\" $OpenBSD: setpgid.2,v 1.9 2003/06/01 21:23:15 jmc Exp $
.\" $NetBSD: setpgid.2,v 1.8 1995/02/27 12:36:55 cgd Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
@@ -92,14 +92,14 @@ child process of the calling process.
.Sh SEE ALSO
.Xr getpgrp 2
.Sh STANDARDS
-The
-.Fn setpgid
-function conforms to
-.St -p1003.1-88 .
-.Sh COMPATIBILITY
.Fn setpgrp
is identical to
.Fn setpgid ,
and is retained for calling convention compatibility with historical
versions of
.Bx .
+.Pp
+The
+.Fn setpgid
+function conforms to
+.St -p1003.1-88 .
diff --git a/lib/libc/sys/setreuid.2 b/lib/libc/sys/setreuid.2
index 60df37991a3..7ddc7fde482 100644
--- a/lib/libc/sys/setreuid.2
+++ b/lib/libc/sys/setreuid.2
@@ -1,3 +1,5 @@
+.\" $OpenBSD: setreuid.2,v 1.2 2003/06/01 21:23:15 jmc Exp $
+.\"
.\" Copyright (c) 1980, 1991, 1993, 1994
.\" The Regents of the University of California. All rights reserved.
.\"
@@ -116,7 +118,7 @@ The current version, with the original semantics restored, appeared in
The
.Fn setreuid
function predates
-.Tn POSIX
+.Tn POSIX
saved user IDs.
This implementation changes the saved user ID to the new value of
the effective user ID if the real user ID is changed.
diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2
index 3487b79bd58..3be3fc336d9 100644
--- a/lib/libc/sys/sigaction.2
+++ b/lib/libc/sys/sigaction.2
@@ -1,4 +1,4 @@
-.\" $OpenBSD: sigaction.2,v 1.37 2003/05/12 14:40:13 jmc Exp $
+.\" $OpenBSD: sigaction.2,v 1.38 2003/06/01 21:23:15 jmc Exp $
.\" $NetBSD: sigaction.2,v 1.7 1995/10/12 15:41:16 jtc Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
@@ -124,7 +124,7 @@ must arrange to restore the previous context itself.
When a signal is delivered to a process a new signal mask is
installed for the duration of the process' signal handler
(or until a
-.Xr sigprocmask
+.Xr sigprocmask 2
call is made).
This mask is formed by taking the union of the current signal mask set,
the signal to be delivered, and the signal mask
@@ -544,6 +544,20 @@ 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 wait 2 ,
+.Xr setjmp 3 ,
+.Xr sigblock 3 ,
+.Xr sigpause 3 ,
+.Xr sigsetops 3 ,
+.Xr sigvec 3 ,
+.Xr tty 4
.Sh STANDARDS
The
.Fn sigaction
@@ -694,7 +708,6 @@ Extension Interfaces:
.Fn strlcat ,
.Fn strlcpy .
.Pp
-.Pp
Most functions not in the above lists are considered to be unsafe
with respect to signals.
That is to say, the behaviour of such functions when called from
@@ -717,18 +730,3 @@ Safe if the
.Va syslog_data
struct is initialized as a local variable.
.El
-.Pp
-.Sh SEE ALSO
-.Xr kill 1 ,
-.Xr kill 2 ,
-.Xr ptrace 2 ,
-.Xr sigaltstack 2 ,
-.Xr sigprocmask 2 ,
-.Xr sigsuspend 2 ,
-.Xr wait 2 ,
-.Xr setjmp 3 ,
-.Xr sigblock 3 ,
-.Xr sigpause 3 ,
-.Xr sigsetops 3 ,
-.Xr sigvec 3 ,
-.Xr tty 4
diff --git a/lib/libc/sys/sigsuspend.2 b/lib/libc/sys/sigsuspend.2
index 8ef998085d3..ca2cd0e7769 100644
--- a/lib/libc/sys/sigsuspend.2
+++ b/lib/libc/sys/sigsuspend.2
@@ -1,4 +1,4 @@
-.\" $OpenBSD: sigsuspend.2,v 1.7 2000/10/18 05:12:12 aaron Exp $
+.\" $OpenBSD: sigsuspend.2,v 1.8 2003/06/01 21:23:15 jmc Exp $
.\" $NetBSD: sigsuspend.2,v 1.4 1995/02/27 12:37:46 cgd Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
@@ -62,7 +62,7 @@ of the signal are examined to determine that there is no work
to be done, and the process pauses awaiting work by using
.Fn sigsuspend
with the previous mask returned by
-.Xr sigprocmask .
+.Xr sigprocmask 2 .
.Sh RETURN VALUES
The
.Fn sigsuspend
diff --git a/lib/libc/sys/socketpair.2 b/lib/libc/sys/socketpair.2
index d2f39432b07..ba6fb588b4b 100644
--- a/lib/libc/sys/socketpair.2
+++ b/lib/libc/sys/socketpair.2
@@ -1,4 +1,4 @@
-.\" $OpenBSD: socketpair.2,v 1.10 1999/07/06 18:21:04 deraadt Exp $
+.\" $OpenBSD: socketpair.2,v 1.11 2003/06/01 21:23:15 jmc Exp $
.\" $NetBSD: socketpair.2,v 1.5 1995/02/27 12:38:00 cgd Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
@@ -86,6 +86,16 @@ The system file table is full.
.Xr pipe 2 ,
.Xr read 2 ,
.Xr write 2
+.Sh STANDARDS
+The
+.Fn socketpair
+function conforms to
+.St -xpg4.2 .
+.Sh HISTORY
+The
+.Fn socketpair
+function call appeared in
+.Bx 4.2 .
.Sh BUGS
This call is currently implemented only for the
.Tn LOCAL
@@ -97,13 +107,3 @@ of
so that should be used instead of
.Ev PF_LOCAL
for maximal portability.
-.Sh STANDARDS
-The
-.Fn socketpair
-function conforms to
-.St -xpg4.2 .
-.Sh HISTORY
-The
-.Fn socketpair
-function call appeared in
-.Bx 4.2 .