Commit Graph

7926 Commits

Author SHA1 Message Date
Michael Kerrisk 986bc4a267 Changes: Ready for 3.42
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-14 00:29:05 +02:00
Bjarni Ingi Gislason 383d58e9c7 iso_8859-1.7: Explanation of SOFT HYPHEN and the code for it
<groff: iso_8859-2.7>:89: warning: can't find special character `shc'

This is the only "iso_8859-*.7" file that has this (now)
undefined character.  The code in column four in "iso_8859-1.7" is
"0x2D" ("HYPHEN, MINUS SIGN" or "HYPHEN-MINUS") instead of "0xAD".
See Debian bug 156154 (or package "manpages").

There should be an explanation for this graphic character and the
code should be 0xAD in iso_8859-1.7 (as in all others), even
though "[gn]roff" does not display a "HYPHEN" in that position of
the table.

The line with "SOFT HYPHEN" gets a footnote and a short
explanation.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-14 00:10:43 +02:00
Michael Kerrisk 4832b48ab0 futex.2: Fix description of EINVAL error
The current text seems incorrect. Replace with a more general
description.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-14 00:10:36 +02:00
Michael Kerrisk e808bba0ff futex.2: Various wording fix-ups
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 14:50:26 +02:00
Марк Коренберг 9f6c40c0e6 futex.2: Consolidate error descriptions to ERRORS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 14:25:13 +02:00
Michael Kerrisk a2f11be3c1 mprotect.2: 'addr' argument is not const
As reported by Rasmus:

    Both my system's man-pages (3.22) and the latest online
    (3.41) show:

        int mprotect(const void *addr, size_t len, int prot);

    as the prototype for mprotect(2). However, POSIX [1] and the
    actual sys/mman.h (on all the systems I checked) do not have
    the const qualifier on the first argument.

Reported-by: Rasmus Villemoes <Rasmus.Villemoes@decode.is>

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 14:00:29 +02:00
Sami Kerola 608bf95023 capget.2, futex.2, sched_setscheduler.2, spu_create.2, spu_run.2, vfork.2, getnameinfo.3, netlink.3, cciss.4, console_codes.4, dsp56k.4, hpsa.4, sk98lin.4, filesystems.5, protocols.5, aio.7, capabilities.7, charsets.7, feature_test_macros.7, futex.7, hier.7, iso_8859-16.7, iso_8859-2.7, koi8-r.7, libc.7, man.7, netlink.7, numa.7, standards.7, unicode.7, units.7, uri.7, x25.7: Global fix: use UR macro where applicable
The syntax .UR http://example.com paired with .UE will create
links which one can interact, if the pager allows that.  One
way to see the effect is ask the man(1) command to use browser
display, e.g.:

    man -H man7/uri.7

("\:" is optional groff syntax to permit hyphenless line breaks.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 10:02:36 +02:00
Shawn Landden dbe8b62bd7 realpath.3: Use past tense with ancient history (libc4, libc5)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 09:36:47 +02:00
Tolga Dalman 2b5407af0c proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 09:30:21 +02:00
Michael Kerrisk 6edb20bcd8 migrate_pages.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 09:26:21 +02:00
David Prévot 1de7d4a1af strcpy.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 09:25:39 +02:00
David Prévot d4dfdd5b16 strcat.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 09:24:22 +02:00
David Prévot 62389489eb readdir.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 09:23:41 +02:00
David Prévot b0b1d9b517 ptrace.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 09:22:34 +02:00
David Prévot 7e0721e3ed futex.7: ffix
uri(7) documents that "Older documents suggested inserting the
prefix 'URL:' just before the URI, but this form has never
caught on." and advise to "enclosed in angle brackets" (and a
few other alternatives).

This patch removes an instance of 'URL:' from the page.

Reported-By: Denis Barbier <bouzim@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
Michael Kerrisk b63b27da2e rtime.3: Fix broken pointer cast in example code
Reported-by: Jan Engelhardt <jengelh@medozas.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
Michael Kerrisk 13f78d96ad getdents.2, select_tut.2, atof.3, atoi.3, pthread_create.3, pthread_sigmask.3, rtime.3, setbuf.3, tsearch.3, netlink.7: Remove unneeded casts
Reported-by: Jan Engelhardt <jengelh@medozas.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
Denys Vlasenko ca302d0ee3 ptrace.2: Explain WNOHANG behavior and EINTR bug
I didn't like ithe "SIGKILL operates similarly, with exceptions"
phrase (if it's different, then it's not "similar", right?),
and now I got around to changing it. Now it says simply:
"SIGKILL does not generate signal-delivery-stop and therefore
the tracer can't suppress it."

Replaced "why WNOHANG is not reliable" example with a more
realistic one (the one which actually inspired to add this
information to man page in the first place): we got
ESRCH - process is gone! - but waitpid(WNOHANG) can still
confusingly return 0 "no processes to wait for".

Replaced "This means that unneeded trailing arguments may
be omitted" part with a much better recommendation
to never do that and to supply zero arguments instead.
(The part about "undocumentedness" of gcc behavior was bogus,
btw - deleted).

Expanded BUGS section with the explanation and an example
of visible strace behavior on the buggy syscalls which
exit with EINTR on ptrace attach. I hope this will lead
to people submitting better bug reports to lkml about
such syscalls.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
Michael Kerrisk 65cee725a9 adjtimex.2: srcfix: added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
Michael Kerrisk cb72917199 ptrace.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
Michael Kerrisk 41a65f128c migrate_pages.2: Fix description of return value
Reported-by: Christoph Lameter <cl@linux.com>
Reported-by: JoonSoo Kim <js1304@gmail.com>

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
Akihiro MOTOKI 1f1fd5eff5 socket.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
Akihiro MOTOKI 982ff543cd inotify_init.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
Michael Kerrisk 82fdd7c7d0 ioprio_set.2: Document who==0 for IOPRIO_WHO_PROCESS and IOPRIO_WHO_PGRP
For IOPRIO_WHO_PROCESS, who==0 means operate on the caller.
For IOPRIO_WHO_PGRP, who==0 means operate on the caller's
process group.

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

Reported-by: Марк Коренберг <socketpair@gmail.com>
Reported-by: Kalle Olavi Niemitalo <kon@iki.fi>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
Michael Kerrisk c4949ba488 ioprio_set.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
Colin McCabe b91e4e72eb ioprio_set.2: Clarify the multithreaded behavior of ioprio_set(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
Simon Paillard b8896b6e14 netlink.7: Change description of "*_pid" fields to "Port ID"
As reported by Herbert Xu, these should not be considered as PIDs.

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

Reported-by: Herbert Xu <herbert@gondor.apana.org.au>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:40 +02:00
Michael Kerrisk 10d2beb5f9 glob.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-28 08:14:50 +02:00
Michael Kerrisk c998e004b1 glob.7: Update bash(1) command used to obtain classical globbing behavior
The man page formerly noted the bash(1) v1 command to do this.

Reported-by: Aaron Peschel <aaron.peschel@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-28 08:14:32 +02:00
Michael Kerrisk 3de2d3be31 socket.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-23 15:00:23 +02:00
Michael Kerrisk 5011ecfd2b sigwait.3: Reword "is delivered" to "becomes pending"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-21 05:52:30 +02:00
Michael Kerrisk bf1298c9e5 sigwaitinfo.2: Some wording clarifications
Mainly rewording things like "is delivered" to "becomes pending",
which is more accurate terminology.

Reported-by: Daniel Zingaro <daniel.zingaro@utoronto.ca>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-21 05:52:22 +02:00
Michael Kerrisk 4e9ee22571 set_tid_address.2: Some rewordings and minor clarifications
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-21 05:09:45 +02:00
Michael Kerrisk 72442c6803 set_tid_address.2: Some minor rewordings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-21 05:01:37 +02:00
Michael Kerrisk 568c4c02b7 set_tid_address.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-21 04:55:31 +02:00
Michael Kerrisk f5fe595295 set_tid_address.2: Rename 'ctid' argument for consistency with clone(2) page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-20 17:17:06 +02:00
Michael Kerrisk 5add3af3d8 clone.2: Rewrite discussion of sys_clone
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-20 17:17:06 +02:00
Michael Kerrisk ef3e84642a strcat.3: NOTES: Add discussion on strlcat()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-20 12:52:45 +02:00
Michael Kerrisk 1f577d97c7 strcat.3: Add some text to emphasize the dangers of buffer overruns
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-20 12:52:45 +02:00
Michael Kerrisk 15cecd32a5 strcpy.3: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-20 12:52:45 +02:00
Michael Kerrisk bb96fc35a3 strcpy.3: NOTES: Add a discussion of strlcpy()
Inspired by https://lwn.net/Articles/506530/

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-20 12:52:45 +02:00
Michael Kerrisk 276d73b6ed strcpy.3: Note that info is lost when strncpy() doesn't null terminate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:29 +02:00
Michael Kerrisk 50a24bbcde strcpy.3: Add some text to emphasize possibility of buffer runs with strcpy()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:28 +02:00
Michael Kerrisk cd90222a3a strcpy.3: Fix description of the null-byte padding performed by strncpy()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:28 +02:00
Michael Kerrisk 9339d7498c capabilities.7: Document CAP_BLOCK_SUSPEND
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:28 +02:00
Michael Kerrisk ca93a9ed21 ldd.1: Add security note on untrusted executables
See also http://www.catonmat.net/blog/ldd-arbitrary-code-execution/
and
http://tldp.org/HOWTO/Program-Library-HOWTO/shared-libraries.html

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:28 +02:00
Michael Kerrisk 98309d3fea syscalls.2: Move discussion of set_zone_reclaim(2) out of main table
This system call was never visible to user space, so it makes
sense to move it out of the main table of system calls into
the notes below the table.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:28 +02:00
Michael Kerrisk 8eec4a2373 syscalls.2: Add kcmp(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:28 +02:00
Michael Kerrisk 0ac3f06fc9 core.5: Note effect of madvise(2) MADV_DONTDUMP flag
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:28 +02:00
Michael Kerrisk 45c99e3ec4 get_robust_list.2, get_thread_area.2, getcpu.2, getdents.2, gettid.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioprio_set.2, kexec_load.2, llseek.2, modify_ldt.2, mq_getsetattr.2, pivot_root.2, readdir.2, rt_sigqueueinfo.2, set_thread_area.2, sgetmask.2, spu_create.2, spu_run.2, subpage_prot.2, sysctl.2, tkill.2: Add note to SYNOPSIS that there is no glibc wrapper for system call
Reduce the chance that the reader may be misled into thinking
that there is a wrapper function for this system call by noting
explicitly in the SYNOPSIS that there is no glibc wrapper and
pointing the reader to NOTES for further details.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:28 +02:00