Commit Graph

5219 Commits

Author SHA1 Message Date
Michael Kerrisk 447cd9e76e pthreads.7: Rework, and fix small error in, thread-safe function list
Integrate the changes that occurred in POSIX.1-2008 into the
main list (to be consistent with the list, elsewhere on this
page, of functions that are cancellation points).

Also, fix an error that said that strerror() was added to
the list in POSIX.1-2008.  It was strsignal() that was
added.  (strerror() was already in the list in POSIX.1-2001.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-11 14:53:10 -05:00
Michael Kerrisk 940c8ce244 getdents.2, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, pthread_setaffinity_np.3, pthread_setschedparam.3, pthread_tryjoin_np.3: Use consistent error-handling function names
Many older pages use a handle_error() macro to do simple
error handling from system and library function calls.
Switch these pages to do similar.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-11 14:51:13 -05:00
Michael Kerrisk 13466d9898 pthread_tryjoin_np.3: minor: tidy up example code segment
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-11 14:51:13 -05:00
Michael Kerrisk 7fd4e74c1c pthreads.7: Tweak text on sigpause() cancellation point
In POSIX.1-2009, this function moves from the "must be"
to the "may be" list.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-11 14:51:04 -05:00
Michael Kerrisk b6a82811c7 pthread_attr_setinheritsched.3: New page for pthread_attr_setinheritsched(3) and pthread_attr_getinheritsched(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-10 12:17:19 -05:00
Michael Kerrisk 2cbeeec32c bindresvport.3: Since glibc 2.8, EPFNOSUPPORT error is now EAFNOSUPPORT
Glibc switched to using a POSIX-specified error code for
this error case.

http://bugs.linuxbase.org/show_bug.cgi?id=2375

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Acked-by: Stew Benedict <stewb@linux-foundation.org>
2008-11-10 12:12:02 -05:00
Michael Kerrisk ffe8c4ae77 pthreads.7: Add section on cancellation points
This section includes a list of the functions that must and
may be cancellation points.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-10 12:00:51 -05:00
Michael Kerrisk da8dbaa525 fsync.2: Update feature test macro requirements for fsync()
Since glibc 2.8, the fsync() declaration is also exposed if
_POSIX_C_SOURCE >= 200112L

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-07 21:42:33 -05:00
Michael Kerrisk a5a061ee0c clone.2: srcfix: added comment about CLONE_STOPPED going away in glibc 2.8 2008-11-07 21:32:57 -05:00
Michael Kerrisk 515ad54217 makecontext.3: grfix 2008-11-07 20:57:48 -05:00
Michael Kerrisk 7acf73dc37 makecontext.3: Add text on use of pointer arguments to makecontext()
Passing pointer arguments to makecontext() is possible,
but only on some architectures, and with no guarantees
of portability.

http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504699

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Paul Evans <leonerd@leonerd.org.uk>
2008-11-07 20:31:15 -05:00
Michael Kerrisk c6ec368541 getpwnam.3: Add an EXAMPLE program for getpwnam_r()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-07 17:51:33 -05:00
Michael Kerrisk 3b11a49415 getgrnam.3: Rename arguments to getgrnam_r() and getgrgid_r()
s/gbuf/grp/ and s/gbufp/result/, for consistency
with POSIX.1 argument names.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-07 17:51:32 -05:00
Michael Kerrisk 3adc12e97f getpwnam.3: Rename arguments to getpwnam_r() and getpwuid_r()
s/pwbuf/pwd/ and s/pwbufp/result/, for consistency
with POSIX.1 argument names.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-07 17:51:32 -05:00
Michael Kerrisk 2ac1e1d3d4 getgrnam.3: Clarify and add more detail in RETURN VALUE description
The page was a bit fuzzy in describing the return values for
various cases.  In particular, it needed to be more explicit
in describing what happens for the "not found" case.

This is an analogous change to the previous change for
getpwnam.3, made after Andreas Henriksson's report.
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504787

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-07 17:51:32 -05:00
Michael Kerrisk bbab485de0 getpwnam.3: Clarify and add more detail in RETURN VALUE description
The page was a bit fuzzy in describing the return values for
various cases.  In particular, it needed to be more explicit
in describing what happens for the "not found" case.

http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504787

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Andreas Henriksson <andreas@fatal.se>
2008-11-07 17:51:32 -05:00
Michael Kerrisk b006e083a0 getgrnam.3: Clarify RETURN VALUE description
The page was a bit fuzzy in describing the return values for
various cases.  In particular, it needed to be more explicit
in describing what happens for the "not found" case.

http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504708

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Andreas Henriksson <andreas@fatal.se>
2008-11-07 17:51:32 -05:00
Michael Kerrisk a6915393f0 clock_getres.3: wfix 2008-11-07 17:51:31 -05:00
Michael Kerrisk b3f72461cb clock_getres.3: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-07 17:51:31 -05:00
Michael Kerrisk b7170be27b Start of man-pages-3.14: updating Changes and Changes.old 2008-11-07 17:51:31 -05:00
Michael Kerrisk 9732978182 Start of man-pages-3.14: updating .Announce and .lsm files 2008-11-07 17:51:31 -05:00
Michael Kerrisk 655e6866b9 Start of man-pages-3.14: renaming .Announce and .lsm files 2008-11-07 17:51:31 -05:00
Michael Kerrisk 08df4081c2 Ready for 3.13 2008-11-07 17:51:31 -05:00
Michael Kerrisk 5f2abc481d Expanded tabs 2008-11-07 17:51:30 -05:00
Michael Kerrisk 9eb0c11cb5 pthread_attr_getaffinity_np.3: Fix circular self-link reference
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-07 17:51:30 -05:00
Michael Kerrisk a5bba85928 pthread_getattr_np.3, pthread_tryjoin_np.3: tstamp 2008-11-07 17:51:30 -05:00
Michael Kerrisk b554d3fba2 Changes: Update changelog for 3.13 release
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-07 17:51:30 -05:00
Michael Kerrisk d668e4b3bb pthread_setschedparam.3: tfix 2008-11-07 17:51:30 -05:00
Michael Kerrisk 437b9d9c2f pthread_attr_setschedparam.3: tfix 2008-11-07 17:51:29 -05:00
Michael Kerrisk 4c3586b390 pthread_attr_setschedpolicy.3: minor: s/policy/*policy/ in SYNOPSIS 2008-11-07 17:51:29 -05:00
Michael Kerrisk dc05a5d50c pthread_attr_setschedpolicy.3: ffix 2008-11-07 17:51:29 -05:00
Michael Kerrisk 3847be7851 clock_getres.3: CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID not settable
According to POSIX.1-2001, the CLOCK_PROCESS_CPUTIME_ID and
CLOCK_THREAD_CPUTIME_ID clocks should be settable, but
currently they are not.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-07 17:51:16 -05:00
Michael Kerrisk 4888dfbf49 pthread_setschedprio.3: New page for pthread_setschedprio(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:27 -05:00
Michael Kerrisk 9b6ba4d8a4 sched_setscheduler.2: tfix
s/2.6.20/2.6.30/ to fix an earlier typo in the description
of the likely kernel version that will have fully fledged
real-time features.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:27 -05:00
Michael Kerrisk a1ca96443e pthread_setschedparam.3: Rework text pointing to information on required permissions
Rework the text that refers to sched_setscheduler(2) for
a description of the permissions required to change
the scheduling policy and priority.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:27 -05:00
Michael Kerrisk cb4db101d2 pthread_setschedparam.3: SEE ALSO: add getrlimit(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:26 -05:00
Michael Kerrisk 1f62722442 pthread_attr_setschedpolicy.3: Add pointer to EXAMPLE in pthread_setschedparam(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:26 -05:00
Michael Kerrisk 2c5f1561a6 pthread_attr_setschedparam.3: Add pointer to EXAMPLE in pthread_setschedparam(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:26 -05:00
Michael Kerrisk f51fabeb1a pthread_getschedparam.3: New link to new pthread_setschedparam.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:26 -05:00
Michael Kerrisk bec63ef665 pthread_setschedparam.3: New page for pthread_setschedparam(3) and pthread_getschedparam(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:26 -05:00
Michael Kerrisk ce5139ca28 pthread_create.3, pthread_getattr_np.3: ffix: s/'/\\(aq/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:26 -05:00
Michael Kerrisk f1e29e2764 pthread_attr_setschedpolicy.3: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:25 -05:00
Michael Kerrisk e7d2bb653d pthread_setaffinity_np.3: SEE ALSO: add pthread_self(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:25 -05:00
Michael Kerrisk 83a87192af resolver.3: Fix prototype of dn_expand()
The 4th argument is "char *", not "unsigned char *".
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504708

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Trk Edwin <edwintorok@gmail.com>
2008-11-06 16:49:25 -05:00
Michael Kerrisk ecdd9a10bb pthreads.7: spfix 2008-11-06 16:49:25 -05:00
Michael Kerrisk 84ee6c22e3 pthreads.7: Add a section describing thread IDs
In particular, note that in each pthreads function that takes
a thread ID argument, that ID by definition refers to a thread
in the same process as the caller.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:13 -05:00
Michael Kerrisk 3ba07ec788 sched_setaffinity.2: SEE ALSO: add sched_getcpu(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:06 -05:00
Michael Kerrisk cbdc74c919 pthread_setaffinity_np.3: SEE ALSO: add sched_getcpu(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:06 -05:00
Michael Kerrisk a4963c7c62 pthread_attr_getschedparam.3: New link to new pthread_attr_setschedparam.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:06 -05:00
Michael Kerrisk b326494cc0 pthread_attr_setschedparam.3: New page for pthread_attr_setschedparam(3) and pthread_attr_getschedparam(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:06 -05:00