3780f8a5e5
prctl.2: Some wording improvements in timer slack description
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-09 22:12:34 +02:00
8b41eea4fc
prctl.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-09 22:12:34 +02:00
1a8e1c2fae
prctl.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-09 22:12:34 +02:00
164a3a92c9
kcmp.2: Minor fix-ups
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-09 22:11:53 +02:00
5c1932ae50
kcmp.2: Minor tweaks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-09 22:11:53 +02:00
8ec68b89b4
kcmp.2: Note about SECURITY_YAMA
2016-06-09 22:11:53 +02:00
8c93a5df95
ioctl_ficlonerange.2, ioctl_fideduperange.2: srcfix: fix licensing
...
These are licensed under GPLv2, not VERBATIM.
Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
2016-06-09 22:11:47 +02:00
8592ec74bd
ioctl_ficlonerange.2, ioctl_fideduperange.2: Mention same-filesystem requirement
...
Mention that FICLONE, FICLONERANGE, and FIDEDUPERANGE all require
both files to reside on the same filesystem.
Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
2016-06-09 10:08:18 +02:00
5711c5f7aa
ioctl_fideduperange.2: Add VERSIONS section
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-08 12:35:00 +02:00
2db75216ad
ioctl_fideduperange.2: Minor tweaks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-08 12:35:00 +02:00
990a64f7e3
ioctl_fideduperange.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-08 12:35:00 +02:00
2998d8b804
man2: New page documenting the FIDEDUPERANGE ioctl
...
Document the FIDEDUPERANGE ioctl, formerly known as
BTRFS_IOC_EXTENT_SAME.
Reviewed-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
2016-06-08 12:34:55 +02:00
c4f9c619fe
ioctl_ficlonerange.2: Add VERSIONS section
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-08 12:34:54 +02:00
603fc95a2b
ioctl_ficlonerange.2: Minor tweaks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-08 12:34:54 +02:00
1d691addc2
ioctl_ficlonerange.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-08 12:34:54 +02:00
9eb18e174c
man2: New page documenting FICLONE and FICLONERANGE ioctls
...
Document the FICLONE and FICLONERANGE ioctls, formerly known as
the BTRFS_IOC_CLONE and BTRFS_IOC_CLONE_RANGE ioctls.
Reviewed-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
2016-06-08 12:34:45 +02:00
7f891e5db7
add_key.2: Empty payloads are not allowed in user-defined keys
...
iBoth add_key and the utility "keyctl add" return EINVAL when
attempting to add a user key with an empty or NULL payload.
The manpage implies that this should be valid.
From my reading of the kernel source, this has not been possible
since at least linux kernel commit 1da177e4 (2.6.12-rc2 on
2005-04-16).
Until kernel commit cf7f601c,
security/keys/user_defined.c:user_instantiate returned -EINVAL
if datalen <= 0. That commit only moved this behavior to a new
user_preparse function, where it remains today in b562e44f
(4.5.0 on 2016-03-13).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-08 11:56:58 +02:00
d1f84ed72a
clone.2, confstr.3, hpsa.4, tcp.7: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
2016-06-08 11:24:08 +02:00
9c2678e629
mount.2: MS_LAZYTIME and MS_RELATIME can be changed on remount
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-05 13:00:57 -05:00
d8b67bc9b2
mount.2: Explicitly note that MS_DIRSYNC setting cannot be changed on remount
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-05 13:00:57 -05:00
014b17c608
mount.2: Remove version numbers attached to flags that are modifiable on remount
...
This information was simply bogus. Mea culpa.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-05 06:21:02 -05:00
9e1ae4f847
mount.2: Minor restructuring/rewording in ERRORS
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 10:47:11 -05:00
eac1e05005
mount.2: Document the MS_REC flag
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 10:42:31 -05:00
c8e5f55869
mount.2: Document flags used to set propagation type
...
Document MS_SHARED, MS_PRIVATE, MS_SLAVE, and MS_UNBINDABLE.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 10:42:31 -05:00
4a19136b83
mount.2: Note kernel version that added MS_MOVE
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 10:42:31 -05:00
74b46b5f77
mount.2: Minor tweaks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 10:42:31 -05:00
f429fadc96
mount.2: Restructure discussion of 'mountflags' into functional groups
...
The existing text makes no differentiation between different
"classes" of mount flags. However, certain flags such as
MS_REMOUNT, MS_BIND, MS_MOVE, etc. determine the general
type of operation that mount() performs. Furthermore, the
choice of which class of operation to perform is performed in
a certain order, and that order is significant if multiple
flags are specified. Restructure and extend the text to
reflect these details.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 10:41:50 -05:00
f54e02b4bf
mount.2: Relocate text on multimounting and mount stacking to NOTES
...
The text was somewhat out of place in its previous location;
NOTES is a better location.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 07:28:06 -05:00
b3ae9c7d6f
mount.2: Move text describing 'data' argument higher up in page
...
In preparation for other reworking.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 07:25:56 -05:00
9792cd169c
mount.2: Update example list of filesystem types
...
Put more modern examples in; remove many older examples.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 07:20:56 -05:00
52f00c053c
mount.2: Relocate/demote/rework text on MS_MGC_VAL
...
The use of this constant has not been needed for 15 years now.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 07:20:56 -05:00
49f6854626
mount.2: Note the default treatment of ATIME flags during MS_REMOUNT
...
The behavior changed in Linux 3.17.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 06:57:44 -05:00
f5da58a8f2
mount.2: Since Linux 2.6.26, bind mounts can be made read-only
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-03 11:12:31 -05:00
16008a4146
mount.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-03 11:05:44 -05:00
4014230990
mmap.2: EXAMPLE: for completeness, add munmap() and close() calls
...
Reported-by: Rahul Bedarkar <rahulbedarkar89@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-03 06:53:41 -05:00
69a7267960
get_mempolicy.2: Correct rounding to 'maxnodes' (bits, not bytes)
...
Reported-by: Jörn Engel <joern@purestorage.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-02 21:32:22 -05:00
f9e2bea7ca
get_mempolicy.2: Fix prototype for get_mempolicy()
...
In numaif.h, 'add' is typed as 'void *'
Reported-by: Jörn Engel <joern@purestorage.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-02 21:18:16 -05:00
1f7191bb03
open.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-02 20:08:38 -05:00
27f5380d5c
quotactl.2: 'dqb_curspace' is in bytes, not blocks
...
This error appears to have been injected into glibc
when copying some headers from BSD.
See https://bugs.debian.org/825548
Reported-by: Jacob Willoughby <jacob@spacemonkey.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-01 14:37:34 -05:00
cd32ec849d
wait.2: Since Linux 4.7, __WALL is implied if child being ptraced
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-29 06:42:48 -05:00
ff82608eb6
wait.2: waitid() now (since Linux 4.7) also supports __WNOTHREAD/__WCLONE/__WALL
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-29 06:42:48 -05:00
36c8e72131
recv.2: With pending 0-length datagram read() and recv() with flags == 0 differ
...
Quoting Tom:
The statement "With a zero flags argument, recv() is equivalent to
read(2)." is not correct. In the case of passing a UDP socket an
empty buffer the two calls differ. read(2) will be a noop (as it
rightly says in its manpage), but recv(2) will discard the
packet.
We ran into this in networkd, as we use FIONREAD to determine the
buffer size (and allocate the right buffer), so in case someone
passed us an empty packet we would end up in a busy loop when we
were using read(2). Changing to recv(2) fixed the issue
[https://github.com/systemd/systemd/pull/3299 ].
Reported-by: Tom Gundersen <teg@jklm.no>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-29 06:42:48 -05:00
c3cfbeb992
recv.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-29 06:42:48 -05:00
c89a9937ca
open.2: Refer to correct functions in description of O_TMPFILE
...
Signed-off-by: Eric Biggers <ebiggers3@gmail.com>
2016-05-26 16:17:17 -05:00
42f194cf22
fnctl.2: tfix - remove duplicate paragraph in NOTES
...
This paragraph already appears above, right before the "File Locking"
one.
Signed-off-by: Iustin Pop <iustin@k1024.org>
2016-05-26 16:16:29 -05:00
0c00a52e49
umask.2: NOTES: Mention /proc/PID/status 'Umask' field
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-26 16:14:26 -05:00
5d92f6e91a
mount.2: Clarify that MS_MOVE ignores remaining bits in 'mountflags'
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-21 11:36:33 -05:00
59dea18e1d
mount.2: Minor clarification to MS_BIND
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-21 11:35:55 -05:00
373c8b2536
mount.2: MS_BIND still ignores mountflags
...
This is clear from the do_mount() function in the kernel as of v4.6.
Signed-off-by: Omar Sandoval <osandov@fb.com>
2016-05-21 11:28:35 -05:00
751de899b5
mount.2: Clarify that 'source' and 'target' are pathnames, and can refer to files
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-19 13:13:54 +02:00
9aae8d48a7
memfd_create.2: tfix
...
This is patch for current master. Fixes small typo.
From 94292ebe260a64920c63fe64075e0fa636a126cb Mon Sep 17 00:00:00 2001
From: Marko Kevac <marko@kevac.org>
Date: Sun, 15 May 2016 23:56:34 +0300
Subject: [PATCH] memfd_create.2: tfix
2016-05-18 13:14:06 +02:00
2641953087
pwritev2.2: New link to readv(2)
...
This link should have been added in the previous release...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-16 22:20:14 +02:00
62bd1ef2e8
preadv2.2: New link to readv(2)
...
This link should have been added in the previous release...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-16 22:18:33 +02:00
f516d6d979
fork.2: Add ENOMEM error for PID namespace where "init" has died
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-13 09:47:41 +02:00
4be9e801da
mount.2: MS_NOSUID also disables file capabilities
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-10 20:01:10 +01:00
9f496381ef
clock_getres.2, getrlimit.2, ioctl_fat.2, ioprio_set.2, quotactl.2, core.5, cpuset.7, vdso.7, ld.so.8: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:37:59 +02:00
b9fe4bc3d7
clone.2: Minor fix (page xref)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:54 +02:00
46dd317603
setns.2: Document CLONE_NEWCGROUP
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:54 +02:00
216131bdf5
unshare.2: Document CLONE_NEWCGROUP
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:54 +02:00
c5af067406
clone.2: Document CLONE_NEWCGROUP
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:54 +02:00
6881dc4717
unshare.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:54 +02:00
99851d8b2e
getrlimit.2: SEE ALSO: add cgroups(7)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:53 +02:00
ae2ff8f944
ioprio_set.2: SEE ALSO: add cgroups(7)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:53 +02:00
c550a89728
clone.2: ERRORS: add EINVAL for improperly aligned 'child_stack' value
...
As noted by Colin King:
Currently, the aarch64 clone() system call requires the stack
to be aligned at a 16 byte boundary, see
arch/arm64/kernel/process.c, copy_thread():
if (stack_start) {
if (is_compat_thread(task_thread_info(p)))
childregs->compat_sp = stack_start;
/* 16-byte aligned stack mandatory on AArch64 */
else if (stack_start & 15)
return -EINVAL;
else
childregs->sp = stack_start;
}
..and returns -EINVAL if not aligned correctly. This should
be added to the manual page clone(2) as it took me a while to
figure out why clone() was failing with -EINVAL for aarch64
but not on x86.
Reported-by: Colin Ian King <colin.king@canonical.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:06:27 +02:00
b31056e386
open.2: tfix
2016-05-09 22:32:35 +02:00
11a6d0506c
clone.2, fork.2: srcfix: Add commit ID for ERESTARTNOINTR error
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 22:31:01 +02:00
10e46057dd
clone.2, fork.2: Document ERESTARTNOINTR error code
...
Since Linux 2.6.17, clone and fork syscalls return ERESTARTNOINTR
when interrupted by a signal before newly created process is added
to its process group.
This error code can only be seen by ptrace at syscall exit tracing.
The information was obtained from kernel source code:
http://bit.ly/24xdofn
Signed-off-by: Nikola Forró <nforro@redhat.com>
2016-05-09 22:30:34 +02:00
29ff7699b7
ioctl_fat.2: Use %04x to print volume ID
...
Leading zeroes should be used when display a FAT volume ID.
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
2016-05-09 22:25:41 +02:00
d673870eba
execve.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-08 17:41:26 +02:00
7be43378e6
fcntl.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-03 21:27:01 +02:00
ba65cc12a8
memfd_create.2: Note that memfd_create() does not have a glibc wrapper
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-03 13:09:23 +02:00
e57f8d34e4
memfd_create.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-03 12:45:16 +02:00
03117dc0db
fsync.2: Give some examples of files where sync can fail with EINVAL
...
Reported-by: Georg Sauthoff <gsauthof@techfak.uni-bielefeld.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-21 14:28:53 +02:00
2a79c2ac32
execve.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-21 11:22:14 +02:00
246104f0bc
execve.2: Since Linux 2.6.28, recursive script interpretation is supported
...
Reported-by: Valery Reznic <valery_reznic@yahoo.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-21 11:22:08 +02:00
c74bc51914
clock_getres.2: Note that coarse clock need architecture and VDSO support
...
Reported-by: Rasmus Villemoes <linux@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-18 16:23:51 +01:00
bfd08d7770
readv.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-18 14:57:34 +01:00
840dfaf0de
readv.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-18 14:57:34 +01:00
3b31ec64ab
readv.2: Tweaks to Christoph's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-18 14:57:33 +01:00
d948a87054
readv.2: Document preadv2() and pwritev2()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-18 14:40:18 +01:00
e1124af0ba
fcntl.2: Note that mandatory locking is now governed by a configuration option
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-18 13:31:17 +01:00
afa0b44d06
mount.2: MS_MANDLOCK requires CAP_SYS_ADMIN (since Linux 4.5)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-18 13:16:39 +01:00
51015f1409
write.2: Clarify that 'size_t' and 'ssize_t' are integer types specified in POSIX
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-14 20:18:14 +01:00
aead9ac9bf
read.2: Clarify that 'size_t' and 'ssize_t' are integer types specified in POSIX
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-14 20:18:14 +01:00
b4b1c3e7d0
lseek.2: Note that 'off_t' is an integer data type defined by POSIX
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-14 20:18:14 +01:00
9f6007b8bc
sigaction.2: Document SEGV_PKUERR
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-28 19:05:16 +13:00
0c962aab5f
sigaction.2: Document SEGV_BNDERR
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-28 17:54:33 +13:00
fec74bb1aa
ptrace.2: srcfix: add info about PTRACE_SEIZE
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-28 17:38:04 +13:00
a73a078154
sigaction.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-28 17:29:59 +13:00
8d03f12cd4
quotactl.2: Document Q_GETNEXTQUOTA and Q_XGETNEXTQUOTA
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-28 10:15:22 +13:00
3b17710415
quotactl.2: Rework/reorder ERRORS list
...
Make into a single alphabetically ordered list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-28 09:35:43 +13:00
4c8a2e1d4c
quotactl.2: Add kernel version for G_GETINFO, Q_SETINFO, and Q_GETFMT
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-28 09:13:26 +13:00
3cf5ae17a1
quotactl.2: Note kernel version that removed Q_GETSTATS
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-28 08:34:07 +13:00
28520ed405
syscalls.2: Add preadv2() and pwritev2()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-28 08:01:09 +13:00
efcc21c9fa
semctl.2: From kernel 4.6, Linux now updates 'sempid' on SETALL operations
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-26 07:18:07 +13:00
2c767761a2
Removed trailing white space at end of lines
2016-03-15 17:30:43 +13:00
979867082b
locale.1, localedef.1, _exit.2, accept.2, access.2, acct.2, adjtimex.2, bdflush.2, bind.2, bpf.2, brk.2, chdir.2, chmod.2, chown.2, chroot.2, clock_nanosleep.2, clone.2, close.2, connect.2, copy_file_range.2, create_module.2, delete_module.2, dup.2, epoll_ctl.2, eventfd.2, execve.2, fallocate.2, fanotify_init.2, fcntl.2, flock.2, fork.2, fsync.2, futex.2, get_kernel_syms.2, getdomainname.2, getgroups.2, gethostname.2, getpagesize.2, getpeername.2, getsid.2, getsockname.2, getsockopt.2, gettimeofday.2, init_module.2, ioctl.2, ioctl_list.2, ioperm.2, iopl.2, kexec_load.2, kill.2, killpg.2, link.2, listen.2, llseek.2, lseek.2, madvise.2, memfd_create.2, mincore.2, mkdir.2, mknod.2, mmap.2, mount.2, nanosleep.2, nice.2, open.2, personality.2, pipe.2, poll.2, posix_fadvise.2, read.2, readahead.2, readlink.2, readv.2, recv.2, recvmmsg.2, rename.2, request_key.2, sched_setaffinity.2, sched_setattr.2, select.2, select_tut.2, semctl.2, semop.2, send.2, sendfile.2, sendmmsg.2, seteuid.2, setns.2, setpgid.2, setreuid.2, shutdown.2, sigaction.2, sigaltstack.2, signal.2, signalfd.2, sigpending.2, sigprocmask.2, sigsuspend.2, socketpair.2, splice.2, stat.2, statfs.2, stime.2, symlink.2, sync.2, syscall.2, syscalls.2, times.2, truncate.2, unlink.2, unshare.2, uselib.2, utimensat.2, vfork.2, vhangup.2, wait.2, wait4.2, write.2, a64l.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, aio_read.3, aio_write.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, backtrace.3, cbrt.3, ceil.3, cfree.3, clearenv.3, clock_getcpuclockid.3, clog10.3, cmsg.3, copysign.3, cos.3, cosh.3, ctermid.3, ctime.3, daemon.3, dirfd.3, div.3, dl_iterate_phdr.3, drand48.3, drand48_r.3, dysize.3, ecvt.3, ecvt_r.3, endian.3, erf.3, erfc.3, errno.3, exec.3, exp.3, exp2.3, expm1.3, fabs.3, fdim.3, ferror.3, fexecve.3, ffs.3, fgetgrent.3, fgetpwent.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fopen.3, fpclassify.3, frexp.3, fseeko.3, fts.3, futimes.3, fwide.3, gamma.3, gcvt.3, getaddrinfo.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getline.3, getloadavg.3, getmntent.3, getnameinfo.3, getnetent_r.3, getpass.3, getprotoent_r.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent_r.3, getservent_r.3, getspnam.3, getsubopt.3, getusershell.3, getutent.3, getw.3, gsignal.3, hypot.3, ilogb.3, inet.3, initgroups.3, insque.3, isalpha.3, isgreater.3, iswblank.3, j0.3, ldexp.3, lgamma.3, lio_listio.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, lrint.3, lround.3, makedev.3, matherr.3, mbsnrtowcs.3, mkdtemp.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_receive.3, mq_send.3, nan.3, nextafter.3, on_exit.3, open_memstream.3, opendir.3, perror.3, popen.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, posix_openpt.3, posix_spawn.3, pow.3, printf.3, profil.3, psignal.3, pthread_attr_setstack.3, pthread_setaffinity_np.3, putenv.3, putpwent.3, qecvt.3, rand.3, random.3, random_r.3, rcmd.3, readdir.3, realpath.3, remainder.3, remquo.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, scalb.3, scalbln.3, scandir.3, scanf.3, seekdir.3, sem_wait.3, setbuf.3, setenv.3, setjmp.3, setnetgrent.3, siginterrupt.3, signbit.3, significand.3, sigset.3, sigsetops.3, sigvec.3, sigwait.3, sin.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stpcpy.3, stpncpy.3, strdup.3, strerror.3, strftime.3, strlen.3, strnlen.3, strsep.3, strsignal.3, strtod.3, strtok.3, strtol.3, strtoul.3, syslog.3, system.3, tan.3, tanh.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, trunc.3, ttyslot.3, tzset.3, ualarm.3, unlocked_stdio.3, usleep.3, wcpcpy.3, wcpncpy.3, wcscasecmp.3, wcsdup.3, wcsncasecmp.3, wcsnlen.3, wcsnrtombs.3, wprintf.3, y0.3, pts.4, st.4, tty_ioctl.4, elf.5, gai.conf.5, group.5, locale.5, nsswitch.conf.5, proc.5, utmp.5, aio.7, capabilities.7, credentials.7, environ.7, epoll.7, fanotify.7, feature_test_macros.7, inotify.7, ip.7, mq_overview.7, namespaces.7, pipe.7, signal.7, socket.7, standards.7, svipc.7, symlink.7, time.7, unicode.7, unix.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-15 17:30:43 +13:00
b6e7016e54
ioperm.2: Permissions are inherited across fork(2)
...
See https://bugzilla.kernel.org/show_bug.cgi?id=99911
Reported-by: Alex Henrie <alexhenrie24@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-15 16:41:24 +13:00
38931a4d3c
iopl.2: Permissions are not inherited across fork(2) or preserved on execve(2)
...
See https://bugzilla.kernel.org/show_bug.cgi?id=99901
Reported-by: Alex Henrie <alexhenrie24@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-15 16:41:24 +13:00
33fd2d00f1
lseek.2: NFS supports SEEK_HOLE and SEEK_DATA
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-15 13:39:50 +13:00
6660ed034a
lseek.2: FUSE now supports SEEK_HOLE and SEEK_DATA
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-15 13:39:50 +13:00
949ceae398
futex.2: FUTEX_CLOCK_REALTIME can now be used with FUTEX_WAIT
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-15 13:28:53 +13:00
9982c065da
epoll_ctl.2: Fix discussion of "ignored" EPOLLHUP and EPOLLERR with EPOLLEXCLUSIVE
...
Reported-by: Jason Baron <jbaron@akamai.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-15 06:48:20 +13:00
6a6d83b2c7
epoll_ctl.2: Document EPOLLEXCLUSIVE
...
Cowritten-by: Jason Baron <jbaron@akamai.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-15 06:48:20 +13:00
9c088226d6
statfs.2: Use consistent case for hex constants
...
Reported-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-14 08:41:46 +13:00
c69e13c2aa
statfs.2: spfix
...
The "Filesystem types" list had a random mixture of lower- and
uppercase hexadecimal digits. This patch makes them all uppercase.
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-14 08:33:35 +13:00
5fec8763c5
adjtimex.2: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-14 08:32:38 +13:00
cf1487b1da
open.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 17:36:20 +01:00
1893b64807
recv.2, cmsg.3: Note that cmsg_len is typed as socklen_t in POSIX.1
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 16:58:07 +01:00
8d8ee1cac3
recv.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 16:52:34 +01:00
8924f60387
recv.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 16:52:21 +01:00
aea45daeee
recv.2, cmsg.3: Fix type of cmsg_len member of cmsghdr structure
...
The type shown for cmsg_len member of cmsghdr structure is socklen_t,
but the actual type used by glibc and the kernel is size_t.
The information was obtained from glibc source code:
http://bit.ly/21m1RMp
Signed-off-by: Nikola Forró <nforro@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 16:51:07 +01:00
7255c7c0df
fcntl.2: Rework description of F_SETOWN
...
As suggested by Jason, make it clearer that I/O signalling
requires the use of both F_SETOWN and O_ASYNC. While we're at,
make a few other cleanups to the text.
Reported-by: Jason Vas Dias <jason.vas.dias@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 07:49:11 +01:00
813596e5f2
epoll_ctl.2: Document ELOOP error for circular monitoring loops
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 00:42:31 +01:00
cc7b36035b
splice.2: Improve description of 0 return value.
...
See https://bugzilla.kernel.org/show_bug.cgi?id=90911
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 00:32:15 +01:00
69fff55970
sendfile.2: Fix incorrect description in text referring to splice(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 00:32:15 +01:00
02959ce250
select.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 21:05:11 +01:00
4efcd5dd6a
sched_setaffinity.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 21:05:11 +01:00
310ac27840
sched_setaffinity.2: Warn that CPU_ALLOC() may allocate a slightly CPU set than requested
...
Reported-by: Florian Weimer <fweimer@redhat.com>
Reviewed-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 21:04:55 +01:00
b796767217
sched_setaffinity.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 16:02:39 +01:00
8cd11c4293
execve.2: Add EPERM error for capabilities check of capability-dumb binaries
...
Reported-by: Krzysztof Adamski <k@japko.eu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 01:30:38 +01:00
bf9c09382b
sched_setaffinity.2: Add reference to CPU_ALLOC(3)
...
Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 00:34:41 +01:00
9764a9ff2a
eventfd.2: Note that eventfd info is available in /proc/PID/fdinfo
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-08 19:24:48 +01:00
13dd2598aa
signalfd.2: Note that signalfd info is available in /proc/PID/fdinfo
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-08 19:24:47 +01:00
aaf7a57425
open.2: NOTES: mention existence of proc/PID/fd and /proc/PID/fdinfo
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-08 18:58:34 +01:00
8bbae7d03c
adjtimex.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 19:30:53 +01:00
ebfc893ec7
adjtimex.2: Add ATTRIBUTES section
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 11:15:18 +01:00
55b82822e8
adjtimex.2: srcfix: update copyright
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 11:15:10 +01:00
c40843ae0b
adjtimex.2: Minor wording tweaks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 02:21:28 +01:00
cf19a3b98c
adjtimex.2: SEE ALSO: add ntp_gettime(3)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 01:35:13 +01:00
4ed5a32d22
adjtimex.2: Minor wording and formatting fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 01:35:12 +01:00
e837b41c13
adjtimex.2: Improve description of some PPS timex fields
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 01:35:12 +01:00
b346e7a030
adjtimex.2: Document ntp_adjtime(3)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 01:10:23 +01:00
90d4198f2a
adjtimex.2: Don't refer reader to adjtime(3)
...
Probably, it's not wise to suggest adjtime(3) as the more
portable API. Rather, ntp_adjtime(3) should be used.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-06 22:51:42 +01:00
46c7501043
adjtimex.2: Minor wording fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-06 11:06:11 +01:00
de69c712ba
adjtimex.2: Minor tweaks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-06 06:21:53 +01:00
53ee58a32c
socketpair.2: Note treatment of 'sv' on error
...
Reported-by: Eric Blake <eblake@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-05 08:52:29 +01:00
89cfe0cf65
pipe.2: Note treatment of 'pipefd' on error
...
Reported-by: Eric Blake <eblake@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-05 08:52:29 +01:00
9414812651
adjtimex.2: Minor fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-04 17:25:09 +01:00
178635c4e4
adjtimex.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-04 17:25:09 +01:00
1a96e4f2ba
adjtimex.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-04 17:25:09 +01:00
2f01620267
adjtimex.2: Various improvements after feedback from John Stultz
...
Reported-by: John Stultz <john.stultz@linaro.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-04 17:25:09 +01:00
f4d9c97d6a
adjtimex.2: Note range constraints and clamping for ADJ_FREQUENCY
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-04 17:25:04 +01:00
88ec900f22
adjtimex.2: Note treatment of out-of-range buf.offset
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-04 14:32:46 +01:00
a2300b58d1
adjtimex.2: Update details of buf.offset EINVAL error
...
Reported-by: Naresh Kamboju <naresh.kernel@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-04 14:32:30 +01:00
77a47e474d
adjtimex.2: Split EINVAL error cases
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-04 14:07:12 +01:00
f3910b4712
adjtimex.2: Update a detail in adjtimex return value description
...
Starting with Linux 3.4, the time_state change is now asynchronous
and the call returns the time_state before it has been altered,
rather than after it was altered as the previous code did.
======================================================
Notes from Petr Gajdos
attached program behaves differently on 2.6 and 3.0 kernels:
*******************************************************
2.6.32.59-0.7-default
Insert LS
adjtimex() return code 1: insert leap second (TIME_INS)
Kernel leap second flag: STA_INS
Delete LS
adjtimex() return code 2: delete leap second (TIME_DEL)
Kernel leap second flag: STA_DEL
Insert LS again
adjtimex() return code 1: insert leap second (TIME_INS)
Kernel leap second flag: STA_INS
Delete LS again
adjtimex() return code 2: delete leap second (TIME_DEL)
Kernel leap second flag: STA_DEL
*******************************************************
3.0.101-0.35-default
sbsvt101:~/tmp # ./adjt
Insert LS
adjtimex() return code 0: clock synchronized (TIME_OK)
Kernel leap second flag: STA_INS
Delete LS
adjtimex() return code 1: insert leap second (TIME_INS)
Kernel leap second flag: STA_DEL
Insert LS again
adjtimex() return code 2: delete leap second (TIME_DEL)
Kernel leap second flag: STA_INS
Delete LS again
adjtimex() return code 1: insert leap second (TIME_INS)
Kernel leap second flag: STA_DEL
*******************************************************
The explanation provided by William Preston (in CC):
"""
in both cases you get the actual value of the global kernel variable
time_state.
The code changed between the two kernels in the way it handled this.
In 2.6.32.59 the adjtimex call starts a timer immediately with the
function ntp_start_leap_timer(), which sets the value of time_state
before returning to the user.
This means you will get the value TIME_INS / TIME_DEL back
immediately.
In 3.0.101, the timer has been removed and the value of time_state is
set when the microsecond field overflows. The function
second_overflow() handles this. This means the value of time_state
will not have been set when the syscall adjtimex returns, and so you
will almost certainly get the old state.
Incidentally if you remove the sleep() calls in the code for 3.0.101
you may instead see the state of TIME_OK when switching between
STA_INS / STA_DEL.
All this is completely normal and expected behaviour, since both
return the current state, however I agree it is not intuitive.
I would recommend calling adjtimex without a mode to get the actual
state of the system after waiting a second.
At the same time, William suggests the patch in the attachement.
Petr
=============== adjt.c ================
void adjtm(int);
int main()
{
printf("Insert LS\n");
adjtm(STA_INS);
sleep(2);
printf("\nDelete LS\n");
adjtm(STA_DEL);
sleep(2);
printf("\nInsert LS again\n");
adjtm(STA_INS);
sleep(2);
printf("\nDelete LS again\n");
adjtm(STA_DEL);
printf("\nRestoring initial state\n");
adjtm(0);
}
/*************************************/
/* Modify LS flag and print status */
/*************************************/
void adjtm(int ls)
{
struct timex tx;
int rc;
tx.modes = ADJ_STATUS;
tx.status = ls;
if ((rc = adjtimex(&tx)) == -1) {
perror("adjtimex()");
exit(1);
}
sleep(2);
tx.modes = 0;
rc = adjtimex(&tx);
printf("adjtimex() return code %d: ", rc);
switch (rc) {
case TIME_OK:
printf("clock synchronized (TIME_OK)\n");
break;
case TIME_INS:
printf("insert leap second (TIME_INS)\n");
break;
case TIME_DEL:
printf("delete leap second (TIME_DEL)\n");
break;
case TIME_OOP:
printf("leap second in progress (TIME_OOP)\n");
break;
case TIME_WAIT:
printf("leap second has occurred (TIME_WAIT)\n");
break;
case TIME_BAD:
printf("clock not synchronized (TIME_BAD)\n");
break;
default:
printf("Unknown return code: %i\n", rc);
break;
}
printf("Kernel leap second flag: ");
if (tx.status & STA_INS)
printf("STA_INS\n");
else if (tx.status & STA_DEL)
printf("STA_DEL\n");
else
printf("not set\n");
}
=======================================
Reported-by: Petr Gajdos <pgajdos@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-04 12:22:46 +01:00
e3548e1d64
adjtimex.2: Add some FIXMEs
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-04 12:22:46 +01:00
cd65c2b1eb
semop.2: Tweak comment describing 'sempid'
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-03 08:53:23 +01:00
cff459dea2
kill.2, sigaction.2, sigpending.2, sigprocmask.2, sigsuspend.2, ctermid.3, ferror.3, fopen.3, getaddrinfo.3, getnameinfo.3, longjmp.3, rand.3, setjmp.3, sigsetops.3, sigwait.3, tzset.3: Simply FTM requirements
...
_XOPEN_SOURCE implies _POSIX_C_SOURCE >=2, so simplify FTM
requirements in various pages.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:05 +01:00
c1016e8767
kill.2, sigaction.2, sigpending.2, sigprocmask.2, sigsuspend.2, ctermid.3, ctime.3, ferror.3, flockfile.3, fopen.3, getaddrinfo.3, getgrnam.3, getnameinfo.3, getpwnam.3, rand.3, sigsetops.3, sigwait.3, strtok.3, tzset.3, unlocked_stdio.3, feature_test_macros.7: Remove mention of the obsolete _POSIX_SOURCE macro from SYNOPSIS
...
_POSIX_SOURCE was a POSIX.1-1990 creation that was soon made
obsolete bu _POSIX_C_SOURCE. Retaining mention of it
in the feature test macro requirements section of the
SYNOPSIS doesn't contain important information, and may
mislead readers into actually trying to use this macro.
A few mentions of it a maintained in a some pages where
defining _POSIX_SOURCE inhibits some behavior.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
f8619b6a26
killpg.2, mknod.2, mmap.2, nice.2, readlink.2, seteuid.2, setpgid.2, setreuid.2, sigaltstack.2, symlink.2, sync.2, truncate.2, vfork.2, wait.2: Update FTM requirements (mainly _DEFAULT_SOURCE)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
f8e7625cad
signal.2: Update FTM requirements (_DEFAULT_SOURCE)
...
Also remove redundant text covering FTM details that
are already provided in feature_test_macros(7).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
6b0f5f5c4c
fcntl.2: Remove mention of _BSD_SOURCE to get definition of F_SETOQN/F_GETOWN
...
This usage went away in glibc 2.20, and the simplest remedy
is just to omit mention of it.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
1b5de130aa
chroot.2: Update FTM requirements
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
bc3e200eb3
chown.2: Update FTM requirements
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
7943641180
chmod.2: Update FTM requirements
...
There have been a number of changes in recent glibc versions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
4f71ba5dbd
clone.2, unshare.2: Remove mention of _BSD_SOURCE and _SVID_SOURCE
...
The right way to expose declarations for these Linux-specific
system calls was always _GNU_SOURCE. Mentioning the historical
use of _BSD_SOURCE and _SVID_SOURCE just clouds the issue.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
827cdae3f1
_exit.2, abs.3, acos.3, acosh.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, cbrt.3, ceil.3, copysign.3, cos.3, cosh.3, div.3, erf.3, erfc.3, exp.3, exp2.3, expm1.3, fabs.3, fdim.3, finite.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fpclassify.3, frexp.3, fwide.3, hypot.3, ilogb.3, isalpha.3, isgreater.3, iswblank.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, log2.3, logb.3, lrint.3, lround.3, modf.3, nan.3, nextafter.3, pow.3, printf.3, remainder.3, remquo.3, rint.3, round.3, scalbln.3, scanf.3, signbit.3, sin.3, sinh.3, sqrt.3, strtod.3, strtol.3, strtoul.3, tan.3, tanh.3, tgamma.3, trunc.3, wprintf.3: Remove "or 'cc -std=c99'" from SYNOPSIS
...
Under the FTM requirements all of these pages document the
requirement for _ISOC99_SOURCE. And feature_test_macros(7) now
documents that "cc -std=c99" produces the same effect as defining
_ISOC99_SOURCE. So, all of these pages don't additionally need
to specify "or 'cc -std=c99'" under the FTM requirements
in the SYNOPSIS. Removing that redundant text also simplifies
the SYNOPSIS a little.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
16347c676c
chdir.2: Update FTM requirements
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
c8fab0f00e
getpagesize.2: Update FTM requirements (_DEFAULT_SOURCE)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
a48088b0e6
fsync.2: Update FTM requirements
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
b68a13bc33
fsync.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
51c612fb9f
getgroups.2, gettimeofday.2, mincore.2, readv.2, stime.2, wait4.2, addseverity.3, adjtime.3, cfree.3, dysize.3, fgetgrent.3, fgetpwent.3, futimes.3, getdirentries.3, getgrent_r.3, getgrouplist.3, getmntent.3, getnetent_r.3, getprotoent_r.3, getpwent_r.3, getrpcent_r.3, getservent_r.3, getspnam.3, gsignal.3, initgroups.3, mkdtemp.3, on_exit.3, perror.3, psignal.3, putpwent.3, rcmd.3, rpmatch.3, setbuf.3, setnetgrent.3, sigvec.3, strsep.3, syslog.3, tempnam.3, termios.3, timegm.3, timeradd.3: Update FTM requirements (_DEFAULT_SOURCE)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
52d1e2b247
setpgid.2: Correct/simplify FTM requirements for BSD setpgrp() and getpgrp()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
cf7fa0a179
brk.2, chdir.2, chmod.2, chown.2, chroot.2, getpagesize.2, getsid.2, killpg.2, mknod.2, readlink.2, setpgid.2, setreuid.2, sigaltstack.2, stat.2, symlink.2, sync.2, truncate.2, vfork.2, wait.2, wait4.2, a64l.3, acosh.3, asinh.3, atanh.3, cbrt.3, ecvt.3, expm1.3, gcvt.3, getcwd.3, getdate.3, getdtablesize.3, getgrent.3, gethostid.3, getpass.3, getpwent.3, getsubopt.3, ilogb.3, insque.3, lockf.3, log1p.3, logb.3, mkstemp.3, mktemp.3, nextafter.3, posix_memalign.3, random.3, realpath.3, remainder.3, rint.3, scalb.3, siginterrupt.3, sigset.3, strdup.3, ualarm.3, usleep.3: Remove references to _XOPEN_SOURCE_EXTENDED in SYNOPSIS
...
_XOPEN_SOURCE_EXTENDED is obsolete (it existed in SUSv1, but not
subsequent standards). _XOPEN_SOURCE >= 500 produces the same
effects as (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED). Modifying
the SYNOPSIS of various ages that contain:
_XOPEN_SOURCE\ >=\ 500 ||
_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
to just:
_XOPEN_SOURCE\ >=\ 500
This has the following benefits:
a) Simplifying the SYNOPSIS by removing ancient
historical information.
b) Preventing users from being misled into using
_XOPEN_SOURCE_EXTENDED in new source code.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
38e3518901
adjtimex.2: Remove FTM requirements
...
It seems that adjtimex() never needed _BSD_SOURCE (and my
earlier commit 5918743bc8
2016-03-01 20:01:03 +01:00
b0da7b8b76
access.2, chmod.2, chown.2, link.2, mkdir.2, open.2, readlink.2, rename.2, stat.2, symlink.2, unlink.2, utimensat.2, vfork.2, dirfd.3, fexecve.3, ffs.3, fmemopen.3, getcwd.3, gethostbyname.3, getline.3, mbsnrtowcs.3, mkdtemp.3, mkfifo.3, opendir.3, printf.3, psignal.3, qecvt.3, scandir.3, stpcpy.3, stpncpy.3, strdup.3, strnlen.3, strsignal.3, ualarm.3, usleep.3, wcpcpy.3, wcpncpy.3, wcscasecmp.3, wcsdup.3, wcsncasecmp.3, wcsnlen.3, wcsnrtombs.3: Simply FTM requirements
...
Looking at <features.h> (or feature_test_macros(7)), one can
see that when _XOPEN_SOURCE is defined with the value 700
(or greater), then _POSIX_C_SOURCE is defined with the value
200809L (or greater). Therefore, terms in the man pages such as
_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
can be simpified to:
_POSIX_C_SOURCE\ >=\ 200809L
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
e464f0546d
_exit.2, brk.2, abs.3, acos.3, acosh.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, cbrt.3, ceil.3, copysign.3, cos.3, cosh.3, div.3, erf.3, erfc.3, exp.3, expm1.3, fabs.3, fdim.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fpclassify.3, frexp.3, hypot.3, ilogb.3, isalpha.3, isgreater.3, iswblank.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, logb.3, lrint.3, lround.3, modf.3, nan.3, nextafter.3, posix_memalign.3, pow.3, remainder.3, remquo.3, round.3, scalbln.3, scanf.3, signbit.3, sin.3, sinh.3, sqrt.3, strtod.3, strtol.3, strtoul.3, tan.3, tanh.3, tgamma.3, trunc.3: Simplify FTM requirements
...
Looking at <features.h> (or feature_test_macros(7)), one can
see that when _XOPEN_SOURCE is defined with the value 600
(or greater), then _POSIX_C_SOURCE is defined with the value
200112L (or greater). Therefore, terms in the man pages such as
_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
can be simplified to:
_POSIX_C_SOURCE\ >=\ 200112L
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>`
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
a446ac0c68
brk.2, chroot.2, clock_nanosleep.2, getpagesize.2, posix_fadvise.2, select.2, select_tut.2, seteuid.2, clock_getcpuclockid.3, ecvt.3, exp2.3, fseeko.3, gcvt.3, getdtablesize.3, getpass.3, getw.3, log2.3, mktemp.3, mq_receive.3, mq_send.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, pthread_attr_setstack.3, rint.3, sem_wait.3, setenv.3, sockatmark.3, strerror.3: Simplify FTM requirements
...
Looking at <features.h> (or feature_test_macros(7)), one can
see that when _XOPEN_SOURCE is defined with the value 600
(or greater), then _POSIX_C_SOURCE is defined with the value
200112L (or greater). Therefore, terms in the man pages such as
_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
can be simpified to:
_POSIX_C_SOURCE\ >=\ 200112L
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
eb15868c65
brk.2: Update FTM requirements (_DEFAULT_SOURCE)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
d054453419
acct.2, getdomainname.2, gethostname.2, vhangup.2, daemon.3, gethostid.3, getusershell.3, profil.3: Update feature test macro requirements
...
Update to use _DEFAULT_SOURCE, and also changes brought by
glibc commit 266865c0e7b79d4196e2cc393693463f03c90bd8.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
344c74c02a
madvise.2: Update FTM requirements to mention _DEFAULT_SOURCE
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:02 +01:00
84466c16bd
semctl.2: NOTES: note when 'sempid' is set on various implementations
...
See https://bugzilla.kernel.org/show_bug.cgi?id=112271 and
http://thread.gmane.org/gmane.linux.kernel/2162754/
Subject: [PATCH] Don't set sempid in semctl syscall.
Newsgroups: gmane.linux.kernel
Date: 2016-02-26 12:21:38 GMT
Reported-by: Davidlohr Bueso <dave@stgolabs.net>
Reported-by: Manfred Spraul <manfred@colorfullife.com>
Reported-by: Philip Semanchuk <linux_kernel.20.ick@spamgourmet.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-28 20:11:22 +01:00
88ee5c1c61
prctl.2: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-28 14:39:46 +01:00
d4b9c2c3f3
utimensat.2: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 16:39:03 +01:00
0e886e9862
times.2: Fix an incorrect description in NOTES
...
The text has an incorrect description in NOTES, it says
that (2^32/HZ) - 300 is about 429 million. It is correct
only if HZ=10 which does not look common today. So just
removing "(i.e., about 429 million)" is good enough.
----
Signed-off-by: Naoya Kondo <kondo-naoya@jp.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 16:38:06 +01:00
ef2c622810
truncate.2: SEE ALSO: add truncate(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 13:15:08 +01:00
7d11c72f51
sync.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 13:13:06 +01:00
5a22437855
mknod.2: SEE ALSO: add mknod(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 12:27:55 +01:00
4214760726
chown.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-25 21:33:22 +01:00
e746db2e27
open.2: f
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-22 15:47:29 +01:00
ff9225cc57
open.2: O_TMPFILE support in Btrfs
...
Reported-by: Petr Gajdos <pgajdos@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-22 15:43:55 +01:00
e92f04afa5
get_kernel_syms.2: Note that glibc des not support this system call
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-22 09:21:56 +01:00
0eace267be
init_module.2: Glibc 2.23 removed last vestiges of support for this system call
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-22 09:21:56 +01:00
fa3b5cee4c
delete_module.2: Glibc 2.23 removed last vestiges of support for this system call
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-22 09:21:56 +01:00
c37cf7d3e8
create_module.2: Glibc 2.23 removed last vestiges of support for this system call
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-22 09:21:56 +01:00
7be3122f4f
bdflush.2: Note that glibc support for this system call went away in version 2.23
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-22 09:21:56 +01:00
d04b14bd3b
uselib.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-22 09:21:56 +01:00
b575a20f86
uselib.2: Note that glibc does not support this (obsolete) system call
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-22 09:21:50 +01:00
90493c8cf0
create_module.2, delete_module.2, query_module.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-22 09:21:50 +01:00
50f6c77429
uselib.2: Mention CONFIG_USELIB
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-22 09:21:50 +01:00
9a20348ccb
posix_fadvise.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-19 09:02:23 +01:00
47c3854b91
utimensat.2: ffix + wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-17 11:17:51 +01:00
35acdc5d41
sigprocmask.2: Explicitly refer the reader to sigsetops(3)
...
This man page did not make it obvious which functions
should be used for manipulating signals sets, nor where
those functions were documented.
Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-17 10:53:17 +01:00
1b398e8099
mount.2: SEE ALSO: add findmnt(8)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-15 15:32:52 +01:00
0d7ae27d85
fcntl.2, flock.2: SEE ALSO: add lslocks(8)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-15 15:32:52 +01:00
f4a44ac634
stat.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-15 13:34:44 +01:00
698ac0e263
chmod.2: Clarify terminology (file mode versus file permission bits)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-15 13:34:44 +01:00
1bab84a885
open.2: Minor wording fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-13 17:55:10 +01:00
b3eb228083
gettid.2: tfix
...
Reported-by: Ivan Shapovalov <intelfx@intelfx.name>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-13 15:58:04 +01:00
0f166ce187
bpf.2: Document close-on-exec semantics
...
The close-on-exec file descriptor flag is automatically enabled
for FDs returned by bpf().
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-11 14:50:16 +01:00
cf8bac925f
sync.2: Clarify description and document the Linux data integrity guarantees
...
Signed-off-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-11 13:34:20 +01:00
0509285e2c
stat.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-08 16:11:58 +01:00
368bbfa929
brk.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-08 16:11:58 +01:00
d432f10d89
madvise.2: Tweaks and improvements to Minchan's text
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-08 08:24:15 +01:00
9ec1369898
madvise.2: Reorder MAD_FREE entry
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-08 08:24:15 +01:00
cbb9ef3061
madvise.2: Document MADV_FREE
...
Document the MADV_FREE flag added to madvise() in Linux 4.5.
Signed-off-by: Minchan Kim <minchan@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-08 08:24:15 +01:00
d38a09fca6
fanotify_init.2: Note kernel version that allowed O_CLOEXEC for event_f_flags
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-06 19:31:55 +01:00
6b1e34f2a4
madvise.2: Put MADV_SOFT_OFFLINE into kernel version order
...
Exceptionally, the lists on this page are in kernel version order
rather than alphabetical order. But one entry was out of order.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-06 12:27:25 +01:00
11c25e24c8
madvise.2: Clarify MADV_HWPOISON wording to say that it applies to a page range
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-06 12:24:54 +01:00
20cc8fa829
select.2: Document spurious EAGAIN error that can occur on other systems
...
Light reworking of text proposed by Josh Triplett.
Reported-by: Josh Triplett <josh@joshtriplett.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-04 12:34:06 +01:00
f14637570d
poll.2: Document spurious EAGAIN error that can occur on other systems
...
Light reworking of text proposed by Josh Triplett.
Reported-by: Josh Triplett <josh@joshtriplett.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-04 12:34:06 +01:00
5dbb60df52
select_tut.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 15:51:42 +01:00
65842010f3
select_tut.2: Simplify 'if' logic in in example program
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 14:37:40 +01:00
894d620ae2
select_tut.2: Use correct type (socklen_t) for addrlen
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 14:37:40 +01:00
5bb9aa4e0c
select_tut.2: Better variable names in example program
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 14:37:40 +01:00
f145f66700
select_tut.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 14:18:21 +01:00
887f19e8a1
select.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 14:16:00 +01:00
455f50e98b
select_tut.2: Some readability fixes to example program
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 14:08:29 +01:00
24a31d632b
accept.2, bind.2, connect.2, getpeername.2, getsockname.2, recv.2, recvmmsg.2, select_tut.2, send.2, sendmmsg.2, getaddrinfo.3, getnameinfo.3, epoll.7, unix.7: Use consistent argument/variable names for socket addresses and lengths
...
As noted by Carlos, there's quite a bit of inconsistency across
pages. Use 'addr' and 'addrlen' consistently in variables and
function arguments.
Cowritten-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 14:08:29 +01:00
787dd4ad3a
membarrier.2, crypt.3, dladdr.3, duplocale.3, fmemopen.3, gethostbyname.3, mallopt.3, newlocale.3, resolver.3, sigsetops.3, strfmon.3, tzset.3, console_ioctl.4, lirc.4, loop.4, vcs.4, dir_colors.5, locale.5, proc.5, tzfile.5, attributes.7, bootparam.7, capabilities.7, feature_test_macros.7, icmp.7, man-pages.7, netlink.7, path_resolution.7, pipe.7, socket.7, unix.7, vdso.7: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 09:14:22 +01:00
def04e1ccf
chown.2, futex.2, membarrier.2, memfd_create.2, mount.2, msgop.2, open.2, open_by_handle_at.2, perf_event_open.2, readv.2, sched_setscheduler.2, syslog.2, basename.3: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 08:46:16 +01:00
e6a05bfff2
clock_getres.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 08:36:41 +01:00
9088de13ba
capget.2, chown.2, chroot.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 08:36:32 +01:00
122502e824
bind.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 08:34:02 +01:00
ed1819cf3e
futex.2: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
2016-02-03 08:27:03 +01:00
2050c09881
perf_event_open.2: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
2016-02-03 08:26:34 +01:00
3a1de8ba24
kexec_load.2: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
2016-02-03 08:26:01 +01:00
8400413301
msgop.2: tfix
...
Reported-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 08:24:17 +01:00
6c3453059b
select.2: Add details on the glibc fixed-size fd_set limitation
...
No modern application should use select() on Linux.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-01 15:21:54 +01:00
6b6e918550
select.2: Mention the 'fd_set' size limitation early and refer to poll(2)
...
Change this because of the serious limitation of select()
imposing a limit on the range of file descriptors that can
be monitored. This is currently mentioned too late in the
documentation (in the NOTES section). The man page should
warn early and refer to poll(2) as soon as possible.
Signed-off-by: Nikos Mavrogiannopoulos <nmav@gnutls.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-01 15:21:54 +01:00
555c23c278
personality.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-31 16:34:02 +01:00
2d41eca319
personality.2: Greatly expand, to add descriptions of personality domains.
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-30 17:31:14 +01:00
6d8e9b7e76
readv.2: wrcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-28 21:48:45 +01:00
34d4e61def
accept.2, perf_event_open.2, unlink.2, lirc.4, proc.5, inotify.7: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-28 10:44:01 +01:00
2bea5d44a5
copy_file_range.2: Add notes on copy_on_write() filesystem optimizations
...
Based on Anna Schumaker's noted in the initial commit for
this man page.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-27 09:10:32 +01:00
a5918afa92
syscalls.2: Add copy_file_range(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-27 09:00:36 +01:00
9876bc24d0
sendfile.2: SEE ALSO: add copy_file_range(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:51:28 +01:00
d1de085084
copy_file_range.2: EXAMPLE: remove unused variable from example program
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:42:20 +01:00
b4fe696c8a
copy_file_range.2: NOTES: expand details on the use of lseek()
...
Mention SEEK_DATA and SEEK_HOLE explicitly.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:42:20 +01:00
4cfafd7910
copy_file_range.2: ERRORS: clarify EXDEV description
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:42:20 +01:00
f0558db88d
copy_file_range.2: ERRORS: clarify EINVAL O_APPEND description
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:42:19 +01:00
ee43ffde93
copy_file_range.2: Minor fixes to Anna's new page
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:42:19 +01:00
903b48079c
copy_file_range.2: New page documenting copy_file_range()
...
copy_file_range() is a new system call for copying ranges of data
completely in the kernel. This gives filesystems an opportunity to
implement some kind of "copy acceleration", such as reflinks or
server-side-copy (in the case of NFS).
Signed-off-by: Anna Schumaker <Anna.Schumaker@Netapp.com>
Reviewed-by: Darrick J. Wong <darrick.wong@oracle.com>
Reviewed-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:15:24 +01:00
c72249c562
fork.2, read.2, sendfile.2, splice.2, write.2, aio_read.3, aio_write.3, proc.5: Wording fix: "current file offset" ==> "file offset"
...
"File offset" is the preferred POSIX terminology.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:13:47 +01:00
f180e30bc2
lseek.2: wfix ("open file description")
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:08:39 +01:00
e2b89c5c8c
lseek.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:06:41 +01:00
930fa2cd5a
llseek.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:05:32 +01:00
14a9ad4952
llseek.2, lseek.2, readahead.2: Wording fix: use "open file description" rather than "open file"
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:02:21 +01:00
162ce82786
llseek.2: SEE ALSO: add open(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:02:21 +01:00
1a6de32849
perfmonctl.2: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-25 14:33:57 +01:00
f0e9ccbc88
keyctl.2: tfix
...
Signed-off-by: Joe Stein <joeaarons@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-25 14:32:09 +01:00
e6659f737e
execve.2: Add reference to ld-linux.so(8)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-21 00:21:24 +01:00
36f8fb2bcd
wait.2, wait4.2: Rename the "status" argument to "wstatus"
...
The fact that exit(3)/_exit(2) has an argument called
"status" and the same name is used in the arguments to the
wait*() calls can a little too easily lead the user into
thinking that the two arguments hold the same information,
when of course they don't. So, use a different name
for the argument of the wait*() functions, to reduce
the chances of such confusion.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-20 22:14:00 +01:00
90425b93fc
recv.2: Equivalence to read
...
Describe the recv(2)-read(2) and the recvfrom(2)-recv(2)
equivalences for zero-valued arguments.
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-16 12:08:55 +01:00
ea84b0fd6b
nanosleep.2: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-16 11:20:12 +01:00
e6aa1ec849
execve.2: SEE ALSO: add system(3)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-16 10:37:50 +01:00
ef2244feb9
recv.2: MSG_WAITALL has no effect for datgram sockets
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-16 10:10:56 +01:00
972748d883
readlink.2: Clarify EINVAL error description
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-12 10:10:35 +01:00
4a6f17b57a
sched_setattr.2: EPERM depends on affinity mask of target thread, not calling thread
...
Reported-by: Akihiro Suda <suda.kyoto@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-08 21:26:50 +01:00
67c67ff26b
futex.2: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-08 17:26:15 +01:00
1a3c3468bd
ptrace.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-08 17:24:58 +01:00
851eae74ca
ptrace.2: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-08 17:24:20 +01:00
a1dc786b3d
bind.2: Improve description of ENOENT error
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 13:19:01 +01:00
2a70e42b66
chdir.2: Minor wording fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 13:17:29 +01:00
bb14af394e
clock_nanosleep.2, fallocate.2, nanosleep.2, request_key.2, sigsuspend.2, statfs.2, getgrent.3, getgrnam.3, getpwent.3, getpwnam.3, lio_listio.3, statvfs.3, tmpfile.3, ualarm.3: ERRORS: add reference to signal(7) in description of EINTR
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 13:15:06 +01:00
3aa743158f
truncate.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 13:02:36 +01:00
a72a617408
execve.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 13:00:35 +01:00
d9cb0d7d3f
Various pages: Word "descriptor" more precisely
...
Use either "file descriptor" or message queue descriptor".
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 12:29:37 +01:00
0fa890e0d8
stat.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 12:28:38 +01:00
d60d564db8
connect.2: ERRORS: improve EBADF description
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 12:28:38 +01:00
298998880f
socket.2: Minor wording improvement
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 12:28:37 +01:00
ad3450b92c
chown.2: ERRORS: improve EBADF description
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 12:28:37 +01:00
3ad7769474
accept.2: ERRORS: improve description for EBADF
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 12:28:37 +01:00
3438c51640
syscall(2): ffix
...
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 20:37:16 +01:00
835b2b2c27
fcntl.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 20:36:19 +01:00
f6615c426b
futex.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 20:35:30 +01:00
eb56b04bcc
ioctl_list.2: Transfer structure (wireless.h IOCTLs)
...
The sole parameter to be passed to the wireless.h IOCTLs is
of type struct iwreq *.
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 20:34:13 +01:00
cd175805de
futex.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 13:57:02 +01:00
938bcc0824
ioctl_list.2: Include uapi/linux/wireless.h
...
Add the list of wireless IOCTLs.
We should later add a page ioctl_wireless.2 decribing the usage.
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 11:57:28 +01:00
767ffad326
ioctl_list.2: Path to sockios.h
...
sockios.h is now in include/uapi
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 11:53:41 +01:00
a3b9b5da15
ioctl_list.2: Add reference to netdevice.7
...
netdevice.7 describes most of the IOCTLs of sockios.h
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 11:49:06 +01:00
1078a69975
syscall.2: Minor tweaks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 11:33:56 +01:00
ddbe84e64e
syscall.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 11:09:33 +01:00
9f9a9b76c8
syscall.2: Reformat tables to be narrower
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 11:07:25 +01:00
8585e83715
syscall.2: Add more architectures and improve error documentation
...
Move the error register documentation into the main table rather
than listing them in sentences after the fact.
Add sparc error return details.
Add details for alpha/arc/m68k/microblaze/nios2/powerpc/superh/
tile/xtensa.
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 10:44:43 +01:00
e24fbf1098
Removed trailing white space at end of lines
2015-12-29 13:51:32 +01:00
6a95087eb2
clock_getres.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-29 13:50:26 +01:00
29b41e747f
accept.2, acct.2, bind.2, clock_getres.2, connect.2, dup.2, epoll_create.2, eventfd.2, execve.2, fanotify_init.2, fcntl.2, fork.2, futex.2, get_robust_list.2, getcpu.2, getpeername.2, getrlimit.2, getsockname.2, getsockopt.2, gettimeofday.2, inotify_init.2, listen.2, membarrier.2, memfd_create.2, mlock.2, mmap.2, personality.2, pipe.2, poll.2, recv.2, send.2, sendfile.2, shmget.2, shutdown.2, sigreturn.2, socket.2, socketcall.2, socketpair.2, spu_create.2, swapon.2, time.2, timerfd_create.2, uselib.2, dlerror.3, dlopen.3, drand48.3, errno.3, fnmatch.3, getgrent.3, getgrnam.3, getlogin.3, getpwent.3, getpwnam.3, iconv.3, mq_open.3, opendir.3, random_r.3, sem_open.3, shm_open.3, tmpfile.3, tzset.3, random.4, fanotify.7, futex.7, vdso.7, ld.so.8: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-29 13:48:42 +01:00
e258766bf4
accept.2, acct.2, epoll_create.2, execve.2, futex.2, inotify_init.2, mmap.2, open.2, pipe.2, shmget.2, socket.2, socketpair.2, spu_create.2, swapon.2, uselib.2, getgrent.3, getgrnam.3, getlogin.3, getpwent.3, getpwnam.3, mq_open.3, opendir.3, sem_open.3, shm_open.3, tmpfile.3, fanotify.7: ERRORS: standardize text for ENFILE error
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-27 17:10:23 +01:00
26c32fabec
accept.2, dup.2, eventfd.2, execve.2, fcntl.2, memfd_create.2, open.2, perf_event_open.2, pipe.2, signalfd.2, socket.2, socketpair.2, spu_create.2, timerfd_create.2, getgrent.3, getgrnam.3, getlogin.3, getpwent.3, getpwnam.3, mq_open.3, opendir.3, sem_open.3, shm_open.3, tmpfile.3: ERRORS: standardize text for EMFILE error
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-27 16:37:03 +01:00
78d8b29eb5
inotify_init.2: ERRORS: add an EMFILE error case
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-27 16:37:03 +01:00
71d597e942
fanotify_init.2: ERRORS: add an EMFILE error case
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-27 16:37:03 +01:00
6bde54afad
epoll_create.2: ERRORS: add another EMFILE error case
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-27 16:36:54 +01:00
deedfd97fe
accept.2, bind.2, connect.2, getpeername.2, getsockname.2, getsockopt.2, listen.2, recv.2, send.2, shutdown.2: ERRORS: standardize error text for ENOTSOCK error
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-27 16:36:43 +01:00
8adaf0a794
futex.2: Minor wording tweaks after comments from Darren Hart
...
Reported-by: Darren Hart <dvhart@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-26 09:02:35 +01:00
ee25832b41
personality.2: Note kernel and glibc versions that introduced this system call
...
Signed-off-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-26 08:47:23 +01:00
0bf502fc7f
poll.2: Shorten name of timeout argument for ppoll()
...
The name is overly long, and does not hint at the fact
that this argument is a pointer. Fix this by renaming:
s/timeout_ts/tmo_p/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-23 23:25:41 +01:00
32c8dbc049
poll.2: timeout_ts is a pointer, so use -> not . for member access
...
From the context, it is apparent that in the code explaining
ppoll in terms of poll, timeout_ts must be a pointer.
Usage #1 : ready = ppoll(&fds, nfds, timeout_ts, &sigmask);
Usage #2 : (timeout_ts == NULL)
Thus member access in (timeout_ts.tv_sec * 1000 +
timeout_ts.tv_nsec / 1000000) is an error.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-23 23:19:09 +01:00
Michael Kerrisk