Commit Graph

200 Commits

Author SHA1 Message Date
Michael Kerrisk 91085d8525 Removed trailing white space at end of lines 2014-06-14 08:03:45 +02:00
Michael Kerrisk ad5b45abe5 localedef.1, execve.2, fcntl.2, flock.2, lseek.2, open.2, open_by_handle_at.2, recvmmsg.2, sendmmsg.2, seteuid.2, setresuid.2, setreuid.2, setuid.2, statfs.2, syscalls.2, basename.3, catgets.3, getdate.3, getdirentries.3, getdtablesize.3, iconv.3, lockf.3, malloc_get_state.3, malloc_usable_size.3, matherr.3, mkdtemp.3, mkstemp.3, mq_close.3, mq_unlink.3, siginterrupt.3, system.3, locale.5, bootparam.7, environ.7, man-pages.7, signal.7, unicode.7, utf-8.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-13 17:15:44 +02:00
Michael Kerrisk d20d9d33ab open.2: Rework and extend the discussion of open file descriptions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:49 +02:00
Michael Kerrisk 0da5e58ad2 Removed trailing white space at end of lines 2014-05-21 13:16:14 +02:00
Michael Kerrisk 103ea4f6b3 open.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-19 11:25:57 +02:00
Michael Kerrisk 2feae60283 open.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-19 11:23:13 +02:00
Michael Kerrisk d6a74b9559 open.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-19 11:06:18 +02:00
Michael Kerrisk 9af6b11576 open.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-19 10:39:47 +02:00
Michael Kerrisk fa5d243fac open.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-10 07:33:48 +02:00
Michael Kerrisk 726663fd9d bind.2, connect.2, create_module.2, delete_module.2, execve.2, get_robust_list.2, getpriority.2, getrusage.2, init_module.2, link.2, listen.2, mbind.2, open.2, poll.2, query_module.2, readlink.2, recv.2, remap_file_pages.2, sched_setaffinity.2, semop.2, send.2, stat.2, stime.2, syscall.2, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, remquo.3, rtime.3, sched_getcpu.3, stpcpy.3, stpncpy.3, strcasecmp.3, system.3, fd.4, proc.5, ip.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:31:12 +02:00
Andy Lutomirski 7dee406bc4 link.2, open.2: Update AT_EMPTY_PATH and O_PATH documentation
The current text reflects the general worry in the kernel about
recipients of O_PATH fds being able to hardlink the referenced
files.  It turns out that it was possible to link these files
regardless of any possible security concerns.

Linux 3.11 removes the capability check in AT_EMPTY_PATH.
I expect that this functionality will be generally useful,
so let's document it better.

Signed-off-by: Andy Lutomirski <luto@amacapital.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:53 +02:00
Michael Kerrisk dff25141a5 open.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:53 +02:00
Michael Kerrisk 30821db82e open.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 10:09:17 +02:00
John Marshall 3ad65ff004 open.2: wfix
Signed-off-by: John Marshall <jm18@sanger.ac.uk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-06 14:41:52 +02:00
Michael Kerrisk 2b9b829d52 time.1, get_kernel_syms.2, getitimer.2, open.2, perf_event_open.2, wait.2, alloca.3, bcmp.3, catopen.3, fputwc.3, iconv.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, mbsinit.3, putwchar.3, rcmd.3, rexec.3, sigqueue.3, strverscmp.3, wctrans.3, wctype.3, wcwidth.3, console_codes.4, initrd.4, st.4, elf.5, nss.5, ip.7, netdevice.7, path_resolution.7, socket.7, udp.7, ld.so.8: grfix: s/Otherwise /Otherwise, /
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 10:15:47 +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
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 6549664445 open.2: Remove crufty text stating that O_DIRECTORY is Linux-specific
Reported-by: Matthew Dempsky <mdempsky@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-10 21:11:50 +02:00
Michael Kerrisk cde2074a45 open.2: Note which filesystems support O_TMPFILE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-10 06:30:24 +02:00
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 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 f1ad56a654 open.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:16 +01:00
Michael Kerrisk 89851a0054 Removed trailing white space at end of lines 2014-03-18 16:29:34 +01:00
Michael Kerrisk 289f790700 open.2: Clarify ELOOP error interaction with O_PATH
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 12:40:56 +01:00
Michael Kerrisk d30344ab97 open.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 12:40:56 +01:00
Michael Kerrisk d26f8a31f1 open.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 12:40:56 +01:00
Michael Kerrisk 80d250b469 open.2: Add other system calls and functions that are like openat()
fanotify_mark(2), name_to_handle_at(2), and scandirat(3) have a
directory file descriptor argument for the same reason as openat().
Also: reword the rationale for the *at() functions somewhat.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 12:39:49 +01:00
Michael Kerrisk 6cf19e6234 open.2: Document O_DSYNC and rewrite discussion of O_SYNC
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-17 08:46:40 +01:00
Michael Kerrisk 5dc8986d0d open.2: Organize some material under additional subheadings in NOTES
There's an amorphous mass of material under NOTES.  Structure
it with some subheadings, and do a little reorganizing.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-17 08:46:40 +01:00
Michael Kerrisk 92692952b1 Removed trailing white space at end of lines 2014-02-26 18:29:50 +01:00
Michael Kerrisk cadd38ba1b access.2, chmod.2, chown.2, link.2, mkdir.2, open.2, readlink.2, rename.2, stat.2, symlink.2, unlink.2, mkfifo.3, scandir.3: Minor fix: remove section numbers in references to functions inside page
With the page merges, we now have some references to functions
within the page that have section numbers. Remove those.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:52:53 +01:00
Michael Kerrisk 2d829cd2bd open.2: Remove sentence that openat() is present on Solaris
That point was only really relevant before openat() was
standardized in POSIX.1.2008.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 10:34:00 +01:00
Michael Kerrisk 7b8ba76c2f open.2: Merge text from openat(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 10:33:47 +01:00
Michael Kerrisk 90823c7091 open.2: Make NAME text a little more generic
(No need to say "file *or device*")

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 07:11:26 +01:00
Michael Kerrisk 0d55b37f8c open.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 22:01:28 +01:00
Michael Kerrisk 84fc2a6e35 Removed trailing white space at end of lines 2014-01-24 12:06:21 +01:00
Michael Kerrisk 8b04592d3a open.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-24 11:44:57 +01:00
Michael Kerrisk 0d730fcc90 open.2: BUGS: Verifying O_TMPFILE support requires checking for *two* errors
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-24 11:44:57 +01:00
Michael Kerrisk fd185f5819 open.2: srcfix: Update copyright to add mtk
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-24 11:44:57 +01:00
Michael Kerrisk 0115aaedca open.2: Add text on meaning of O_EXCL + O_TMPFILE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-24 11:44:57 +01:00
Michael Kerrisk e1252130e0 open.2: Adjust O_TMPFILE code sample
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-24 11:44:57 +01:00
Michael Kerrisk 4d61d36a8e open.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-24 11:44:57 +01:00
Michael Kerrisk 0fb83d0052 open.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-24 11:44:57 +01:00
Michael Kerrisk f869dc0479 open.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-24 11:44:56 +01:00
Michael Kerrisk 566b427d82 open.2: Minor reworking of text referring to fcntl(2) and file status flags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-24 11:44:56 +01:00
Michael Kerrisk fb0840efdd open.2: Remove crufty duplicate text on modifying file status flags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-24 11:44:56 +01:00