Commit Graph

5083 Commits

Author SHA1 Message Date
Michael Kerrisk 44b1f5a0c2 stat.2: Minor fixes
Reported-by: Andreas Grünbacher <andreas.gruenbacher@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 16:50:34 +02:00
Michael Kerrisk bba094e3f9 stat.2: Remove excessive leading zeros on some constants
Reported-by: Andreas Grünbacher <andreas.gruenbacher@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 16:35:23 +02:00
Michael Kerrisk addfd6c39c stat.2: Wording tweaks to Jann Horn's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 15:56:15 +02:00
Michael Kerrisk 5ec64a3abd mkdir.2: Further tweaks to text on S_ISVTX and 'mode' argument
Reported-by: Andreas Grünbacher <andreas.gruenbacher@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 15:50:05 +02:00
Michael Kerrisk 1dab8564e2 stat.2: Add text on POSIX terms "file mode bits" and "file permission bits"
Recent changes to various pages employ this distinction.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 15:42:40 +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 7e64d33c18 shutdown.2: BUGS: UNIX domain sockets now detect invalid 'how' values
Bug fixed in Linux 3.7.
See https://bugzilla.kernel.org/show_bug.cgi?id=47111

Reported-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 15:42:31 +02:00
Michael Kerrisk 64639e9aa6 stat.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:44:20 +02:00
Jann Horn f240296dee stat.2: Add note about stat() being racy
The same thing was fixed for execve() in kernel commit
8b01fc86b9f425899f8a3a8fc1c47d73c2c20543, but for performance
reasons, that simple patch won't work for stat().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:40:39 +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 10ef5a5549 mkdir.2: Fix a small error added by Andreas's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:37:15 +02:00
Michael Kerrisk 2fc8395c2b mkdir.2: Wording fixes + point reader at stat(2) for explanation of file mode
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:37:09 +02:00
Michael Kerrisk 9fcca5a033 mknod.2: Rewordings + point reader at stat(2) for details of mode bits
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:37:09 +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 ed948c28b3 chown.2, execve.2, prctl.2, truncate.2, proc.5, capabilities.7, ld.so.8: Tighter wording: 'mode bit' rather than 'permission bit'
For sticky, set-UID, and set-GID mode bits (as used in POSIX).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:36:59 +02:00
Michael Kerrisk 7901c9c3cd stat.2: Tighten wording: use 'mode bit' rather than 'permission bit'
According to POSIX, the the 9 UGO*RWX bits are permissions, and
'mode' is used to refer to collectively to those bits plus sticky,
set-UID, and set_GID bits.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:27:41 +02:00
Andreas Gruenbacher b0c5363f3e stat.2: Improve description of some mode constants
Signed-off-by: Andreas Gruenbacher <agruenba@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:27:29 +02:00
Michael Kerrisk cd358be37a Removed trailing white space at end of lines 2015-04-19 11:21:53 +02:00
Michael Kerrisk c73595c249 getent.1, fallocate.2, getrlimit.2, llseek.2, madvise.2, mount.2, poll.2, posix_fadvise.2, pread.2, stat.2, symlink.2, timer_create.2, timerfd_create.2, unshare.2, acos.3, acosh.3, asin.3, asinh.3, asprintf.3, atan.3, atan2.3, atanh.3, cabs.3, cacos.3, cacosh.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cexp.3, cimag.3, clog.3, conj.3, copysign.3, cos.3, cosh.3, cpow.3, cproj.3, creal.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctime.3, erf.3, erfc.3, exec.3, exp.3, exp2.3, expm1.3, fabs.3, fdim.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, frexp.3, ftw.3, get_nprocs_conf.3, getcwd.3, gethostbyname.3, getnetent.3, getutent.3, glob.3, ilogb.3, insque.3, j0.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, lrint.3, lround.3, lseek64.3, malloc.3, mbsnrtowcs.3, mbsrtowcs.3, modf.3, mq_notify.3, mq_open.3, nan.3, nextafter.3, openpty.3, perror.3, posix_memalign.3, pow.3, printf.3, qsort.3, realpath.3, remainder.3, remquo.3, rint.3, round.3, scalbln.3, scandir.3, scanf.3, setnetgrent.3, significand.3, sin.3, sinh.3, sqrt.3, strcasecmp.3, tan.3, tanh.3, tgamma.3, trunc.3, unlocked_stdio.3, updwtmp.3, wcrtomb.3, wcsnrtombs.3, wcsrtombs.3, wordexp.3, wprintf.3, y0.3, epoll.7, icmp.7, nptl.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 11:20:58 +02:00
Michael Kerrisk 04855535d3 posix_fadvise.2: Remove obsolete FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 09:56:28 +02:00
Michael Kerrisk 915b52efa4 madvise.2: SEE ALSO: add posix_madvise(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 09:56:28 +02:00
Michael Kerrisk cdd14e51bf mount.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 09:51:49 +02:00
Michael Kerrisk 9b24956272 mount.2: Fix version number for MS_LAZYTIME
Reported-by: Darrick J. Wong <darrick.wong@oracle.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 09:51:49 +02:00
Michael Kerrisk 5eab76af77 mount.2: Tweak MS_LAZYTIME text
Reported-by: Omar Sandoval <osandov@osandov.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 09:43:01 +02:00
Michael Kerrisk 9cdabfa62a mount.2: Enhancements to MS_LAZYTIME description
Cowritten-by: Theodore Ts'o <tytso@mit.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 09:43:01 +02:00
Michael Kerrisk 42a8e396cf mount.2: Document MS_LAZYTIME
Based on Ted T'so's commit message 0ae45f63d4e

Reviewed-by: Eric Sandeen <sandeen@redhat.com>
Reviewed-by: Andreas Dilger <adilger@dilger.ca>
Cowritten-by: Theodore Ts'o <tytso@mit.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 09:43:01 +02:00
Michael Kerrisk 1a7e5113c6 seccomp.2: Note that seccomp_data is read-only
Reported-by: Pierre Chifflier <pollux@debian.org>
Reviewed-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 09:33:38 +02:00
Michael Kerrisk adf507a373 fallocate.2: Note that SMB3 added FALLOC_FL_ZERO_RANGE support in Linux 3.17
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 09:25:20 +02:00
Michael Kerrisk 4a401602a7 fallocate.2: Fix kernel version number for FALLOC_FL_ZERO_RANGE
FALLOC_FL_ZERO_RANGE as added in 3.15, not 3.14.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 08:16:40 +02:00
Nikos Mavrogiannopoulos 24e9c95d2d ioctl_list.2: SIOCADDRT accepts in6_rtmsg in INET6 protocol
Signed-off-by: Nikos Mavrogiannopoulos <nmav@gnutls.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 23:06:22 +02:00
Michael Kerrisk 144d1a361f sched_setaffinity.2: tfix
Reported-by: cdlscpmv <cdlscpmv@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 23:03:11 +02:00
Heinrich Schuchardt 9537fb3c51 ioctl_list.2: TFD_IOC_SET_TICKS
timerfd_create.2 mentions TFD_IOC_SET_TICKS. We should add it to
ioctl_list.2, too.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 20:39:15 +02:00
Michael Kerrisk 9755c034f7 poll.2: SEE ALSO: add epoll(7)
Reported-by: Andreas Baak <andreas.baak@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:39 +02:00
Michael Kerrisk 40f6b649da timerfd_create.2: Note kernel version for TFD_IOC_SET_TICKS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:39 +02:00
Michael Kerrisk 80d27367ab timerfd_create.2: Tweaks to Cyrill Gorcunov's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:39 +02:00
Cyrill Gorcunov 5a3eb9cd35 timerfd_create.2: Document TFD_IOC_SET_TICKS ioctl() operation
Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:39 +02:00
Michael Kerrisk 32b262a163 symlink.2: ERRORS: add linkpath=="" case for ENOENT
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 09:58:24 +02:00
Michael Kerrisk bc5e71f562 symlink.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 09:58:24 +02:00
Michael Kerrisk d01c52164e getdents.2: Update timestamp
Really just a marker to record the reporters of bugs
that stemmed from the fact that the page did not
document getdents64(). I'll fix things up in the changelog.

See https://bugzilla.kernel.org/show_bug.cgi?id=14795

Reported-by: Dima Tisnek <dimaqq@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 09:58:24 +02:00
Michael Kerrisk 31f7afcddf getdents.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 07:42:45 +02:00
Michael Kerrisk 51fe959a97 getdents.2: Document getdents64()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 07:42:45 +02:00
Michael Kerrisk 063fd85422 getdents.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 07:42:45 +02:00
Michael Kerrisk 77cbbd07eb getdents.2: wfix (off-by-one kernel version)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-12 07:42:45 +02:00
Michael Kerrisk 9497142004 stat.2: Add some details on various "stat" versions
Three versions of "stat" appeared on 32-bit systems,
dealing with structures of different (increasing) sizes.
Explain some of the details, and also note that the
situation is simpler on modern 64-bit architectures.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Michael Kerrisk a54afa1e7b llseek.2: llseek() exists on 32-bit platforms to support seeking to large offsets
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Michael Kerrisk 6cfd51e74c llseek.2: Advise reader to use lseek(2) instead
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
Michael Kerrisk d3c49afa7e syscalls.2: Add some details about the "multiple versions of system calls"
The multiple-system-call-version phenomenon is particular a
feature of older 32-bit platforms. Hint at that fact in the text.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:26 +02:00
Michael Kerrisk a39f2f4dc8 stat.2: Add a little more detail on history of three versions of *stat()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:26 +02:00