LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity
10,733 Commits 1 Branch 197 Tags 93 MiB
Commit Graph

10733 Commits

Author SHA1 Message Date
Michael Kerrisk ddfa9db7c2 fanotify_init.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 12:11:08 +02:00
Michael Kerrisk 5f6231f293 fanotify.7: srcfix: Add FIXME 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 12:10:32 +02:00
Michael Kerrisk 122dd1667c fanotify_init.2: Minor wording improvement 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 12:07:10 +02:00
Michael Kerrisk f199b3082f fanotify_init.2: Minor wording improvement for O_NONBLOCK 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 12:05:48 +02:00
Michael Kerrisk cd505a8a22 fanotify_init.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 12:04:49 +02:00
Michael Kerrisk d58f41903f fanotify_init.2: Minor clarification 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 12:03:11 +02:00
Michael Kerrisk f1282fd068 fanotify_init.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 12:02:32 +02:00
Michael Kerrisk 72b14a93a1 fanotify_init.2: Minor wording improvements 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 12:01:06 +02:00
Michael Kerrisk 370359a7c6 fanotify.7: Add some whitespace to example program 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:58:21 +02:00
Michael Kerrisk e1ca5880d4 fanotify.7: Add some comments to example code 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:57:29 +02:00
Michael Kerrisk 616fce491b fanotify.7: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:55:32 +02:00
Michael Kerrisk 3d4433fe17 fanotify.7: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:46:40 +02:00
Michael Kerrisk c00ff2dc16 fanotify.7: Add subheading for /proc/PID/fdinfo 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:46:16 +02:00
Michael Kerrisk 679a078389 fanotify.7: Remove a sentence from ETXTBSY description 
No file descriptor is actually created...

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:44:51 +02:00
Michael Kerrisk 68bcc008cc fanotify.7: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:44:51 +02:00
Michael Kerrisk 72b9aa964c fanotify.7: Minor wording fix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:44:51 +02:00
Michael Kerrisk 49894a5a8f fanotify.7: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:44:50 +02:00
Michael Kerrisk d7d24d40ec fanotify.7: Add sentence introducing fanotify_response fields 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:44:50 +02:00
Michael Kerrisk f897ec112f fanotify.7: Minor rewording of FAN_CLOSE 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:44:50 +02:00
Michael Kerrisk f2ac23e758 fanotify.7: Add introductory sentence for explanation of fanotify_event_metadata 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:44:50 +02:00
Michael Kerrisk ad02dd1f87 fanotify.7: Add a subheading for reading events 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:44:50 +02:00
Michael Kerrisk 75c3e3bd6b fanotify.7: Move the text on event merging 
Place it near the discussion of the events bit mask.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:44:50 +02:00
Michael Kerrisk 2932564490 fanotify.7: Rework text on event bits a little 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:44:50 +02:00
Michael Kerrisk c9120323bf fanotify.7: Rework and enhance text introducing read() and events 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:44:50 +02:00
Michael Kerrisk 6c693f6de5 fanotify.7: Move text describing fanotify_mark() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:44:50 +02:00
Michael Kerrisk 488cdd819c fanotify.7: Move epoll/poll/select discussion to its own subsection 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:44:50 +02:00
Michael Kerrisk 7fc5dd9466 fanotify.7: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:44:50 +02:00
Michael Kerrisk be8ba5d879 fanotify.7: Rework text on close() 
Closing the fanotify FD was discussed in two places.
Merge them into one location, and discard redundant text.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 11:44:40 +02:00
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 c200b422df fanotify_mark.2: New page documenting fanotify_mark(2) 
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 07:56:49 +02:00
Heinrich Schuchardt 3e6ebb33e5 fanotify_init.2: New page documenting fanotify_init(2) 
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-25 07:56:02 +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 84f573db60 rename.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-04-23 20:55:44 +02:00