Commit Graph

1807 Commits

Author SHA1 Message Date
Michael Kerrisk d3471a460b fanotify.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk 88145b29e7 fanotify.7: Add some subheadings to structure the DESCRIPTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk 397ff1fd3f fanotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk 02a18e0f7f fanotify.7: Reword FAN_CLOSE_NOWRITE text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk 9d76d63060 fanotify.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk 8d2ee5c85d fanotify.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk 815df19b29 fanotify.7: Declare handle_events() in example code as 'static'
To avoid warning "no previous prototype for..."
when compiling with "-Wmissing-prototypes"

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:11 +02:00
Michael Kerrisk b34cbc4530 fanotify.7: Change a comment in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:10 +02:00
Michael Kerrisk def5c668e8 fanotify.7: Merge two printf() calls
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:10 +02:00
Michael Kerrisk 48fd9fe08a fanotify.7: Change a comment in example code
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:10 +02:00
Michael Kerrisk 8cc4f7a94e fanotify.7: Remove unneeded close() calls
The fanotify file descriptor will be implicitly closed by process
termination, and in any case it was not closed explicitly in all
process termination paths.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:42:57 +02:00
Michael Kerrisk f776794974 fanotify.7: Minor tweaks to example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 10:00:53 +02:00
Michael Kerrisk ddb112c281 fanotify.7: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 09:49:19 +02:00
Michael Kerrisk 6d8c5d015d fanotify.7: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 09:20:45 +02:00
Michael Kerrisk d9b086d625 fanotify.7: Mention inotify(7) in opening paragraph
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 08:06:41 +02:00
Michael Kerrisk 7ea227bdde fanotify.7: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 08:06:41 +02:00
Heinrich Schuchardt f75d27e6b0 inotify.7: SEE ALSO: add fanotify(7)
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 07:57:41 +02:00
Heinrich Schuchardt 597aaea2f7 fanotify.7: New page providing overview of the fanotify API
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 07:55:05 +02:00
Stefan Puiu a29edaeef6 packet.7: Status in PACKET_RX_RING is actually a bit mask
Stefan:
I'm playing with the PACKET_RX_RING option to packet sockets and I
noticed that the status field from the tpacket_hdr structures
inside the mmaped buffer is actually a bit mask. I'm testing with
4Gbps traffic rates and sometimes I get status=5. I'm using Ubuntu
12.04 with a 3.8.0-29 kernel, and at least from the code (I got it
using "sudo apt-get source linux-image-$(uname -r)") it seems the
5 means TP_STATUS_USER | TP_STATUS_LOSING. The 3.8.0 kernel code
has this line in tpacket_rcv():

    /*
     * LOSING will be reported till you read the stats,
     * because it's COR - Clear On Read.
     * Anyways, moving it for V1/V2 only as V3 doesn't need this
     * at packet level.
     */
            if (po->stats.tp_drops)
                    status |= TP_STATUS_LOSING;

Daniel:
Now to your question. It can easily be seen from the if_packet.h header
file http://lingrok.org/xref/linux-net-next/include/uapi/linux/if_packet.h#93
that TP_STATUS_* are individual bits that are set in tp_status field.

TP_STATUS_USER simply means a frame was received in the ring and is
ready for user space to be processed. If the field also indicates
TP_STATUS_LOSING then this means that there were packet drops in the
rx ring itself so a user knows it didn't get all traffic. This bit
is being reset on getsockopt() when querying PACKET_STATISTICS,
otherwise it stays. Drops occur when the ring buffer was not emptied
fast enough by user space (so no free slot with TP_STATUS_KERNEL), e.g.
due to high incoming traffic load. However, the current frame you're
reading that has TP_STATUS_USER|TP_STATUS_LOSING is fine by itself.

Acked-by: Daniel Borkmann <dborkman@redhat.com>
Acked-by: Carsten Andrich <carsten.andrich@tu-ilmenau.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-24 11:52:39 +02:00
Michael Kerrisk ab80da6e17 packet.7: SEE ALSO: add /tools/testing/selftests/net/psock_tpacket.c
Reported-by: Carsten Andrich <carsten.andrich@tu-ilmenau.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 3d4d5a0635 packet.7: Minor tweak to Carsten Andrich's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 896333c57e packet.7: Minor fixes to Carsten Andrich's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Carsten Andrich 8c26e99bce packet.7: PACKET_LOSS has inverse meaning
I stumbled upon an error in packet.7 regarding the meaning of the
PACKET_LOSS socket option. According to the current git version of
linux-man setting PACKET_LOSS causes malformed packets to *not* be
silently dropped.

However it is the other way round. If PACKET_LOSS is *not* set,
malformed packets will be marked TP_STATUS_WRONG_FORMAT and the
transmission process aborted, leaving untransmitted packets in
the ring.  If it *is* set, malformed packets will be silently
skipped, their status set to TP_STATUS_AVAILABLE and the
transmission process continued with the following packet.

This behaviour can be clearly seen in net/packet/af_packet.c:
http://git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git/tree/net/packet/af_packet.c#n2300

The value accompanying TP_PACKET_LOSS translates into po->tp_loss:
http://git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git/tree/net/packet/af_packet.c#n3304

I inverted the meaning of PACKET_LOSS and clarified the
description in the attached patch.

Reviewed-by: Willem de Bruijn <willemb@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk fe8b1358a6 Removed trailing white space at end of lines 2014-04-20 11:06:01 +02:00
Michael Kerrisk 84b349919b madvise.2, msync.2, libc.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-20 11:05:32 +02:00
David Prévot d2c3d8a829 inotify.7: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 07:49:54 +02:00
Michael Kerrisk 85dd46e89b libc.7: srcfix: Reformat to use .UR/.UE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-14 12:50:42 +02:00
Michael Kerrisk ba8b587366 libc.7: Add musl libc
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-14 12:50:41 +02:00
David Prévot f360dbe83d locale.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-14 12:25:18 +02:00
Michael Kerrisk e8a700f9ae capabilities.7: SEE ALSO: add capsh(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-09 15:27:32 +02:00
Michael Kerrisk fa1d49a63c Removed trailing white space at end of lines 2014-04-06 08:47:56 +02:00
Michael Kerrisk b8dbf73de8 bdflush.2, fsync.2, mmap.2, open.2, perf_event_open.2, sync.2, syscall.2, fmemopen.3, getaddrinfo.3, getline.3, mq_notify.3, offsetof.3, aio.7, symlink.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:47:35 +02:00
Michael Kerrisk e449e5f15a inotify.7: Inotify does not report events for mmap(2) and msync(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk e226bed757 inotify.7: Inotify doesn't work for remote and pseudo filesystems
Reported-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk fa51f4d941 inotify.7: Remind reader of the cookie value in discussion of rename events
Reported-by: Jan Kara <jack@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 6f1a495406 inotify.7: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 6b1cc2c9a4 inotify.7: Add paragraph on cache consistency checking
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 67898fdfd0 inotify.7: Reorganize "Limits and caveats"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk da977073d0 inotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 85e179c5c2 inotify.7: Add text on dealing with rename() events
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk a79d28b202 inotify.7: Minor reorganization
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 94d52c1529 inotify.7: Mention cache rebuilding to handle overflow events
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 264276c6b0 inotify.7: Move discussion of application cache to start of "Limitations"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 356911f692 inotify.7: Rewrite introductory section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk ff6e23973d inotify.7: Add subheading for reading from inotify file descriptor
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 1a737afd5a inotify.7: symlink(2) can generate IN_CREATE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 415f63be17 inotify.7: Add some examples of events generated by various system calls
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk ed17140040 symlink.7: Mention use of readlink(2) to read contents of a symlink
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk 7aa6eb89d4 symlink.7: Minor edits
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk 828b6e3dad symlink.7: Add mtk copyright
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk 58be64a41a symlink.7: f
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk d33b6ed2d8 symlink.7: Add subsection on opening a symbolic link with O_PATH
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk 19d9c23c6a symlink.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk df63d3e84d symlink.7: name_to_handle_at(2) and open_by_handle_at(2) optionally follow symlinks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk b01c936e4b inotify.7: Note that IN_UNMOUNT will be followed by an IN_IGNORED event
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk 39f43968d7 inotify.7: Note that IN_DELETE_SELF will be followed by IN_IGNORED
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk 7a64793b93 inotify.7: Add examples of syscalls that trigger IN_CREAT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk b0e1ac43e0 inotify.7: Add examples of syscalls that trigger IN_ATTRIB
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk 79f8f40ccb inotify.7: Minor wording change
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk f54a125572 inotify.7: Add some examples of syscalls that trigger IN_MODIFY
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk f23fc716d5 inotify.7: Minor list reformatting
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk 49b07b8f8b inotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk 22ae407d3e tcp.7: Document /proc/sys/net/ipv4/tcp_autocorking
Text heavily based on Documentation/networking/ip-sysctl.txt

Cowritten-by: Eric Dumazet <edumazet@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:02 +02:00
Michael Kerrisk 64aa9bcb39 inotify.7: Minor clarification
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 20:59:35 +02:00
Michael Kerrisk 70f70c9d40 inotify.7: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 20:59:31 +02:00
Michael Kerrisk f08cdf85df inotify.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-30 10:30:27 +02:00
Michael Kerrisk a15ead5e9f inotify.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-29 22:07:16 +01:00
Michael Kerrisk 7b5151b7f0 inotify.7: BUGS: IN_ONESHOT does now cause IN_IGNORED when the watch is dropped
A silent change as a result of the fanotify work in kernel 2.6.36.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-29 22:06:48 +01:00
Michael Kerrisk dede00fed9 inotify.7: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 15:41:17 +01:00
Michael Kerrisk f20fc09276 inotify.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 15:33:47 +01:00
Michael Kerrisk c577b95c7b inotify.7: ffix: Reformat events list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 15:33:14 +01:00
Michael Kerrisk 4a1e4cca21 inotify.7: Moving an object to another filesystem generates IN_DELETE_SELF
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 15:25:24 +01:00
Michael Kerrisk 22129aa9f5 inotify.7: srcfix: Note commit that fixed the "coalescing" bug
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 13:43:58 +01:00
Michael Kerrisk 2f48204194 inotify.7: Directory renames may invalidate multiple paths cached by application
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 06:45:17 +01:00
Michael Kerrisk 031de15217 inotify.7: Further describe the race when adding a watch to a new subtree
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 06:43:09 +01:00
Michael Kerrisk c284192003 ip.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 14:01:44 +01:00
Michael Kerrisk 56db9d31d0 socket.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 13:55:56 +01:00
Michael Kerrisk 04161f0875 rtnetlink.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 13:55:13 +01:00
Michael Kerrisk b752509ac2 capabilities.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 13:54:53 +01:00
Michael Kerrisk 3f3698d8a7 inotify.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 13:41:00 +01:00
Michael Kerrisk 8856aab855 inotify.7: Note rationale and consequences of event coalescing
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 13:05:11 +01:00
Michael Kerrisk a7dc2c8052 mdoc.samples.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:18 +01:00
Michael Kerrisk 9b6d6dcc93 posixoptions.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 075972dfef mdoc.samples.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 1be0d8295d bootparam.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 02b69bc6e7 netdevice.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 1c1cbf3db6 signal.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk aa17b6e735 posixoptions.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk eebf8c09a4 socket.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 4d196edb82 raw.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 0a9fd8a4b9 ip.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 1c4070c7f0 epoll.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk baaf1fcc30 x25.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:16 +01:00
Michael Kerrisk 8817c2c829 inotify.7: execve(2) also generates IN_ACCESS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:15 +01:00
Michael Kerrisk 955f23d1e4 man-pages.7: ffix: remove unneeded .ad tags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-20 14:23:23 +01:00
Michael Kerrisk 49a86fb90e rtnetlink.7: ffix: Remove unneeded .na / .ad tags
The result without these tags looks acceptable.
With these tags, the HTML rendering on man7.org
is bit messed up.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-20 14:21:11 +01:00
Michael Kerrisk 0eb65d3aec netlink.7: ffix: Remove unneeded .na / .ad tags
These aren't really needed, and they mess up the HTML pages
at man7.org.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-20 14:21:11 +01:00
Michael Kerrisk 69b77259c0 netlink.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-20 13:52:38 +01:00
Michael Kerrisk d84dea2263 feature_test_macros.7: Document _LARGEFILE_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-20 08:34:52 +01:00
Michael Kerrisk a007cc2904 feature_test_macros.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-20 08:34:52 +01:00
Michael Kerrisk 034a3f2fe1 feature_test_macros.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-20 06:49:33 +01:00
Michael Kerrisk 89576e562e koi8-u.7: Wrap table cell to avoid groff warning
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-19 17:13:41 +01:00
Michael Kerrisk 8c5fcd21e5 fmemopen.3, getaddrinfo.3, mq_notify.3, offsetof.3, aio.7: Print size_t/ssize_t values using %z printf() modifier
There are fewer and fewer systems these days that don't
support the %z specifier mandated in C99.  So replace the
use of %ld/%lu + (long) cast with %zd/%zu.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-19 15:09:14 +01:00
Michael Kerrisk 14e9f7cf4b fcntl.2, strtol.3, strtoul.3, socket.7: ffix in feature test macro names
Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 20:17:50 +01:00
Michael Kerrisk 89851a0054 Removed trailing white space at end of lines 2014-03-18 16:29:34 +01:00
Michael Kerrisk 52d06f483d fts.3, isalpha.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, strerror.3, strftime.3, strtol.3, strtoul.3, toupper.3, towlower.3, towupper.3, wcrtomb.3, wcsnrtombs.3, wcsrtombs.3, wcstombs.3, wctomb.3, locale.5, koi8-u.7, locale.7, uri.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 16:29:06 +01:00
Michael Kerrisk 713167dc50 locale.7: SEE ALSO: add mbstowcs(3) and wcstombs(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk de0f9c1cd5 locale.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk 5f49682efa locale.7: Document LC_IDENTIFICATION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk 7c57cb8027 locale.7: Document LC_MEASUREMENT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk ebb553379b locale.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk 1981ba432b locale.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk 1c59803974 locale.7: Document LC_TELEPHONE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk 798f7baf37 locale.7: Document LC_ADDRESS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk ba5e9ef309 locale.7: Document LC_NAME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk 0b65297e51 locale.7: Document LC_PAPER
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk 8d63e6ec34 locale.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk 9518a5f419 locale.7: srcfix: update FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk fb844405b1 locale.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk 2fa99a6285 locale.7: Remove reference to LI18NUX2000
LI18NUX2000 is difficult to even find these days, and in any case
thispage does not document gettext(), so notes about gettext()
in the CONFORMING TO section here make no sense.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk 4aeed3697f locale.7: Add subsection on POSIX.1-2008 (originally GNU) extensions to locale API
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk a6ce0ba566 man-pages.7: Add preferred terms "uppercase" and "lowercase"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk efaef3dad0 duplocale.3, isalpha.3, strftime.3, strtol.3, strtoul.3, koi8-u.7, man-pages.7, mdoc.7, mdoc.samples.7, uri.7: Global change: "upper case" ==> "uppercase", "lower case" ==> lowercase"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:12:47 +01:00
Michael Kerrisk a8de62de23 locale.7: SEE ALSO: add newlocale(3) + duplocale(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:12:47 +01:00
Michael Kerrisk deed406ee1 feature_test_macros.7: tfix
Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-17 08:46:40 +01:00
Michael Kerrisk 644ee9c73b man-pages.7: Add preferred term "superblock"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-16 05:35:25 +01:00
Michael Kerrisk da6aad026b feature_test_macros.7: Add packaging note for _BSD_SOURCE/_SVID_SOURCE/_DEFAULT_SOURCE
To compile warning-free across glibc < 2.20 and glibc >= 2.20
code may been to define both _DEFAULT_SOURCE and either
_BSD_SOURCE or _SVID_SOURCE.

Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-14 10:37:45 +01:00
Michael Kerrisk 7280750886 feature_test_macros.7: Reword description of C90
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-13 09:21:32 +01:00
Michael Kerrisk cfba52fc5b feature_test_macros.7: Remove mention of bogus _ISOC95_SOURCE macro
The _ISOC95_SOURCE macro is defined in <features.h>, but it
does nothing. So remove discussion of it, and move some of
the discussion of C95 under the ISOC99_SOURCE subhead.

Reported-by: Joseph S. Myers <joseph@codesourcery.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-13 09:15:34 +01:00
Michael Kerrisk e9f22b0ac0 Removed trailing white space at end of lines 2014-03-11 22:33:19 +01:00
Michael Kerrisk ed725bac60 feature_test_macros.7: Note version number for _POSIX_C_SOURCE >= 200112L implies C99/C95
_POSIX_C_SOURCE >= 200112L causes C95 definitions to be
exposed only since glibc 2.12 and C99 definitions only
since 2.10.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 22:32:14 +01:00
Michael Kerrisk 64eb1484fb feature_test_macros.7: _ISOC99_SOURCE also exposes C95 definitions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 11:41:45 +01:00
Michael Kerrisk 08d695652c feature_test_macros.7: _GNU_SOURCE implicitly defines other macros
Saying that _GNU_SOURCE has the "effects of" other macros is not
quite precise.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 11:41:45 +01:00
Michael Kerrisk b694081ac3 feature_test_macros.7: Minor clarification for _POSIX_C_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 11:41:45 +01:00
Michael Kerrisk df553d91c2 feature_test_macros.7: Rework discussion of _ISOC99_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 11:41:40 +01:00
Michael Kerrisk 2b4608d288 feature_test_macros.7: Reword glibc version for _ISOC95_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 08:42:18 +01:00
Michael Kerrisk d4e80b4d09 feature_test_macros.7: _XOPEN_SOURCE may implicitly defined _POSIX_SOURCE and _POSIX_C_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 08:32:17 +01:00
Michael Kerrisk e8349edb50 feature_test_macros.7: _POSIX_C_SOURCE >= 200112L implies C95 and C95 features
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 07:56:06 +01:00
Michael Kerrisk 8effdb2ded feature_test_macros.7: _ISOC11_SOURCE implies the effects of _ISOC99_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 07:44:00 +01:00
Michael Kerrisk d6ced64f1b feature_test_macros.7: Reword glibc version for _ISOC99_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 07:41:45 +01:00
Michael Kerrisk d6472258ec feature_test_macros.7: _BSD_SOURCE and _SVID_SOURCE are deprecated in glibc 2.20
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 17:20:06 +01:00
Michael Kerrisk 3244e6ad0b feature_test_macros.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Michael Kerrisk 199cbeb076 feature_test_macros.7: ffix: add some paragraph breaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Michael Kerrisk dfb1232ca8 feature_test_macros.7: Improve discussion of _DEFAULT_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Michael Kerrisk 841f7fc6f6 locale.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Michael Kerrisk 47e067e500 locale.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-04 13:13:31 +01:00
Michael Kerrisk a33c5137cc locale.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-04 13:12:25 +01:00
Michael Kerrisk 31718129c9 packet.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-03 05:48:49 +01:00
Simon Paillard f8efa4be44 packet.7: wfix
A side-effect: singular

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-03 05:47:43 +01:00
Michael Kerrisk 778fcac982 getifaddrs.3, iswctype.3, sem_post.3, sem_unlink.3, sem_wait.3, packet.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 18:29:17 +01:00