Commit Graph

8243 Commits

Author SHA1 Message Date
Michael Kerrisk fa1d274987 Removed trailing white space at end of lines 2012-11-07 14:24:27 +01:00
Michael Kerrisk 0d3bd76037 clock_getres.2, clock_nanosleep.2, ipv6.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-07 14:23:14 +01:00
Michael Kerrisk 8463b88011 Changes: Ready for 3.44
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-07 14:19:25 +01:00
David Prévot 8321eae507 init_module.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-07 13:58:21 +01:00
David Prévot f7fbc7a95e ipc.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-07 13:47:30 +01:00
David Prévot b2fc8e9f28 delete_module.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-07 13:46:38 +01:00
Michael Kerrisk 8b38565c7b getenv.3: SEE ALSO: add getauxval(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-07 13:04:34 +01:00
Michael Kerrisk 2a8d4230be ld.so.8: SEE ALSO: add getauxval(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-07 13:04:28 +01:00
Michael Kerrisk 4946106cae getauxval.3: Document getauxval() function added in glibc 2.16
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-07 13:02:54 +01:00
Simon Paillard aa8a6b4fbf proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-05 17:17:27 +01:00
David Prévot 99e9158609 proc.5: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-05 17:14:57 +01:00
David Prévot 7bccb7d474 proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-05 17:02:55 +01:00
David Prévot b33062e53b ipv6.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-02 06:57:34 +01:00
Michael Kerrisk 029599913b clock_getres.2, clock_nanosleep.2: Linking with -lrt is no longer needed from glibc 2.17 onward
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-29 09:27:58 +01:00
Michael Kerrisk fb759ff43d clock_getcpuclockid.3: Linking with -lrt is no longer needed from glibc 2.17 onward
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-29 09:27:10 +01:00
Michael Kerrisk f8090b56ca time.7: Add a subsection on timer slack
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:37:42 +01:00
Michael Kerrisk f9313d015c proc.5: Default for /proc/sys/fs/protected_{hardlinks,symlinks} is now 0
The default setting of 1 in/proc/sys/fs/protected_hardlinks
and /proc/sys/fs/protected_symlinks caused one too many
breakages for Linus's taste, so commit 561ec64ae67e changed
the default for both files to 0.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:23:28 +01:00
Michael Kerrisk e089cba10e fork.2: Note treatment of default timer slack value on fork()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:23:28 +01:00
Michael Kerrisk 934487a086 prctl.2: Document PR_SET_TIMERSLACK and PR_GET_TIMERSLACK
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:23:28 +01:00
Michael Kerrisk 8e9412e7a5 execve.2: Document treatment of SECBIT_KEEP_CAPS securebits flag on execve()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:23:28 +01:00
Michael Kerrisk 30cc7676ef execve.2: Document treatment of PR_SET_PDEATHSIG on execve()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:23:28 +01:00
Michael Kerrisk 46b7f60e65 prctl.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:23:28 +01:00
Michael Kerrisk 990e388795 prctl.2: Minor rewording for seccomp description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:23:03 +01:00
Michael Kerrisk f49202ae2b prctl.2: Reword PR_SET_NAME and PR_GET_NAME in terms of threads
Plus tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:18:11 +01:00
Michael Kerrisk 34709982a5 ptrace.2: Clarify that some operations are not present on all architectures
PTRACE_GETREGS, PTRACE_SETGREFS, PTRACE_GETFPREGS,
and PTRACE_GETSPREGS are not present on all architectures.
PTRACE_SYSEMU and PTRACE_SYSEMU_SINGLESTEP are present only
on x86.

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

Simon Paillard <spaillard@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-25 14:04:23 +02:00
Simon Paillard 86be5cf6f9 fts.3: Improve description of physical vs. logical tree walking
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=633505

Reported-by: James Youngman <jay@gnu.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-25 12:33:53 +02:00
Simon Paillard 47cfbecf0a getdomainname.2: Point out that these calls relate to NIS, not DNS
See http://bugs.debian.org/295635

Reported-by: Lars Wirzenius <liw@iki.fi>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-25 12:27:15 +02:00
Michael Kerrisk 1733db3538 prctl.2: Note 'seccomp' semantics with respect to fork(), execve(), and prctl()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:30 +02:00
Thomas Habets ff393a5f0d times.2: Recommend clock_gettime(2) as alternative to times(2)
Recommend clock_gettime(2), not gettimeofday(2) as alternative to times(2).

From times(2):
  "To measure changes in elapsed time, use gettimeofday(2)
  instead."

From gettimeofday(2):
  "POSIX.1-2008 marks gettimeofday() as obsolete, recommending the
  use of clock_gettime(2) instead."

Some context, showing how use of gettimeofday() causes actual bugs
(also read comments):
http://blog.habets.pp.se/2010/09/gettimeofday-should-never-be-used-to-measure-time

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:20 +02:00
Michael Kerrisk 1959393715 prctl.2: Mention Documentation/prctl/no_new_privs.txt for PR_SET_NO_NEW_PRIVS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:19 +02:00
Michael Kerrisk b1df307176 prctl.2: Some edits to Kees's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:19 +02:00
Michael Kerrisk 0fcc276ff1 prctl.2: Minor edits to Kee's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:19 +02:00
Kees Cook f83fe154a8 prctl.2: document PR_SET_NO_NEW_PRIVS, PR_GET_NO_NEW_PRIVS
This adds a short description of the no_new_privs bit,
as described in Documentation/prctl/no_new_privs.txt.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:19 +02:00
Michael Kerrisk 6239dfb213 prctl.2: Small improvements to PR_SET_SECCOMP discussion
Note type of 'arg3' for SECCOMP_MODE_FILTER.
Add pointer to Documentation/prctl/seccomp_filter.txt.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:19 +02:00
Michael Kerrisk d6ef3d5748 prctl.2: Minor edits to Kees's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:19 +02:00
Kees Cook 34447828c4 prctl.2: update seccomp sections for mode 2 (BPF)
This adds a short summary of the arguments used
for "mode 2" (BPF) seccomp.

Signed-off-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:19 +02:00
Bert Hubert d796c68d5a ipv6.7: Document IPV6_RECVPKTINFO
Notes from Bert Hubert:
    Recently PowerDNS needed to support the getting of the
    original destination address of packets received on ::.
    Following the advice in ipv6(7) generated an error on
    setsockopt().

    Some googling confirmed that setsockopt() with
    IPV6_PKTINFO indeed does not work, but we found that
    IPV6_RECVPKTINFO did.

   Our experiences are detailed in
   http://bert-hubert.blogspot.nl/2012/10/on-binding-datagram-udp-sockets-to-any.html

    Please find attached a quite naive patch to ipv6.7 that at
    least fixes 'my' problem, but does not document if
    IPV6_PKTINFO ever worked as a flag. It does document that
    IPV6_RECVPKTINFO is available since 2.6.13.

    Please let me know if this patch is acceptable, or if you
    want me to dig deeper into the IPV6_PKTINFO situation.

Notes from mtk:
    Drop mention of IPV6_PKTINFO; that's IPV6_2292PKTINFO nowadays
    (and needs to be documented). And, confusingly, there's nowadays
    an IPV6_PKTINFO that is a quite different thig.

    With kernel commit 333fad5364d6b457c8d837f7d05802d2aaf8a961
    (Sep 2005) PV6_PKTINFO disappeared from the
    getsockopt/setsockopt API, and IPV6_2292PKTINFO took its place.
    Meanwhile, IPV6_RECVPKTINFO was added.

    Then kernel commit b24a2516d10751d7ed5afb58420df25370c9dffb
    (Dec 2008) added IPV6_PKTINFO back to the
    getsockopt/getsockopt API, but with what looks to be a
    rather different meaning (it takes a 'struct in6_pktinfo'
    as the third arg).

    This seems consistent (if confusing) with the RFCs:
    http://www.ietf.org/rfc/rfc2292.txt
    http://www.ietf.org/rfc/rfc3542.txt (obsoletes 2292)

    Both of those RFCs define an IPV6_PKTINO sockopt, but the
    former takes an int arg, and the latter takes a
    'struct in6_pktinfo'.

    So, my summary of your patch is that it's correct. (But I think
    that IPV6_RECVPKTINFO is present since 2.6.14, not 2.6.13.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:50 +02:00
Simon Paillard 251da60bbb Makefile: Add 'check-groff-warnings' target
Add a 'check-groff-warnings' target to check if groff
reports warnings (the underlying problem may be causing
words or sentences not to be displayed) from
http://lintian.debian.org/tags/manpage-has-errors-from-man.html
Some edits by mtk.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:48 +02:00
David Prévot 075963263e proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:48 +02:00
Michael Kerrisk 3cad956f53 set_thread_area.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:48 +02:00
Michael Kerrisk b84a1732b4 get_thread_area.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:48 +02:00
Michael Kerrisk 977768444c man-pages.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:48 +02:00
Michael Kerrisk 472926d803 man-pages.7: Note rules for capitalization in NAME section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:48 +02:00
Michael Kerrisk f68512e9fe intro.1, add_key.2, get_mempolicy.2, get_thread_area.2, intro.2, keyctl.2, mbind.2, request_key.2, set_thread_area.2, clock.3, cmsg.3, getcwd.3, getpw.3, intro.3, malloc.3, posix_memalign.3, shm_open.3, sleep.3, sysconf.3, intro.4, sd.4, intro.5, locale.5, slabinfo.5, intro.6, boot.7, bootparam.7, futex.7, glob.7, hier.7, intro.7, libc.7, locale.7, mq_overview.7, netlink.7, sem_overview.7, shm_overview.7, unix.7, intro.8: Global fix: Use consistent capitalization in NAME section
The line(s) in the NAME section should only use capitals
where English usage dictates that. Otherwise, use
lowercase throughout.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:48 +02:00
Michael Kerrisk ce154705ec futex.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:48 +02:00
Michael Kerrisk a437cdbc24 netdevice.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:47 +02:00
Michael Kerrisk 7fac88a949 eventfd.2, futex.2, mmap2.2, open.2, pciconfig_read.2, ptrace.2, reboot.2, request_key.2, sched_rr_get_interval.2, splice.2, stat.2, sync_file_range.2, syscalls.2, timer_create.2, vm86.2, pthread_attr_setscope.3, core.5, proc.5, aio.7, futex.7, netlink.7, time.7: Global fix: "userspace" ==> "user space" or "user-space"
Existing pages variously use "userspace or "user space".
But, "userspace" is not quite an English word.
So change "userspace" to "user space" or, when used
attributively, "user-space".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:33 +02:00
Michael Kerrisk a9c1e09721 Changes.old: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:26 +02:00
Michael Kerrisk 63365c6216 Changes.old: Minor tweaks to 3.43 changelog
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:26 +02:00
Michael Kerrisk eceb82f70d delete_module.2: SEE ALSO: Add modprobe(8)
Reported-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:26 +02:00