Commit Graph

19720 Commits

Author SHA1 Message Date
Michael Kerrisk 010a79cd86 rename.2: wfix: s/shmem/tmpfs/ in discussion of RENAME_NOREPLACE
Reported-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 17:41:49 +01:00
Michael Kerrisk 9738a72a0b rename.2: XFS support for RENAME_NOREPLACE was added in Linux 4.0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 17:40:15 +01:00
Michael Kerrisk 62f68f105d rename.2: Rework list of supported filesystems for RENAME_NOREPLACE
There was probably a little too much detail in
Lukas Werkmeister's patch. Simplify, by removing a few
file systems, and arrange the information as a bulleted
list for easier readability.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 17:40:15 +01:00
Lucas Werkmeister 94b9d26faa rename.2: Add kernel versions for RENAME_NOREPLACE support
The RENAME_NOREPLACE flag was added with the initial release of the
renameat2 syscall in Linux 3.15, but support for most filesystems was
only added in later versions, and some may still not support it.

Signed-off-by: Lucas Werkmeister <mail@lucaswerkmeister.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 17:16:36 +01:00
Jakub Wilk 587ff4d5af vdso.7: tfix
Escape hyphens; use \(aq for ASCII apostrophes.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 17:00:05 +01:00
Elliot Hughes 7c2c86efb7 getmntent.3: Clarify that endmntent() should be used rather than fclose()
This doesn't actually matter on any C library I know of --- they
all just do a NULL check and forward to fclose(3). (The actual
mistake I saw was someone not realizing that they had to call
*anything*.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 16:52:40 +01:00
Elliot Hughes c36a6bedf6 ferror.3: Warn about closing the result of fileno()
Since adding checking to Android's bionic for file descriptor
double-closes, we've found that the most common cause of these
bugs is incorrect use of fileno(3). There appears to be a common
misconception that it transfers ownership of the file descriptor
to the caller.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 16:50:52 +01:00
Michael Kerrisk b79b66d119 getrlimit.2: Resource limits are process-wide attributes shared by all threads
This was already noted in pthreads(7), but bears repeating here.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 15:23:19 +01:00
Michael Kerrisk 4641c596b3 proc.5: Document /proc/PID/status CoreDumping field
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 12:40:46 +01:00
Michael Kerrisk 422425ff92 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 12:35:30 +01:00
Michael Kerrisk fcfac78d29 proc.5: /proc/[pid]/status VmPMD field was removed in Linux 4.15
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 12:30:25 +01:00
Michael Kerrisk f7bbc79dbc proc.5: Document /proc/Meminfo LazyFree field
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 12:25:57 +01:00
Michael Kerrisk f9326a24ff proc.5: Fix kernel source pathname for soft-dirty documentation
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 12:21:46 +01:00
Michael Kerrisk 7375eaabfb proc.5: Document /proc/meminfo KReclaimable field
Added in Linux 4.20.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 12:05:08 +01:00
Michael Kerrisk 1c1ccb2c65 mount.2: Document EROFS for read-only filesystems
See https://bugzilla.kernel.org/show_bug.cgi?id=200649

Reported-by: Harry Mallon <hjmallon@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 10:15:23 +01:00
Michael Kerrisk ed6d190860 mount.2: EACCES: note some reasons why a filesystem may be read-only
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 10:12:00 +01:00
Michael Kerrisk 642df17c43 prctl.2: Add some further historical details on PR_SET_MM_EXE_FILE
Also some minor tweaks to Benjamin Peterson's patch.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 08:29:13 +01:00
Benjamin Peterson 47bc9cec30 prctl.2: PR_SET_MM_EXE_FILE may now be used as many times as desired
The original implementation of PR_SET_MM_EXE_FILE only allowed it
to be used once in a process's lifetime. This restriction was
lifted in Linux commit 3fb4afd9a504c2386b8435028d43283216bf588e
("prctl: remove one-shot limitation for changing exe link").

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 08:15:12 +01:00
Michael Kerrisk d2eeb68f0b prctl.2: wfix: Remove a redundant sentence
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 08:14:44 +01:00
Michael Kerrisk 01df7b7046 proc.5: Document /proc/[pid]
See also https://bugzilla.kernel.org/show_bug.cgi?id=201441

Reported-by: Philip Dumont <phil@solidstatescientific.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-04 23:56:10 +01:00
Michael Kerrisk 3c7cfa32d7 proc.5: Add an overview section describing the groups of files under /proc
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-04 23:04:52 +01:00
Michael Kerrisk 0de3b92c34 lirc.4: Clarify the description LIRC_SET_REC_TIMEOUT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-04 20:23:27 +01:00
Michael Kerrisk c020b5a217 msgctl.2, semctl.2, shmctl.2: Some small wording improvements for Davidlohr Bueso's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-04 17:28:24 +01:00
Michael Kerrisk 5593795fc3 msgctl.2: tfix
Reported-by: Joe Lawrence <joe.lawrence@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-04 17:19:36 +01:00
Michael Kerrisk 14cbb25e36 msgctl.2, semctl.2, shmctl.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-04 17:17:07 +01:00
Davidlohr Bueso d2ff4f8619 msgctl.2, semctl.2, shmctl.2: Document STAT_ANY commands
Reported-by: Joe Lawrence <joe.lawrence@redhat.com>
Signed-off-by: Davidlohr Bueso <dbueso@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-04 17:10:47 +01:00
Michael Kerrisk 08069f7a04 lirc.4: Minor language fix-ups
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-04 12:13:32 +01:00
Michael Kerrisk 7d3e44d581 lirc.4: Remove crufty text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-04 12:11:25 +01:00
Michael Kerrisk f3c3a5c42b lirc.4: Minor wording and formatting fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-04 12:11:25 +01:00
Sean Young aef83b6047 lirc.4: tfix
Signed-off-by: Sean Young <sean@mess.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-04 11:41:01 +01:00
Sean Young a1e1ac251d lirc.4: Document remaining ioctl (LIRC_GET_REC_TIMEOUT)
Now all ioctls are documented.

Signed-off-by: Sean Young <sean@mess.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-04 11:39:48 +01:00
Michael Kerrisk 77eefc59bd cgroups.7: tfix
Reported-by: Alan Jenkins <alan.christopher.jenkins@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-04 11:29:06 +01:00
Michael Kerrisk c6c28d527d user_namespaces.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-02 13:52:24 +01:00
Michael Kerrisk 602ecf86cd lp.4: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-02 13:37:43 +01:00
Michael Kerrisk 2c1608c23b namespaces.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-02 13:32:25 +01:00
Michael Kerrisk 99a9a45f06 lirc.4: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-02 13:02:30 +01:00
Michael Kerrisk 264a16db27 lirc.4: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-02 12:38:10 +01:00
Sean Young 5116995534 lirc.4: Document error returns more explicitly
Signed-off-by: Sean Young <sean@mess.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-02 12:36:57 +01:00
Michael Kerrisk 922819b84d lirc.4: Minor fix-ups for Sean Young's previous patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-02 12:36:57 +01:00
Sean Young 29a1847441 lirc.4: Both ioctls are supported if LIRC_CAN_SET_REC_CARRIER_RANGE is set
Signed-off-by: Sean Young <sean@mess.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-02 12:36:57 +01:00
Sean Young f75ee79d12 lirc.4: LIRC_CAN_SET_REC_DUTY_CYCLE_RANGE was never supported
No driver ever supported such a thing.

Signed-off-by: Sean Young <sean@mess.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-02 12:36:57 +01:00
Michael Kerrisk 17f08f5e64 lirc.4: Minor reworking of Sean Young's LIRC_SET_REC_TIMEOUT patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-02 12:36:57 +01:00
Sean Young ae04ed0767 lirc.4: Timeout reports are enabled by default
Signed-off-by: Sean Young <sean@mess.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-02 12:18:30 +01:00
Ian Turner 9e8d7a8925 lockf.3: ERRORS: add EINTR
Ian Turner: The exact return calls are at the discretion of the
underlying VFS, but I'm pretty sure that EINTR is a possibility.
Or, if it's not, then the flock() manpage should be amended
accordingly, since the two share the same underlying
implementation.

mtk: lockf(3) is implemented on top of fcntl() locking, so
EINTR is of course a possibility.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-02 07:47:39 +01:00
Quentin Monnet 3bcfaff627 bpf.2: SEE ALSO: add bpf-helpers(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-01 21:23:56 +01:00
Michael Kerrisk 2eb89baa0e capabilities.7: Minor fixes to Marcus Gelderie's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-01 20:55:13 +01:00
Marcus Gelderie 35ecd12dd9 capabilities.7: Mention header for SECBIT constants
Mention that the named constants (SECBIT_KEEP_CAPS and others)
are available only if the linux/securebits.h user-space header
is included.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-01 20:55:13 +01:00
Michael Kerrisk c3617f39b6 mmap.2: tfix
Reported-by: Thomas Posch <kernel.org@online.posch.name>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-01 18:23:33 +01:00
Paul Eggert 5355e20f81 zic.8: Sync from tzdb upstream
Make zic.8 a copy of the upstream tzdb version, except that
the tzdb version's first line is replaced by man-pages
boilerplate, and omit features introduced after 2017b
(the most recent merge to glibc).

This has the following effect:

Document --version, --help.

Document new -v warnings.

Remove -y.

Document that input should be text files, and similar restrictions
on names.

Document negative DST.

Document what is meant by "white space".

Do some minor reformatting.

Use .B for as-is keywords, like commands.

New section "EXTENDED EXAMPLE".

Omit some changes that were made on the man-pages side, notably by
changing some "timezone"s back to the preferred-upstream "time
zone" when talking about traditional time zones as opposed to
POSIX timezone settings.  Also, fix some formatting glitches.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-01 15:09:33 +01:00
Paul Eggert 09c05a89e3 zdump.8: Sync from tzdb upstream
Make zdump.8 a copy of the upstream tzdb version, except that
the tzdb version's first line is replaced by man-pages
boilerplate.

This has the following effect:

Document new options -i, -t, -V.

New section LIMITATIONS.

Do some minor reformatting.

Omit some changes that were made on the man-pages side, notably by
changing some "timezone"s back to the preferred-upstream "time
zone" when talking about traditional time zones as opposed to
POSIX timezone settings.  Also, fix some formatting glitches.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-01 15:09:18 +01:00