Commit Graph

10311 Commits

Author SHA1 Message Date
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 567572a7d7 Changes: Ready for 3.64
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:43:00 +02:00
Michael Kerrisk f8f8b9c1f6 termios.3: Add descriptive titles to noncanonical read() cases
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:20:51 +02:00
Michael Kerrisk a9f0126fa6 termios.3: Clarify termination conditions for MIN > 0, TIME > 0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:20:51 +02:00
Michael Kerrisk e764d1b79d termios.3: Clarify behavior if data is available before noncanonical read()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:20:51 +02:00
Michael Kerrisk 5ee2d3c5d6 termios.3: Add a note on interaction of O_NONBLOCK with noncanonical MIN/TIME
POSIX leaves the behavior open.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:20:50 +02:00
Michael Kerrisk 4b985dd60a termios.3: Fix error in discussion of MIN > 0, TIME == 0 noncanonical mode
As reported by Peter Hurley, for the MIN > 0, TIME == 0 case:

    read() may unblock when MIN bytes are available but return
    up to the 'count' parameter if more input arrives in between
    waking and copying into the user buffer.
    ...
    read() may also _not_ return until MIN bytes have been
    received, even if 'count' bytes have been received.

MTK: verified the above by experiment.

Reported-by: Peter Hurley <peter@hurleysoftware.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:20:50 +02:00
Michael Kerrisk 959c4b2519 termios.3: ffix: reformat MIN/TIME list to use .TP
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:20:50 +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 08107714a5 open_by_handle_at.2: Remove FIXMEs after review by Aneesh Kumar
Reviewed-by: Aneesh Kumar K.V <aneesh.kumar@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:13:47 +02:00
Michael Kerrisk 39c98c7d50 open_by_handle_at.2: Note when glibc support was added
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:26 +02:00
Michael Kerrisk 43a8bfc677 proc.5: srcfix: added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:26 +02:00
Michael Kerrisk 3ad5d1b9f6 open_by_handle_at.2: Rework example programs
Rework example programs so that they use a text file (rather
than a binary file) to exchange mount ID and file handle.
Various clean-ups and bug fixes after review by Mike Frysinger.

Reviewed-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:26 +02:00
Michael Kerrisk 886f35af61 open_by_handle_at.2: ffix 2014-04-06 08:12:26 +02:00
Michael Kerrisk b2fe7451ce open_by_handle_at.2: Fixes after review comments by Mike Frysinger
Reviewed-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:26 +02:00
Michael Kerrisk e2199ccbc0 open_by_handle_at.2: Further edits after comments by Neil Brown
Reviewed-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:26 +02:00
Michael Kerrisk 97236faef5 open_by_handle_at.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:26 +02:00
Michael Kerrisk 269ad84333 open_by_handle_at.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:26 +02:00
Michael Kerrisk 74a769f92d open_by_handle_at.2: ERRORS: Remove bogus ENOTDIR error for open_by_handle_at()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:26 +02:00
Michael Kerrisk 3be5b709ad open_by_handle_at.2: ERRORS: change reference from open(2) to openat(2)
Christoph noted that if ERRORS defers to openat(2) rather than
open(2), then a couple of errors can be eliminated from the list
on this page.

Reviewed-by: Christoph Hellwig <hch@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk fb968310b1 open_by_handle_at.2: Various fixes after review by Neil Brown
Reviewed-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk b088c3ca52 open.2: SEE ALSO: add open_by_name_at(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk 55ac9696ec name_to_handle_at.2: New link to new open_by_name_at(2) page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk a827d5c648 open_by_handle_at.2: New page describing name_to_handle_at(2) and open_by_handle_at(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +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
Abhay Sachan 25cb5f9b8b getxattr.2: Fix REURN VALUE description
A EA can have length zero.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:10:59 +02:00
Andrey Vagin 5e7c71f6ac mmap.2: The file descriptor for a file mapping must be readable
There is no difference between MAP_SHARED and MAP_PRIVATE.

do_mmap_pgoff()
	switch (flags & MAP_TYPE) {
	case MAP_SHARED:
	...
	/* fall through */
	case MAP_PRIVATE:
		if (!(file->f_mode & FMODE_READ))
			return -EACCES;

Signed-off-by: Andrey Vagin <avagin@openvz.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-04 13:25:08 +02:00
David Prévot 5f7504ef28 locale.5: Minor fixes
Hi Michael,

Please find attach various minor fixes:
- consistency fixes;
- punctuation fixes;
- typo fixes;
- format fixes;
- usage fix;
- American spelling convention.

Regards

David

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-04 07:46:23 +02:00
David Prévot 5201bb40a7 stat.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-03 13:41:19 +02:00
Alexey Samsonov cc82e457b2 getline.3: Caller should free the allocated buffer even if getline() failed
Relevant discussion in glibc bugzilla:
https://sourceware.org/bugzilla/show_bug.cgi?id=5666
test program:

    $ cat tmp/getline/a.cc
    #include <stdio.h>
    int main() {
      for (int x = 0; x < 2; x++) {
        char *lineptr = 0;
        size_t size = 0;
        int res = getline(&lineptr, &size, stdin);
        printf("%d\n%p\n", res, lineptr);
      }
      return 0;
    }
    $ gcc tmp/getline/a.cc && echo -n "xxx" > x && ./a.out < x
    3
    0x11ae010
    -1
    0x11ae090

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-02 12:10:03 +02:00