Commit Graph

3424 Commits

Author SHA1 Message Date
Doug Goldstein ef4901931a open.2: Add EINVAL to errors list
EINVAL can be returned by open(2) when the underlying filesystem
doesn't support O_DIRECT. It is documented in the NOTES section
but this patch adds it to the list of possible errors.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-02 07:49:45 +02:00
Zdenek Pavlas 7d082baba6 sigaction.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-02 07:40:27 +02:00
Simon Paillard 40f7562094 fstatat.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-22 09:06:31 +02:00
Johan Erlandsson aa60c0d2b2 syscall.2: Correct registers for arm/EABI
Registers was off by one.

Reference:
http://www.arm.linux.org.uk/developer/patches/viewpatch.php?id=3105/4

See also:
http://peterdn.com/post/e28098Hello-World!e28099-in-ARM-assembly.aspx
https://wiki.debian.org/ArmEabiPort
http://en.wikipedia.org/wiki/Calling_convention#ARM

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 10:13:22 +02:00
Robert Harris 2510e4e5a1 open.2: Add mmap(2) to list of calls that fail when given an O_PATH descriptor
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 09:49:22 +02:00
Johan Erlandsson 415f7e6317 syscall.2: Add missing argument in example
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 09:33:51 +02:00
Michael Kerrisk 6ace3248f2 setfsgid.2: Refer to setfsuid(2) for an explanation of why setfsgid() is obsolete
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 09:28:35 +02:00
Michael Kerrisk 4069bc44a6 setfsgid.2: Wording improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 09:28:35 +02:00
Michael Kerrisk 2ec26c2b30 setfsuid.2: Wording improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 09:28:35 +02:00
Michael Kerrisk 68f2e81eda setfsuid.2: Correct header file in SYNOPSIS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 09:28:35 +02:00
Michael Kerrisk 0070a62d0a setfsgid.2: Correct header file in SYNOPSIS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 09:28:35 +02:00
Michael Kerrisk 18cc659761 setfsuid.2: Clarify historical details and note that setfsuid() is obsolete
Reported-by: Chen Gang <gang.chen@asianux.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 09:27:07 +02:00
Michael Kerrisk 9e3859ed2b kill.2: Small improvements to text on historical rules for permissions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 08:41:53 +02:00
Michael Kerrisk ff4739ceab setfsgid.2: Clarify description of return value
More clearly describe the weirdness in the return value of this
system call, and ote the problems it creates in in BUGS

Reported-by: Oleg Nesterov <oleg@redhat.com>

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 15:44:17 +02:00
Michael Kerrisk 06e4308972 setfsuid.2: Clarify description of return value
More clearly describe the weirdness in the return value of this
system call, and ote the problems it creates in in BUGS

Reported-by: Oleg Nesterov <oleg@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 15:42:28 +02:00
Michael Kerrisk fd524ab98b sched_setparam.2: Clarify that this system call applies to threads (not processes)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 15:19:00 +02:00
Michael Kerrisk 81bd66daf4 sched_setscheduler.2: Clarify that this system call applies to threads (not processes)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 15:02:24 +02:00
Michael Kerrisk 6a7fcf3ccf sched_setaffinity.2: Clarify that these system calls affect a per-thread attribute
Reported-by: Christos Tsopokis <christos@tsopokis.gr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 15:02:21 +02:00
Michael Kerrisk 282c1a35d0 msgctl.2, semctl.2, shmctl.2, cciss.4: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 10:27:55 +02:00
Michael Kerrisk 9ee4a2b6ec intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 10:07:57 +02:00
Michael Kerrisk 3ad8d7a2b7 nfsservctl.2: Note commands that were only in Linux 2.4.x and earlier
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 09:49:03 +02:00
Michael Kerrisk d59eaecdeb nfsservctl.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 09:48:13 +02:00
Michael Kerrisk 58d0a2034a nfsservctl.2: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 09:45:41 +02:00
Michael Kerrisk 8699159874 nfsservctl.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 09:43:32 +02:00
Michael Kerrisk bd6416540a adjtimex.2: SEE ALSO: Add adjtimex(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-07 09:16:39 +02:00
Michael Kerrisk 95dadb392f fcntl.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-01 11:52:12 +02:00
Michael Kerrisk 8a94e783a9 Removed trailing white space at end of lines 2013-07-31 08:45:42 +02:00
Michael Kerrisk f80a7a348b readlinkat.2, setpgid.2, resolv.conf.5, udp.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-31 08:45:18 +02:00
Michael Kerrisk d806bc0518 clock_nanosleep.2, futex.2, nanosleep.2, poll.2, sigaction.2, sigreturn.2, signal.7: SEE ALSO: add restart_syscall(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-30 05:21:20 +02:00
Michael Kerrisk 92f30072c8 restart_syscall.2: New page for restart_syscall(2) system call
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-30 05:08:16 +02:00
Vince Weaver 98f3e7ccfa perf_event_open.2: Fix indentation of the MMAP layout section
The indentation of the MMAP layout section wasn't quite right.
I think this improves things but I admit I'm not an expert at the
low-level indentation directives.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-27 12:15:20 +02:00
David Prévot bc4fc8e0d5 perf_event_open.2: cfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-27 12:14:31 +02:00
David Prévot 460e3d7a3e perf_event_open.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-23 13:25:15 +02:00
Peter Schiffer 13a082cb40 open.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-22 12:44:48 +02:00
Michael Kerrisk ab5deaea0d fchownat.2, fstatat.2, linkat.2, capabilities.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-20 23:12:07 +02:00
Michael Kerrisk a3041a5894 open.2: Remove warning that O_DIRECTORY is only for use with opendir(3)
O_DIRECTORY can also be used with, for example, O_PATH.

Reorted-by: Geoffrey Thomas <gthomas@mokafive.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-20 23:11:03 +02:00
Michael Kerrisk 09f677a344 open.2: Note that fcntl(F_GETFL) can also be used on O_PATH descriptor
Reported-by: Al Viro <viro@ZenIV.linux.org.uk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-20 23:11:03 +02:00
Michael Kerrisk f22e7f8016 open.2: srcfix: remove FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-20 23:11:03 +02:00
Michael Kerrisk 1135dbe188 open.2: Document O_PATH
See also https://bugzilla.redhat.com/show_bug.cgi?id=885740

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-20 23:11:02 +02:00
Michael Kerrisk fd53da3318 fchownat.2: Document AT_EMPTY_PATH
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-20 23:11:02 +02:00
Michael Kerrisk 3fd3e05413 fstatat.2: Document AT_EMPTY_PATH
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-20 23:11:02 +02:00
Michael Kerrisk 5ad04066f7 linkat.2: Document AT_EMPTY_PATH
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-20 23:11:02 +02:00
Michael Kerrisk 80b0c433c5 readlinkat.2: Document use of empty 'pathname' argument
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-20 23:11:02 +02:00
Andrey Vagin ff01b23214 ptrace.2: Place GETSIGINFO and SETSIGINFO near each other
Signed-off-by: Andrey Vagin <avagin@openvz.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-18 03:13:13 +02:00
Chuck Coffing c1de8e3e30 Fix possible race condition in readlink.2 example
I noticed that the example in the readlink.2 man pages does error
checking for a race condition that would cause the value of the
symbolic link to get larger.  However, it doesn't handle the
opposite case, in which the value gets shorter.  (The NULL
terminator is always set at the old, longer offset.)  This could
cause the program to operate on uninitialized data.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-18 02:11:35 +02:00
Michael Kerrisk 4b80b37c54 readlink.2: Change error check in example program from "< 0" to "== -1"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-18 02:11:35 +02:00
Vince Weaver e30dc77f5c perf_event_open.2: Improve sysfs files documentation
This improves the documentation of the various
perf_event_open()-related sysfs files.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-18 02:11:35 +02:00
Vince Weaver dbc01ecdff perf_event_open.2: Update PERF_IOC_FLAG_GROUP info
It turns out PERF_IOC_FLAG_GROUP was broken from 75f937f24bd9
(in Linux 2.6.31, the initial perf_event release) until
724b6daa1 (Linux 3.4).

I've done some extensive kernel source code digging plus
running tests of various kernels and I hope the info
presented is accurate now.

(Patch edited somewhat by mtk.)

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-18 02:11:35 +02:00
Denys Vlasenko 29f9b8fb31 ptrace.2: If SEIZE was used, initial auto-attach stop is EVENT_STOP
For every PTRACE_O_TRACEfoo option, mention that old-style SIGSTOP
is replaced by PTRACE_EVENT_STOP if PTRACE_SEIZE attach was used.

Mention the same thing again in the description of
PTRACE_EVENT_STOP.

Acked-by: Oleg Nesterov <oleg@redhat.com>
Acked-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Denys Vlasenko <dvlasenk@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-18 02:11:34 +02:00
Michael Kerrisk ad84c54302 ptrace.2: Minor fixes to patches from Denys Vlasenko
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-07-18 02:11:34 +02:00