Commit Graph

118 Commits

Author SHA1 Message Date
Akihiro MOTOKI 02ace852fb open.2, select.2, aio_cancel.3, aio_suspend.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-06-08 03:10:25 +12:00
Michael Kerrisk 0ab8aeecc5 Removed trailing white space at end of lines 2012-05-11 08:13:04 +12:00
Nick Piggin 1847167b8b open.2: Describe race of direct I/O and fork()
Rework 04cd7f64, which didn't capture the details correctly.
See the April/May 2012 linux-man@ mail thread "[PATCH]
Describe race of direct read and fork for unaligned buffers"
http://thread.gmane.org/gmane.linux.kernel.mm/77571

Acked-by: KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
Cowritten-by: Jan Kara <jack@suse.cz>
Cowritten-by: Hugh Dickins <hughd@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-09 19:18:43 +12:00
Jan Kara 04cd7f643d open.2: Describe race of direct read and fork() for unaligned buffers
This is a long standing problem (or a surprising feature) in our
implementation of get_user_pages() (used by direct IO). Since
several attempts to fix it failed (e.g.,
http://linux.derkeiler.com/Mailing-Lists/Kernel/2009-04/msg06542.html,
or http://lkml.indiana.edu/hypermail/linux/kernel/0903.1/01498.html
refused in http://comments.gmane.org/gmane.linux.kernel.mm/31569)
and it's not completely clear whether we really want to fix
it given the costs. Let's at least document it.

Signed-off-by: Jan Kara <jack@suse.cz>
Acked-by: Jeff Moyer <jmoyer@redhat.com>
Acked-by: Mel Gorman <mgorman@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk be02e49f7c open.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-24 13:05:14 +13:00
Michael Kerrisk 1901002c4a fallocate.2, fork.2, open.2, send.2: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 14:12:16 +13:00
Jessica McKellar 0deb3ce930 open.2: Fix grammar in O_DIRECT description
Some small grammar fixes to the O_DIRECT description.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-13 10:22:05 +13:00
Michael Kerrisk 5503c85ea4 intro.1, fork.2, futex.2, open.2, rename.2, select_tut.2, semop.2, spu_create.2, stat.2, netlink.3, random.3, scanf.3, shm_open.3, strftime.3, console.4, console_codes.4, sk98lin.4, st.4, bootparam.7, cpuset.7, credentials.7, man-pages.7, path_resolution.7, uri.7: Global fix: remove spaces around em-dash
Normal English typographical convention is not to have
spaces around em dashes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:47:35 +02:00
Michael Kerrisk 12e263f178 open.2: wfix
Reported-by: Graham Gower <graham.gower@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Folkert van Heusden fd3ac44091 open.2: Remove text describing O_CLOEXEC as Linux-specific
O_CLOEXEC is specified in POSIX.1-2008, as noted
elsewhere in the page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:46 +02:00
Michael Kerrisk 54903f5e97 open.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-07 19:17:43 +02:00
Denis Barbier 6303d401a9 open.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:42:18 +01:00
Ivana Hutarova Varekova 10b7a94568 open.2: O_EXCL can be used without O_CREAT for block devices
Since Linux 2.6 there is a possibility to use O_EXCL without
O_CREAT. See patch: http://lkml.org/lkml/2003/8/10/221.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-15 06:58:11 +01:00
Michael Kerrisk 0a4f8b7bb4 getresuid.2, intro.2, mremap.2, open.2, poll.2, posix_fadvise.2, pread.2, remap_file_pages.2, setresuid.2, signal.2, splice.2, sync_file_range.2, tee.2, vmsplice.2, INFINITY.3, asprintf.3, assert_perror.3, basename.3, bsd_signal.3, canonicalize_file_name.3, clog10.3, crypt.3, dl_iterate_phdr.3, dlopen.3, dprintf.3, encrypt.3, exp10.3, fcloseall.3, fenv.3, ffs.3, fmemopen.3, fopencookie.3, ftw.3, getdate.3, getline.3, getloadavg.3, getopt.3, getsubopt.3, getutent.3, grantpt.3, hsearch.3, intro.3, lseek64.3, memmem.3, mempcpy.3, mq_receive.3, mq_send.3, posix_fallocate.3, pow10.3, program_invocation_name.3, ptsname.3, putgrent.3, readdir.3, sigset.3, sincos.3, stpcpy.3, stpncpy.3, strchr.3, strfry.3, strnlen.3, strptime.3, strsignal.3, strstr.3, strverscmp.3, swab.3, sysv_signal.3, tsearch.3, unlocked_stdio.3, unlockpt.3, wcpcpy.3, wcpncpy.3, wcsdup.3, wcwidth.3: SEE ALSO: Remove redundant reference to feature_test_macros(7)
Reported-by: Florian Lehmann <flo.lehmann@googlemail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-31 06:06:58 +01:00
Michael Kerrisk b218b02329 open.2, poll.2, select_tut.2, getpt.3, openpty.3, posix_openpt.3, ptsname.3, unlockpt.3, pts.4, tty_ioctl.4, proc.5, pty.7: spfix: s/psuedoterminal/psuedoterminal/g
Reported-by: Denis Barbier <bouzim@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-13 05:32:15 +02:00
Michael Kerrisk 662b2137e8 open.2, poll.2, select_tut.2, getpt.3, grantpt.3, openpty.3, posix_openpt.3, ptsname.3, unlockpt.3, pts.4, tty_ioctl.4, proc.5, pty.7: Global fix: s/pseudo-terminal/pseudoterminal/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-12 06:51:51 +02:00
Michael Kerrisk 803e1d2f16 open.2: spfix in source comment
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 06:37:55 +02:00
Michael Kerrisk e417acb023 fcntl.2, intro.2, open.2, poll.2, ftw.3, intro.3, matherr.3, system.3, tmpnam.3, unix.7: Note that feature test macros must be defined before *any* includes
Programmers often make the mistake of including a feature test
macro only after having already included some header files.
This patch adds some text at opportune places to remind
programmers to do things the right way.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 06:33:31 +02:00
Yuri Kozlov 0a598d2676 open.2: grfix
Signed-off-by: Michael Kerrisk <mtk@konstanz.(none)>
2010-08-29 06:39:28 +02:00
Michael Kerrisk 245dec52ca open.2, sync_file_range.2, umount.2: Global fix: s/filesystem/file system/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-15 05:16:42 +02:00
Michael Kerrisk efe08656e6 open.2: Remove ambiguity in text on NFS and O_EXCL.
Reported-by: David Sommerseth <davids@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-14 04:38:26 +02:00
Michael Kerrisk 2fda57bd09 _syscall.2, accept.2, epoll_create.2, inotify_add_watch.2, ioctl.2, msgget.2, msgop.2, open.2, prctl.2, sched_setscheduler.2, semctl.2, semget.2, swapon.2, addseverity.3, cacosh.3, csqrt.3, dirfd.3, drand48.3, fputws.3, mq_send.3, posix_openpt.3, puts.3, sched_getcpu.3, shm_open.3, sqrt.3, sysconf.3, tgamma.3, ulimit.3, credentials.7, svipc.7: Global fix: s/non-negative/nonnegative/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 17:44:48 +01:00
Michael Kerrisk ff40dbb354 accept.2, connect.2, eventfd.2, flock.2, open.2, posix_fadvise.2, read.2, recv.2, sched_setscheduler.2, select_tut.2, send.2, signalfd.2, splice.2, timerfd_create.2, write.2, flockfile.3, mkfifo.3, mq_notify.3, mq_open.3, pthread_tryjoin_np.3, scanf.3, random.4, ddp.7, epoll.7, fifo.7, ip.7, pipe.7, socket.7, spufs.7: Global fix: s/non-blocking/nonblocking/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 17:43:10 +01:00
Michael Kerrisk c8f2dd479b accept.2, execve.2, futimesat.2, getresuid.2, getrlimit.2, madvise.2, mq_getsetattr.2, msgctl.2, nice.2, open.2, poll.2, setresuid.2, shmctl.2, sigaction.2, times.2, utimensat.2, __setfpucw.3, atoi.3, endian.3, err.3, euidaccess.3, fenv.3, fopencookie.3, fpurge.3, getgrouplist.3, getutmp.3, j0.3, lgamma.3, netlink.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_cleanup_push_defer_np.3, pthread_getattr_np.3, pthread_kill_other_threads_np.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3, pthread_yield.3, random_r.3, readdir.3, rtnetlink.3, scanf.3, setenv.3, significand.3, sigsetops.3, strerror.3, strstr.3, sysv_signal.3, termios.3, timegm.3, unlocked_stdio.3, y0.3, locale.5, bootparam.7, feature_test_macros.7, ip.7, locale.7, pthreads.7, rtld-audit.7, nscd.8: Global fix: s/non-standard/nonstandard/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 17:40:20 +01:00
Michael Kerrisk 7111f89ff2 open.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-05 17:49:46 +01:00
Christoph Hellwig 015221eff8 open.2: add some comments on O_SYNC and friends
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:21 +02:00
Michael Kerrisk 5e4dc2691b open.2, stat.2: tfix s/_FILE_OFF_SET_BITS/_FILE_OFFSET_BITS/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Chris Heath <chris@heathens.co.nz>
2008-12-05 22:47:18 -05:00
Michael Kerrisk 7c7fb55221 open.2: EFBIG error is now EOVERFLOW (since Linux 2.6.24)
When a 32-bit app opens a file whose size is too big to be
represented in 31-bits, POSIX.1 specifies the error EOVERFLOW.
Linux used to give EFBIG for this case, but 2.6.24 fixed this.

Also, add some text to describe the error scenario in
more detail.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:18 -05:00
Michael Kerrisk 85c2bdba64 open.2: wfix 2008-11-25 20:54:02 -05:00
Ulrich Mueller 7c5f05139c open.2: tfix: in CONFORMING TO: s/POSIX.1-2001/POSIX.1-2008/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-04 08:51:26 -05:00
Michael Kerrisk a439142940 open.2: srcfix: add comments re NFS and O_APPEND 2008-10-29 14:54:27 -05:00
Michael Kerrisk 9502479bab open.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 07:49:40 +02:00
Michael Kerrisk 93ee8f96d4 open.2: FIXME: Add a FIXME regarding open flags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 07:49:40 +02:00
Michael Kerrisk f1d97f6e4d open.2: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 07:49:39 +02:00
Michael Kerrisk 24ec631f42 open.2: minor: Fix O_CLOEXEC wording re fcntl() calls
The current wording suggests that only a single fcntl()
operation is needed to set the FD_CLOEXEC flag, when "proper"
usage would be fcntl(F_GETFD) + fcntl(F_SETFD) to get the
flags and then update them.  So change the wording to indicate
that more than one fcntl() operation is required.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 07:49:39 +02:00
Michael Kerrisk 08a3addfa4 O_CLOEXEC is specified in POSIX.1-2008. 2008-08-21 04:51:54 +00:00
Michael Kerrisk 1f8f8acb44 grfix 2008-08-21 04:44:02 +00:00
Michael Kerrisk bbae62c333 Remove ambiguity in description of support for O_EXCL on NFS.
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=491791.
2008-07-22 05:48:27 +00:00
Michael Kerrisk f0c34053bc Put SEE ALSO section into alphabetical order. 2008-07-14 15:52:21 +00:00
Michael Kerrisk c4bb193f3c s/parameter/argument/ when talking about the things given
to a function call, for consistency with majority usage.
2008-07-10 20:53:08 +00:00
Michael Kerrisk f96bf6e9a3 tstamp 2008-07-04 15:45:55 +00:00
Michael Kerrisk e51412ea9e ERRORS: Add EINTR error 2008-07-04 15:44:19 +00:00
Michael Kerrisk c734b9f234 NOTES: Note that access mode flags are not single bits,
and document the Linuxism "access mode 3".
See also http://thread.gmane.org/gmane.linux.kernel/653123.
2008-06-11 22:04:37 +00:00
Michael Kerrisk a9cfde1dbc SEE ALSO: add symlink.7 2008-06-11 21:50:53 +00:00
Michael Kerrisk a6d57a94af tfix 2008-06-03 09:19:38 +00:00
Michael Kerrisk d051e0c01e Update FIXME. 2008-06-03 09:19:25 +00:00
Michael Kerrisk a3bf802265 Add chown.2/chmod.2 to SEE ALSO 2008-05-13 11:29:39 +00:00
Michael Kerrisk 8b39ad6681 More than just ext2 supports "mount -o bsdgroups" nowadays, so make the
discussion about group ownership of new files a bit more generic.
2008-05-13 10:54:22 +00:00
Michael Kerrisk d77eb76422 spfix 2008-05-12 14:38:18 +00:00
Michael Kerrisk 61b7c1e18f spfix/wfix 2008-05-12 14:30:24 +00:00