Commit Graph

5804 Commits

Author SHA1 Message Date
Michael Kerrisk f4a44ac634 stat.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-15 13:34:44 +01:00
Michael Kerrisk 698ac0e263 chmod.2: Clarify terminology (file mode versus file permission bits)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-15 13:34:44 +01:00
Michael Kerrisk 1bab84a885 open.2: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-13 17:55:10 +01:00
Michael Kerrisk b3eb228083 gettid.2: tfix
Reported-by: Ivan Shapovalov <intelfx@intelfx.name>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-13 15:58:04 +01:00
Michael Kerrisk 0f166ce187 bpf.2: Document close-on-exec semantics
The close-on-exec file descriptor flag is automatically enabled
for FDs returned by bpf().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-11 14:50:16 +01:00
Christoph Hellwig cf8bac925f sync.2: Clarify description and document the Linux data integrity guarantees
Signed-off-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-11 13:34:20 +01:00
Michael Kerrisk 0509285e2c stat.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-08 16:11:58 +01:00
Michael Kerrisk 368bbfa929 brk.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-08 16:11:58 +01:00
Michael Kerrisk d432f10d89 madvise.2: Tweaks and improvements to Minchan's text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-08 08:24:15 +01:00
Michael Kerrisk 9ec1369898 madvise.2: Reorder MAD_FREE entry
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-08 08:24:15 +01:00
Minchan Kim cbb9ef3061 madvise.2: Document MADV_FREE
Document the MADV_FREE flag added to madvise() in Linux 4.5.

Signed-off-by: Minchan Kim <minchan@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-08 08:24:15 +01:00
Michael Kerrisk d38a09fca6 fanotify_init.2: Note kernel version that allowed O_CLOEXEC for event_f_flags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-06 19:31:55 +01:00
Michael Kerrisk 6b1e34f2a4 madvise.2: Put MADV_SOFT_OFFLINE into kernel version order
Exceptionally, the lists on this page are in kernel version order
rather than alphabetical order. But one entry was out of order.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-06 12:27:25 +01:00
Michael Kerrisk 11c25e24c8 madvise.2: Clarify MADV_HWPOISON wording to say that it applies to a page range
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-06 12:24:54 +01:00
Michael Kerrisk 20cc8fa829 select.2: Document spurious EAGAIN error that can occur on other systems
Light reworking of text proposed by Josh Triplett.

Reported-by: Josh Triplett <josh@joshtriplett.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-04 12:34:06 +01:00
Michael Kerrisk f14637570d poll.2: Document spurious EAGAIN error that can occur on other systems
Light reworking of text proposed by Josh Triplett.

Reported-by: Josh Triplett <josh@joshtriplett.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-04 12:34:06 +01:00
Michael Kerrisk 5dbb60df52 select_tut.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 15:51:42 +01:00
Michael Kerrisk 65842010f3 select_tut.2: Simplify 'if' logic in in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 14:37:40 +01:00
Michael Kerrisk 894d620ae2 select_tut.2: Use correct type (socklen_t) for addrlen
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 14:37:40 +01:00
Michael Kerrisk 5bb9aa4e0c select_tut.2: Better variable names in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 14:37:40 +01:00
Michael Kerrisk f145f66700 select_tut.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 14:18:21 +01:00
Michael Kerrisk 887f19e8a1 select.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 14:16:00 +01:00
Michael Kerrisk 455f50e98b select_tut.2: Some readability fixes to example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 14:08:29 +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 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
Michael Kerrisk def04e1ccf chown.2, futex.2, membarrier.2, memfd_create.2, mount.2, msgop.2, open.2, open_by_handle_at.2, perf_event_open.2, readv.2, sched_setscheduler.2, syslog.2, basename.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 08:46:16 +01:00
Michael Kerrisk e6a05bfff2 clock_getres.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 08:36:41 +01:00
Michael Kerrisk 9088de13ba capget.2, chown.2, chroot.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 08:36:32 +01:00
Michael Kerrisk 122502e824 bind.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 08:34:02 +01:00
Jakub Wilk ed1819cf3e futex.2: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
2016-02-03 08:27:03 +01:00
Jakub Wilk 2050c09881 perf_event_open.2: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
2016-02-03 08:26:34 +01:00
Jakub Wilk 3a1de8ba24 kexec_load.2: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
2016-02-03 08:26:01 +01:00
Michael Kerrisk 8400413301 msgop.2: tfix
Reported-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 08:24:17 +01:00
Michael Kerrisk 6c3453059b select.2: Add details on the glibc fixed-size fd_set limitation
No modern application should use select() on Linux.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-01 15:21:54 +01:00
Nikos Mavrogiannopoulos 6b6e918550 select.2: Mention the 'fd_set' size limitation early and refer to poll(2)
Change this because of the serious limitation of select()
imposing a limit on the range of file descriptors that can
be monitored. This is currently mentioned too late in the
documentation (in the NOTES section). The man page should
warn early and refer to poll(2) as soon as possible.

Signed-off-by: Nikos Mavrogiannopoulos <nmav@gnutls.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-01 15:21:54 +01:00
Michael Kerrisk 555c23c278 personality.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-31 16:34:02 +01:00
Michael Kerrisk 2d41eca319 personality.2: Greatly expand, to add descriptions of personality domains.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-30 17:31:14 +01:00
Michael Kerrisk 6d8e9b7e76 readv.2: wrcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-28 21:48:45 +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
Michael Kerrisk 2bea5d44a5 copy_file_range.2: Add notes on copy_on_write() filesystem optimizations
Based on Anna Schumaker's noted in the initial commit for
this man page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-27 09:10:32 +01:00
Michael Kerrisk a5918afa92 syscalls.2: Add copy_file_range(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-27 09:00:36 +01:00
Michael Kerrisk 9876bc24d0 sendfile.2: SEE ALSO: add copy_file_range(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:51:28 +01:00
Michael Kerrisk d1de085084 copy_file_range.2: EXAMPLE: remove unused variable from example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:42:20 +01:00
Michael Kerrisk b4fe696c8a copy_file_range.2: NOTES: expand details on the use of lseek()
Mention SEEK_DATA and SEEK_HOLE explicitly.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:42:20 +01:00
Michael Kerrisk 4cfafd7910 copy_file_range.2: ERRORS: clarify EXDEV description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:42:20 +01:00
Michael Kerrisk f0558db88d copy_file_range.2: ERRORS: clarify EINVAL O_APPEND description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:42:19 +01:00
Michael Kerrisk ee43ffde93 copy_file_range.2: Minor fixes to Anna's new page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:42:19 +01:00
Anna Schumaker 903b48079c copy_file_range.2: New page documenting copy_file_range()
copy_file_range() is a new system call for copying ranges of data
completely in the kernel.  This gives filesystems an opportunity to
implement some kind of "copy acceleration", such as reflinks or
server-side-copy (in the case of NFS).

Signed-off-by: Anna Schumaker <Anna.Schumaker@Netapp.com>
Reviewed-by: Darrick J. Wong <darrick.wong@oracle.com>
Reviewed-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:15:24 +01:00
Michael Kerrisk c72249c562 fork.2, read.2, sendfile.2, splice.2, write.2, aio_read.3, aio_write.3, proc.5: Wording fix: "current file offset" ==> "file offset"
"File offset" is the preferred POSIX terminology.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:13:47 +01:00
Michael Kerrisk f180e30bc2 lseek.2: wfix ("open file description")
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:08:39 +01:00