Commit Graph

214 Commits

Author SHA1 Message Date
Michael Kerrisk 8392a3b33f _exit.2, dup.2, execve.2, execveat.2, fallocate.2, fcntl.2, get_robust_list.2, getrlimit.2, mbind.2, memfd_create.2, mmap.2, open.2, ptrace.2, readv.2, select.2, sigaction.2, syscall.2, syscalls.2, truncate.2, utimensat.2, write.2, errno.3, exec.3, fclose.3, fexecve.3, fmemopen.3, fopencookie.3, getgrent_r.3, getline.3, getmntent.3, getpw.3, getpwent_r.3, getspnam.3, malloc_info.3, posix_fallocate.3, putgrent.3, shm_open.3, locale.5, proc.5: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-22 23:29:25 +01:00
Michael Kerrisk fbab10e5d6 fallocate.2, mmap.2, open.2, truncate.2, write.2: ERRORS: add EPERM for operation denied by file seal
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-19 10:35:33 +01:00
Michael Kerrisk c6a167837c open.2: Add execveat(2) in system call list under "Rationale for openat()"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-16 15:05:09 +01:00
Michael Kerrisk 12c21590c5 open.2: Refer to RLIMIT_NOFILE for explanation of EMFILE error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-13 10:26:41 +01:00
Michael Kerrisk 0649afd45a localedef.1, adjtimex.2, clock_nanosleep.2, epoll_ctl.2, ioctl.2, madvise.2, open.2, posix_fadvise.2, prctl.2, restart_syscall.2, sched_setaffinity.2, select.2, semop.2, setsid.2, sgetmask.2, sigaction.2, sigreturn.2, splice.2, syscall.2, syscalls.2, tee.2, tkill.2, abort.3, cmsg.3, exp10.3, ftw.3, getopt.3, ilogb.3, memcmp.3, mq_open.3, pow.3, pthread_setschedparam.3, sigvec.3, sysconf.3, termios.3, tgamma.3, wordexp.3, locale.5, proc.5, resolv.conf.5, cp1251.7, credentials.7, fanotify.7, inotify.7, locale.7, man-pages.7, signal.7, unix.7, ld.so.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-12-31 07:01:38 +01:00
Michael Kerrisk 54305f5b5f open.2: Enhance rationale discussion for openat() and friends
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-12-26 07:35:25 +01:00
Michael Kerrisk bc65e77236 ldd.1, execve.2, fanotify_init.2, fanotify_mark.2, getrlimit.2, open.2, readlink.2, sched_setattr.2, sched_setscheduler.2, shmget.2, syscalls.2, vmsplice.2, dlopen.3, fseeko.3, getgrent.3, mq_getattr.3, mq_open.3, realpath.3, armscii-8.7, ascii.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, koi8-r.7, koi8-u.7, sched.7, ld.so.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-02 23:47:51 +02:00
Michael Kerrisk 4e1a4d72f0 open.2: Fix number and formula in description of EOVERFLOW error
Reported-by: Shriramana Sharma <samjnaa@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-26 07:30:02 +02:00
Christian von Roques f36a14687b open.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-01 19:07:04 +02:00
Simon Paillard 31d7909822 open.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-15 20:23:35 +02:00
Michael Kerrisk a83923cafb open.2: wfix
Reported-by: Rahul Bedarkar <rahulbedarkar89@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-01 21:57:51 +02:00
Michael Kerrisk c77eace5b1 iconv.1, ldd.1, connect.2, dup.2, epoll_ctl.2, eventfd.2, fallocate.2, fcntl.2, getitimer.2, inotify_add_watch.2, open.2, pipe.2, poll.2, sendmmsg.2, set_tid_address.2, shmop.2, signalfd.2, splice.2, syscalls.2, syslog.2, tee.2, vmsplice.2, ether_aton.3, mallopt.3, printf.3, profil.3, charmap.5, proc.5, epoll.7, inotify.7, libc.7, pipe.7, sched.7, socket.7, udplite.7, iconvconfig.8, ld.so.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-08 16:14:48 +02:00
Michael Kerrisk 6807fc6f8a open.2: O_CLOEXEC is also one the flags not ignored when O_PATH is specified
Reported-by: Кирилл <kirillnow@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-18 12:12:56 +02:00
Simon Paillard a1fa36afd2 :eventfd.2, fallocate.2, open.2, sendmmsg.2, signalfd.2, proc.5, sched.7, socket.7, udplite.7: spfix: "behaviour": use American spelling "behavior" instead
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-17 07:27:20 +02:00
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