LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

Relocated LINUX NOTES as subsection under NOTES

This commit is contained in:
Michael Kerrisk 2007-05-18 10:39:45 +00:00
parent d597239cbd
commit 4fb3134194
16 changed files with 50 additions and 43 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
man2/access.2
View File

@ -154,7 +154,8 @@ Insufficient kernel memory was available.
.B ETXTBSY
Write access was requested to an executable which is being
executed.
.SH "LINUX NOTES"
.SH "NOTES"
.SS Linux Notes
In kernels before 2.6.20,
.BR access ()
ignored the effect of the

4
man2/brk.2
View File

@ -62,7 +62,7 @@ On error, \-1 is returned, and
.I errno
is set to
.BR ENOMEM .
(But see LINUX NOTES below.)
(But see \fILinux Notes\fP below.)
On success,
.BR sbrk ()
@ -89,7 +89,7 @@ Common are \fIint\fP, \fIssize_t\fP, \fIptrdiff_t\fP, \fIintptr_t\fP.
.\" \fIptrdiff_t\fP (libc4, libc5, ulibc, glibc 2.0, 2.1),
.\" \fIintptr_t\fP (e.g. XPGv5, AIX, SunOS 5.8, 5.9, FreeBSD 4.7, NetBSD 1.6,
.\" Tru64 5.1, glibc2.2).
.SH LINUX NOTES
.SS Linux Notes
The return value described above for
.BR brk ()
is the behaviour provided by the glibc wrapper function for the Linux

2
man2/kill.2
View File

@ -125,7 +125,7 @@ has it unblocked or is waiting for it in
at least one
unblocked signal must be delivered to the sending thread before the
.BR kill ().
.SH "LINUX NOTES"
.SS "Linux Notes"
Across different kernel versions, Linux has enforced different rules
for the permissions required for an unprivileged process
to send a signal to another process.

3
man2/madvise.2
View File

@ -166,7 +166,8 @@ maximum resident set size.
.B ENOMEM
Addresses in the specified range are not currently
mapped, or are outside the address space of the process.
.SH "LINUX NOTES"
.SH NOTES
.SH "Linux Notes"
.LP
The current Linux implementation (2.4.0) views this system call
more as a command than as advice and hence may return an error

2
man2/mlock.2
View File

@ -170,7 +170,7 @@ for the corresponding range or by
Pages which are mapped to several locations or by several processes stay
locked into RAM as long as they are locked at least at one location or by
at least one process.
.SH "LINUX NOTES"
.SS "Linux Notes"
Under Linux,
.BR mlock ()
and

8
man2/msgget.2
View File

@ -202,15 +202,15 @@ System wide maximum number of message queues: policy
dependent
(on Linux, this limit can be read and modified via
.IR /proc/sys/kernel/msgmni ).
.SS "Linux Notes"
Until version 2.3.20 Linux would return EIDRM for a
.BR msgget ()
on a message queue scheduled for deletion.
.SH BUGS
The name choice IPC_PRIVATE was perhaps unfortunate, IPC_NEW
would more clearly show its function.
.SH "CONFORMING TO"
SVr4, POSIX.1-2001.
.SH "LINUX NOTES"
Until version 2.3.20 Linux would return EIDRM for a
.BR msgget ()
on a message queue scheduled for deletion.
.SH "SEE ALSO"
.BR msgctl (2),
.BR msgrcv (2),

28
man2/poll.2
View File

@ -263,20 +263,6 @@ value exceeds the RLIMIT_NOFILE value.
.TP
.B ENOMEM
There was no space to allocate file descriptor tables.
.SH "LINUX NOTES"
The Linux
.BR ppoll ()
system call modifies its
.I timeout
argument.
However, the glibc wrapper function hides this behaviour
by using a local variable for the timeout argument that
is passed to the system call.
Thus, the glibc
.BR ppoll ()
function does not modify its
.I timeout
argument.
.SH BUGS
See the discussion of spurious readiness notifications under the
BUGS section of
@ -311,6 +297,20 @@ Some implementations define the non-standard constant
with the value \-1 for use as a
.IR timeout .
This constant is not provided in glibc.
.SS "Linux Notes"
The Linux
.BR ppoll ()
system call modifies its
.I timeout
argument.
However, the glibc wrapper function hides this behaviour
by using a local variable for the timeout argument that
is passed to the system call.
Thus, the glibc
.BR ppoll ()
function does not modify its
.I timeout
argument.
.SH "SEE ALSO"
.BR select (2),
.BR select_tut (2),

3
man2/readv.2
View File

@ -157,7 +157,8 @@ Linux libc5 used \fIsize_t\fR as the type of the \fIiovcnt\fR parameter,
and \fIint\fP as return type for these functions.
.\" The readv/writev system calls were buggy before Linux 1.3.40.
.\" (Says release.libc.)
.SH "LINUX NOTES"
.SH NOTES
.SS Linux Notes
POSIX.1-2001 allows an implementation to place a limit on
the number of items that can be passed in
.IR iov .

3
man2/sched_rr_get_interval.2
View File

@ -87,7 +87,8 @@ The system call is not yet implemented (only on rather old kernels).
The process whose ID is \fIpid\fR could not be found.
.SH "CONFORMING TO"
POSIX.1-2001.
.SH "LINUX NOTES"
.SH NOTES
.SS Linux Notes
POSIX does not specify any mechanism for controlling the size of the
round-robin time quantum.
However, Linux provides a (non-portable) method of doing this.

14
man2/select.2
View File

@ -425,13 +425,7 @@ is defined, under glibc 2.2.2-2.2.4 it gives it when
.B _XOPEN_SOURCE
is defined and has a value of 600 or larger.
No doubt, since POSIX.1-2001, it should give the prototype by default.
.SH VERSIONS
.BR pselect ()
was added to Linux in kernel 2.6.16.
Prior to this,
.BR pselect ()
was emulated in glibc (but see BUGS).
.SH "LINUX NOTES"
.SS "Linux Notes"
The Linux
.BR pselect ()
system call modifies its
@ -444,6 +438,12 @@ Thus, the glibc
.BR pselect ()
function does not modify its timeout argument;
this is the behaviour required by POSIX.1-2001.
.SH VERSIONS
.BR pselect ()
was added to Linux in kernel 2.6.16.
Prior to this,
.BR pselect ()
was emulated in glibc (but see BUGS).
.SH BUGS
Glibc 2.0 provided a version of
.BR pselect ()

3
man2/setuid.2
View File

@ -88,7 +88,8 @@ SVr4, POSIX.1-2001.
Not quite compatible with the 4.4BSD call, which
sets all of the real, saved, and effective user IDs.
.\" SVr4 documents an additional EINVAL error condition.
.SH LINUX NOTES
.SH NOTES
.SS Linux Notes
Linux has the concept of filesystem user ID, normally equal to the
effective user ID.
The

8
man2/shmget.2
View File

@ -266,16 +266,16 @@ on Linux, this limit can be read and modified via
The implementation has no specific limits for the per process maximum
number of shared memory segments
.RB ( SHMSEG ).
.SS Linux Notes
Until version 2.3.30 Linux would return EIDRM for a
.BR shmget ()
on a shared memory segment scheduled for deletion.
.SH BUGS
The name choice IPC_PRIVATE was perhaps unfortunate, IPC_NEW
would more clearly show its function.
.SH "CONFORMING TO"
SVr4, POSIX.1-2001.
.\" SVr4 documents an additional error condition EEXIST.
.SH LINUX NOTES
Until version 2.3.30 Linux would return EIDRM for a
.BR shmget ()
on a shared memory segment scheduled for deletion.
.B SHM_HUGETLB
is a non-portable Linux extension.

3
man2/stat.2
View File

@ -249,7 +249,8 @@ The `sticky' bit (S_ISVTX) on a directory means that a file
in that directory can be renamed or deleted only by the owner
of the file, by the owner of the directory, and by a privileged
process.
.SH "LINUX NOTES"
.SH NOTES
.SS Linux Notes
Since kernel 2.5.48, the
.I stat
structure supports nanosecond resolution for the three

3
man2/vfork.2
View File

@ -172,7 +172,8 @@ or
.BR _exit (2)
and cannot rely on any specific behaviour w.r.t. shared memory.
.\" In AIXv3.1 vfork is equivalent to fork.
.SH "LINUX NOTES"
.SH NOTES
.SS Linux Notes
Fork handlers established using
.BR pthread_atfork (3)
are not called when a multithreaded program employing

4
man2/wait.2
View File

@ -384,7 +384,7 @@ and
does not exist or is not a child of the calling process.
(This can happen for one's own child if the action for SIGCHLD
is set to SIG_IGN.
See also the LINUX NOTES section about threads.)
See also the \fILinux Notes\fP section about threads.)
.TP
.B EINTR
.B WNOHANG
@ -445,7 +445,7 @@ is being ignored, the call behaves just as though
.B SIGCHLD
were not being ignored, that is, the call blocks until the next child
terminates and then returns the process ID and status of that child.
.SH "LINUX NOTES"
.SS Linux Notes
In the Linux kernel, a kernel-scheduled thread is not a distinct
construct from a process.
Instead, a thread is simply a process

2
man3/catopen.3
View File

@ -140,7 +140,7 @@ The glibc value for NL_CAT_LOCALE is 1.
(Compare MCLoadAll below.)
The default path varies, but usually looks at a number of places below
.IR /usr/share/locale .
.SH LINUX NOTES
.SS Linux Notes
These functions are available for Linux since libc 4.4.4c.
In the case of linux libc4 and libc5, the catalog descriptor
.I nl_catd