Commit Graph

2140 Commits

Author SHA1 Message Date
Michael Kerrisk 0dc60a9902 fclose.3: Minor rewordings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-23 15:27:03 +13:00
Michael Kerrisk 9d05bd16f8 getnameinfo.3: tfix
Reported-by: Leandro A. F. Pereira <leandro@tia.mat.br>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-23 14:51:28 +13:00
Michael Kerrisk a306ffff9f getlogin.3: spfix 2009-02-21 07:14:34 +13:00
Michael Kerrisk 88850fde24 getnetent_r.3: Fix function name in text: s/getnetbynumber_r/getnetbyaddr_r/
The SYNOPSIS showed the right function name (getnetbyaddr_r),
but the text repeatedly used the wrong name (getnetbynumber_r).
Probably, this was a cut-and-paste error.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-21 07:06:32 +13:00
Michael Kerrisk 88d61d8a48 syslog.3: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-21 06:56:43 +13:00
Michael Kerrisk 5a3b4036f6 realpath.3: spfix 2009-02-21 06:47:49 +13:00
Michael Kerrisk c49e8fc97b realpath.3: Rework resolved_path==NULL discussion w.r.t. POSIX.1-200[18]
Although the page already mentioned the resolved_path==NULL
feature, and that this feature was added in POSIX.1-2008, there
was still some crufty text in BUGS that hadn't been updated to
reflect the POSIX.1-2008 changes.

Also, some other minor wording and grammar fixes.

Reported-by: Reuben Thomas <rrt@femur.dyndns.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-21 06:40:45 +13:00
Michael Kerrisk 3683d2505b malloc_hook.3: srcfix 2009-02-21 00:19:53 +13:00
Michael Kerrisk c09cb5f47f recno.3: spfix 2009-02-21 00:19:06 +13:00
Michael Kerrisk d442cb84ea memchr.3: spfix 2009-02-21 00:17:41 +13:00
Michael Kerrisk ab186fbd11 inet.3: spfix 2009-02-21 00:16:37 +13:00
Michael Kerrisk 7ae19fdf8f memchr.3: spfix 2009-02-21 00:14:51 +13:00
Michael Kerrisk 09d7e7ebe1 clock_getcpuclockid.3, sem_open.3: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-20 20:22:00 +13:00
Jens Thoms Toerring db2fff8c01 sem_open.3: Add case of non-well-formed name to ENOENT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-20 19:52:31 +13:00
Michael Kerrisk 18fe47e06f sem_open.3: ERRORS: add EINVAL error where name == "/"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-20 19:52:31 +13:00
Michael Kerrisk 8e98475172 shm_open.3: Clarify rules for construction of shared memory object names
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-20 19:52:30 +13:00
Michael Kerrisk b2e7d0723e mq_open.3: ERRORS: Add EACCES error for name containing > 1 slash
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-20 19:52:30 +13:00
Michael Kerrisk 1e22e66618 mq_open.3: ERRORS: add ENOENT error for name == "/"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-20 19:52:30 +13:00
Kir Kolyshkin baf17bc4f2 Trivial punctuation fixes in SEE ALSO
In SEE ALSO, when a few man pages are referenced, those are divided by commas.
Every reference is on a separate line, and all lines but the last one should
end with comma. I spotted one place where there is no comma in between
references, and mocked up an awk script to find similar places:

for f in man*/*; do awk '/^.SH ["]SEE ALSO["]/ {sa=1; print "== " FILENAME " =="; print; next } /^\.(PP|SH)/ {sa=0; no=0; next} /^\.BR/ { if (sa==1) { print; if (no == 1) print "Missing comma in " FILENAME " +" FNR-1; no=0 } } /^\.BR .*)$/ { if (sa==1) no=1; next } /\.\\"/ {next} /.*/ { if (sa==1) { print; next }}' $f; done | fgrep 'Missing comma'

This patch fixes all the places found by the above script.

Also, there is an extra dot at the end of uri.7 "SEE ALSO" section.
Removed as per man-pages(7) recommendation.

Signed-off-by: Kir Kolyshkin <kir@openvz.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-20 19:52:29 +13:00
Michael Kerrisk 8699ebd957 getitimer.2, clock_getcpuclockid.3, time.7: SEE ALSO: add timer_create(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-10 14:42:17 +13:00
Michael Kerrisk d96dea0ac8 sigwait.3: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 15:06:33 +13:00
Michael Kerrisk c1091bc94e scandir.3: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 15:06:32 +13:00
Michael Kerrisk 3e8d776c07 clock_getres.3, clock_gettime.3, clock_settime.3: srcfix: Add comment explaining why these link files exist
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:33:48 +13:00
Michael Kerrisk 3da3747663 rand.3: srcfix: remove outdated FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:32:01 +13:00
Michael Kerrisk 8b98f282b6 sem_wait.3: SEE ALSO: add clock_getime(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:32:01 +13:00
Michael Kerrisk 0eb443910b clock_nanosleep.2, getrusage.2, timerfd_create.2, clock.3, clock_getcpuclockid.3, ftime.3, pthread_create.3, pthread_getcpuclockid.3, pthread_tryjoin_np.3, sem_wait.3, time.7: Global fix: Fix xrefs to clock_*.? pages to reflect move to section 2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:32:00 +13:00
Michael Kerrisk ac48bb8a29 clock_getres.3: Re-create as link to new location of clock_getres page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:32:00 +13:00
Michael Kerrisk 58ebb7ec73 clock_gettime.2, clock_settime.2, clock_gettime.3, clock_settime.3: Update links to reflect the fact that clock_* pages are now in Section 2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:32:00 +13:00
Michael Kerrisk 9bdcdd5e27 clock_getres.2: Move page from Section 3 to Section 2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:32:00 +13:00
Michael Kerrisk 804f03e657 clock_nanosleep.2, execve.2, fork.2, nanosleep.2, sigaction.2, timerfd_create.2, pthread_getcpuclockid.3, ualarm.3, usleep.3, pthreads.7, time.7: Global fix: s/(3)/(2)/ in section number xrefs for timer_*() API
The POSIX timers API is implemented (mostly) within the kernel,
so thse interfaces are system calls.  Although there are as yet
no man pages, when they are added they should be in Section 2,
not 3.  Therefore fix those pages that currently refer to these
interfaces as being in Section 3.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:29:10 +13:00
Michael Kerrisk f6d908ca5f pthread_getcpuclockid.3: SYNOPSIS: fix type of 'thread'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:29:02 +13:00
Michael Kerrisk 3f97f5a8d1 clock_getcpuclockid.3: SEE ALSO: add pthread_getcpuclockid(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:28:54 +13:00
Michael Kerrisk 1ba3fba8a7 clock_getres.3: Document CLOCK_MONOTONIC_RAW, new in 2.6.28
(kernel commit 2d42244ae71d6c7b0884b5664cf2eda30fb2ae68)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-04 14:02:50 +13:00
Michael Kerrisk 072f467c1f significand.3: wfix 2009-02-03 21:32:43 +13:00
Michael Kerrisk a85e5d51d3 rtime.3: spfix 2009-02-03 21:30:55 +13:00
Timo Sirainen 12c667ca28 fexecve.3: Note that fexecve() depends on a mounted /proc
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=514043

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 17:47:02 +13:00
Michael Kerrisk 1ed5046249 getpwnam.3: SEE ALSO: add getspnam(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 17:39:35 +13:00
Michael Kerrisk 980ee95f65 isalpha.3: SEE ALSO: add toascii(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 17:01:15 +13:00
Michael Kerrisk 55975b54fb ilogb.3: SEE ALSO: add significand(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 16:59:38 +13:00
Michael Kerrisk 0db3562749 significand.3: Add CONFORMING TO noting that this function is unstandardized
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 16:58:22 +13:00
Michael Kerrisk cc0dac782b pthread_attr_setscope.3: spfix 2009-02-03 16:50:33 +13:00
Michael Kerrisk b1e10d407d remainder.3: SEE ALSO: add div(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 16:30:31 +13:00
Michael Kerrisk 978b249975 btowc.3: SEE ALSO: add wctob(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 16:27:50 +13:00
Michael Kerrisk 11cfb06e07 wctob.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 16:27:14 +13:00
Michael Kerrisk a16cea5b13 wctob.3: SEE ALSO: add btowc(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 16:26:43 +13:00
Michael Kerrisk 63a6644b08 cos.3: SEE ALSO: add sincos(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 11:51:41 +13:00
Michael Kerrisk 2546a2bcd8 sin.3: SEE ALSO: add sincos(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 11:51:19 +13:00
Michael Kerrisk 34042be4ce stpcpy.3: Add BUGS section noting the possibility of buffer overruns
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 11:43:57 +13:00
Michael Kerrisk 56e50303bb stpcpy.3: Add missing pieces/fix various problems in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 11:43:32 +13:00
Michael Kerrisk b6898014c5 stpcpy.3: wspfix 2009-02-03 10:21:15 +13:00
Michael Kerrisk 822002bd96 stpcpy.3: CONFORMING TO: stpcpy() is nowadays on the BSDs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 10:20:02 +13:00
Michael Kerrisk 13300ad0bb strcpy.3: SEE ALSO: add stpcpy.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 10:15:47 +13:00
Michael Kerrisk 33a5ffc9ba pthread_join.3: tfix 2009-02-03 10:07:29 +13:00
Michael Kerrisk 2da325d7ff scandir.3: CONFORMING TO: alphasort() and scandir() are added to POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 09:55:36 +13:00
Michael Kerrisk 7a4b8d3631 scandir.3: CONFORMING TO: note that versionsort() was added to glibc in version 2.1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 09:55:24 +13:00
Michael Kerrisk 59414d4852 wcsdup.3: CONFORMING TO: note that this function was added in POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 09:55:17 +13:00
Michael Kerrisk d9a56b2e34 wcsncasecmp.3: CONFORMING TO: note that this function is added in POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 09:55:07 +13:00
Michael Kerrisk 2169618626 wcscasecmp.3: CONFORMING TO: note that this function is added in POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 09:54:43 +13:00
Michael Kerrisk aed04a0a89 fmemopen.3: CONFORMING TO: note that these functions are in POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 09:21:18 +13:00
Michael Kerrisk 50e3cb1f98 fexecve.3: CONFORMING TO: note addition of fexecve() in POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 09:13:23 +13:00
Michael Kerrisk afcfe2900a fexecve.3: 'fd' must be opened read-only and refer to a file that is executable
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 08:19:51 +13:00
Michael Kerrisk 0f7552d2a8 fexecve.3: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 07:53:09 +13:00
Michael Kerrisk 2d64f60e4d random.3: SEE ALSO: add random_r(3)
Reported-by: Peter Zijlstra <peterz@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-02 18:34:41 +13:00
Michael Kerrisk 7bbac16345 qsort.3: EXAMPLE: remove unnecessary "#include <stdlib.h>"
Reported-by: Christian Siebert <christian.siebert@s2000.tu-chemnitz.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-02 02:00:10 +13:00
Michael Kerrisk 6255c227d7 pthread_attr_setaffinity_np.3: SYNOPSIS: Fix declaration of 'attr'
Reported-by: Satyam Sharma <ssatyam@cse.iitk.ac.in>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-02 01:59:57 +13:00
Michael Kerrisk f5d458e6fe intro.3: SEE ALSO: add libc(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-01 00:19:04 +13:00
Michael Kerrisk c67e8ae963 pthread_kill_other_threads_np.3: New page documenting pthread_kill_other_threads_np(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-28 16:34:49 +01:00
Michael Kerrisk abb1d278d7 pthread_kill.3: New page documenting pthread_kill(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-28 16:34:43 +01:00
Michael Kerrisk de8fc4be0d mq_notify.3: Add cross reference to pthread_attr_init(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-27 02:43:49 +01:00
Michael Kerrisk 10e83d4682 offsetof.3: srcfix: remove out-of-date FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-27 02:39:25 +01:00
Michael Kerrisk cf499212e7 sigwait.3: Add EXAMPLES section referring to pthread_sigmask(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-27 02:36:07 +01:00
Michael Kerrisk b4ed795729 pthread_sigmask.3: New page documenting pthread_sigmask(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-27 02:34:56 +01:00
Michael Kerrisk 2472260fff isalpha.3: Fix statement that isalpa() is obsolete; should be isascii()
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=512709

Reported-by: Guillem Jover <guillem@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-24 00:14:35 +01:00
Petr Baudis d664f7cecf getifaddrs.3: Various small fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-22 21:22:00 +01:00
Michael Kerrisk 8aa7b8ebca getifaddrs.3: srcfix: Remove FIXME 2009-01-22 21:13:37 +01:00
Michael Kerrisk 825e43f0f9 getifaddrs.3: srcfix: Remove FIXME 2009-01-22 21:12:04 +01:00
Lucio Maciel 54457ec1f3 getifaddrs.3: Fix memory leak in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-22 21:08:56 +01:00
Florentin Duneau bb9554432c getrpcent.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-22 20:53:07 +01:00
Michael Kerrisk 0b0b6c0a2b getumask.3: Updated glibc version number in NOTES
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-20 15:27:12 +13:00
Michael Kerrisk 74ee79b977 Removed trailing white space at end of lines 2009-01-19 17:12:10 +13:00
Michael Kerrisk 373d0736d1 endian.3: CONFORMING TO: Explain differences in function names across systems
glibc/NetBSD/FreeBSD follow a naming convention for these
functions that unfortunately differs from that originally
established by OpenBSD's implementation.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-18 14:20:36 +13:00
Michael Kerrisk d1a7f7d9f4 strsep.3: BUGS: explicitly list problems afflicting strsep()
Previously, the page said this function suffered the same
problems as strtok(), but in fact strsep() doesn't suffer
from all of the same problems as strtok(), so explicitly
list just the problems of strsep() in the strsep.3 page.

Reported-by: Marc Lehmann <schmorp@schmorp.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-15 07:12:58 +13:00
Michael Kerrisk 132719a5d9 strtok.3: Minor: small rewording in BUGS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-15 06:30:33 +13:00
Michael Kerrisk 7bb33c46ef strtok.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-15 06:20:17 +13:00
Michael Kerrisk fbb2bb4e34 sethostid.3: Rename file (was misnamed sethostd.3 in previous release)
Reported-by: Martin (Joey) Schulze <joey@infodrom.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-15 06:01:36 +13:00
Michael Kerrisk 095fdaea89 byteorder.3: SEE ALSO: add endian(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-14 23:23:17 +13:00
Michael Kerrisk f7c3598ef1 htobe16.3 htole16.3 be16toh.3 le16toh.3 htobe32.3 htole32.3 be32toh.3 le32toh.3 htobe64.3 htole64.3 be64toh.3 le64toh.3: New link to new endian.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-14 23:23:06 +13:00
Michael Kerrisk d35a667305 endian.3: New page documenting byte order conversion functions
Document functions (new in glibc 2.9) for conversion between
host byte order and big-/little- endian byte order:
htobe16(), htole16(), be16toh(), le16toh(),
htobe32(), htole32(), be32toh(), le32toh(),
htobe64(), htole64(), be64toh(), le64toh()

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-14 23:04:12 +13:00
Michael Kerrisk 43e77e4380 freeifaddrs.3: New link to new getifaddrs.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-14 16:23:10 +13:00
Petr Baudis 413b97573e getifaddrs.3: New page documenting getifaddrs(3) and freeifaddrs(3)
Many edits and changes of Petr's initial draft by mtk

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-14 16:22:59 +13:00
Michael Kerrisk 01c0d450f9 memccpy.3: Fix CONFORMING TO: s/C99/POSIX.1-2001/
Reported-by: Mads Martin Joergensen <mmj@mmj.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-14 10:41:53 +13:00
Michael Kerrisk 497be851c2 memccpy.3: If the memory areas overlap, the results are undefined
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-14 10:41:53 +13:00
Michael Kerrisk e739a26839 setjmp.3: Clarify when setjmp() provides BSD vs System V signal mask semantics
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-14 10:41:44 +13:00
Michael Kerrisk 1192ed9476 longjmp.3, setjmp.3: Clarify wording re saving/restoring signal mask
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-14 10:41:43 +13:00
Michael Kerrisk 78604af5bf longjmp.3: siglongjmp() only restores signal mask iff 'savesigs' was non-zero
Note that siglongjmp() only restores signal mask if, and only
if, 'savesigs' argument of sigsetjmp() was non-zero.  (Previous
text omitted the "and only if".)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-14 10:41:31 +13:00
Adeodato Sim c1f3b740e8 malloc.3: tfix: RETURN VALUE: s/realloc/calloc/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 13:50:08 +13:00
Michael Kerrisk 2c4432fc51 gethostid.3: tstamp 2009-01-13 08:52:13 +13:00
Michael Kerrisk c18ecec98b dlopen.3, ld.so.8: SEE ALSO: add rtld-audit(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:47:47 +13:00
Michael Kerrisk 24ad017de2 clock_getres.3: SEE ALSO: Add pthread_getcpuclockid(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:49 +13:00
Michael Kerrisk 0d6cdbf56d pthread_getcpuclockid.3: minor: remove extraneous source comment
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:49 +13:00
Michael Kerrisk c0d72e9ef9 pthread_getcpuclockid.3: New page documenting pthread_getcpuclockid(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:49 +13:00
Michael Kerrisk f9d5bb737b gethostid.3: Before version 2.2, glibc stored the host ID in /var/adm/hostid
Also: rewrite some text describing the /etc/hostid file, so that
this location is referred to just once on the page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:48 +13:00
Michael Kerrisk 4c98d1203b gethostid.3: Added ERRORS section describing errors for sethostid()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:48 +13:00
Michael Kerrisk 0482681627 gethostid.3: RETURN VALUE: describe return value of sethostid()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:48 +13:00
Michael Kerrisk 9caf825633 gethostid.3: Minor wording improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:47 +13:00
Michael Kerrisk 525748e03a gethostid.3: Added BUGS section noting that ID can't be guaranteed to be unique
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:47 +13:00
Michael Kerrisk 963efe88c5 gethostid.3: Update section number to reflect relocation into Section 3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:31 +13:00
Michael Kerrisk a1096a314e sethostid.3: New link to relocated page in Section 3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 07:04:35 +13:00
Michael Kerrisk 1f4f66a924 gethostid.2: Move to Section 3
The interfaces documented in this page are purely glibc.

Reported-by: Colin Watson <cjwatson@ubuntu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 07:00:44 +13:00
Florentin Duneau de90951b73 CPU_SET.3: tfix
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=510507.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-12 23:22:09 +13:00
Michael Kerrisk 08f8825735 printf.3: Source and destination buffers may not overlap for *s*printf()
http://sourceware.org/bugzilla/show_bug.cgi?id=7075

Some existing code relies on techniques like the following to
append text to a buffer:

    $ cat s.c
    #include <stdio.h>
    char buf[80] = "not ";
    main()
    {
        sprintf(buf, "%sfail", buf);
	puts(buf);
	return 0;
    }

    $ cc s.c
    $ ./a.out
    not fail

However, the standards say the results are undefined if source
and destination buffers overlap, and with suitable compiler
options, recent changes can cause unexpected results:

    $ cc -v 2>&1 | grep gcc
    gcc version 4.3.1 20080507 (prerelease) [gcc-4_3-branch revision 135036] (SUSE Linux)
    $ cc -D_FORTIFY_SOURCE -O2 s.c
    $ ./a.out
    fail

Reported-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-19 11:47:04 -05:00
Petr Baudis 4209865fa4 crypt.3: ffix
Signed-off-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-19 10:03:18 -05:00
Michael Kerrisk 6a5dd8b393 readdir.3: Clarify text for return value/errno setting for end-of-stream case
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-19 09:36:12 -05:00
Michael Kerrisk 4b3caf6feb readdir.3: Rewrite text describing 'dirent' fields standardized in POSIX.1 2008-12-19 09:00:58 -05:00
Petr Baudis 450c838664 dlopen.3: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 12:11:51 -05:00
Michael Kerrisk 16625773f9 fmemopen.3: Fix VERSIONS information
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Petr Baudis <pasky@suse.cz>
2008-12-06 12:03:31 -05:00
Michael Kerrisk 8ccde1f0a5 Removed trailing white space at end of lines 2008-12-05 22:53:52 -05:00
Michael Kerrisk 5cedb08f41 bindresvport.3: Fix errors regarding port used, plus other rewrites
Glibc's bindresvport() takes no notice of sin->sin_port:
it always returns an arbitrary reserved port in the
anonymous range (512-1023).  (Reported by Mats Wichmann.)

Also:
* Add EADDRINUSE and EACCES errors.
* Mention use of getsockname(2).
* Other minor rewrites and reorderings of the text.
* Explicitly note that glib's bindresvport() ignores
  sin->sin_port.
* Change license There's now virtually no text remaining from
  the 1.70 version of this page.

Reported-by: Mats Wichmann <mats.d.wichmann@intel.com>
Reviewed-by: Mats Wichmann <mats.d.wichmann@intel.com>
Reviewed-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:26 -05:00
Michael Kerrisk 6eb334b2cf bind.2, rcmd.3, capabilities.7, ip.7: Global fix: s/reserved port/privileged port/
Some pages used one term, some pages the other term;
make some consistency.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:26 -05:00
Michael Kerrisk 97aec57c6f setlocale.3, locale.7: Clean up the description of LANGUAGE environment variable
Clean up the $LANGUAGE description, by removing bogus comments
from setlocale(3) and expanding the mention in locale(7).

Maybe you will decide that a more detailed description should be left
to the gettext(3) documentation, but I actually care about the invisible
part of the patch more since the comments have put me off the track
initially ($LANGUAGE has nothing to do with setlocale(3) and is
completely isolated to gettext, as obvious from the glibc sources).

Signed-off-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:25 -05:00
Michael Kerrisk f439817725 dlopen.3: wsfix 2008-12-05 22:47:25 -05:00
Michael Kerrisk 1d2c48b3a7 dlopen.3: ffix 2008-12-05 22:47:25 -05:00
Petr Baudis 27a61e8622 dlopen.3: Describe confusing dladdr() behavior
dladdr() will act unexpectedly if called from non-pic code on a
compile-time-generated function pointer:

    /* test_dladdr.c */

    #define _GNU_SOURCE
    #include <dlfcn.h>
    #include <stdio.h>

    int
    main(void)
    {
        void *func;
        Dl_info info = {};

        func = printf;
        dladdr(func, &info);
        printf("%s at %p resolved from %s\n", info.dli_sname,
                func, info.dli_fname);

        return 0;
    }

    $ cc test_dladdr.c -ldl
    $ ./a.out
    printf at 0x804838c resolved from ./a.out
    $ cc -fPIC test_dladdr.c -ldl
    $ ./a.out
    _IO_printf at 0xb7f71c30 resolved from /lib/libc.so.6

In the long term, it might make sense to make dladdr() recognize
plt pointers and recurse, but I'm too afraid of Ulrich ;-)
(and he seems to be heavy proponent of pic code anyway, so
the chances for that to be accepted probably aren't high).

Signed-off-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:25 -05:00
Michael Kerrisk 8461e2c703 memmem.3: Remove sentence saying that libc 5.0.9 is still widely used
That was a *long* time ago.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:23 -05:00
Michael Kerrisk 6a02322941 memmem.3: grfix wfix 2008-12-05 22:47:23 -05:00
Michael Kerrisk f84addeb7f memmem.3: ffix 2008-12-05 22:47:23 -05:00
Michael Kerrisk 4f9ea6c361 fmemopen.3: minor: wording tweak
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:22 -05:00
Michael Kerrisk 99111b7580 fmemopen.3: ffix 2008-12-05 22:47:22 -05:00
Petr Baudis 8a4051693d open_wmemstream.3: New link to fmemopen.3
fmemopen.3 now documents open_wmemstream().

Signed-off-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:22 -05:00
Michael Kerrisk 45906a480f fmemopen.3: Add VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:22 -05:00
Petr Baudis 3a0f269da2 fmemopen.3: Add description of open_wmemstream(3)
Signed-off-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:21 -05:00
Petr Baudis 00269a5a24 getaddrinfo.3: Document results ordering and /etc/gai.conf
This patch documents the order of the getaddrinfo(3) results
(RFC 3484), how should the application deal with that,
mentions the extremely common cause of having multiple
results per query (both IPv4 and IPv6 addresses available)
and mentions /etc/gai.conf.

(mtk: Minor tweaks, and note glibc version for /etc/gai.conf)

Signed-off-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:21 -05:00
Petr Baudis a2f86747f1 fopencookie.3: fopencookie() needs _GNU_SOURCE feature test macro
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:21 -05:00
Petr Baudis 5f0aa64a2e fopen.3: SEE ALSO: Add fmemopen(3) and fopencookie(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:21 -05:00
Petr Baudis da607ba120 fmemopen.3: SEE OPEN: Add fopencookie(3)
fopencookie(3) is used to implement fmemopen().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:20 -05:00
Michael Kerrisk 2656acee7d atexit.3: Calling exit(3) more than once produces undefined results
If an exit handler itself calls exit(3), the results are
undefined (see the POSIX.1-2001 specification of exit(3)).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:20 -05:00
Michael Kerrisk db217984ec atexit.3: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:20 -05:00
Michael Kerrisk ee394477fa atexit.3: The same exit handler may be registered multiple times
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:20 -05:00
Michael Kerrisk 41bf770ca3 atexit.3: Calling _exit(2) terminates processing of exit handlers
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:20 -05:00
Michael Kerrisk 374b9a8f7b atexit.3: atexit() and on_exit(3) register functions on the same list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:19 -05:00
Michael Kerrisk 84fc5566f5 atexit.3: Terminating registered function using longjmp() is undefined
According to POSIX.1, using longjmp() to terminate execution of
a function registered using atexit() produces undefined results.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:19 -05:00
Michael Kerrisk 7c298e468d atexit.3: Terminating registered function using longjmp() is undefined
According to POSIX.1, using longjmp() to terminate execution of
a function registered using atexit() produces undefined results.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:19 -05:00
Michael Kerrisk d8437814df on_exit.3: Arg given to registered function is status from *last* call to exit()
It's a subtle point, but if a registered function itself
calls exit(3), then subsequent functions that were registered
with on_exit(3) will see the exit status given to the more
recent exit(3) call.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:19 -05:00
Michael Kerrisk 36a0cc2596 on_exit.3: Document handling of registrations on fork(2) and execve(2)
Treatment in these cases is the same as for atexit(3).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:19 -05:00
Michael Kerrisk 6a275cde4d on_exit.3: Note that same function may be registered multiple times
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:18 -05:00
Michael Kerrisk 22a33e86af envz_add.3, wordexp.3: wsfix 2008-12-05 22:47:18 -05:00
Michael Kerrisk df4ab0f63f pthread_cleanup_pop_restore_np: New link to new pthread_cleanup_push_defer_np.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:17 -05:00
Michael Kerrisk f06b4f5c47 pthread_cleanup_push_defer_np.3: New page for pthread_cleanup_push_defer_np(3) and pthread_cleanup_pop_restore_np(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:29:01 -05:00
Michael Kerrisk 46c0fadf3a remove.3: Minor rewordings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:29:00 -05:00
Michael Kerrisk 0c637bbd95 isatty.3: ffix wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:29:00 -05:00