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

CPU_SET.3, err.3, fmod.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setstacksize.3, pthread_create.3, stpcpy.3: Global fix: place sections in correct order 

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2012-03-13 04:16:33 +13:00
parent 44a720e388
commit 22cb459d5c
8 changed files with 53 additions and 53 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
man3/CPU_SET.3
View File

@ -22,7 +22,7 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH CPU_SET 3 2010-09-10 "Linux" "Linux Programmer's Manual"
.TH CPU_SET 3 2012-03-15 "Linux" "Linux Programmer's Manual"
.SH NAME
CPU_SET, CPU_CLR, CPU_ISSET, CPU_ZERO, CPU_COUNT,
CPU_AND, CPU_OR, CPU_XOR, CPU_EQUAL,
@ -295,6 +295,18 @@ in the SYNOPSIS are hints what about is expected in each case.
However, since these interfaces are implemented as macros,
the compiler won't necessarily catch all type errors
if you violate the suggestions.
.SH BUGS
On 32-bit platforms with glibc 2.8 and earlier,
.BR CPU_ALLOC ()
allocates twice as much space as is required, and
.BR CPU_ALLOC_SIZE ()
returns a value twice as large as it should.
This bug should not affect the semantics of a program,
but does result in wasted memory
and less efficient operation of the macros that
operate on dynamically allocated CPU sets.
These bugs are fixed in glibc 2.9.
.\" http://sourceware.org/bugzilla/show_bug.cgi?id=7029
.SH EXAMPLE
The following program demonstrates the use of some of the macros
used for dynamically allocated CPU sets.
@ -339,18 +351,6 @@ main(int argc, char *argv[])
exit(EXIT_SUCCESS);
}
.fi
.SH BUGS
On 32-bit platforms with glibc 2.8 and earlier,
.BR CPU_ALLOC ()
allocates twice as much space as is required, and
.BR CPU_ALLOC_SIZE ()
returns a value twice as large as it should.
This bug should not affect the semantics of a program,
but does result in wasted memory
and less efficient operation of the macros that
operate on dynamically allocated CPU sets.
These bugs are fixed in glibc 2.9.
.\" http://sourceware.org/bugzilla/show_bug.cgi?id=7029
.SH "SEE ALSO"
.BR sched_setaffinity (2),
.BR pthread_attr_setaffinity_np (3),

20
man3/err.3
View File

@ -34,7 +34,7 @@
.\"
.\" 2011-09-10, mtk, Converted from mdoc to man macros
.\"
.TH ERR 3 2011-09-15 "Linux" "Linux Programmer's Manual"
.TH ERR 3 2012-03-15 "Linux" "Linux Programmer's Manual"
.SH NAME
err, verr, errx, verrx, warn, vwarn, warnx, vwarnx \- formatted error messages
.SH SYNOPSIS
@ -104,6 +104,15 @@ and
.BR verrx ()
functions do not return, but exit with the value of the argument
.IR eval .
.SH "CONFORMING TO"
These functions are nonstandard BSD extensions.
.\" .SH HISTORY
.\" The
.\" .BR err ()
.\" and
.\" .BR warn ()
.\" functions first appeared in
.\" 4.4BSD.
.SH EXAMPLE
Display the current
.I errno
@ -138,15 +147,6 @@ if ((fd = open(block_device, O_RDONLY, 0)) == \-1)
err(1, "%s", block_device);
.fi
.in
.SH "CONFORMING TO"
These functions are nonstandard BSD extensions.
.\" .SH HISTORY
.\" The
.\" .BR err ()
.\" and
.\" .BR warn ()
.\" functions first appeared in
.\" 4.4BSD.
.SH SEE ALSO
.BR error (3),
.BR exit (3),

14
man3/fmod.3
View File

@ -30,7 +30,7 @@
.\" Modified 2002-07-27 by Walter Harms
.\" (walter.harms@informatik.uni-oldenburg.de)
.\"
.TH FMOD 3 2010-09-20 "" "Linux Programmer's Manual"
.TH FMOD 3 2012-03-15 "" "Linux Programmer's Manual"
.SH NAME
fmod, fmodf, fmodl \- floating-point remainder function
.SH SYNOPSIS
@ -127,6 +127,12 @@ An invalid floating-point exception
is raised.
.\" POSIX.1 documents an optional underflow error, but AFAICT it doesn't
.\" (can't?) occur -- mtk, Jul 2008
.SH "CONFORMING TO"
C99, POSIX.1-2001.
The variant returning
.I double
also conforms to
SVr4, 4.3BSD, C89.
.SH BUGS
Before version 2.10, the glibc implementation did not set
.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6784
@ -135,11 +141,5 @@ to
.B EDOM
when a domain error occurred for an infinite
.IR x .
.SH "CONFORMING TO"
C99, POSIX.1-2001.
The variant returning
.I double
also conforms to
SVr4, 4.3BSD, C89.
.SH "SEE ALSO"
.BR remainder (3)

8
man3/pthread_attr_setinheritsched.3
View File

@ -21,7 +21,7 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH PTHREAD_ATTR_SETINHERITSCHED 3 2008-11-10 "Linux" "Linux Programmer's Manual"
.TH PTHREAD_ATTR_SETINHERITSCHED 3 2012-03-15 "Linux" "Linux Programmer's Manual"
.SH NAME
pthread_attr_setinheritsched, pthread_attr_getinheritsched \- set/get
inherit scheduler attribute in thread attributes object
@ -97,9 +97,6 @@ error ("attempt was made to set the attribute to an unsupported value") for
.\" Available since glibc 2.0.
.SH CONFORMING TO
POSIX.1-2001.
.SH EXAMPLE
See
.BR pthread_setschedparam (3).
.SH BUGS
As at glibc 2.8, if a thread attributes object is initialized using
.BR pthread_attr_init (3),
@ -116,6 +113,9 @@ in the thread attributes object before calling
.BR pthread_create (3).
.\" FIXME . Track status of the following bug:
.\" http://sourceware.org/bugzilla/show_bug.cgi?id=7007
.SH EXAMPLE
See
.BR pthread_setschedparam (3).
.SH SEE ALSO
.BR sched_setscheduler (2),
.BR pthread_attr_init (3),

8
man3/pthread_attr_setschedparam.3
View File

@ -21,7 +21,7 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH PTHREAD_ATTR_SETSCHEDPARAM 3 2010-02-03 "Linux" "Linux Programmer's Manual"
.TH PTHREAD_ATTR_SETSCHEDPARAM 3 2012-03-15 "Linux" "Linux Programmer's Manual"
.SH NAME
pthread_attr_setschedparam, pthread_attr_getschedparam \- set/get
scheduling parameter attributes in thread attributes object
@ -85,13 +85,13 @@ handle a possible error return).
.\" Available since glibc 2.0.
.SH CONFORMING TO
POSIX.1-2001.
.SH EXAMPLE
See
.BR pthread_setschedparam (3).
.SH NOTES
See
.BR pthread_attr_setschedpolicy (3)
for a list of the thread scheduling policies supported on Linux.
.SH EXAMPLE
See
.BR pthread_setschedparam (3).
.SH SEE ALSO
.BR sched_get_priority_min (2),
.BR sched_setscheduler (2),

8
man3/pthread_attr_setstacksize.3
View File

@ -21,7 +21,7 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH PTHREAD_ATTR_SETSTACKSIZE 3 2008-11-05 "Linux" "Linux Programmer's Manual"
.TH PTHREAD_ATTR_SETSTACKSIZE 3 2012-03-15 "Linux" "Linux Programmer's Manual"
.SH NAME
pthread_attr_setstacksize, pthread_attr_getstacksize \- set/get stack size
attribute in thread attributes object
@ -79,9 +79,6 @@ is not a multiple of the system page size.
These functions are provided by glibc since version 2.1.
.SH CONFORMING TO
POSIX.1-2001.
.SH EXAMPLE
See
.BR pthread_create (3).
.SH NOTES
For details on the default stack size of new threads, see
.BR pthread_create (3).
@ -105,6 +102,9 @@ in violation of POSIX.1-2001, which says that the allocated stack will
be at least
.I stacksize
bytes.
.SH EXAMPLE
See
.BR pthread_create (3).
.SH SEE ALSO
.BR getrlimit (2),
.BR pthread_attr_init (3),

14
man3/pthread_create.3
View File

@ -21,7 +21,7 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH PTHREAD_CREATE 3 2008-11-11 "Linux" "Linux Programmer's Manual"
.TH PTHREAD_CREATE 3 2012-03-15 "Linux" "Linux Programmer's Manual"
.SH NAME
pthread_create \- create a new thread
.SH SYNOPSIS
@ -191,6 +191,12 @@ the stack size attribute can be explicitly set in the
.I attr
argument used to create a thread,
in order to obtain a stack size other than the default.
.SH BUGS
In the obsolete LinuxThreads implementation,
each of the threads in a process has a different process ID.
This is in violation of the POSIX threads specification,
and is the source of many other nonconformances to the standard; see
.BR pthreads (7).
.SH EXAMPLE
The program below demonstrates the use of
.BR pthread_create (),
@ -358,12 +364,6 @@ main(int argc, char *argv[])
exit(EXIT_SUCCESS);
}
.fi
.SH BUGS
In the obsolete LinuxThreads implementation,
each of the threads in a process has a different process ID.
This is in violation of the POSIX threads specification,
and is the source of many other nonconformances to the standard; see
.BR pthreads (7).
.SH SEE ALSO
.BR getrlimit (2),
.BR pthread_attr_init (3),

8
man3/stpcpy.3
View File

@ -22,7 +22,7 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.TH STPCPY 3 2011-09-28 "GNU" "Linux Programmer's Manual"
.TH STPCPY 3 2012-03-15 "GNU" "Linux Programmer's Manual"
.SH NAME
stpcpy \- copy a string returning a pointer to its end
.SH SYNOPSIS
@ -68,6 +68,9 @@ This function was added to POSIX.1-2008. Before that, it was not part of
the C or POSIX.1 standards, nor customary on UNIX systems, but was not a
GNU invention either. Perhaps it came from MS-DOS. It is also present on
the BSDs.
.SH BUGS
This function may overrun the buffer
.IR dest .
.SH EXAMPLE
For example, this program uses
.BR stpcpy ()
@ -92,9 +95,6 @@ main(void)
}
.fi
.in
.SH BUGS
This function may overrun the buffer
.IR dest .
.SH "SEE ALSO"
.BR bcopy (3),
.BR memccpy (3),