Commit Graph

8209 Commits

Author SHA1 Message Date
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
Michael Kerrisk c470e180cf query_module.2: Move some information in NOTES to VERSIONS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:26 +02:00
Michael Kerrisk 9100326959 create_module.2, delete_module.2, get_kernel_syms.2, init_module.2, query_module.2: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:25 +02:00
Michael Kerrisk 3371ab17aa init_module.2: Change copyright and license
Little of the original page now remains. Change
copyright and license

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:25 +02:00
Michael Kerrisk 0cb430a1e5 init_module.2: Changes after review comments from Rusty Russell
Reviewed-by: Rusty Russell <rusty@rustcorp.com.au>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:25 +02:00
Michael Kerrisk 27ad8f18a5 create_module.2: Note that ENOSYS probably indicates kernel 2.6+
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:25 +02:00
Michael Kerrisk 6fe81824ca query_module.2: Note that ENOSYS probably indicates kernel 2.6+
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:25 +02:00
Michael Kerrisk f400805045 delete_module.2: Change license and copyright
There is now nothing left of the original FSF-copyrighted
page. So, change the copyright and license.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:25 +02:00
Michael Kerrisk b4f495025a delete_module.2: Substantial reorganization after comments from Rusty Russell
Rusty notes that O_NONBLOCK is almost always used in
practice. Therefore, it would be better to reorganize
the page to consider that "the default".

Reviewed-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
Reviewed-by: Rusty Russell <rusty@rustcorp.com.au>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:45:43 +02:00
Kees Cook ce123e8e64 init_module.2: Add various pieces describing Linux 2.6+ behavior
Pieces take from, or inspired by, a patch sent by Kees.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
Michael Kerrisk 6b9024ca05 get_kernel_syms.2: Note that this system call is present only in kernels before 2.6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
Michael Kerrisk 77a0889553 create_module.2: Note that this system call is present only in kernels before 2.6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
Michael Kerrisk fdeca96e95 query_module.2: Note that this system call is present only in kernels before 2.6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
Michael Kerrisk 8f4d1a1c3c init_module.2: Rewrite to Linux 2.6+ reality
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
Michael Kerrisk 460240cab4 delete_module.2: Rewrite to Linux 2.6+ reality
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
Michael Kerrisk 98038e9855 delete_module.2: SEE ALSO: add rmmod(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
Michael Kerrisk a439440e16 query_module.2: SEE ALSO: Add modinfo(8) and lsinfo(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
Michael Kerrisk 59bdef6a21 query_module.2: Add a few words clarifying reference to /sys/module
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
Michael Kerrisk 17b657f4d3 proc.5: Since Linux 2.6.27, /proc/sys/kernel/modprobe depends on CONFIG_MODULES
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
Michael Kerrisk 1eeb999522 proc.5: Fix merge conflict
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:04:50 +02:00
Michael Kerrisk 3ba3d5b1b7 proc.5: Document /proc/meminfo
Info mosly taken from Documentation/filesystems/proc.txt
and Documentation/vm/hugetlbpage.txt.

Also added info on the CONFIG_* options that govern various
parameters, and also version information for fields
introduced since 2.6.0. This information is current up to
Linux 3.6.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 14:46:21 +02:00
Michael Kerrisk 8306193887 proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 09:22:40 +02:00
Michael Kerrisk dc51f1ff84 link.2: Add EPERM error triggered by /proc/sys/fs/protected_hardlink
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-16 10:30:15 +02:00
Michael Kerrisk f3996ef7f2 ipc.2: Update note on architectures that don't have ipc()
Replace mention of ia64 with x86-64 and ARM.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-16 10:23:02 +02:00
Michael Kerrisk cd1df3b89b socketcall.2: Update note on architectures that don't have socketcall()
Replace mention of ia64 with x86-64 and ARM.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-16 10:21:59 +02:00
Michael Kerrisk 2f249f3bd6 proc.5: Note system call error yeilded by /proc/sys/fs/protected_symlinks
Note that violating 'protected_symlinks' restrictions
causes system calls to fail with the error EACCES.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-15 13:28:47 +02:00
Michael Kerrisk 2da52bf6b8 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-15 12:15:13 +02:00
Michael Kerrisk 9a53cb847d Start of man-pages-3.44: updating Changes and Changes.old 2012-10-15 11:20:00 +02:00
Michael Kerrisk fa4709113f Start of man-pages-3.44: updating .Announce and .lsm files 2012-10-15 11:20:00 +02:00
Michael Kerrisk ef75e1610d Start of man-pages-3.44: renaming .Announce and .lsm files 2012-10-15 11:20:00 +02:00
Michael Kerrisk 0d71e44f0d Ready for 3.43 2012-10-15 11:13:41 +02:00
Michael Kerrisk 4eaa04c556 Removed trailing white space at end of lines 2012-10-15 11:13:31 +02:00
Michael Kerrisk 928145bb39 Expanded tabs 2012-10-15 11:13:31 +02:00
Michael Kerrisk b473be57b9 timer_settime.2, man-pages.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-15 11:13:02 +02:00
Michael Kerrisk 7cabc47f1d Changes: Ready for 3.43
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-15 11:11:21 +02:00