Commit Graph

10622 Commits

Author SHA1 Message Date
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
Jan Moskyto Matejka d63ff76e2a proc.5: Improve description of /proc/stat 'intr' field
The sum at the beginning of line "intr" includes also
unnumbered interrupts.

(Change made in kernel commit
a2eddfa95919a730e0e5ed17e9c303fe5ba249cd)

Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Jan Moskyto Matejka <mq@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 7fdec06564 open.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 21557928fa open.2: Minor tweaks to Peter Schiffer's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Peter Schiffer e6042e4ad2 open.2: Update note on alignment of user buffer and file offset for O_DIRECT
The sentence in open(2) man page in notes for O_DIRECT flag:

    "Under Linux 2.6, alignment to 512-byte boundaries suffices."

is not universally correct. The alignment is a property of the
storage, for example, 4k-sector drives with no 512 byte sector
emulation will be unable to perform 512-byte direct I/O.

The patch clarifies this sentence.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 20ee63c18c open.2: Remove repetitious text on use of fcntl() to change file status flags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 61b12e2b63 open.2: Note some of the various synonyms for "open file description"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Peng Haitao 88b11b50cb pthread_attr_setstack.3: ATTRIBUTES: Note functions that are thread-safe
The functions pthread_attr_setstack() and pthread_attr_getstack()
are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Peng Haitao 180a948b37 pthread_attr_setscope.3: ATTRIBUTES: Note functions that are thread-safe
The functions pthread_attr_setscope() and pthread_attr_getscope()
are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Peng Haitao 1cfb294673 pthread_attr_setschedpolicy.3: ATTRIBUTES: Note functions that are thread-safe
The functions pthread_attr_setschedpolicy() and
pthread_attr_getschedpolicy() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Peng Haitao 6fea3867c0 pthread_attr_setschedparam.3: ATTRIBUTES: Note functions that are thread-safe
The functions pthread_attr_setschedparam() and
pthread_attr_getschedparam() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Peng Haitao 47fb8a7f94 pthread_attr_setinheritsched.3: ATTRIBUTES: Note functions that are thread-safe
The functions pthread_attr_setinheritsched() and
pthread_attr_getinheritsched() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 1df20d51b3 dlopen.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 61a37c81ef flock.2: Employ term "open file description" in DESCRIPTION
And include reference to open(2) for an explanation of the term.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 04346be5bb clone.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 840324c0d5 msync.2: s/flushes... back to disk/flushes... back to filesystem/
As noted by Heinrich:

    The manpage of msync(2) says:
        "msync() flushes changes made to the in-core copy of a file
        that was mapped into memory using mmap(2) back to disk."
    ...
    "back to disk" implies that the file system is forced to
    actually write to the hard disk, somewhat equivalent to
    invoking sync(1).  Is that guaranteed for all file systems?

    Not all file systems are necessarily disk based
    (e.g. davfs, tmpfs).

    So shouldn't we write:
        "... back to the file system."

    http://pubs.opengroup.org/onlinepubs/007904875/functions/msync.html
    says "... to permanent storage locations, if any,"

Reported-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-21 11:35:20 +02:00
Michael Kerrisk 645de70f2f Start of man-pages-3.66: updating Changes and Changes.old 2014-04-20 11:08:56 +02:00
Michael Kerrisk 035e513fc1 Start of man-pages-3.66: updating .Announce and .lsm files 2014-04-20 11:08:56 +02:00
Michael Kerrisk 3a130ce6eb Start of man-pages-3.66: renaming .Announce and .lsm files 2014-04-20 11:08:56 +02:00
Michael Kerrisk e55b400ec6 Ready for 3.65 2014-04-20 11:06:11 +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
Michael Kerrisk 7e8b106588 Changes: Ready for 3.65
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-20 10:59:53 +02:00
Yuri Kozlov a675383214 timer_getoverrun.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-20 10:46:41 +02:00
Michael Kerrisk 2f4772d2d2 fcntl.2: Note the race when O_CLOEXEC is used at same time as fork()+execve()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-20 10:46:40 +02:00
Michael Kerrisk 7756d15761 open.2: Add more detail on the race that O_CLOEXEC is designed to avoid
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-20 10:46:40 +02:00
Michael Kerrisk 62bd7742ff fexecve.3: If 'fd' is a close-on-exec file descriptor for a script, fexecve() fails
See https://bugzilla.kernel.org/show_bug.cgi?id=74481

Reported-by: Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-20 07:48:15 +02:00
Michael Kerrisk 0dbfbe8e71 fexecve.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-20 07:48:15 +02:00
Michael Kerrisk 5f8ddde3b7 execve.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-20 07:48:15 +02:00
Michael Kerrisk 5526923ae2 inet.3: The form 'a.b' if is suitable for Class A addresses (not class C)
Reported-by: Craig McQueen <craig.mcqueen@beamcommunications.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-19 10:44:40 +02:00
Michael Kerrisk 4cbfaed0ad inet.3: Note success and error return for inet_aton()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-19 10:44:28 +02:00
Michael Kerrisk 2af4d967af fallocate.2: Document EINVAL for FALLOC_FL_COLLAPSE_RANGE on non-regular file
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-19 10:44:22 +02:00
Simon Paillard 85ad779b17 open_by_handle_at.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-19 10:44:15 +02:00
Michael Kerrisk 43d19bc76f crypt.3: Minor fixes to Mike Frysinger's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-18 17:51:25 +02:00
Mike Frysinger 3cc95d3f42 crypt(3): Use real dashes in regex
I don't think rendering the dashes in the regex expression as the
en style makes sense.  This is a literal regex, so use literal
dashes.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-18 17:50:07 +02:00
Michael Kerrisk 1ecfa5b30e fallocate.2: Greatly expanded description of FALLOC_FL_COLLAPSE_RANGE
Reviewed-by: Christoph Hellwig <hch@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-18 17:38:41 +02:00
Michael Kerrisk f78da076c9 fallocate.2: Minor fixes to Namjae Jeon's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 15:38:51 +02:00
Namjae Jeon ea56dddf25 fallocate.2: Document FALLOC_FL_COLLAPSE_RANGE
Signed-off-by: Namjae Jeon <namjae.jeon@samsung.com>
Signed-off-by: Ashish Sangwan <a.sangwan@samsung.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 15:38:51 +02:00
Michael Kerrisk e6a110ef57 proc.5: Note kernel version for /proc/sys/kernel/{msgmax,msgmnb}
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 15:38:51 +02:00
Michael Kerrisk d85d2ed8e6 proc.5: Note kernel version for /proc/sys/kernel/{shmall,shmmax}
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 15:38:51 +02:00
Michael Kerrisk 098c699809 shmget.2: Rewrite description of SHMMNI default value
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 15:38:50 +02:00
Michael Kerrisk c00811f345 shmget.2: Note default value of SHMMAX
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 15:38:44 +02:00
Michael Kerrisk e6a38ea607 shmget.2: Note default value for SHMALL
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 15:38:37 +02:00
Michael Kerrisk 8ab18f6ce0 shmget.2: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 13:28:07 +02:00
Michael Kerrisk 2b23ecbdea perf_event_open.2: Explain the EACCES "monitoring all processes" case more precisely
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 09:44:58 +02:00
Michael Kerrisk bec6277efa perf_event_open.2: Change "fd" to "file descriptor"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 09:22:06 +02:00
Michael Kerrisk ee7b0cbfc9 perf_event_open.2: Change "current process" to "calling process" in various places
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 09:22:06 +02:00
Michael Kerrisk ce88f77b91 perf_event_open.2: Minor grammar, formatting, wording, and typo fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 09:22:06 +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
David Prévot 8563c24924 termios.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 07:45:52 +02:00