Commit Graph

5216 Commits

Author SHA1 Message Date
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
Michael Kerrisk d71915efe6 pthread_attr_getschedpolicy.3: New link to new pthread_attr_setschedpolicy.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:05 -05:00
Michael Kerrisk 2f80dc3711 pthread_attr_setschedpolicy.3: New page for pthread_attr_setschedpolicy(3) and pthread_attr_getschedpolicy(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:05 -05:00
Michael Kerrisk c2befb6a93 pthread_attr_setstacksize.3: EINVAL occurs on some systems if stacksize != page-size
On MacOS X at least, pthread_attr_setstacksize(3) can fail
with EINVAL if 'stacksize' is not a multiple of the system
page size.  Best to mention this so as to aid people writing
portable programs.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Karsten Weiss <knweiss@gmail.com>

==
From: Karsten Weiss <knweiss@gmail.com>
Date: Fri, Oct 31, 2008 at 3:46 PM
Subject: pthread_create(3) - example bug + problems

[...]
A look in the pthread_set_stacksize man page on Mac revealed that on
Mac the stack size must not only be at least PTHREAD_STACK_MIN...
[...]
...but the new stack size must also be a multiple of the system page
size!

From pthread_attr_setstacksize(3):

    pthread_attr_setstacksize() will fail if:

    [EINVAL]           Invalid value for attr.
    [EINVAL]           stacksize is less than PTHREAD_STACK_MIN.
!!!  [EINVAL]           stacksize is not a multiple of the system page size.

See for yourself (PTHREAD_STACK_MIN==8192 on Mac OS X):

$ ./pthread_test -s $((8192*10-1)) a
pthread_attr_setstacksize: Invalid argument
$ ./pthread_test -s $((8192*10)) a
Thread 1: top of stack near 0xb0014f6c; argv_string=a
Joined with thread 1; returned value was A
$ ./pthread_test -s $((8192*10+1)) a
pthread_attr_setstacksize: Invalid argument
2008-11-06 16:49:05 -05:00