867a8f5dfc
makecontext.3: Note that POSIX.1-2008 recommends the use of POSIX threads instead
...
Reported-by: Jan Engelhardt <jengelh@medozas.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-15 08:07:54 +13:00
ff9fe6df96
isalpha.3: Explain why POSIX.1-2008 marks isascii(3) obsolete
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-15 08:07:41 +13:00
cbf4eee73f
index.3: Note that POSIX.1-2008 recommends strchr(3) and strrchr(3) instead
...
Reported-by: Jan Engelhardt <jengelh@medozas.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-15 08:04:59 +13:00
aeb2174ae7
gethostbyname.3: POSIX.1-2008 recommends getaddrinfo(3) and getnameinfo(3) instead
...
Reported-by: Jan Engelhardt <jengelh@medozas.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-15 08:04:58 +13:00
40e122bbeb
getcwd.3: Note that getcwd() should be used instead of the obsolete getwd()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-15 08:04:58 +13:00
4aeb80edca
ftime.3: Minor wording fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-15 08:04:58 +13:00
fb2d6d3616
gcvt.3: Note that POSIX.1-2008 recommends sprintf(3) instead of this function
...
Reported-by: Jan Engelhardt <jengelh@medozas.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-15 08:04:58 +13:00
5a4668117d
ecvt.3: Note that POSIX.1-2008 recommends sprintf(3) instead of these functions
...
Reported-by: Jan Engelhardt <jengelh@medozas.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-15 08:04:58 +13:00
9e36b352bc
ctime.3: Note that POSIX.1-2008 recommends strftime(3) instead of these functions
...
Reported-by: Jan Engelhardt <jengelh@medozas.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-15 08:04:58 +13:00
48cc3d9d8f
bcopy.3: Note that POSIX.1-2008 removes specification of bcopy()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-15 08:04:57 +13:00
67bb874245
bsd_signal.3: Note that POSIX.1-2008 recommends sigaction(2) instead of this API
...
Reported-by: Jan Engelhardt <jengelh@medozas.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-15 08:04:57 +13:00
fc3c831d6b
seekdir.3: SYNOPSIS: Fix type of 'offset' argument: s/off_t/long/
...
And add a NOTES section pointing out that 'off_t'
was indeed used in glibc 2.1.1 and earlier.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519230
Reported-by: Tanaka Akira <akr@fsij.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-12 15:03:41 +13:00
48e39fa763
telldir.3: SYNOPSIS: Fix return type: s/off_t/long/
...
And add a NOTES section pointing out that 'off_t'
was indeed used in glibc 2.1.1 and earlier.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519230
Reported-by: Tanaka Akira <akr@fsij.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-12 15:03:41 +13:00
7dcae89694
mempcpy.3, signbit.3, significand.3: Global fix: acknowledge FSF in copyright
...
These pages are heavily based on original material in
glibc info pages, but the comments in the source of the pages
did not acknowledge the FRF copyright on the original material.
Fix that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-12 07:24:34 +13:00
6652fffac3
timeradd.3: Note that on some systems, <=, >=, == don't work for timercmp()
...
Reported-by: Martin Gebert <martin.gebert@alpha-bit.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-08 13:35:18 +13:00
f6c92d2a5e
timeradd.3: SYNOPSIS: Fix return types of timerisset() and timercmp()
...
Reported-by: Martin Gebert <martin.gebert@alpha-bit.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-08 13:35:17 +13:00
bd8384888b
shm_open.3, mq_overview.7: Recast discussion on name length to exclude terminating NULL byte
...
Probably it's clearer to describe the length of the IPC object
name as a count that excludes the null terminator.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-08 13:34:49 +13:00
590d0346d9
strftime.3: Add details on ISO 8601 week-based dates
...
ISO 8602 week-based dates are relevant for %G, %g, and %V,
and the existing details on these dates are a little thin.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-24 16:05:49 +13:00
894765f0e5
strftime.3: Remove mention of year from ISO 8601 standard
...
The text mentioned the 1988 8601 standard, but there have
already been two revisions of the standard since then, so
simply remove mention of the year.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-24 14:02:37 +13:00
3d78d77891
strftime.3: Small fix to description of %G
...
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=516677
Reported-by: Reuben Thomas <rrt@femur.dyndns.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-24 14:02:36 +13:00
28d03ce9e9
daemon.3, exec.3, fmemopen.3, fopen.3, realpath.3, siginterrupt.3, strtoul.3: Minor rewordings
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-23 15:34:12 +13:00
9e39c4da05
fflush.3: Minor rewordings
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-23 15:32:28 +13:00
0dc60a9902
fclose.3: Minor rewordings
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-23 15:27:03 +13:00
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
a306ffff9f
getlogin.3: spfix
2009-02-21 07:14:34 +13:00
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
88d61d8a48
syslog.3: spfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-21 06:56:43 +13:00
5a3b4036f6
realpath.3: spfix
2009-02-21 06:47:49 +13:00
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
3683d2505b
malloc_hook.3: srcfix
2009-02-21 00:19:53 +13:00
c09cb5f47f
recno.3: spfix
2009-02-21 00:19:06 +13:00
d442cb84ea
memchr.3: spfix
2009-02-21 00:17:41 +13:00
ab186fbd11
inet.3: spfix
2009-02-21 00:16:37 +13:00
7ae19fdf8f
memchr.3: spfix
2009-02-21 00:14:51 +13:00
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
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
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
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
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
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
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
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
d96dea0ac8
sigwait.3: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 15:06:33 +13:00
c1091bc94e
scandir.3: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 15:06:32 +13:00
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
3da3747663
rand.3: srcfix: remove outdated FIXME
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:32:01 +13:00
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
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
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
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
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
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
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
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
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
072f467c1f
significand.3: wfix
2009-02-03 21:32:43 +13:00
a85e5d51d3
rtime.3: spfix
2009-02-03 21:30:55 +13:00
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
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
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
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
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
cc0dac782b
pthread_attr_setscope.3: spfix
2009-02-03 16:50:33 +13:00
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
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
11cfb06e07
wctob.3: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 16:27:14 +13:00
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
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
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
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
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
b6898014c5
stpcpy.3: wspfix
2009-02-03 10:21:15 +13:00
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
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
33a5ffc9ba
pthread_join.3: tfix
2009-02-03 10:07:29 +13:00
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
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
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
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
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
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
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
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
0f7552d2a8
fexecve.3: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 07:53:09 +13:00
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
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
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
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
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
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
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
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
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
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
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
d664f7cecf
getifaddrs.3: Various small fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-22 21:22:00 +01:00
8aa7b8ebca
getifaddrs.3: srcfix: Remove FIXME
2009-01-22 21:13:37 +01:00
825e43f0f9
getifaddrs.3: srcfix: Remove FIXME
2009-01-22 21:12:04 +01:00
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
bb9554432c
getrpcent.3: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-22 20:53:07 +01:00
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
74ee79b977
Removed trailing white space at end of lines
2009-01-19 17:12:10 +13:00
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
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
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
7bb33c46ef
strtok.3: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-15 06:20:17 +13:00
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
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
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
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
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
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
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
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
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
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
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
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
2c4432fc51
gethostid.3: tstamp
2009-01-13 08:52:13 +13:00
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
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
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
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
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
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
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
9caf825633
gethostid.3: Minor wording improvements
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:47 +13:00
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
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
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
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
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
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
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
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
4b3caf6feb
readdir.3: Rewrite text describing 'dirent' fields standardized in POSIX.1
2008-12-19 09:00:58 -05:00
450c838664
dlopen.3: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 12:11:51 -05:00
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
8ccde1f0a5
Removed trailing white space at end of lines
2008-12-05 22:53:52 -05:00
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
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
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
f439817725
dlopen.3: wsfix
2008-12-05 22:47:25 -05:00
1d2c48b3a7
dlopen.3: ffix
2008-12-05 22:47:25 -05:00
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
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
6a02322941
memmem.3: grfix wfix
2008-12-05 22:47:23 -05:00
f84addeb7f
memmem.3: ffix
2008-12-05 22:47:23 -05:00
4f9ea6c361
fmemopen.3: minor: wording tweak
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:22 -05:00
99111b7580
fmemopen.3: ffix
2008-12-05 22:47:22 -05:00
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
45906a480f
fmemopen.3: Add VERSIONS section
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:22 -05:00
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
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
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
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
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
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
db217984ec
atexit.3: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:20 -05:00
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
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
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
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
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
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
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
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
22a33e86af
envz_add.3, wordexp.3: wsfix
2008-12-05 22:47:18 -05:00
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
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
46c0fadf3a
remove.3: Minor rewordings
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:29:00 -05:00
0c637bbd95
isatty.3: ffix wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:29:00 -05:00
fac9854624
isatty.3: Complete rewrite of this page, with rather more detail
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:29:00 -05:00
c4e7b71426
getpeername.2, getsockname.2, getsockopt.2, recv.2, send.2, shutdown.2, sockatmark.3, socket.7, udplite.7: SYNOPSIS: Rename socket file descriptor argument to 'sockfd'
...
Many sockets man pages use the name 'sockfd' already.
For consistency, changes the others to do so as well.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:56 -05:00
4510cb9d07
bindresvport.3: SYNOPSIS: s/\*\*/*/ in prototype
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:56 -05:00
56b2037871
bindresvport.3: wfix tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:56 -05:00
be4c136ad5
atan.3: Fix return value description
...
The correct range for the return value is [-pi/2,pi/2].
(mtk's fix in the last change to the return value text was
a botch-up of a (correct) suggestion by Nicolas Francois.)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:55 -05:00
2bada9cfe0
makedev.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:55 -05:00
0382510bc1
makedev.3: srcfix: remove FIXMEs
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:54 -05:00
4770bc9118
gnu_dev_major.3, gnu_dev_makedev.3, gnu_dev_minor.3, major.3, minor.3: New links to new makedev(3) page
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:54 -05:00
47a0131ab7
makedev.3: New page for makedev(), major(), and minor() macros
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reviewed-by: Phil Endecott <phil_vonar_endecott@chezphil.org>
2008-12-05 22:28:54 -05:00
314c72c381
CPU_SET.3: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-28 11:18:52 -05:00
a113945faa
Removed trailing white space at end of lines
2008-11-25 21:44:53 -05:00
a86f0a4b0e
pthread_setcancelstate.3: Add another sentence to NOTES on asynchronous cancelability
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:26 -05:00
f5410853fb
pthread_setcancelstate.3: spfix
2008-11-25 20:54:26 -05:00
0ac743c540
pthread_cleanup_push.3: minor fix to example program
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Loic Domaigne <tech@domaigne.com>
2008-11-25 20:54:26 -05:00
f90fec66e2
pthread_cleanup_push.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Loic Domaigne <tech@domaigne.com>
2008-11-25 20:54:26 -05:00
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
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
a3dadfe86f
sigwait.3: wfix: s/set/sig/
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:24 -05:00
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
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
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
222d90f4e9
pthread_getattr_np.3, pthread_setschedparam.3: wfix
2008-11-25 20:54:04 -05:00
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
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
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
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
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
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
65cc854059
pthread_setaffinity_np.3: srcfix: spfix
2008-11-25 20:54:02 -05:00
803486cb45
pthread_setaffinity_np.3: srcfix: Add comment: CONFIG_NR_CPUS may become obsolete one day
2008-11-25 20:54:02 -05:00
d4ac23a7e2
pthread_testcancel.3: New page for pthread_testcancel(3)
2008-11-25 20:54:02 -05:00
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
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
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
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
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
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
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
188cf22e22
pthread_create.3: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:00 -05:00
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
553e8b962e
pthread_setaffinity_np.3: tfix
2008-11-25 20:54:00 -05:00
f5bf1e9b13
pthread_setaffinity_np.3: Various improvements after review by Loc Domaigne
...
Various fix-ups after Loc's review.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reviewed-by: Loc Domaigne <tech@domaigne.com>
2008-11-25 20:54:00 -05:00
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
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
50ee5bc147
CPU_SET.3: spfix
2008-11-25 20:53:59 -05:00
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
214c1dd290
CPU_SET.3: grfix
2008-11-25 20:53:54 -05:00
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
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
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
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
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
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
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
ef5694bc07
pthread_attr_setaffinity_np.3: spfix
2008-11-25 20:53:52 -05:00
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
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
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
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
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