diff --git a/man3/CPU_SET.3 b/man3/CPU_SET.3 index 77cdd7a5f..c84d8263e 100644 --- a/man3/CPU_SET.3 +++ b/man3/CPU_SET.3 @@ -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), diff --git a/man3/err.3 b/man3/err.3 index 8565da105..a3b6bd78a 100644 --- a/man3/err.3 +++ b/man3/err.3 @@ -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), diff --git a/man3/fmod.3 b/man3/fmod.3 index cf247545c..4909796f6 100644 --- a/man3/fmod.3 +++ b/man3/fmod.3 @@ -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) diff --git a/man3/pthread_attr_setinheritsched.3 b/man3/pthread_attr_setinheritsched.3 index b858f72ac..3889da7fe 100644 --- a/man3/pthread_attr_setinheritsched.3 +++ b/man3/pthread_attr_setinheritsched.3 @@ -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), diff --git a/man3/pthread_attr_setschedparam.3 b/man3/pthread_attr_setschedparam.3 index 9b6ac5d80..048f6cb6d 100644 --- a/man3/pthread_attr_setschedparam.3 +++ b/man3/pthread_attr_setschedparam.3 @@ -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), diff --git a/man3/pthread_attr_setstacksize.3 b/man3/pthread_attr_setstacksize.3 index 6f2e165c4..f82360abb 100644 --- a/man3/pthread_attr_setstacksize.3 +++ b/man3/pthread_attr_setstacksize.3 @@ -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), diff --git a/man3/pthread_create.3 b/man3/pthread_create.3 index 726476941..66190bb7f 100644 --- a/man3/pthread_create.3 +++ b/man3/pthread_create.3 @@ -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), diff --git a/man3/stpcpy.3 b/man3/stpcpy.3 index 170ab7e52..35da9c58b 100644 --- a/man3/stpcpy.3 +++ b/man3/stpcpy.3 @@ -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),