Commit Graph

102 Commits

Author SHA1 Message Date
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
Michael Kerrisk 84a275c4c8 ffix 2008-04-24 09:36:45 +00:00
Michael Kerrisk 9f91e36c26 Note that O_CLOEXEC is in next POSIX revison.
Added a FIXME for other upcoming POSIX changes.
2008-04-08 11:28:12 +00:00
Michael Kerrisk 24d01c530c s/filesystem/file system/ 2008-03-19 07:26:08 +00:00
Michael Kerrisk 4e698277c0 Move discussion of 'mode' argument under description of O_CREAT. 2008-02-28 14:47:54 +00:00
Michael Kerrisk ddc4d3392c Greatly expand the detail on O_DIRECT. 2008-02-11 10:38:24 +00:00
Michael Kerrisk 7db44341af Minor fix to O_EXCL changes in previous release. 2008-01-05 04:50:10 +00:00
Michael Kerrisk 447bb15ee0 Removed trailing white space at end of lines 2008-01-03 16:06:22 +00:00
Michael Kerrisk f4b9d6a511 Clarify initial description of O_EXCL.
Clarify description of behavious of O_CREAT | O_EXCL for symbolic links.
Clarify text describing use of lockfiles without O_EXCL.
O_EXCL is supported on NFSv3 and later, with Linux 2.6 and later.
2008-01-03 08:12:02 +00:00
Michael Kerrisk 8382f16db1 grfix 2007-12-25 21:28:09 +00:00
Michael Kerrisk e2badfdf26 Hyphenation fixes 2007-12-25 20:50:22 +00:00
Michael Kerrisk 5895e7eb8d wspace in SYNOPSIS 2007-12-23 13:45:24 +00:00
Michael Kerrisk c7992edccf Removed tabs 2007-12-05 13:47:50 +00:00
Michael Kerrisk 0daa9e92d0 Fix redundant formatting macros 2007-09-20 16:26:31 +00:00
Michael Kerrisk c11b1abf2e Change mtk's email address 2007-09-20 06:52:22 +00:00
Michael Kerrisk fb7339dfa0 Removed trailing white space at end of lines 2007-09-19 21:42:14 +00:00
Michael Kerrisk fe75ec04d3 Added description of O_CLOEXEC (new in 2.6.23) + other
minor fixes for O_DIRECT.
2007-09-10 04:34:20 +00:00