Commit Graph

1303 Commits

Author SHA1 Message Date
Michael Kerrisk 1285ff3d2d lseek.2, read.2, setsid.2, vhangup.2, getttyent.3, login.3, openpty.3, console_codes.4, console_ioctl.4, securetty.5, signal.7: Global fix: s/tty/terminal/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-31 21:54:44 +01:00
David Prévot 437b953c23 ipv6.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-23 20:03:04 +01:00
Michael Kerrisk 38b6e5b098 capabilities.7: Add kcmp(2) under CAP_SYS_PTRACE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-22 08:06:24 +01:00
Michael Kerrisk e6d86b417f Removed trailing white space at end of lines 2012-12-20 18:17:09 +01:00
Michael Kerrisk 2970eb3bb4 ipv6.7: Minor fix to Gao Feng's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-17 22:01:22 +01:00
Gao Feng 032e1ba5c0 ipv6.7: Add description of getsockopt() for IPV6_MTU
In IPv4,IP_MTU is only supported by getsockopt.
In IPv6, we can use IPV6_MTU to set socket's MTU,
but the return value of getsockopt() is the path MTU.

Signed-off-by: Gao feng <gaofeng@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-17 20:15:06 +01:00
Michael Kerrisk c6a7484a2d ipv6.7: srcfix: Added/updated FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-15 19:18:26 +01:00
Michael Kerrisk f645fea8c0 ip.7: srcfix: Added/updated FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-15 19:18:26 +01:00
Michael Kerrisk 08df16d409 tcp.7: srcfix: Added/updated FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-15 19:18:19 +01:00
Michael Kerrisk b1b84b7a5c socket.7: Document 'sockaddr' and 'sockaddr_storage' types
Reported-by: YOSHIFUJI Hideaki <yoshfuji@linux-ipv6.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-15 19:17:48 +01:00
Michael Kerrisk 8cd5dce111 socket.7: srcfix: updated FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-14 18:25:20 +01:00
Michael Kerrisk 6455a3f2c6 capabilities.7: Correct URL for POSIX.1e draft
Reported-by: Rens van der Heijden <rens.vanderheijden@uni-ulm.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-09 11:26:50 +01:00
Michael Kerrisk 3036baf00e rtnetlink.7: Update description of IFLA_STATS to Linux 2.6+ reality
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=526778

Reported-by: Julien Cristau <jcristau@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-11 13:01:19 +01:00
Michael Kerrisk 94c0ab851a rtnetlink.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-11 12:58:41 +01:00
Andi Kleen f327722042 socket.7: Explain effect of SO_SNDTIMEO for connect()
When SO_SNDTIMEO is set before connect(), then connect()
may return EWOULDBLOCK when the timeout fires.

Signed-off-by: Andi Kleen <ak@linux.intel.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-09 06:59:57 +01:00
David Prévot 3685fa98f3 time.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-09 06:52:09 +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
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 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
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
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 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 4eaa04c556 Removed trailing white space at end of lines 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
Yuri Kozlov ca9464ab67 ddp.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-15 11:11:21 +02:00
Michael Kerrisk 10fe548528 capabilities.7: Document interaction of CAP_SYSLOG and /proc/sys/kernel/kptr_restrict
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-15 08:57:09 +02:00
Michael Kerrisk f567c52d80 ip.7: SEE ALSO: Add icmp(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-10 11:10:45 +02:00
Michael Kerrisk e28830e42e ip.7: SEE ALSO: Add ipv6(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-10 11:10:05 +02:00
Michael Kerrisk 31a6818e3c time.1, atexit.3, bsearch.3, dlopen.3, envz_add.3, errno.3, fmtmsg.3, getgrent_r.3, getline.3, getmntent.3, getnameinfo.3, getpass.3, getpwent_r.3, gets.3, isalpha.3, printf.3, puts.3, recno.3, scandir.3, stdarg.3, sysconf.3, termios.3, wordexp.3, null.4, core.5, dir_colors.5, issue.5, proc.5, termcap.5, utmp.5, ascii.7, cpuset.7, glob.7, man-pages.7, man.7, mdoc.7, mdoc.samples.7, regex.7: Revert 9f8e673e62 (whose global s%\\e%\\\\% caused problems)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-26 23:56:54 +02:00
Michael Kerrisk ca8a0bd25b sched_get_priority_max.2, sched_setparam.2, sched_setaffinity.2, sched_setscheduler.2, timer_create.2, malloc.3, pthread_attr_init.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_getattr_np.3, pthread_cancel.3, pthread_create.3, pthread_setschedparam.3, pthread_setschedprio.3, aio.7, time.7: Global ffix: disable justification and hyphenation in SEE ALSO
For a better visual result, disable justification and hyphenation
in SEE ALSO where page names are long.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-25 06:39:39 +02:00
Michael Kerrisk c92b6bb51d man-pages.7: Add some advice about disabling hyphenation in SEE ALSO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-25 06:19:44 +02:00
Michael Kerrisk 9f8e673e62 time.1, atexit.3, bsearch.3, dlopen.3, envz_add.3, errno.3, fmtmsg.3, getgrent_r.3, getline.3, getmntent.3, getnameinfo.3, getpass.3, getpwent_r.3, gets.3, isalpha.3, printf.3, puts.3, recno.3, scandir.3, stdarg.3, sysconf.3, termios.3, wordexp.3, null.4, core.5, dir_colors.5, issue.5, proc.5, termcap.5, utmp.5, ascii.7, cpuset.7, glob.7, man-pages.7, man.7, mdoc.7, mdoc.samples.7, regex.7: Global fix: use \\ rather than \e for literal backslash
Reported-by: Jan Engelhardt <jengelh@inai.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 10:23:07 +02:00
Michael Kerrisk 6c1544c132 syscalls.2, uname.2, boot.7: Global fix: s/OS/operating system/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 10:05:20 +02:00
Michael Kerrisk 66a9882e46 bdflush.2, get_robust_list.2, kexec_load.2, madvise.2, mmap.2, mount.2, prctl.2, query_module.2, rt_sigqueueinfo.2, shmget.2, sigaction.2, syscalls.2, umount.2, malloc.3, hpsa.4, initrd.4, proc.5, bootparam.7, icmp.7, netlink.7, signal.7: Global fix: use "Linux kernel source" consistently
Rather than "kernel source".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 10:02:34 +02:00
David Prévot 173fe7e792 arch_prctl.2, fcntl.2, flock.2, get_robust_list.2, getpriority.2, ioprio_set.2, migrate_pages.2, mmap.2, mremap.2, msync.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, select.2, socket.2, subpage_prot.2, unshare.2, btree.3, dbopen.3, dl_iterate_phdr.3, dlopen.3, getnameinfo.3, hash.3, lockf.3, netlink.3, recno.3, rpc.3, xdr.3, cciss.4, console_ioctl.4, hpsa.4, initrd.4, msr.4, rtc.4, st.4, hosts.5, services.5, tzfile.5, aio.7, arp.7, capabilities.7, cpuset.7, feature_test_macros.7, futex.7, inotify.7, ip.7, ipv6.7, iso_8859-16.7, iso_8859-2.7, koi8-r.7, math_error.7, netlink.7, packet.7, pthreads.7, raw.7, spufs.7, udplite.7, uri.7, x25.7: Global fix: Various consistency fixes for SEE ALSO
Coauthored-by: Michael Kerrisk <mtk.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 09:53:22 +02:00
Michael Kerrisk bc636d8ab1 inotify.7: tfix
Reported-by: Anatoli Klassen <anatoli@aksoft.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 07:15:03 +02:00
Michael Kerrisk 2e2c032fe3 iso_8859-1.7: Minor fixes
Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-14 21:17:05 +02:00
Michael Kerrisk bf42aad4a7 mprotect.2, syscall.2, realpath.3, iso_8859-1.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-14 00:37:33 +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
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
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 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
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 9339d7498c capabilities.7: Document CAP_BLOCK_SUSPEND
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:28 +02:00