Commit Graph

230 Commits

Author SHA1 Message Date
Michael Kerrisk 6f3c74a8b9 mremap.2, open.2, perf_event_open.2, prctl.2, ptrace.2, reboot.2, seccomp.2, signalfd.2, syscalls.2, __ppc_set_ppr_med.3, daemon.3, dirfd.3, fgetgrent.3, fgetpwent.3, getauxval.3, getspnam.3, mallinfo.3, mallopt.3, posix_fallocate.3, termios.3, tty_ioctl.4, core.5, nsswitch.conf.5, proc.5, aio.7, capabilities.7, path_resolution.7, pipe.7, rtld-audit.7, signal.7, tcp.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-05 10:46:28 +01:00
Michael Kerrisk 15fb5d0374 open.2: Remove accidental mention of O_TTY_INIT
An earlier edit mentioned O_TTY_INIT as a file creation flag.
That's true, according POSIX, but Linux does not implement
this flag, so remove mention of it.

Reported-by: David Drysdale <drysdale@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-14 18:04:52 +02:00
Michael Kerrisk c84d3aa375 open.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk 9f629381c9 open.2, read.2, write.2: Clarify that O_NONBLOCK is a no-op for regular files and block devices
Reported-by: Mike Hayward <hayward@loup.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-11 12:03:43 +02:00
Michael Kerrisk 403b78f89e open.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-11 11:30:00 +02:00
Michael Kerrisk 67d2c6873c add_key.2, chown.2, epoll_ctl.2, epoll_wait.2, execve.2, fcntl.2, get_mempolicy.2, getxattr.2, ioctl.2, keyctl.2, listxattr.2, mkdir.2, mknod.2, mmap.2, msync.2, nfsservctl.2, open.2, prctl.2, removexattr.2, request_key.2, sendfile.2, set_mempolicy.2, setxattr.2, shmget.2, shutdown.2, sigaction.2, syslog.2, truncate.2, umask.2, CPU_SET.3, atexit.3, bsearch.3, cmsg.3, err.3, gethostid.3, getmntent.3, getopt.3, iconv_close.3, inet_ntop.3, longjmp.3, lsearch.3, mcheck.3, on_exit.3, putpwent.3, regex.3, resolver.3, setbuf.3, setjmp.3, setlocale.3, setlogmask.3, sleep.3, strsignal.3, sysconf.3, undocumented.3, tty_ioctl.4, proc.5, resolv.conf.5, tzfile.5, aio.7, bootparam.7, capabilities.7, fanotify.7, inotify.7, ip.7, packet.7, pthreads.7, raw.7, signal.7, socket.7, unix.7, ld.so.8, nscd.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-07 08:26:32 +02:00
Michael Kerrisk 320f8a8ec9 open.2: BUGS: O_CREAT | O_DIRECTORY succeeds if pathname does not exist
See http://www.openwall.com/lists/oss-security/2014/11/26/10
and http://thread.gmane.org/gmane.linux.file-systems/90997
    Subject: O_CREAT|O_DIRECTORY on nonexisting file with ext4
             not posix-compliant
    Newsgroups: gmane.linux.file-systems
    Date: 2014-12-15 17:39:09 GMT
and https://lkml.org/lkml/2005/9/23/80
    Subject: [PATCH] open: O_DIRECTORY and O_CREAT together should fail
    From:    Miklos Szeredi <>
    Date:    Fri, 23 Sep 2005 16:45:04 +0200

Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-06 18:31:49 +02:00
Michael Kerrisk 97d5b76276 open.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-06 17:57:32 +02:00
Michael Kerrisk 3a9c5a29b6 open.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 15:42:40 +02:00
Michael Kerrisk 9e1d8950a2 open.2: open() honors the S_ISVTX, S_ISUID, and S_ISGID bits in 'mode'
Reported-by: Andreas Gruenbacher <agruenba@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:37:15 +02:00
Michael Kerrisk 58222012f8 open.2: Tighten wording: use 'mode bit' rather than 'permission bit'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:37:09 +02:00
Michael Kerrisk a57c98a000 mkdir.2, mknod.2, open.2, umask.2: Tweaks to Andreas's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:37:09 +02:00
Andreas Gruenbacher 5d817eb475 umask.2, open.2, mknod.2, mkdir.2: Explain what default ACLs do
Explain the effect that default ACLs have (instead of the umask)
in umask.2.  Mention that default ACLs can have an affect in
open.2, mknod.2, and mkdir.2.

Signed-off-by: Andreas Gruenbacher <agruenba@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:37:09 +02:00
Michael Kerrisk 1e64c86bbf intro.1, ldd.1, clone.2, getgroups.2, getpid.2, getsockopt.2, ioctl_list.2, msgop.2, open.2, seccomp.2, setgid.2, setresuid.2, setreuid.2, setuid.2, sigaction.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, syscall.2, syscalls.2, umount.2, clock.3, dlopen.3, fmemopen.3, fpathconf.3, fputwc.3, fputws.3, fseek.3, fseeko.3, gcvt.3, getline.3, getwchar.3, hypot.3, if_nameindex.3, initgroups.3, popen.3, resolver.3, strcoll.3, strdup.3, tzset.3, ulimit.3, wcstombs.3, wctob.3, xdr.3, console_codes.4, random.4, filesystems.5, host.conf.5, hosts.5, proc.5, resolv.conf.5, securetty.5, credentials.7, feature_test_macros.7, hier.7, ipv6.7, packet.7, pthreads.7, raw.7, signal.7, tcp.7, user_namespaces.7, ld.so.8, ldconfig.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-29 22:30:09 +02:00
Michael Kerrisk 1bdc161dbb open.2: Mention blocking semantics for FIFO opens
See https://bugzilla.kernel.org/show_bug.cgi?id=95191

Reported-by: Jason Vas Dias <jason.vas.dias@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 19:25:22 +01:00
Michael Kerrisk f37759b1a0 open.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 08:24:07 +01:00
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