Commit Graph

2544 Commits

Author SHA1 Message Date
Michael Kerrisk 59ac6f2f1a socket.7: Reword discussion of SO_LOCK_FILTER use case
Reported-by: Vincent Bernat <bernat@luffy.cx>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 21:26:04 +01:00
Michael Kerrisk bd8a7ca2fc socket.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 21:16:46 +01:00
Michael Kerrisk 38d9e98ea3 feature_test_macros.7: Give an early hint about some macros being defined by default
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk c1016e8767 kill.2, sigaction.2, sigpending.2, sigprocmask.2, sigsuspend.2, ctermid.3, ctime.3, ferror.3, flockfile.3, fopen.3, getaddrinfo.3, getgrnam.3, getnameinfo.3, getpwnam.3, rand.3, sigsetops.3, sigwait.3, strtok.3, tzset.3, unlocked_stdio.3, feature_test_macros.7: Remove mention of the obsolete _POSIX_SOURCE macro from SYNOPSIS
_POSIX_SOURCE was a POSIX.1-1990 creation that was soon made
obsolete bu _POSIX_C_SOURCE. Retaining mention of it
in the feature test macro requirements section of the
SYNOPSIS doesn't contain important information, and may
mislead readers into actually trying to use this macro.
A few mentions of it a maintained in a some pages where
defining _POSIX_SOURCE inhibits some behavior.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk 50d844a9f1 feature_test_macros.7: Note effects of "cc -std=c99" and "cc -std=c11"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk f04d68ba16 feature_test_macros.7: Clarify some _ISOC99_SOURCE / _DEFAULT_SOURCE details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk 1e92200fa9 feature_test_macros.7: Note that man pages don't mention _XOPEN_SOURCE_EXTENDED
As per previous commit, mention of _XOPEN_SOURCE_EXTENDED
has generally been removed from the man pages.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk 49d2e09456 feature_test_macros.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk f125c76932 feature_test_macros.7: Add a summary of some FTM key points
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk d1473a830f feature_test_macros.7: Clarify that _XOPEN_SOURCE_EXTENDED is obsolete
Since SUSv2, _XOPEN_SOURCE_EXTENDED is no longer specified
in the standard.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk a7d7000f59 feature_test_macros.7: Clarify relation between _XOPEN_SOURCE >=500 and _XOPEN_SOURCE_EXTENDED
Emphasize that defining _XOPEN_SOURCE >=500 produces same
effects as defining  _XOPEN_SOURCE_EXTENDED.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk 96d9edea5b socket.7: Fix description of SO_LOCK_FILTER
Reported-by: Vincent Bernat <bernat@luffy.cx>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 11:24:11 +01:00
Michael Kerrisk 096da11042 socket.7: Minor tweaks to Craig's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 11:01:27 +01:00
Michael Kerrisk 6e9336599c socket.7: SEE ALSO: add wireshark(1) and tcpdump(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 11:01:27 +01:00
Michael Kerrisk 587f954b08 socket.7: SEE ALSO: add pcap(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 11:01:27 +01:00
Craig Gallek 1fa871f537 socket.7: Document some BPF-related socket options
Document the behavior and the first kernel version for each of the
following socket options:

    SO_ATTACH_FILTER
    SO_ATTACH_BPF
    SO_ATTACH_REUSEPORT_CBPF
    SO_ATTACH_REUSEPORT_EBPF
    SO_DETACH_FILTER
    SO_DETACH_BPF
    SO_LOCK_FILTER

Signed-off-by: Craig Gallek <kraig@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 11:01:27 +01:00
Jakub Wilk bf92bef9c9 capabilities.7: spfix
Fix capitalization in the reference to section "Effect of user ID
changes on capabilities".

Capitalization of the section name was changed in
c634028ab5, but the reference remained
unchanged.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-29 12:22:21 +01:00
Jakub Wilk f6f85d2db1 capabilities.7: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-28 14:39:08 +01:00
Michael Kerrisk bc0c82b158 capabilities.7: tfix
Reported-by: Marianne CHEVROT <blackmoor@openmailbox.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 16:31:44 +01:00
Michael Kerrisk 17c42872a3 time.7: SEE ALSO: add timeout(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 13:14:19 +01:00
Michael Kerrisk 8a33c6e06b pipe.7: SEE ALSO: add mkfifo(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 12:27:17 +01:00
Michael Kerrisk bcaa9b6e8c credentials.7: SEE ALSO: add groups(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 12:24:21 +01:00
Michael Kerrisk 127a794de5 credentials.7: SEE ALSO: add sg(1), su(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-25 20:58:19 +01:00
Michael Kerrisk 4d3b948cce credentials.7: SEE ALSO: add id(1), group(5), passwd(5)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-25 20:56:13 +01:00
Michael Kerrisk 94d3ac0936 environ.7: Add some details describing hos shell's environment is initialized
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-17 13:08:45 +01:00
Michael Kerrisk 170eb74156 environ.7: Describe the Bourne "NAME=value command" syntax
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-17 13:08:45 +01:00
Michael Kerrisk 789fdd93bb environ.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-17 12:26:16 +01:00
Michael Kerrisk 9c67b25027 environ.7: Note that child of fork(2) inherits copy of parent's environment
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-17 12:21:58 +01:00
Michael Kerrisk f80ea17946 environ.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-17 12:19:41 +01:00
Michael Kerrisk 2705ab400a environ.7: SEE ALSO: add pam_env(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-17 11:50:05 +01:00
Michael Kerrisk 082efcce8b signal.7: Note the interactions of longjmp() and non-async-signal-safe functions
See http://austingroupbugs.net/view.php?id=516#c1195.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-16 15:48:36 +01:00
Michael Kerrisk b76f24dd41 signal.7: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-16 15:48:36 +01:00
Michael Kerrisk c9eeaf2a94 svipc.7: SEE ALSO: add lsipc(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-15 15:32:52 +01:00
Michael Kerrisk 63f775e8f5 namespaces.7: SEE ALSO: add lsns(1)
lsns(1) was recently added in util-linux, probably to appear
in next release (2.28?).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-15 15:31:59 +01:00
Dr. Tobias Quathamer 66e80e3157 unicode.7: Document private use areas
See https://bugs.debian.org/285444

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-11 13:23:10 +01:00
Michael Kerrisk 785008cd99 mq_overview.7: Note that the close-on-exec flag is automatically set on MQ descriptors
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-06 19:31:55 +01:00
Michael Kerrisk 24a31d632b accept.2, bind.2, connect.2, getpeername.2, getsockname.2, recv.2, recvmmsg.2, select_tut.2, send.2, sendmmsg.2, getaddrinfo.3, getnameinfo.3, epoll.7, unix.7: Use consistent argument/variable names for socket addresses and lengths
As noted by Carlos, there's quite a bit of inconsistency across
pages. Use 'addr' and 'addrlen' consistently in variables and
function arguments.

Cowritten-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 14:08:29 +01:00
Michael Kerrisk af54e3b716 tcp.7: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 12:43:54 +01:00
Michael Kerrisk df350fad22 socket.7: srcfix: FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 12:36:51 +01:00
Michael Kerrisk e875e3e5bc ip.7: Minor tweaks ro Eric's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 12:15:18 +01:00
Eric Dumazet 24d08ec7fb ip.7: Document IP_BIND_ADDRESS_NO_PORT socket option
Signed-off-by: Eric Dumazet <edumazet@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 12:02:01 +01:00
Michael Kerrisk 787dd4ad3a membarrier.2, crypt.3, dladdr.3, duplocale.3, fmemopen.3, gethostbyname.3, mallopt.3, newlocale.3, resolver.3, sigsetops.3, strfmon.3, tzset.3, console_ioctl.4, lirc.4, loop.4, vcs.4, dir_colors.5, locale.5, proc.5, tzfile.5, attributes.7, bootparam.7, capabilities.7, feature_test_macros.7, icmp.7, man-pages.7, netlink.7, path_resolution.7, pipe.7, socket.7, unix.7, vdso.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 09:14:22 +01:00
Andreas Gruenbacher 148c6e74c0 aio.7: Improve example
When aio_sigevent.sigev_notify is set to SIGEV_SIGNAL, signal
handlers called for asynchronous I/O operations will have
si->si_code set to SI_ASYNCIO.  Check to make sure that
si->si_value.sival_ptr is defined.

Signed-off-by: Andreas Gruenbacher <agruenba@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-01 15:21:41 +01:00
Michael Kerrisk 34d4e61def accept.2, perf_event_open.2, unlink.2, lirc.4, proc.5, inotify.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-28 10:44:01 +01:00
Heinrich Schuchardt b5e8061a09 unix.7: srcfix: remove stray Copyright line
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-16 12:10:04 +01:00
Michael Kerrisk 84c8cae2c2 unix.7: Some wording improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-08 20:50:17 +01:00
Michael Kerrisk eb73e8ad50 unix.7: Minor tweaks to Heinrich's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-08 20:50:17 +01:00
Heinrich Schuchardt 15545eb6d7 unix.7: Add example
A complete example demonstrating the usage of sockets for local
interprocess communication is added.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-08 20:47:59 +01:00
Michael Kerrisk 0d7e8d59bc unix.7: Introduce term "sequenced-packet" for SOCK_SEQPACKET
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-08 20:47:59 +01:00
Michael Kerrisk d9cb0d7d3f Various pages: Word "descriptor" more precisely
Use either "file descriptor" or message queue descriptor".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 12:29:37 +01:00