Commit Graph

2025 Commits

Author SHA1 Message Date
Michael Kerrisk 28e00ccfa5 pthread_cleanup_push.3: Prematurely exiting a cleanup block is undefined according to POSIX.1
POSIX.1 says that prematurely exiting a push/pop block
yields undefined results.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Loic Domaigne <tech@domaigne.com>
2008-11-25 20:54:25 -05:00
Michael Kerrisk ee1534cb43 pthread_setcancelstate.3: integrated suggestions by Loic Domaigne
Loic Domaigne suggested some rewordings of the NOTES paragraph
that discusses the utility of asynchronous cancelability.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reviewed-by: Loic Domaigne <tech@domaigne.com>
2008-11-25 20:54:24 -05:00
Pierre-Paul Paquin a3dadfe86f sigwait.3: wfix: s/set/sig/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:24 -05:00
Michael Kerrisk 5a2ff571fb connect.2, listen.2, send.2, uname.2, cmsg.3, proc.5, arp.7, ddp.7, icmp.7, ip.7, raw.7, socket.7, tcp.7, udp.7: Global fix: eliminate mention of the obsolete sysctl(2) interface
Many pages still mention use of the obsolete sysctl(2) system
call, or used the term "sysctls"; rewrite these mentions to
instead be in terms of /proc interfaces.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:11 -05:00
Stefano Teso d62d92dc5f atan2.3: Fix description of range of function value return
The range is not [-pi/2, pi/2], but [-pi, pi].

(mtk: This error was reported by Nicolas Francois, and
should have been fixed in 3.11, but somewhere along the way,
the fix got lost.)

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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:09 -05:00
Michael Kerrisk 71fea60784 fcntl.2, signal.2, mbsnrtowcs.3, mbsrtowcs.3, mbtowc.3, wcrtomb.3, wcsnrtombs.3, wcsrtombs.3, wctomb.3: Global fix: s/multi-thread/multithread/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:08 -05:00
Michael Kerrisk 222d90f4e9 pthread_getattr_np.3, pthread_setschedparam.3: wfix 2008-11-25 20:54:04 -05:00
Michael Kerrisk 653c3aedae pthread_cancel.3: Integrate review feedback from Loic Domaigne
Various fixes, as suggested by Loic.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reviewed-by: Loic Domaigne <tech@domaigne.com>
2008-11-25 20:54:04 -05:00
Michael Kerrisk bdd7090bea pthread_testcancel.3: minor: Review by Loic Domaigne
Reviewed by Loic; no problems found.

Reviewed-by: Loic Domaigne <tech@domaigne.com>
2008-11-25 20:54:03 -05:00
Michael Kerrisk 5b99d42600 pthread_attr_setinheritsched.3: wfix: s/thread/addr/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Loic Domaigne <tech@domaigne.com>
2008-11-25 20:54:03 -05:00
Michael Kerrisk 50b1e6a7f8 pthread_setschedparam.3: PTHREAD_INHERIT_SCHED is default for inherit scheduler attribute
In EXAMPLE, note that PTHREAD_INHERIT_SCHED is the default for
the inherit scheduler attribute attribute.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Loic Domaigne <tech@domaigne.com>
2008-11-25 20:54:03 -05:00
Michael Kerrisk 48718eb35f pthread_cancel.3, pthread_detach.3, pthread_join.3, pthread_setaffinity_np.3: Make text of ESRCH error consistent
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Loic Domaigne <tech@domaigne.com>
2008-11-25 20:54:03 -05:00
Michael Kerrisk 4c5f54136d pthread_attr_setschedparam.3, pthread_setschedparam.3: Remove text saying that only sched_priority is required by POSIX.1
Loic Domaigne points out that if a system implements
SCHED_SPORADIC (which Linux does not), then other
fields are also specified in sched_param.  The simple
solution is just to remove that phrase from the man
page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Loic Domaigne <tech@domaigne.com>
2008-11-25 20:54:03 -05:00
Michael Kerrisk 65cc854059 pthread_setaffinity_np.3: srcfix: spfix 2008-11-25 20:54:02 -05:00
Michael Kerrisk 803486cb45 pthread_setaffinity_np.3: srcfix: Add comment: CONFIG_NR_CPUS may become obsolete one day 2008-11-25 20:54:02 -05:00
Michael Kerrisk d4ac23a7e2 pthread_testcancel.3: New page for pthread_testcancel(3) 2008-11-25 20:54:02 -05:00
Michael Kerrisk ed2d523671 pthread_setcanceltype.3: New link to new pthread_setcancelstate.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:02 -05:00
Michael Kerrisk ccb42cb832 pthread_setcancelstate.3: New page for pthread_setcancelstate(3) and pthread_setcanceltype(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:01 -05:00
Michael Kerrisk 9e528f3de9 pthread_cancel.3: New page for pthread_cancel(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:01 -05:00
Michael Kerrisk 28f09cec39 pthread_cleanup_pop.3: New link to new pthread_cleanup_push.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:01 -05:00
Michael Kerrisk b126ec4b87 pthread_cleanup_push.3: New page for pthread_cleanup_push(3) and pthread_cleanup_pop(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:01 -05:00
Michael Kerrisk f4efb1e28b CPU_SET.3: NOTES: Discuss use of types in "prototypes" for these macros
The SYNOPSIS shows types for arguments and return values, but
these are really just suggestions: since the interfaces are
macros, the compiler won't catch all violations of
the "type rules".  Warn the reader of this.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:01 -05:00
Michael Kerrisk 6ee1c2aaf5 pthread_attr_setaffinity_np.3: Various fixes after review by Loic Domaigne
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reviewed-by: Loic Domaigne <tech@domaigne.com>
2008-11-25 20:54:01 -05:00
Michael Kerrisk 188cf22e22 pthread_create.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:00 -05:00
Michael Kerrisk 532f0406fe pthread_setaffinity_np.3: Add text to EINVAL error mentioning cpuset(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:00 -05:00
Michael Kerrisk 553e8b962e pthread_setaffinity_np.3: tfix 2008-11-25 20:54:00 -05:00
Michael Kerrisk f5bf1e9b13 pthread_setaffinity_np.3: Various improvements after review by Loïc Domaigne
Various fix-ups after Loïc's review.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reviewed-by: Loïc Domaigne <tech@domaigne.com>
2008-11-25 20:54:00 -05:00
Michael Kerrisk 23bb5732b2 pthread_attr_getinheritsched.3: New link to new pthread_attr_setinheritsched.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:59 -05:00
Michael Kerrisk 2fac17032a CPU_SET.3: minor: tweak NOTES text on CPU_SETSIZE and 'setsize'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:59 -05:00
Michael Kerrisk 50ee5bc147 CPU_SET.3: spfix 2008-11-25 20:53:59 -05:00
Michael Kerrisk e973db1769 CPU_SET.3: minor: tweak text of BUGS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:59 -05:00
Michael Kerrisk 6924199053 CPU_SET.3: Various improvements in DESCRIPTION
After review comments by Bert Wesarg:

* Explain that cpu_set_t is a bitset, but should be considered
  opaque.
* A CPU set can be duplicated with memset().
* Size of a CPU set is rounded up to size of long.
* CPU_SETSIZE is in bits, but the setsize argument is in bytes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Bert Wesarg <bert.wesarg@googlemail.com>
Reviewed-by: Bert Wesarg <bert.wesarg@googlemail.com>
2008-11-25 20:53:59 -05:00
Michael Kerrisk b62e354822 CPU_SET.3: Document CPU_ALLOC()/CPU_ALLOC_SIZE() bug
These macros return twice what they should because of thinko
in glibc 2.8 and earlier.  The bug is fixed for glibc 2.9.
http://sourceware.org/bugzilla/show_bug.cgi?id=7029

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:58 -05:00
Michael Kerrisk 7844c4ea58 CPU_ZERO_S.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:57 -05:00
Michael Kerrisk 4ce33dc68a CPU_XOR_S.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:57 -05:00
Michael Kerrisk 3b0122a7a8 CPU_XOR.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:57 -05:00
Michael Kerrisk 474dc065be CPU_SET_S.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:56 -05:00
Michael Kerrisk 6a7fe37559 CPU_OR_S.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:56 -05:00
Michael Kerrisk 966280197f CPU_OR.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:56 -05:00
Michael Kerrisk f4c2bad396 CPU_ISSET_S.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:56 -05:00
Michael Kerrisk d008b874b2 CPU_FREE.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:56 -05:00
Michael Kerrisk ca8a860474 CPU_EQUAL_S.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:55 -05:00
Michael Kerrisk 0e972f10fb CPU_EQUAL.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:55 -05:00
Michael Kerrisk dc23951093 CPU_COUNT_S.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:55 -05:00
Michael Kerrisk ff07d3d53e CPU_CLR_S.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:55 -05:00
Michael Kerrisk 94ed3c6315 CPU_AND_S.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:54 -05:00
Michael Kerrisk 25717f3a2b CPU_AND.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:54 -05:00
Michael Kerrisk e0685b4078 CPU_ALLOC_SIZE.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:54 -05:00
Michael Kerrisk 6dc17d0692 CPU_ALLOC.3: New link to new CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:54 -05:00
Michael Kerrisk 214c1dd290 CPU_SET.3: grfix 2008-11-25 20:53:54 -05:00
Michael Kerrisk aa633a586d CPU_SET.3: Fix return type of CPU_ALLOC_SIZE() in SYNOPSIS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:53 -05:00
Michael Kerrisk 488d0e98f3 CPU_SET.3: Add description of macros for dynamically allocated CPU sets
Add descriptions of CPU_ALLOC(), CPU_ALLOC_SIZE(), CPU_FREE(),
CPU_SET_S(), CPU_CLR_S(), CPU_ISSET_S(), CPU_ZERO_S(),
CPU_COUNT_S(), CPU_AND_S(), CPU_OR_S(), CPU_XOR_S(), and
CPU_EQUAL_S().
2008-11-25 20:53:53 -05:00
Michael Kerrisk 94934ae71c CPU_SET.3: Add description of CPU_AND(), CPU_OR, CPU_XOR(), and CPU_EQUAL()
Plus a few other small clean-ups of the text

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:53 -05:00
Michael Kerrisk df79be827a CPU_SET.3: minor: reorder some text, whitespace fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:53 -05:00
Michael Kerrisk f7eec8970c CPU_SET.3: minor: s/1024/currently 1024/ for description of CPU_SETSIZE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:53 -05:00
Michael Kerrisk f48bf14117 CPU_COUNT.3: New link to CPU_SET.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:53 -05:00
Michael Kerrisk 639c5cc8c3 CPU_SET.3: Add documentation of CPU_COUNT()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:52 -05:00
Michael Kerrisk ef5694bc07 pthread_attr_setaffinity_np.3: spfix 2008-11-25 20:53:52 -05:00
Michael Kerrisk bd5bb13000 pthread_attr_setaffinity_np.3, pthread_setaffinity_np.3: Remove redundant text relating to CPU sets
Information about CPU_SETSIZE can be found in CPU_SET.3, so
remove discussion of it here.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:53:46 -05:00
Michael Kerrisk 8e223af2e3 pthread_attr_setaffinity_np.3, pthread_setaffinity_np.3: Update to reflect new location of CPU_*() documentation
The CPU_*() macros are now documented in CPU_SET.3;
update to reflect that fact.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-13 08:56:56 -05:00
Michael Kerrisk 089de1d271 CPU_CLR.3, CPU_ISSET.3, CPU_ZERO.3: Update links to point to CPU_SET.3
The documentation of the CPU_* macros migrated to a new location:
CPU_SET.3.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-13 08:56:56 -05:00
Michael Kerrisk a9cdb1db67 CPU_SET.3: New page documenting CPU_* macros
This page contains material moved out of sched_setscheduler(2).
It overwrites a previously existing link file with the same name.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-13 08:56:56 -05:00
Masanari Iida ed27948551 syslog.3: LOG_KERN messages can't be generated from user processes
Masanari notes that this is an FAQ for logger(1) and that
Solaris and FreeBSD document this point in syslog(3).
The glibc info page also hides this comment in its source:

    Internally, there is also LOG_KERN, but LOG_KERN == 0,
    which means if you try to use it here, just selects default.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-13 08:56:50 -05:00
Michael Kerrisk 64c85cc4ca syslog.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-12 11:26:17 -05:00
Michael Kerrisk cc7ffe866d inet_ntop.3: Rework text describing 'size' argument
(After a suggestion by Vegard Nossum.)
Also made a few other small rewordings to in the initial
paragraph.

Reported-by: Vegard Nossum <vegard.nossum@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-11 15:10:53 -05:00
Michael Kerrisk f961f9c1ab inet_ntop.3: Rename 'cnt' argument to 'size'
This is consistent with POSIX.1, and also a more sensible name.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-11 15:05:07 -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 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 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 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 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 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: Török Edwin <edwintorok@gmail.com>
2008-11-06 16:49:25 -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
Karsten Weiss 061f742a28 pthread_create.3: Fix bug in EXAMPLE program
The bug is in this part of the code:

    /* Allocate memory for pthread_create() arguments */

    tinfo = calloc(num_threads, num_threads);
    if (tinfo == NULL)
       errExit("calloc");

The calloc() line should read like this instead:

    tinfo = calloc(num_threads, sizeof(struct thread_info));

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:05 -05:00
Michael Kerrisk c94081aa45 pthread_attr_setaffinity_np.3, pthread_getattr_np.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3: Explain _np suffix
Add text to CONFORMING TO explaining that the "_np"
suffix is because these functions are non-portable.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Karsten Weiss <K.Weiss@science-computing.de>
2008-11-06 16:49:05 -05:00
Michael Kerrisk ea75a357a4 pthread_attr_setaffinity_np.3: Remove EFAULT, add new EINVAL error
EFAULT can't occur for these functions.  EINVAL can occur
for invalid 'attr' or 'cpuset' arguments.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:48:56 -05:00
Michael Kerrisk 7415e59a75 pthread_attr_getaffinity_np.3: New link to new pthread_attr_setaffinity_np.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:48:54 -05:00
Michael Kerrisk f94536275a pthread_attr_setaffinity_np.3: New page for pthread_attr_setaffinity_np(3) and pthread_attr_getaffinity_np(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:48:54 -05:00
Michael Kerrisk ae107f5822 pthread_setaffinity_np.3: tfix 2008-11-06 16:48:54 -05:00
Michael Kerrisk 04128e1a06 pthread_setaffinity_np.3: minor: fix function names in EXAMPLE diagnostic messages
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:48:54 -05:00
Michael Kerrisk d67ec7daf3 pthread_setaffinity_np.3: minor: Clean up SEE ALSO list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:48:53 -05:00
Michael Kerrisk 7fec28f02a pthread_getaffinity_np.3: New link to new pthread_setaffinity_np.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:48:53 -05:00
Michael Kerrisk 5655765fdd pthread_setaffinity_np.3: New page for pthread_setaffinity_np(3) and pthread_getaffinity_np(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:48:39 -05:00
Michael Kerrisk d84d0300a5 eventfd.2, getdents.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3, getaddrinfo.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3, strtok.3, strtol.3, core.5: srcfix
s/\.R " "/\\\&/ as a way of getting a blank line after a .SS heading.
(Suggested by Sam Varshavchik <mrsam@courier-mta.com>)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-04 20:42:45 -05:00
Sam Varshavchik 5b4e617fa4 pthread_tryjoin_np.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-04 09:00:41 -05:00
Michael Kerrisk 257f73f262 pthread_exit.3: BUGS: thread group with a dead leader and stop signals
Document the bug that can occur when a stop signal
is sent to a thread group whose leader has terminated.
http://thread.gmane.org/gmane.linux.kernel/611611
http://marc.info/?l=linux-kernel&m=122525468300823&w=2

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Bert Wesarg <bert.wesarg@googlemail.com>
2008-10-30 10:56:59 -05:00
Michael Kerrisk c5571b613b Removed trailing white space at end of lines 2008-10-29 15:43:44 -05:00
Michael Kerrisk 08c9b488f4 timerfd_create.2, ctime.3, frexp.3, strftime.3, strtok.3, tty_ioctl.4, iso_8859-7.7: tstamp 2008-10-29 15:36:12 -05:00
Christoph Hellwig 2250b3eea5 readdir.3: Fix text relating to DT_UNKNOWN and 'd_type' support
(This mirrors the previous change to getdents.2)
Some file systems provide partial support for 'dt_type',
returning DT_UNKNOWN for cases they don't support.
Update the discussion of 'd_type' and DT_UNKNOWN to
support this.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:27 -05:00
Michael Kerrisk a87c4a1da3 getaddrinfo.3: Clarify error descriptions with some examples
Clarify the description of some errors by giving examples
that produce the errors.  (Text added for EAI_SERVICE and
EAI_SOCKTYPE.)

Also, add an error case for EAI_BADFLAGS.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: J.H.M. Dassen (Ray) <fsmla@xinara.org>
2008-10-29 14:54:26 -05:00
Jason Spiro 9031fc7ae5 strcpy.3: Strengthen warning about checking against buffer overruns
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=413940

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:25 -05:00
Michael Kerrisk 213bea670e getaddrinfo.3: minor: Add subheadings to EXAMPLE programs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:24 -05:00
Michael Kerrisk b522208e56 err.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:24 -05:00
Michael Kerrisk e05ccae540 encrypt.3: minor: remove mention of glibc version from EXAMPLE
The relevant text applies to any version of glibc,
so the version number is not needed.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:24 -05:00
Michael Kerrisk f91bef833f div.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:24 -05:00
Michael Kerrisk a831ef971d frexp.3, strftime.3, strtok.3: Global fix: relocate shell session above example program
Move the shell session text that demonstrates the use of
the example program so that it precedes the actual
example program.  This makes the page consistent with the
majority of other pages.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:24 -05:00
Michael Kerrisk 9c33050447 eventfd.2, getdents.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strtol.3, core.5: global fix: Add ".SS Program source" to EXAMPLE
Add ".SS Program source" to clearly distinguish shell session and
descriptive text from actual program code.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:23 -05:00
Michael Kerrisk b43a3b301e eventfd.2, execve.2, getdents.2, ioprio_set.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, malloc.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3, strtok.3, strtol.3, core.5, proc.5, cpuset.7, mq_overview.7: Global fix: Format user input in shell sessions in boldface
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:23 -05:00
Michael Kerrisk 624c0456a7 offsetof.3: ffix 2008-10-29 14:54:22 -05:00
Michael Kerrisk 01f1f222a5 strtok.3: ffix 2008-10-29 14:54:22 -05:00
Michael Kerrisk a173b8c674 strftime.3: ffix 2008-10-29 14:54:22 -05:00
Michael Kerrisk 5497345840 fmemopen.3: ffix 2008-10-29 14:54:22 -05:00
Michael Kerrisk 630a1725b5 pthread_attr_setstacksize.3: wfix: s/pthread_attr_setscope/pthread_attr_setstacksize/
Reported-by: Stefan Puiu <stefan.puiu@gmail.com>
2008-10-29 14:54:19 -05:00
Michael Kerrisk 49c54dd821 pthread_attr_setstack.3: wfix: s/pthread_attr_setscope/pthread_attr_setstack/
Reported-by: Stefan Puiu <stefan.puiu@gmail.com>
2008-10-29 14:54:19 -05:00
Michael Kerrisk 65f6a3ee6d dlopen.3: LD_LIBRARY_PATH is inspected once, at program start-up
Make it clear that LD_LIBRARY_PATH is inspected *once*, at
program start-up.  (Verified from source and by experiment.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Michael B. Trausch <mike@trausch.us>
2008-10-29 14:54:19 -05:00
Michael Kerrisk 240c2fa0fa pthread_join.3: wfix: s/unpredictable/undefined/
Reported-by: Bert Wesarg <bert.wesarg@googlemail.com>
2008-10-29 14:54:19 -05:00
Michael Kerrisk 5de8e5f965 pthread_detach.3: wfix
Reported-by: Bert Wesarg <bert.wesarg@googlemail.com>
2008-10-29 14:54:19 -05:00
Michael Kerrisk 43fa988b91 pthread_join.3: SEE ALSO: Add pthread_tryjoin_np(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:18 -05:00
Michael Kerrisk 0767a53c50 pthread_timedjoin_np.3: New link to new pthread_tryjoin_np.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:18 -05:00
Michael Kerrisk 681f0d67bb pthread_tryjoin_np.3: New page for pthread_tryjoin_np(3) and pthread_timedjoin_np(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:18 -05:00
Michael Kerrisk bbb08de354 pthread_join.3: EINVAL also occurs if there is already a joining thread
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:18 -05:00
Michael Kerrisk 7eec71b80c pthread_attr_getscope.3: New link to new pthread_attr_setscope.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:18 -05:00
Michael Kerrisk 693e11d0c5 pthread_attr_setscope.3: New page for pthread_attr_setscope(3) and pthread_attr_getscope(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:17 -05:00
Michael Kerrisk d670bd3ad5 pthread_attr_getdetachstate.3: New link to new pthread_attr_setdetachstate.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:17 -05:00
Michael Kerrisk 4b5ce6c3bf pthread_attr_setdetachstate.3: New page for pthread_attr_setdetachstate(3) and pthread_attr_getdetachstate(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:17 -05:00
Michael Kerrisk 47ce6b2f53 pthread_attr_getstackaddr.3: New link to new pthread_attr_setstackaddr.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:17 -05:00
Michael Kerrisk e5b89a8d76 pthread_attr_setstackaddr.3: New page for pthread_attr_setstackaddr(3) and pthread_attr_getstackaddr(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:17 -05:00
Michael Kerrisk 2a58e8edf4 pthread_attr_getstack.3: New link to new pthread_attr_setstack.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:17 -05:00
Michael Kerrisk e0ea179fea pthread_attr_setstack.3: spfix 2008-10-29 14:54:16 -05:00
Michael Kerrisk 4008a5d53a pthread_attr_setstack.3: New page for pthread_attr_setstack(3) and pthread_attr_getstack(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:16 -05:00
Michael Kerrisk 599946250e pthread_attr_getguardsize.3: New link to new pthread_attr_setguardsize.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:16 -05:00
Michael Kerrisk 62fba73a47 pthread_attr_setguardsize.3: New page for pthread_attr_setguardsize(3) and pthread_attr_getguardsize(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:16 -05:00
Michael Kerrisk 5bf083d042 pthread_attr_getstacksize.3: New link to new pthread_attr_setstacksize.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:16 -05:00
Michael Kerrisk 5a8b01e1b9 pthread_attr_setstacksize.3: New page for pthread_attr_setstacksize(3) and pthread_attr_getstacksize(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:16 -05:00
Michael Kerrisk 4f37d29c77 pthread_getattr_np.3: New page for pthread_getattr_np(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:15 -05:00
Michael Kerrisk 1bb776052c pthread_attr_destroy.3: New link to new pthread_attr_init.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:15 -05:00
Michael Kerrisk 7896a15506 pthread_attr_init.3: New page for pthread_attr_init(3) and pthread_attr_destroy(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:15 -05:00
Michael Kerrisk b290aa63eb pthread_detach.3: New page for pthread_detach(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:15 -05:00
Michael Kerrisk ebdd7ee18c pthread_join.3: New page for pthread_join(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:15 -05:00
Michael Kerrisk 8c80f3c6e1 pthread_equal.3: New page for pthread_equal(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:15 -05:00
Michael Kerrisk 8dffe2c455 pthread_self.3: New page for pthread_self(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:14 -05:00
Michael Kerrisk 2bb98c3f74 pthread_create.3: minor: three small fixes
Bert Wesarg <bert.wesarg@googlemail.com>
2008-10-29 14:54:14 -05:00
Michael Kerrisk 87d6864727 pthread_exit.3: wfix: s/value_ptr/retval/
Reported-by: Bert Wesarg <bert.wesarg@googlemail.com>
2008-10-29 14:54:14 -05:00
Michael Kerrisk c495ab1b69 pthread_exit.3: New page describing pthread_exit(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:14 -05:00
Michael Kerrisk 058cd95f5a pthread_create.3: New page describing pthread_create(3)
Let's start filling the big, longstanding gap for documentation
of Linux's implementation(s) of POSIX threads.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:14 -05:00
Michael Kerrisk e47fa14cd1 gethostbyname.3: Rationalize text on POSIX.1-2001 obsolete interfaces
POSIX.1 marks gethostbyname(), gethostbyaddr(), and 'h_errno'
as obsolete.  The man page explained this, but with some
duplication.  Remove the duplication, and otherwise tidy up
discussion of this point.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:13 -05:00
Michael Kerrisk 546f67f3cd ctime.3: ctime_r() and localtime_r() need not set 'timezone' and 'daylight'
The man page already noted that these functions need not set
'tzname', but things could be clearer: it tzset() is not called,
then the other two variables also are not set.

Also, clarify that ctime() does set 'timezone' and 'daylight'.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:13 -05:00
Michael Kerrisk e6068f213e strftime.3: srcfix: Added FIXME 2008-10-29 14:54:13 -05:00
Michael Kerrisk 44c95a090f stat.2, tsearch.3, tzset.3: wfix: s/SysV/System V/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:12 -05:00
Michael Kerrisk 24f0c87e42 raise.3: SEE ALSO: add pthread_kill(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:12 -05:00
Michael Kerrisk 273f668082 getaddrinfo.3: srcfix: add FIXME 2008-10-29 14:54:04 -05:00
Michael Kerrisk 97004b99bf fopen.3: minor: Add pointer to glibc 'mode' extensions
Add a sentence in DESCRIPTION pointing reader to NOTES for
discussion of glibc extensions for 'mode'.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-12 08:08:50 +02:00
Michael Kerrisk 82b96f0198 fopen.3: srcfix: remove unneeded FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-12 08:01:20 +02:00
Michael Kerrisk 2f81a9f31c popen.3: Change one-line description in NAME
s%process I/O%pipe stream to or from a process%

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-12 07:57:36 +02:00
Michael Kerrisk 67cf694c64 popen.3: wfix: tweak just added text for 'e' flag
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-12 07:53:25 +02:00
Michael Kerrisk e18599c093 popen.3: Document 'e' (close-on-exec) flag
glibc 2.9 implements the 'e' flag in 'type', which sets the
close-on-exec flag on the underlying file descriptor.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-12 07:53:23 +02:00
Michael Kerrisk 28ddfa90ac popen.3: wfix: rework sentence describing 'type' argument
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-12 07:53:23 +02:00
Michael Kerrisk e008cdda60 fmemopen.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-12 07:53:22 +02:00
Michael Kerrisk 16ee3d5694 fmemopen.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-12 07:53:22 +02:00
Michael Kerrisk 363e70d263 fmemopen.3: Document binary mode (mode 'b')
Glibc 2.9 adds support to fmemopen() for binary mode opens.
Binary mode is specified by inclusion of the letter 'b' in
the 'mode' argument.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-12 07:52:59 +02:00
Michael Kerrisk acddbaea0c Removed trailing white space at end of lines 2008-10-07 10:58:44 +02:00
Michael Kerrisk 9f6293c4ea tstamp 2008-10-06 16:39:20 +02:00
Michael Kerrisk 7f546896f5 tstamp 2008-10-06 16:26:23 +02:00
Michael Kerrisk e8f4a1c928 getcwd.3: wfix (remove duplicate word) 2008-10-05 06:50:51 +02:00
Michael Kerrisk 6a0f91ccfa readdir.3: SEE ALSO: add getdents(2)
Because readdir() is implemented on top of getdents(2).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 15:08:04 +02:00
Michael Kerrisk efb92ba155 getdents.2, readdir.3: d_type is currently only supported on ext[234]
As at kernel 2.6.27, only ext[234] support d_type.
On other file systems, d_type is always set to DT_UNKNOWN (0).

Reported-by: Ricardo Catalinas Jiménez <jimenezrick@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 15:06:36 +02:00
Michael Kerrisk c42ad30f8c fma.3: Add some source code comments explaining two domain error cases.
Two of the "domain error" cases described on this page are treated in
the same way on Linux, but POSIX.1 specifies some optional differences
for the two cases.  Make life easier for future page reviewers/editors
by adding some comments explaining that POSIX.1-2001 distinguishes
the two cases.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Nicolas François <nicolas.francois@centraliens.net>
2008-09-29 13:42:58 +02:00
Nicolas François 69cb728c2f wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 13:24:36 +02:00
Nicolas François 11c87468b9 nextafter.3: Make description more precise: s/next/largest/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 13:22:21 +02:00
Nicolas François 166f4f1630 floor.3: Fix error in description: s/smallest/largest/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 13:21:55 +02:00
Nicolas François f010f3a2ce ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 13:05:56 +02:00
Nicolas François 4718ba1c3b atan2.3: Fix error in description of range or return value
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

In recent changes to the man page, mtk accidentally cganged
the description of the return value range to -pi/2..pi/2;
the corect range is -pi..pi.
2008-09-29 13:01:44 +02:00
Marko Kreen 7d557e75c0 strcpy.3: Revert earlier change to example strncpy() calls
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

I browsed the changes there and found a buggy code snippet:
2008-09-29 12:01:26 +02:00
Nicolas François 553f115ece cmsg.3: Add parentheses after macro names.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 11:33:04 +02:00
Nicolas François 178d104e83 Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 11:09:52 +02:00
Nicolas François 44e5793157 Typo and wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 11:00:36 +02:00
Michael Kerrisk 16d023bce2 grfix 2008-09-29 08:48:18 +02:00
Michael Kerrisk 247ac1d3da mg_getattr.3: mq_getattr() and mq_setattr() are layered on mq_getsetattr(2)
mq_getattr() and mq_setattr() are library functions layered on
top of the mq_getsetattr(2) system call.
(This is useful info for users of strace(1).)
2008-09-29 05:51:25 +02:00
Michael Kerrisk c89e428bcd mq_receive.3: mq_send() is a library function layered on mq_timedreceive() syscall
This info is useful for users of strace(1).
2008-09-29 05:40:37 +02:00