Updated CONFORMING TO and/or standards references

This commit is contained in:
Michael Kerrisk 2006-08-04 09:41:28 +00:00
parent e49f411f31
commit 9d9dc1e854
38 changed files with 121 additions and 68 deletions

View File

@ -248,12 +248,12 @@ may be seen during a trace.
SVr4, 4.4BSD
.RB ( accept ()
first appeared in 4.2BSD).
The BSD man page documents five possible error returns
(EBADF, ENOTSOCK, EOPNOTSUPP, EWOULDBLOCK, EFAULT).
POSIX.1-2001 documents errors
EAGAIN, EBADF, ECONNABORTED, EINTR, EINVAL, EMFILE,
ENFILE, ENOBUFS, ENOMEM, ENOTSOCK, EOPNOTSUPP, EPROTO, EWOULDBLOCK.
In addition, SUSv2 documents EFAULT and ENOSR.
.\" The BSD man page documents five possible error returns
.\" (EBADF, ENOTSOCK, EOPNOTSUPP, EWOULDBLOCK, EFAULT).
.\" POSIX.1-2001 documents errors
.\" EAGAIN, EBADF, ECONNABORTED, EINTR, EINVAL, EMFILE,
.\" ENFILE, ENOBUFS, ENOMEM, ENOTSOCK, EOPNOTSUPP, EPROTO, EWOULDBLOCK.
.\" In addition, SUSv2 documents EFAULT and ENOSR.
.LP
On Linux, the new socket returned by
.BR accept ()

View File

@ -115,7 +115,7 @@ refers to a file on a read-only file system.
.B EUSERS
There are no more free file structures or we ran out of memory.
.SH "CONFORMING TO"
SVr4 (but not POSIX).
SVr4, 4.3BSD (but not POSIX).
.\" SVr4 documents an EBUSY error condition, but no EISDIR or ENOSYS.
.\" Also AIX and HP-UX document EBUSY (attempt is made
.\" to enable accounting when it is already enabled), as does Solaris

View File

@ -260,14 +260,14 @@ The transparent proxy options are not described.
SVr4, 4.4BSD (the
.BR bind ()
function first appeared in 4.2BSD).
SVr4 documents an additional
.B ENOSR
general error condition, and
additional
.B EIO
and
.B EISDIR
Unix-domain error conditions.
.\" SVr4 documents an additional
.\" .B ENOSR
.\" general error condition, and
.\" additional
.\" .B EIO
.\" and
.\" .B EISDIR
.\" Unix-domain error conditions.
.SH NOTE
The third argument of
.BR bind ()

View File

@ -136,6 +136,8 @@ instead of 0.)
.TP
.B ESRCH
No such thread.
.SH "CONFORMING TO"
These system calls are Linux specific.
.SH "FURTHER INFORMATION"
The portable interface to the capability querying and setting
functions is provided by the

View File

@ -213,18 +213,19 @@ be very long when syncookies are enabled on the server.
.SH "CONFORMING TO"
SVr4, 4.4BSD (the
.BR connect ()
function first appeared in 4.2BSD). SVr4 documents the additional
general error codes
.BR EADDRNOTAVAIL ,
.BR EINVAL ,
.BR EAFNOSUPPORT ,
.BR EALREADY ,
.BR EINTR ,
.BR EPROTOTYPE ,
and
.BR ENOSR .
It also
documents many additional error conditions not described here.
function first appeared in 4.2BSD).
.\" SVr4 documents the additional
.\" general error codes
.\" .BR EADDRNOTAVAIL ,
.\" .BR EINVAL ,
.\" .BR EAFNOSUPPORT ,
.\" .BR EALREADY ,
.\" .BR EINTR ,
.\" .BR EPROTOTYPE ,
.\" and
.\" .BR ENOSR .
.\" It also
.\" documents many additional error conditions not described here.
.SH NOTE
The third argument of
.BR connect ()

View File

@ -33,13 +33,12 @@ This system call is equivalent to
.BR exit (2)
except that it terminates not only the present thread, but all threads
in the current thread group.
.SH "RETURN VALUE"
This system call does not return.
.SH HISTORY
This call is present since Linux 2.5.35.
.SH "CONFORMING TO"
This call is Linux specific.
.SH "SEE ALSO"
.BR exit (2)

View File

@ -86,7 +86,7 @@ is defined in <unistd.h> to a value greater than 0. (See also
.\" -1: unavailable, 0: ask using sysconf().
.\" glibc defines them to 1.
.SH "CONFORMING TO"
POSIX.1b
POSIX.1-2001.
.SH "SEE ALSO"
.BR fsync (2)
.BR sync_file_range (2),

View File

@ -128,7 +128,7 @@ An alternative might be to use the
flag to
.BR open (2).
.SH "CONFORMING TO"
POSIX.1b
POSIX.1-2001
.SH "SEE ALSO"
.BR bdflush (2),
.BR open (2),

View File

@ -10,15 +10,18 @@
.SH NAME
futex \- Fast Userspace Locking system call
.SH SYNOPSIS
.nf
.sp
.B "#include <linux/futex.h>"
.sp
.B "#include <sys/time.h>"
.sp
.BI "int futex (int *" uaddr ", int " op ", int " val ,
.BI "const struct timespec *" timeout ,
.BI "int *" uaddr2 ", int " val3 );
.BI "int futex(int *" uaddr ", int " op ", int " val \
", const struct timespec *" timeout ,
.br
.BI " int *" uaddr2 ", int " val3 );
.\" int *? void *? u32 *?
.fi
.SH "DESCRIPTION"
.PP
The
@ -197,6 +200,8 @@ from what was described above. A 4-parameter system call with the semantics
given here was introduced in Linux 2.5.40. In Linux 2.5.70 one parameter
was added. In Linux 2.6.7 a sixth parameter was added \(em messy, especially
on the s390 architecture.
.SH "CONFORMING TO"
This system call is Minux specific.
.SH "SEE ALSO"
.PP
.BR futex (7),

View File

@ -24,9 +24,12 @@
get_mempolicy \- Retrieve NUMA memory policy for a process
.SH NAME
.B "#include <numaif.h>"
.nf
.sp
.BI "int get_mempolicy(int *" policy ", unsigned long *" nodemask ,
.BI "unsigned long " maxnode ", unsigned long " addr ", unsigned long " flags )
.BI " unsigned long " maxnode ", unsigned long " addr ,
.BI " unsigned long " flags );
.fi
.\" TBD rewrite this. it is confusing.
.SH DESCRIPTION
.BR get_mempolicy ()
@ -110,7 +113,6 @@ The bit number is always rounded to a multiple of
For an overview of the possible policies see
.BR set_mempolicy (2).
.SH RETURN VALUE
On success,
.BR get_mempolicy ()
@ -118,7 +120,6 @@ returns 0;
on error, \-1 is returned and
.I errno
is set to indicate the error.
.\" .SH ERRORS
.\" FIXME writeme -- no errors are listed on this page
.\" .
@ -153,11 +154,11 @@ This is deliberate: this flag is not intended for application use,
and its operation may change or it may be removed altogether in
future kernel versions.
.B Do not use it.
.SH "VERSIONS AND LIBRARY SUPPORT"
See
.BR mbind (2).
.SH CONFORMING TO
This system call is Linux specific.
.SH SEE ALSO
.BR mbind (2),
.BR set_mempolicy (2),

View File

@ -11,7 +11,7 @@ get_thread_area \- Get a Thread Local Storage (TLS) area
.br
.B #include <asm/ldt.h>
.sp
.BI "int get_thread_area (struct user_desc *" u_info );
.BI "int get_thread_area(struct user_desc *" u_info );
.SH "DESCRIPTION"
.BR get_thread_area ()

View File

@ -126,6 +126,8 @@ is set to ENOTSUP.
The errors documented for the
.BR stat (2)
system call are also applicable here.
.SH "CONFORMING TO"
These system calls are Linux specific.
.SH AUTHORS
Andreas Gruenbacher,
.RI < a.gruenbacher@computer.org >

View File

@ -308,6 +308,8 @@ Suitable definitions can be found in
.SH VERSIONS
These system calls have been available on Linux since
kernel 2.6.13.
.SH "CONFORMING TO"
These system calls are Linux specific.
.SH "SEE ALSO"
.BR getpriority "(2), " open "(2), " capabilities (7)
.sp

View File

@ -137,6 +137,8 @@ is set to ENOTSUP.
The errors documented for the
.BR stat (2)
system call are also applicable here.
.SH "CONFORMING TO"
These system calls are Linux specific.
.SH AUTHORS
Andreas Gruenbacher,
.RI < a.gruenbacher@computer.org >

View File

@ -151,7 +151,6 @@ returns 0;
on error, \-1 is returned and
.I errno
is set to indicate the error.
.SH ERRORS
.TP
.B EFAULT
@ -191,7 +190,6 @@ System out of memory.
.B MPOL_MF_STRICT
was specified and an existing page was already on a node
that does not follow the policy.
.SH NOTES
NUMA policy is not supported on file mappings.
@ -216,7 +214,6 @@ of
.B MPOL_PREFERRED
with an empty
.IR nodemask .
.SH "VERSIONS AND LIBRARY SUPPORT"
The
.BR mbind (),
@ -257,7 +254,8 @@ package.
This package also has the
.I numaif.h
header.
.SH CONFORMING TO
This system call is Linux specific.
.SH SEE ALSO
.BR numa (3),
.BR numactl (8),

View File

@ -76,6 +76,8 @@ On 32-bit systems,
is used to implement the
.BR mmap64 ()
function that is part of the LFS (Large File Summit).
.SH "CONFORMING TO"
This system call is Linux specific.
.SH "SEE ALSO"
.BR getpagesize (2),
.BR mmap (2),

View File

@ -94,6 +94,8 @@ is set to ENOTSUP.
The errors documented for the
.BR stat (2)
system call are also applicable here.
.SH "CONFORMING TO"
These system calls are Linux specific.
.SH AUTHORS
Andreas Gruenbacher,
.RI < a.gruenbacher@computer.org >

View File

@ -27,7 +27,7 @@ set_mempolicy \- Set default NUMA memory policy for a process and its children.
.B "#include <numaif.h>"
.sp
.BI "int set_mempolicy(int " policy ", unsigned long *" nodemask ,
.BI "unsigned long " maxnode )
.BI "unsigned long " maxnode );
.sp
.SH DESCRIPTION
.BR set_mempolicy ()
@ -100,10 +100,8 @@ The memory policy is inherited by child processes created using
.BR fork (2)
or
.BR clone (2).
.SH NOTES
Process policy is not remembered if the page is swapped out.
.SH RETURN VALUE
On success,
.BR set_mempolicy ()
@ -121,7 +119,8 @@ is set to indicate the error.
.SH "VERSIONS AND LIBRARY SUPPORT"
See
.BR mbind (2).
.SH CONFORMING TO
This system call is Linux specific.
.SH SEE ALSO
.BR mbind (2),
.BR get_mempolicy (2),

View File

@ -126,6 +126,8 @@ is set to ENOTSUP.
The errors documented for the
.BR stat (2)
system call are also applicable here.
.SH "CONFORMING TO"
These system calls are Linux specific.
.SH AUTHORS
Andreas Gruenbacher,
.RI < a.gruenbacher@computer.org >

View File

@ -30,7 +30,7 @@ It is locale dependent and therefore not a compile-time constant.
An integer >= 1 and <= MB_LEN_MAX.
The value 1 denotes traditional 8-bit encoded characters.
.SH "CONFORMING TO"
ANSI C, POSIX.1
C99, POSIX.1-2001.
.SH "SEE ALSO"
.BR MB_LEN_MAX (3),
.BR mblen (3),

View File

@ -27,7 +27,7 @@ wide character, across all locales.
.SH "RETURN VALUE"
A constant integer >= 1.
.SH "CONFORMING TO"
ANSI C, POSIX.1
C99, POSIX.1-2001.
.SH NOTES
The entities
.B MB_LEN_MAX

View File

@ -54,7 +54,11 @@ value is mathematically defined to be between 0 and PI (inclusive).
\fIx\fP is out of range.
.SH "CONFORMING TO"
SVr4, POSIX.1-2001, 4.3BSD, C89.
The float and long double variants are C99 requirements.
The
.I float
and
.I "long double"
variants are C99 requirements.
.SH "SEE ALSO"
.BR asin (3),
.BR atan (3),

View File

@ -54,7 +54,11 @@ is set.
\fIx\fP is out of range.
.SH "CONFORMING TO"
SVr4, POSIX.1-2001, 4.3BSD, C89.
The float and long double variants are C99 requirements.
The
.I float
and
.I "long double"
variants are C99 requirements.
.SH "SEE ALSO"
.BR asinh (3),
.BR atanh (3),

View File

@ -57,7 +57,11 @@ value is mathematically defined to be between \-PI/2 and PI/2
\fIx\fP is out of range.
.SH "CONFORMING TO"
SVr4, POSIX.1-2001, 4.3BSD, C89.
The float and long double variants are C99 requirements.
The
.I float
and
.I "long double"
variants are C99 requirements.
.SH "SEE ALSO"
.BR acos (3),
.BR casin (3),

View File

@ -48,7 +48,11 @@ The \fBasinh\fP() function calculates the inverse hyperbolic sine of
\fIx\fP; that is the value whose hyperbolic sine is \fIx\fP.
.SH "CONFORMING TO"
SVr4, POSIX.1-2001, 4.3BSD, C89.
The float and long double variants are C99 requirements.
The
.I float
and
.I "long double"
variants are C99 requirements.
.SH "SEE ALSO"
.BR acosh (3),
.BR atanh (3),

View File

@ -52,7 +52,11 @@ value is mathematically defined to be between \-PI/2 and PI/2
(inclusive).
.SH "CONFORMING TO"
SVr4, POSIX.1-2001, 4.3BSD, C89.
The float and long double variants are C99 requirements.
The
.I float
and
.I "long double"
variants are C99 requirements.
.SH "SEE ALSO"
.BR acos (3),
.BR asin (3),

View File

@ -53,7 +53,11 @@ The \fBatan2\fP() function returns the result in radians, which
is between \-PI and PI (inclusive).
.SH "CONFORMING TO"
SVr4, POSIX.1-2001, 4.3BSD, C89.
The float and long double variants are C99 requirements.
The
.I float
and
.I "long double"
variants are C99 requirements.
.SH "SEE ALSO"
.BR acos (3),
.BR asin (3),

View File

@ -54,7 +54,11 @@ not-a-number (NaN) and \fIerrno\fP is set.
\fIx\fP is out of range.
.SH "CONFORMING TO"
SVr4, POSIX.1-2001, 4.3BSD, C89.
The float and long double variants are C99 requirements.
The
.I float
and
.I "long double"
variants are C99 requirements.
.SH "SEE ALSO"
.BR acosh (3),
.BR asinh (3),

View File

@ -30,7 +30,7 @@ The \fBbtowc\fP() function returns the wide character converted from the single
byte \fIc\fP. If \fIc\fP is EOF or not a valid multibyte sequence of length 1,
it returns WEOF.
.SH "CONFORMING TO"
ISO/ANSI C, POSIX.1-2001.
C99, POSIX.1-2001.
.SH "SEE ALSO"
.BR mbtowc (3)
.SH NOTES

View File

@ -59,7 +59,11 @@ The \fBerfc\fP() function returns the complementary error function of
\fIx\fP, that is 1.0 \- erf(x).
.SH "CONFORMING TO"
SVr4, 4.3BSD, C99.
The float and long double variants are requirements of C99.
The
.I float
and
.I "long double"
variants are requirements of C99.
.SH "SEE ALSO"
.BR cerf (3),
.BR exp (3)

View File

@ -48,7 +48,7 @@ Apart from the usual ones, there is
The data obtained from the input stream does not
form a valid character.
.SH "CONFORMING TO"
ISO/ANSI C, POSIX.1-2001.
C99, POSIX.1-2001.
.SH NOTES
The behaviour of \fBfgetwc\fP() depends on the LC_CTYPE category of the
current locale.

View File

@ -37,7 +37,7 @@ For a non-locking counterpart, see
The \fBfgetws\fP() function, if successful, returns \fIws\fP. If end of stream
was already reached or if an error occurred, it returns NULL.
.SH "CONFORMING TO"
ISO/ANSI C, POSIX.1-2001.
C99, POSIX.1-2001.
.SH NOTES
The behaviour of \fBfgetws\fP() depends on the LC_CTYPE category of the
current locale.

View File

@ -45,7 +45,7 @@ Apart from the usual ones, there is
.B EILSEQ
Conversion of \fIwc\fP to the stream's encoding fails.
.SH "CONFORMING TO"
ISO/ANSI C, POSIX.1-2001.
C99, POSIX.1-2001.
.SH NOTES
The behaviour of \fBfputwc\fP() depends on the LC_CTYPE category of the
current locale.

View File

@ -31,7 +31,7 @@ For a non-locking counterpart, see
The \fBfputws\fP() function returns a nonnegative integer if the operation was
successful, or \-1 to indicate an error.
.SH "CONFORMING TO"
ISO/ANSI C, POSIX.1-2001.
C99, POSIX.1-2001.
.SH NOTES
The behaviour of \fBfputws\fP() depends on the LC_CTYPE category of the
current locale.

View File

@ -43,7 +43,7 @@ The \fBfwide\fP() function returns the stream's orientation, after possibly
changing it. A return value > 0 means wide-character oriented. A return value
< 0 means byte oriented. A return value of zero means undecided.
.SH "CONFORMING TO"
ISO/ANSI C, UNIX98, POSIX.1-2001.
ISO/ANSI C, POSIX.1-2001.
.SH "SEE ALSO"
.BR fprintf (3),
.BR fwprintf (3)

View File

@ -96,7 +96,11 @@ and
are from C99.
The function
.BR drem ()
is from 4.3BSD. The float and long double variants
is from 4.3BSD. The
.I float
and
.I "long double"
variants
.BR dremf ()
and
.BR dreml ()

View File

@ -59,7 +59,7 @@ For example, this program uses \fBstpcpy\fP() to concatenate \fBfoo\fP and
}
.fi
.SH "CONFORMING TO"
This function is not part of the ANSI or POSIX standards, and is
This function is not part of the C or POSIX.1 standards, and is
not customary on Unix systems, but is not a GNU invention either.
Perhaps it comes from MS-DOS.
.SH "SEE ALSO"

View File

@ -53,7 +53,7 @@ that is, it returns the original value of *\fIstringp\fP.
.SH NOTES
The \fBstrsep\fP() function was introduced as a replacement for
\fBstrtok\fP(), since the latter cannot handle empty fields.
However, \fBstrtok\fP() conforms to ANSI-C and hence is more portable.
However, \fBstrtok\fP() conforms to C89/C99 and hence is more portable.
.SH BUGS
This function suffers from the same problems as \fBstrtok\fP().
In particular, it modifies the original string. Avoid it.