]> git.ipfire.org Git - thirdparty/man-pages.git/log
thirdparty/man-pages.git
5 years agoChanges.old: tfix
Jakub Wilk [Mon, 6 Jul 2020 04:39:07 +0000 (06:39 +0200)] 
Changes.old: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agotermios.3: tfix
Jakub Wilk [Mon, 6 Jul 2020 04:39:06 +0000 (06:39 +0200)] 
termios.3: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoprctl.2: tfix
Jakub Wilk [Mon, 6 Jul 2020 04:39:05 +0000 (06:39 +0200)] 
prctl.2: tfix

Remove duplicated word.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agomath_error.7: wfix
Michael Kerrisk [Mon, 6 Jul 2020 11:36:01 +0000 (13:36 +0200)] 
math_error.7: wfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoresolv.conf.5: Clarify that ip6-bytestring was removed in 2.25
Michael Kerrisk [Mon, 6 Jul 2020 11:03:22 +0000 (13:03 +0200)] 
resolv.conf.5: Clarify that ip6-bytestring was removed in 2.25

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agostrcmp.3: wfix
Michael Kerrisk [Mon, 6 Jul 2020 10:57:02 +0000 (12:57 +0200)] 
strcmp.3: wfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agostrcmp.3: tfix
Michael Kerrisk [Mon, 6 Jul 2020 10:54:47 +0000 (12:54 +0200)] 
strcmp.3: tfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoshmop.2: tfix
Michael Kerrisk [Mon, 6 Jul 2020 10:53:39 +0000 (12:53 +0200)] 
shmop.2: tfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoresolver.3: tfix
Michael Kerrisk [Mon, 6 Jul 2020 10:50:41 +0000 (12:50 +0200)] 
resolver.3: tfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoproc.5: srcfix
Michael Kerrisk [Mon, 6 Jul 2020 10:44:40 +0000 (12:44 +0200)] 
proc.5: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoproc.5: wfix
Michael Kerrisk [Mon, 6 Jul 2020 10:43:49 +0000 (12:43 +0200)] 
proc.5: wfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoopen.2: tfix
Michael Kerrisk [Mon, 6 Jul 2020 10:42:33 +0000 (12:42 +0200)] 
open.2: tfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agomremap.2: tfix
Michael Kerrisk [Mon, 6 Jul 2020 10:41:25 +0000 (12:41 +0200)] 
mremap.2: tfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agommap.2: wfix
Michael Kerrisk [Mon, 6 Jul 2020 10:39:09 +0000 (12:39 +0200)] 
mmap.2: wfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agogetusershell.3: ffix
Michael Kerrisk [Mon, 6 Jul 2020 10:37:36 +0000 (12:37 +0200)] 
getusershell.3: ffix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoexecve.2: tfix
Michael Kerrisk [Mon, 6 Jul 2020 10:35:57 +0000 (12:35 +0200)] 
execve.2: tfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agodsp56k.4: ffix
Michael Kerrisk [Mon, 6 Jul 2020 10:04:38 +0000 (12:04 +0200)] 
dsp56k.4: ffix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agosend.2, recv.2: Add msg_iovlen POSIX note
Alyssa Ross [Fri, 3 Jul 2020 01:25:40 +0000 (01:25 +0000)] 
send.2, recv.2: Add msg_iovlen POSIX note

msg_iovlen is incorrectly typed (according to POSIX) in addition
to msg_controllen, but unlike msg_controllen, this wasn't
mentioned for msg_iovlen.

msg_iovlen being incorrectly typed hasn't been reported as a GCC
bug, but there's no point since it is caused by the same
underlying issue.

Sources: POSIX.1-2017 (<sys/socket.h>), Linux
(include/linux/socket.h)

Signed-off-by: Alyssa Ross <hi@alyssa.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agomount.2: ERRORS: add EINVAL for bind mount of mount namespace inode
Michael Kerrisk [Fri, 3 Jul 2020 10:38:18 +0000 (12:38 +0200)] 
mount.2: ERRORS: add EINVAL for bind mount of mount namespace inode

See kernel commit 8823c079ba7136dc1948d6f6dcb5f8022bde438e
and the in fs/namespace.c::do_loopback():

        err = -EINVAL;
        if (mnt_ns_loop(old_path.dentry))
                goto out;

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agostrfromd.3: ffix: use \- for minus sign
Michael Kerrisk [Thu, 2 Jul 2020 10:24:45 +0000 (12:24 +0200)] 
strfromd.3: ffix: use \- for minus sign

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoman3/*: ffix: change '-' to '\-' for options
Bjarni Ingi Gislason [Wed, 1 Jul 2020 22:50:59 +0000 (22:50 +0000)] 
man3/*: ffix: change '-' to '\-' for options

  Change '-' to '\-' for the prefix of names to indicate an option.

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoman8/*: ffix: change '-' to '\-' for options
Bjarni Ingi Gislason [Wed, 1 Jul 2020 23:38:01 +0000 (23:38 +0000)] 
man8/*: ffix: change '-' to '\-' for options

  Change '-' to '\-' for the prefix of names to indicate an option.

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoman7/*: ffix: change '-' to '\-' for options and to '\(en' for a range
Bjarni Ingi Gislason [Wed, 1 Jul 2020 23:31:30 +0000 (23:31 +0000)] 
man7/*: ffix: change '-' to '\-' for options and to '\(en' for a range

  Change '-' to '\-' for the prefix of names to indicate an option.

  Change '-' to '\(en' for a range.

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoman5/*: ffix: change '-' to '\-' for options
Bjarni Ingi Gislason [Wed, 1 Jul 2020 23:12:18 +0000 (23:12 +0000)] 
man5/*: ffix: change '-' to '\-' for options

  Change '-' to '\-' for the prefix of names to indicate an option.

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoman4/*: ffix: change '-' to '\-' for options
Bjarni Ingi Gislason [Wed, 1 Jul 2020 23:01:21 +0000 (23:01 +0000)] 
man4/*: ffix: change '-' to '\-' for options

  Change '-' to '\-' for the prefix of names to indicate an option.

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoman2/*: ffix: change '-' to '\-' for options
Bjarni Ingi Gislason [Wed, 1 Jul 2020 22:08:50 +0000 (22:08 +0000)] 
man2/*: ffix: change '-' to '\-' for options

  Change '-' to '\-' for the prefix of names to indicate an option.

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoman1/*: ffix: change '-' to '\-' for options
Bjarni Ingi Gislason [Wed, 1 Jul 2020 22:05:53 +0000 (22:05 +0000)] 
man1/*: ffix: change '-' to '\-' for options

  Change '-' to '\-' for the prefix of names to indicate an option.

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoftw.3: srcfix
Michael Kerrisk [Thu, 2 Jul 2020 08:36:55 +0000 (10:36 +0200)] 
ftw.3: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agocgroups.7, cpuset.7: Update kernel cgroup documentation references
Sven Hoexter [Mon, 29 Jun 2020 14:41:10 +0000 (16:41 +0200)] 
cgroups.7, cpuset.7: Update kernel cgroup documentation references

cgroups-v1/v2 documentation got moved to the "admin-guide" subfolder
and converted from .txt files to .rst

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agohosts.5: Clarify capability for IPv6 outside of examples
Thomas Bartelsmeier [Mon, 29 Jun 2020 15:07:16 +0000 (17:07 +0200)] 
hosts.5: Clarify capability for IPv6 outside of examples

Resolves https://bugzilla.kernel.org/show_bug.cgi?id=208279

Signed-off-by: Thomas Bartelsmeier <t.bartelsmeier@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agostrfromd.3: wfix (null character --> null byte)
Michael Kerrisk [Mon, 29 Jun 2020 20:30:07 +0000 (22:30 +0200)] 
strfromd.3: wfix (null character --> null byte)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoiopl.2: Minor tweaks to Thomas Piekarski's patch
Michael Kerrisk [Mon, 29 Jun 2020 11:46:00 +0000 (13:46 +0200)] 
iopl.2: Minor tweaks to Thomas Piekarski's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoiopl.2: Updating description of permissions and disabling interrupts
Thomas Piekarski [Fri, 26 Jun 2020 20:29:23 +0000 (22:29 +0200)] 
iopl.2: Updating description of permissions and disabling interrupts

Update description of permissions for port-mapped I/O set
per-thread and not per-process. Mention that iopl() can not
disable interrupts since Linux 5.5 anymore and is in general
deprecated and only provided for legacy X servers.

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

Reported-by: victorm007@yahoo.com
Signed-off-by: Thomas Piekarski <t.piekarski@deloquencia.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoprctl.2: srcfix: add various people to copyright
Michael Kerrisk [Fri, 26 Jun 2020 11:42:48 +0000 (13:42 +0200)] 
prctl.2: srcfix: add various people to copyright

Based on git history.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoprctl.2: Minor fixes to Dave Martin's patch
Michael Kerrisk [Fri, 26 Jun 2020 11:21:15 +0000 (13:21 +0200)] 
prctl.2: Minor fixes to Dave Martin's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoprctl.2: Add tagged address ABI control prctls (arm64)
Dave Martin [Wed, 24 Jun 2020 17:36:02 +0000 (18:36 +0100)] 
prctl.2: Add tagged address ABI control prctls (arm64)

Add documentation for the the PR_SET_TAGGED_ADDR_CTRL and
PR_GET_TAGGED_ADDR_CTRL prctls added in Linux 5.4 for arm64.

Signed-off-by: Dave Martin <Dave.Martin@arm.com>
Reviewed-by: Catalin Marinas <catalin.marinas@arm.com>
Cc: Vincenzo Frascino <vincenzo.frascino@arm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoprctl.2: Minor tweaks to Dave Martin's patch
Michael Kerrisk [Fri, 26 Jun 2020 11:13:19 +0000 (13:13 +0200)] 
prctl.2: Minor tweaks to Dave Martin's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoprctl.2: Add SVE prctls (arm64)
Dave Martin [Wed, 24 Jun 2020 17:36:01 +0000 (18:36 +0100)] 
prctl.2: Add SVE prctls (arm64)

Add documentation for the the PR_SVE_SET_VL and PR_SVE_GET_VL
prctls added in Linux 4.15 for arm64.

Signed-off-by: Dave Martin <Dave.Martin@arm.com>
Cc: Catalin Marinas <catalin.marinas@arm.com>
Cc: Will Deacon <will@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agolocale.5: srcfix
Michael Kerrisk [Fri, 26 Jun 2020 09:34:20 +0000 (11:34 +0200)] 
locale.5: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agolocale.5: tfix
Michael Kerrisk [Fri, 26 Jun 2020 09:33:41 +0000 (11:33 +0200)] 
locale.5: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agocciss.4: tfix
Michael Kerrisk [Fri, 26 Jun 2020 09:29:02 +0000 (11:29 +0200)] 
cciss.4: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoclone.2: tfix
Michael Kerrisk [Fri, 26 Jun 2020 09:17:44 +0000 (11:17 +0200)] 
clone.2: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agosemctl.2: tfix
Michael Kerrisk [Fri, 26 Jun 2020 09:15:53 +0000 (11:15 +0200)] 
semctl.2: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agosync.2: Minor fixes
Michael Kerrisk [Fri, 26 Jun 2020 09:08:19 +0000 (11:08 +0200)] 
sync.2: Minor fixes

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agosync.2: Minor tweaks to Jeff Layton's patch
Michael Kerrisk [Fri, 26 Jun 2020 09:07:30 +0000 (11:07 +0200)] 
sync.2: Minor tweaks to Jeff Layton's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agosync.2: syncfs() now returns errors if writeback fails
Jeff Layton [Thu, 25 Jun 2020 23:37:31 +0000 (19:37 -0400)] 
sync.2: syncfs() now returns errors if writeback fails

A patch has been merged for v5.8 that changes how syncfs() reports
errors. Change the sync() manpage accordingly.

Signed-off-by: Jeff Layton <jlayton@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agotcp.7: tfix
Philip Adams [Fri, 26 Jun 2020 04:46:34 +0000 (00:46 -0400)] 
tcp.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agogethostid.3: wfix: s/is intended/was intended/
Michael Kerrisk [Thu, 25 Jun 2020 19:35:44 +0000 (21:35 +0200)] 
gethostid.3: wfix: s/is intended/was intended/

The host ID might once have been intended to be globally unique,
but that turned out not to feasible.

Reported-by: Rich Felker <dalias@libc.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agold.so.8: Explain than empty entry in LD_LIBRARY_PATH means cwd
Arkadiusz Drabczyk [Tue, 23 Jun 2020 22:59:10 +0000 (00:59 +0200)] 
ld.so.8: Explain than empty entry in LD_LIBRARY_PATH means cwd

If this was ever going to change the test case is very simple:

$ cd /tmp
$ touch libc.so.6
$ LD_LIBRARY_PATH=: sh
sh: error while loading shared libraries: libc.so.6: file too short

Signed-off-by: Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoip.7: Remove mention of ipfw(4) which was in long obsolete ipchains project
Michael Kerrisk [Thu, 25 Jun 2020 07:00:59 +0000 (09:00 +0200)] 
ip.7: Remove mention of ipfw(4) which was in long obsolete ipchains project

Reported-by: Stephen Hemminger <stephen@networkplumber.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agommap.2: tfix
Michael Kerrisk [Thu, 25 Jun 2020 06:10:21 +0000 (08:10 +0200)] 
mmap.2: tfix

Reported-by: Bruno Haible <bruno@clisp.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agocapabilities.7: Clarify that CAP_SYS_NICE relates to *lowering* the nice value
Dan Kenigsberg [Wed, 24 Jun 2020 11:43:06 +0000 (13:43 +0200)] 
capabilities.7: Clarify that CAP_SYS_NICE relates to *lowering* the nice value

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agostandards.7: Add an entry for POSIX.1-1988
Michael Kerrisk [Wed, 24 Jun 2020 11:20:45 +0000 (13:20 +0200)] 
standards.7: Add an entry for POSIX.1-1988

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agostandards.7: Correct various details in the explanation of XPG/POSIX/SUS
Michael Kerrisk [Wed, 24 Jun 2020 11:06:26 +0000 (13:06 +0200)] 
standards.7: Correct various details in the explanation of XPG/POSIX/SUS

As reported by mail from Geoff Clare, there are some details that
need correcting:

Subject: standards(7) (was: man-pages-5.07 released)
Date: Wed, 10 Jun 2020 10:53:14 +0100
From: Geoff Clare <gwc@opengroup.org>

...

The first isn't really a problem, just an oddity. You list
POSIX.1b as "formerly known as POSIX.4", but you don't do the
equivalent for POSIX.1c ("formerly known as POSIX.4a").

There are several problems with the XPG3 entry:

    "first significant release" - although I suppose XPG3 could
    be considered more significant than XPG2 because it was the
    first one to incorporate POSIX.1, I don't think it's fair to
    imply that XPG2 was not significant.  (E.g. XPG2 was
    significant in that it was the first release to include
    I18N, and the first that had a conformance test suite.)

    "produced by the X/Open Company, a multivendor consortium" -
    this conflates two different things called X/Open. X/Open
    Company Limited is the UK company that did the editing work,
    organised meetings, etc. X/Open Group is the consortium
    whose members developed the technical content.

    "This multivolume guide was based on the POSIX standards" -
    at the time there was only one POSIX standard, namely
    POSIX.1-1988.  The first release to incorporate POSIX.2 was
    XPG4 (which you may consider worth noting in the XPG4
    entry).

To fix these problems I would suggest changing the entry to:

XPG3  Released in 1989, this was the first release of the X/Open
      Portability Guide to be based on a POSIX standard
      (POSIX.1-1988).  This multivolume guide was developed by the
      X/Open Group, a multivendor consortium.

Under SUSv2 I would suggest changing:

    Sometimes also referred to as XPG5.

to:

    Sometimes also referred to (incorrectly) as XPG5.

Under POSIX.1-2001, SUSv3: "XSI conformance constitutes the Single
UNIX Specification version 3 (SUSv3)" is problematic.  I think I
touched on this in the previous discussion. I would suggest
deleting that sentence and instead inserting, before "Two
Technical Corrigenda ...", the following:

    The Single UNIX Specification version 3 (SUSv3) comprises the
    Base Specifications containing XBD, XSH, XCU and XRAT as
    above, plus X/Open Curses Issue 4 version 2 as an extra volume
    that is not in POSIX.1-2001.

Something similar is needed in the POSIX.1-2008, SUSv4 entry where
it talks about "the same four parts". The extra volume this time
is X/Open Curses Issue 7.
]]

Cowritten-by: Geoff Clare <gwc@opengroup.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agocapabilities.7: srcfix
Michael Kerrisk [Wed, 24 Jun 2020 10:02:18 +0000 (12:02 +0200)] 
capabilities.7: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agocapabilities.7: tfix
Michael Kerrisk [Wed, 24 Jun 2020 10:01:06 +0000 (12:01 +0200)] 
capabilities.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agocapabilities.7: Clarify wording around increasing process nice value
Michael Kerrisk [Wed, 24 Jun 2020 09:59:49 +0000 (11:59 +0200)] 
capabilities.7: Clarify wording around increasing process nice value

The fact that a more negative nice value means higher
priority is a continuing source of confusion.

Reported-by: Dan Kenigsberg <danken@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agozic.8: ffix
Michael Kerrisk [Mon, 27 Apr 2020 05:26:47 +0000 (07:26 +0200)] 
zic.8: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agozic.8: Sync to 2020a tzdb release
Michael Kerrisk [Mon, 27 Apr 2020 05:24:29 +0000 (07:24 +0200)] 
zic.8: Sync to 2020a tzdb release

From https://www.iana.org/time-zones, version 2020a.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agosysctl.2: glibc removed support for sysctl() starting in version 2.32
Michael Kerrisk [Tue, 23 Jun 2020 19:26:51 +0000 (21:26 +0200)] 
sysctl.2: glibc removed support for sysctl() starting in version 2.32

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoconnect.2, pidfd_send_signal.2, ptrace.2, socket.7: ffix
Michael Kerrisk [Sun, 21 Jun 2020 07:26:30 +0000 (09:26 +0200)] 
connect.2, pidfd_send_signal.2, ptrace.2, socket.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoman3/*: srcfix: fix warnings from "mandoc -Tlint"
Bjarni Ingi Gislason [Sat, 20 Jun 2020 20:43:49 +0000 (20:43 +0000)] 
man3/*: srcfix: fix warnings from "mandoc -Tlint"

Remove superfluous paragraph macros.

Remove request ".br" if it precedes a line, that begins with a
space, as such lines automatically cause a break.

There is no change in the output from "nroff" and "groff".

###

Examples of warnings from "mandoc -Tlint":

mandoc: bindresvport.3:41:2: WARNING: skipping paragraph macro: PP after SH

mandoc: crypt.3:228:2: WARNING: skipping paragraph macro: PP empty

mandoc: dlinfo.3:151:2: WARNING: skipping paragraph macro: IP empty

mandoc: exec.3:86:2: WARNING: skipping paragraph macro: PP after SS

mandoc: getsubopt.3:45:2: WARNING: skipping paragraph macro: br before text line with leading blank

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoman2/*: srcfix: fix warnings from "mandoc -Tlint"
Bjarni Ingi Gislason [Sat, 20 Jun 2020 19:29:31 +0000 (19:29 +0000)] 
man2/*: srcfix: fix warnings from "mandoc -Tlint"

  Remove superfluous paragraph macros.

  Remove ".br" if it is before a line that starts with a space
character, as such lines automatically cause a break.

###

  The output is unchanged, except two empty lines are added at the
bottom (before the footer line) in the output of "nroff" for the files
"alloc_hugepages.2" and "userfaultfd.2".

###

  Examples of warnings from "mandoc -Tlint":

mandoc: access.2:283:2: WARNING: skipping paragraph macro: PP after SH

mandoc: adjtimex.2:185:2: WARNING: skipping paragraph macro: PP empty

mandoc: futex.2:728:2: WARNING: skipping paragraph macro: IP empty

mandoc: getsid.2:48:2: WARNING: skipping paragraph macro: br before text line with leading blank

mandoc: init_module.2:290:2: WARNING: skipping paragraph macro: PP after SS

mandoc: ioctl_fideduperange.2:27:2: WARNING: skipping paragraph macro: br after SH

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoman7/*: srcfix: trim trailing space
Bjarni Ingi Gislason [Sat, 20 Jun 2020 17:06:40 +0000 (17:06 +0000)] 
man7/*: srcfix: trim trailing space

  Trim tailing space in "strings".

  There is no change in the output from "nroff" and "groff".

###

Output is from: test-groff -b -mandoc -T utf8 -rF0 -t -w w -z

  [ "test-groff" is a developmental version of "groff" ]

troff: <attributes.7>:510: warning: trailing space
troff: <attributes.7>:512: warning: trailing space
troff: <attributes.7>:513: warning: trailing space
troff: <attributes.7>:516: warning: trailing space
troff: <attributes.7>:649: warning: trailing space
troff: <attributes.7>:681: warning: trailing space
troff: <attributes.7>:720: warning: trailing space
####

troff: <environ.7>:181: warning: trailing space
troff: <environ.7>:182: warning: trailing space
####

troff: <ip.7>:820: warning: trailing space
####

troff: <signal.7>:316: warning: trailing space
Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
####

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoproc.5: srcfix: trim trailing space
Bjarni Ingi Gislason [Sat, 20 Jun 2020 16:03:38 +0000 (16:03 +0000)] 
proc.5: srcfix: trim trailing space

Output is from: test-groff -b -mandoc -T utf8 -rF0 -t -w w -z

  [ "test-groff" is a developmental version of "groff" ]

Input file is ./proc.5

troff: <proc.5>:4410: warning: trailing space
troff: <proc.5>:5206: warning: trailing space
troff: <proc.5>:5488: warning: trailing space

###

  There is no change in the output from "nroff" and "groff".

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoman4/*: srcfix: remove trailing space in "strings"
Bjarni Ingi Gislason [Sat, 20 Jun 2020 15:39:48 +0000 (15:39 +0000)] 
man4/*: srcfix: remove trailing space in "strings"

Trim trailing space.

There is no change in the output from "nroff" and "groff".

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agofstatvfs.2, getcontext.2, getcwd.2, gethostid.2, killpg.2, mq_notify.2, mq_open.2...
Michael Kerrisk [Sat, 20 Jun 2020 07:24:32 +0000 (09:24 +0200)] 
fstatvfs.2, getcontext.2, getcwd.2, gethostid.2, killpg.2, mq_notify.2, mq_open.2, mq_timedreceive.2, mq_timedsend.2, mq_unlink.2, setcontext.2, sethostid.2, statvfs.2: Remove historical .so links

These links were mostly created when pages were moved between
sections, in almost every case several years ago. The idea
was to allow people time to get used to the new section numbers
while still having commands of the form "man <sec> <page>"
work as before. Let's assume that people have now had time to
get used to the new section numbers, and remove these links.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agogetdtablesize.2, sigqueue.2, clock_getres.3, clock_gettime.3, clock_settime.3, attr...
Michael Kerrisk [Fri, 19 Jun 2020 18:50:47 +0000 (20:50 +0200)] 
getdtablesize.2, sigqueue.2, clock_getres.3, clock_gettime.3, clock_settime.3, attr.5, numa_maps.5: Remove old links

These are all links that were created several years ago, mainly
when pages were migrated to different sections, in order to
allow the 'man' commands using the old section numbers to work.
However, the plan was always to eventually remove them, after
allowing people who cared to get used to the new section numbers.
Now, after 5+ years in each case, it's time to remove
these links.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agosymlink.7: Minor fixes to Aleksa Sarai's patch
Michael Kerrisk [Fri, 19 Jun 2020 12:54:27 +0000 (14:54 +0200)] 
symlink.7: Minor fixes to Aleksa Sarai's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agosymlink.7: Document magic links more completely
Aleksa Sarai [Wed, 10 Jun 2020 05:53:19 +0000 (15:53 +1000)] 
symlink.7: Document magic links more completely

Traditionally, magic links have not been a well-understood topic
in Linux. This helps clarify some of the terminology used in
openat2.2.

Signed-off-by: Aleksa Sarai <cyphar@cyphar.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agokeyctl.2: Declare auth_key
Oleksandr Kravchuk [Fri, 12 Jun 2020 15:35:33 +0000 (17:35 +0200)] 
keyctl.2: Declare auth_key

The variable is used in the code example, but not declared,
leading to a compilation error.

Signed-off-by: Oleksandr Kravchuk <open.source@oleksandr-kravchuk.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agofread.3: srcfix: remove crufty line
Michael Kerrisk [Fri, 19 Jun 2020 12:38:11 +0000 (14:38 +0200)] 
fread.3: srcfix: remove crufty line

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agofread.3: Add example
Arkadiusz Drabczyk [Thu, 18 Jun 2020 14:22:32 +0000 (16:22 +0200)] 
fread.3: Add example

Signed-off-by: Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agofread.3: Explain that file position is moved after calling fread()/fwrite()
Arkadiusz Drabczyk [Tue, 16 Jun 2020 22:15:20 +0000 (00:15 +0200)] 
fread.3: Explain that file position is moved after calling fread()/fwrite()

Corresponding manpage on FreeBSD already contains that
information.

Signed-off-by: Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoatoi.3: Minor tweaks to Arkadiusz Drabczyk's patch
Michael Kerrisk [Fri, 19 Jun 2020 12:23:38 +0000 (14:23 +0200)] 
atoi.3: Minor tweaks to Arkadiusz Drabczyk's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoatoi.3: Relocate BUGS section
Michael Kerrisk [Fri, 19 Jun 2020 12:22:18 +0000 (14:22 +0200)] 
atoi.3: Relocate BUGS section

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoatoi.3: Add NOTES section explaining 0 return value on error
Michael Kerrisk [Fri, 19 Jun 2020 12:19:27 +0000 (14:19 +0200)] 
atoi.3: Add NOTES section explaining 0 return value on error

And note that this is not specified by POSIX.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoatoi.3: Explain disadvantages of atoi()
Arkadiusz Drabczyk [Thu, 18 Jun 2020 20:42:41 +0000 (22:42 +0200)] 
atoi.3: Explain disadvantages of atoi()

I believe new users should be discouraged from using atoi() and
that its disadvantages should be explained.

I added the information that 0 is returned on error - although C
standard and POSIX say that "If the value of the result cannot be
represented, the behavior is undefined." there are some
interpretations that 0 has to be returned
https://stackoverflow.com/questions/38393162/what-can-i-assume-about-the-behaviour-of-atoi-on-error
and this is also what happens in practice with glibc, musl and
uClibc.

Signed-off-by: Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoproc.5: Inform that comm in /proc/pid/{stat,status} might also be truncated
Arkadiusz Drabczyk [Wed, 17 Jun 2020 20:51:25 +0000 (22:51 +0200)] 
proc.5: Inform that comm in /proc/pid/{stat,status} might also be truncated

pgrep for example searches for a process name in /proc/pid/status
and therefore cannot find processes whose names are longer than 15
characters unless -f is specified.

Signed-off-by: Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoman-pages.7: wfix
Jakub Wilk [Thu, 18 Jun 2020 21:26:49 +0000 (23:26 +0200)] 
man-pages.7: wfix

Reorder full wordings to match the order of abbreviations.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agosetns.2: ERRORS: add ESRCH for PID FD that refers to a terminated process
Michael Kerrisk [Mon, 15 Jun 2020 20:41:49 +0000 (22:41 +0200)] 
setns.2: ERRORS: add ESRCH for PID FD that refers to a terminated process

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agosetns.2: Minor wording fixes
Michael Kerrisk [Mon, 15 Jun 2020 20:16:32 +0000 (22:16 +0200)] 
setns.2: Minor wording fixes

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agosetns.2: wfix
Michael Kerrisk [Mon, 15 Jun 2020 20:12:42 +0000 (22:12 +0200)] 
setns.2: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agosetns.2: Minor tweak
Michael Kerrisk [Mon, 15 Jun 2020 14:32:52 +0000 (16:32 +0200)] 
setns.2: Minor tweak

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agosetns.2: Document the use of PID file descriptors with setns()
Michael Kerrisk [Mon, 15 Jun 2020 14:23:49 +0000 (16:23 +0200)] 
setns.2: Document the use of PID file descriptors with setns()

Starting with Linux 5.8, setns() can take a PID file descriptor as
an argument, and move the caller into or more of the namespaces of
the thread referred to by that descriptor.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agopidfd_open.2: Add the setns(2) use case for PID file descriptors
Michael Kerrisk [Mon, 15 Jun 2020 13:04:16 +0000 (15:04 +0200)] 
pidfd_open.2: Add the setns(2) use case for PID file descriptors

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agopidfd_open.2: ffix
Michael Kerrisk [Mon, 15 Jun 2020 13:02:05 +0000 (15:02 +0200)] 
pidfd_open.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agosetns.2: It is possible to setns() to the caller's current PID namespace
Michael Kerrisk [Mon, 15 Jun 2020 10:01:31 +0000 (12:01 +0200)] 
setns.2: It is possible to setns() to the caller's current PID namespace

The page currently incorrectly says that 'fd' must refer to
a descendant PID namespace. However, 'fd' can also refer to
the caller's current PID namespace. Verified by experiment,
and also comments in kernel/pid_namespace.c (Linux 5.8-rc1).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoVarious pages: srcfix: trim a trailing space
Bjarni Ingi Gislason [Fri, 12 Jun 2020 19:57:42 +0000 (19:57 +0000)] 
Various pages: srcfix: trim a trailing space

Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z

  [ "test-groff" is a developmental version of "groff" ]

  There is no change in the output of "nroff" and "groff".

####

troff: <fts.3>:50: warning: trailing space
####

troff: <getgrnam.3>:175: warning: trailing space
####

troff: <getpwnam.3>:181: warning: trailing space
####

troff: <rcmd.3>:52: warning: trailing space
troff: <rcmd.3>:57: warning: trailing space
troff: <rcmd.3>:60: warning: trailing space
troff: <rcmd.3>:63: warning: trailing space
troff: <rcmd.3>:69: warning: trailing space
troff: <rcmd.3>:73: warning: trailing space
####

troff: <rexec.3>:48: warning: trailing space
troff: <rexec.3>:51: warning: trailing space
####

troff: <sem_open.3>:36: warning: trailing space

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoopenat2.2: ffix
Michael Kerrisk [Fri, 12 Jun 2020 19:54:55 +0000 (21:54 +0200)] 
openat2.2: ffix

Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agopidfd_getfd.2: srcfix
Michael Kerrisk [Fri, 12 Jun 2020 19:47:21 +0000 (21:47 +0200)] 
pidfd_getfd.2: srcfix

Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agomadvise.2: tfix
Michael Kerrisk [Fri, 12 Jun 2020 19:46:21 +0000 (21:46 +0200)] 
madvise.2: tfix

Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agotimer_create.2, timerfd_create.2: tfix
Michael Kerrisk [Fri, 12 Jun 2020 19:44:55 +0000 (21:44 +0200)] 
timer_create.2, timerfd_create.2: tfix

Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agotimerfd_create.2: tfix
Michael Kerrisk [Fri, 12 Jun 2020 19:44:15 +0000 (21:44 +0200)] 
timerfd_create.2: tfix

Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agoman2/*: srcfix: trim trailing space
Bjarni Ingi Gislason [Fri, 12 Jun 2020 03:23:23 +0000 (03:23 +0000)] 
man2/*: srcfix: trim trailing space

  Remove superfluous space at the end of a processed input line.

  There is no change in the output from "nroff" and "groff".

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agotime.1: ffix: correct a three-fonts line in SYNOPSIS
Bjarni Ingi Gislason [Fri, 12 Jun 2020 02:22:31 +0000 (02:22 +0000)] 
time.1: ffix: correct a three-fonts line in SYNOPSIS

  The current version shows the square brackets, '[' and ']', in
boldface.

  Use the '\c' escape sequence (function) to join the output of two
macros.

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agocapabilities.7: Document CAP_BPF
Michael Kerrisk [Fri, 12 Jun 2020 10:15:02 +0000 (12:15 +0200)] 
capabilities.7: Document CAP_BPF

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agocapabilities.7: srcfix
Michael Kerrisk [Fri, 12 Jun 2020 09:51:50 +0000 (11:51 +0200)] 
capabilities.7: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agocapabilities.7: Add CAP_PERFMON
Michael Kerrisk [Fri, 12 Jun 2020 09:50:57 +0000 (11:50 +0200)] 
capabilities.7: Add CAP_PERFMON

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
5 years agosyscalls.2: Add faccessat2(), added in Linux 5.8
Michael Kerrisk [Fri, 12 Jun 2020 09:15:10 +0000 (11:15 +0200)] 
syscalls.2: Add faccessat2(), added in Linux 5.8

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>