Commit Graph

1977 Commits

Author SHA1 Message Date
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: Trk 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 Jimnez <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 Franois <nicolas.francois@centraliens.net>
2008-09-29 13:42:58 +02:00
Nicolas Franois 69cb728c2f wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 13:24:36 +02:00
Nicolas Franois 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 Franois 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 Franois f010f3a2ce ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 13:05:56 +02:00
Nicolas Franois 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 Franois 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 Franois 178d104e83 Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 11:09:52 +02:00
Nicolas Franois 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
Michael Kerrisk 5496c8c1d2 mq_send.3: mq_send() is a library function layered on mq_timedsend() syscall
This info is useful for users of strace(1).
2008-09-29 05:36:48 +02:00
Michael Kerrisk bf0e2b8a8e realpath.3: clarify that returned pathname is NULL terminated
Also clarify that null-byte is included in PATH_MAX limit.
2008-09-26 07:22:00 +02:00
Michael Kerrisk d0cb7cc649 grfix: s/null terminated string/null-terminated string/ 2008-09-26 07:13:25 +02:00
Michael Kerrisk f9db4400fd ctime.3: clarify mktime()'s use of tm_isdst
Describe use of tm_isdst for input to mktime();
explain how mktime() modifies this field.
(This field is left unchanged in case of error.)

Reported-by: Eugene V. Lyubimkin <jackyf.devel@gmail.com>
Debian bug 500178
2008-09-26 06:48:22 +02:00
Michael Kerrisk ef38dda012 ctime.3 Minor rewording
Clarify wording for ctime_r() and asctime_r() to indicate that
the bffer must be at least 26 *bytes*.
2008-09-26 06:05:54 +02:00
Michael Kerrisk 9ef659a9a8 ctime.3: minor rewording of mktime() description. 2008-09-26 06:02:10 +02:00
Michael Kerrisk 8fe528b35b ffix 2008-09-26 05:02:12 +02:00
Michael Kerrisk 63e3731b2c tstamp 2008-09-25 11:11:08 +02:00
André Goddard Rosa 7b80ee9bff strcpy.3: Avoid redundantly filling the position 'n - 1' two times in strncpy() example code
When we use 'strncpy(buf, str, n)', strncpy() will fill chars from 0..(n - 1).
As we force the character at position 'n - 1' to be '\0' anyway, don't fill
it in strncpy() before.

Signed-off-by: André Goddard Rosa <andre.goddard@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-25 10:12:33 +02:00
André Goddard Rosa ed7bbec7a5 hsearch.3: Call hdestroy() after using hash table created by hcreate(), for the sake of completeness
Signed-off-by: André Goddard Rosa <andre.goddard@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-25 10:02:19 +02:00
Michael Kerrisk 3fe44d51dd Tweak check of 'val' after tsearch() call. 2008-09-23 15:38:33 +02:00
George Spelvin 7134d7e62c Clarify closedir()'s treatment of underlying file descriptor.
At the end of the paragraph in opendir(3) describing fdopendir(), I
think it's worth adding "The file descriptor will be closed when
closedir() is called."  It's a bit ambiguous if the file descriptor
is closed or "given back" at closedir time.

(I've tested this and verified that it's true, BTW.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-23 08:55:50 +02:00
Michael Kerrisk 6dea120e68 Fix 'dir' argument name: should be 'dirp'.
POSIX.1-2008 and glibc call this argument 'dirp' (consistent
with the fact that it is a *pointer* to a DIR structure).
2008-09-23 08:45:52 +02:00
Michael Kerrisk 2390bfe8fd Add feature test macro to example program
tdestroy() needs _GNU_SOURCE.
2008-09-23 08:22:22 +02:00
André Goddard Rosa 6fa5dff6b4 tsearch.3: dispose properly of allocated resources in example code
As there are many users who base their own code on these examples,
we should avoid leaking memory when using functions of tsearch() family.
In the provided example, tsearch() leaks memory whenever it tries to
insert a number which was already inserted before.

Also: include use of tdestroy() in example program.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-23 08:20:29 +02:00
Michael Kerrisk 3e7a52936d Fix 'dir' argument name: should be 'dirp'.
The page formerly used both 'dir' and 'dirp'(!).
POSIX.1-2008 and glibc call this argument 'dirp' (consistent
with the fact that it is a *pointer* to a DIR structure).
2008-09-23 04:25:35 +02:00
Michael Kerrisk d4e9903bb7 Removed trailing white space at end of lines 2008-09-10 12:39:34 +00:00
Michael Kerrisk da1eef3d9d tstamp 2008-09-10 10:35:15 +00:00
Michael Kerrisk 30da961413 tstamp 2008-09-10 10:19:15 +00:00
Michael Kerrisk 19eee0a623 s/stat(2)/lstat(2)/ when discussin d_type (since we
are talking about a case where we might be interested to
whether the file itself is a symbolic link).
2008-09-10 10:18:53 +00:00
Michael Kerrisk 9da1822fd8 tfix 2008-09-10 09:18:38 +00:00
Michael Kerrisk d6a591bc7f tfix 2008-09-10 09:05:33 +00:00
Michael Kerrisk eeeffe2d3b grfix 2008-09-10 03:41:35 +00:00
Michael Kerrisk 6dec79368a tstamp 2008-09-09 05:48:35 +00:00
Michael Kerrisk 79bf8cdcf3 Document fopencookie(3), a library function that allows
custom implementation of a stdio stream.
2008-09-09 05:48:00 +00:00
Michael Kerrisk 037273a620 Describe "shift sequence" input. 2008-09-08 13:50:13 +00:00
Michael Kerrisk 5b0dc1baed s/time zone/timezone/ for consistency across pages and with POSIX.1. 2008-09-07 04:17:25 +00:00
Michael Kerrisk e957764019 Rewrite description of getdate_r() and integrate into main text
(rather than describing in NOTES).
Other parts rewritten for greater clarity.
Make it clearer in the main text that glibc does not implement %Z;
remove discussion of that point from NOTES.
Added an example program.
2008-09-07 04:11:07 +00:00
Michael Kerrisk b905d225d2 Add "Link with -lrt" to SYNOPSIS; remove now redundant
sentence mentioning librt from NOTES.
2008-09-05 10:04:06 +00:00
Michael Kerrisk 0927f4c5cf tweaks 2008-09-03 10:32:22 +00:00
Michael Kerrisk 74f7e82aa9 Updated changelog 2008-09-03 08:09:40 +00:00
Michael Kerrisk fc5911e1ea glibc headers: s/ret/retval/; s/tab/htab/.
Integrate discussion of reentrant functions into main discussion
(rather than as a short paragraph at the end).
Other minor additions and changes.
2008-09-03 08:07:02 +00:00
Michael Kerrisk 7a4076fa06 tweaks 2008-09-03 05:55:36 +00:00
Michael Kerrisk 55fbb69b35 Fix return type of ptsname_r() in SYNOPSIS. 2008-09-03 05:23:11 +00:00
Michael Kerrisk 4f5aae8404 Update changelog 2008-09-02 14:25:59 +00:00
Michael Kerrisk fe80e23e06 Noted that table size as specified by 'nel' is immutable.
Described differences between hsearch() and hsearch_r().
Added missing pieces to RETURN VALUE.
Added a number of new entries under ERRORS.
NOTES: added some basic advice on sizing the hash table;
noted that when a table is destroyed, the caller is responsible
for freeing the buffers pointed to by 'key' and 'data' fields.
One of the BUGS was fixed in glibc 2.3.
Rewrote and clarified various other pieces.
2008-09-02 14:06:20 +00:00
Michael Kerrisk 86bd1991a5 Fix typo: s/sigdelset/sigorset/ 2008-09-01 10:42:14 +00:00
Michael Kerrisk e4da5dfcc3 ffix 2008-09-01 10:30:48 +00:00
Michael Kerrisk 0f200f076c Add/fix feature test macro requirements. 2008-08-29 15:50:13 +00:00
Michael Kerrisk dafba96a51 SEE ALSO: Add clock_gettime(3), clock(3). 2008-08-28 11:13:21 +00:00
Michael Kerrisk 8fe60aeffb Removed trailing white space at end of lines 2008-08-27 06:07:22 +00:00
Michael Kerrisk 8ef32a2b4d tstamp 2008-08-27 06:02:44 +00:00
Michael Kerrisk 7fb7a60bb5 Link to crypt.3. 2008-08-25 04:58:00 +00:00
Michael Kerrisk 4e602cb2b0 Add description of crypt_r(). 2008-08-25 04:57:21 +00:00
Michael Kerrisk 33b1b47eb7 Since glibc 2.7, it is possible to seek past the end of
a stream created by open_memstream().  Add a BUGS section
describing the bug in earlier glibc versions.
2008-08-21 10:06:18 +00:00
Michael Kerrisk 9908786738 Remove FIXMEs. 2008-08-21 08:47:09 +00:00
Michael Kerrisk 345edc6afd POSIX.1-2008 rectifies the POSIX.1-2001 ommission, specifying
that zero is returned by a successful sem_init() call.
2008-08-21 06:48:50 +00:00
Michael Kerrisk 2773008f52 These interfaces are specified in POSIX.1-2008. 2008-08-21 06:31:11 +00:00