]> git.ipfire.org Git - thirdparty/man-pages.git/log
thirdparty/man-pages.git
4 years agopthread_attr_setdetachstate.3: ffix
Michael Kerrisk [Sun, 20 Dec 2020 10:56:07 +0000 (11:56 +0100)] 
pthread_attr_setdetachstate.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosetns.2: ffix
Michael Kerrisk [Sun, 20 Dec 2020 10:54:31 +0000 (11:54 +0100)] 
setns.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoelf.5: ffix
Michael Kerrisk [Fri, 18 Dec 2020 20:16:53 +0000 (21:16 +0100)] 
elf.5: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoperf_event_open.2: tfix
Michael Kerrisk [Wed, 16 Dec 2020 14:51:34 +0000 (15:51 +0100)] 
perf_event_open.2: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agomount_namespaces.7: ffix
Michael Kerrisk [Wed, 16 Dec 2020 13:36:22 +0000 (14:36 +0100)] 
mount_namespaces.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agostrtol.3: tfix
John A. Leuenhagen [Tue, 15 Dec 2020 03:03:59 +0000 (22:03 -0500)] 
strtol.3: tfix

Signed-off-by: John A. Leuenhagen <john@zlima12.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoelf.5: srcfix
Michael Kerrisk [Sun, 13 Dec 2020 09:46:47 +0000 (10:46 +0100)] 
elf.5: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoelf.5: SEE ALSO: add objcopy(1)
Michael Kerrisk [Sun, 13 Dec 2020 09:45:43 +0000 (10:45 +0100)] 
elf.5: SEE ALSO: add objcopy(1)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agotcp.7: tcp_syncookies: It is now an integer [0, 2]
Alejandro Colomar [Fri, 11 Dec 2020 18:47:10 +0000 (19:47 +0100)] 
tcp.7: tcp_syncookies: It is now an integer [0, 2]

Since Linux kernel 3.12, tcp_syncookies can have the value 2,
which sends out cookies unconditionally.

Related kernel commits:
5ad37d5deee1ff7150a2d0602370101de158ad86
d8513df2598e5142f8a5c4724f28411936e1dfc7

Reported-by: Philip Rowlands <linux-kernel@dimebar.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Cc: Eric Dumazet <eric.dumazet@gmail.com>
Cc: Hannes Frederic Sowa <hannes@stressinduktion.org>
Cc: David S. Miller <davem@davemloft.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agomodf.3: tfix
Michael Kerrisk [Thu, 3 Dec 2020 09:47:48 +0000 (10:47 +0100)] 
modf.3: tfix

See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=976312

Reported-by: Bill Allombert <ballombe@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agokeyctl.2: tfix
Arusekk [Tue, 1 Dec 2020 14:40:26 +0000 (15:40 +0100)] 
keyctl.2: tfix

Fixes: fa76da808eff
Signed-off-by: Arusekk <arek_koz@o2.pl>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agostrnlen.3: Fix a small inconsistency in the text
Michael Kerrisk [Sat, 28 Nov 2020 09:00:23 +0000 (10:00 +0100)] 
strnlen.3: Fix a small inconsistency in the text

Quoting Heinrich:

    The strnlen.3 manpage has the following sentence:

    "In doing this, strnlen() looks only at the first maxlen
    characters in the string pointed to by s and never beyond
    s+maxlen."

    This sentence is self-contradictory:

    The last visited character implied by "first maxlen
    characters" is s[maxlen-1].

    Given that "beyond a" does not include "a", the last visited
    character implied by "never beyond s+maxlen" is s[maxlen].

    A consistent sentence would be

    "In doing this, strnlen() looks only at the first maxlen
    characters in the string pointed to by s and never beyond
    s+maxlen-1."

    I would prefer

    "In doing this, strnlen() looks only at the first maxlen
    characters in the string pointed to by s and never beyond
    s[maxlen-1]"

Reported-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosubpage_prot.2: SYNOPSIS: Fix return type: s/long/int/
Alejandro Colomar [Fri, 27 Nov 2020 23:44:18 +0000 (00:44 +0100)] 
subpage_prot.2: SYNOPSIS: Fix return type: s/long/int/

The Linux kernel uses 'int' instead of 'long' for the return type.
As glibc provides no wrapper, use the same type the kernel uses.

......

$ grep -n wrapper man-pages/man2/subpage_prot.2
40:There is no glibc wrapper for this system call; see NOTES.
99:Glibc does not provide a wrapper for this system call; call it using

$ grep -rn SYSCALL_DEFINE.*subpage_prot linux/;
linux/arch/powerpc/mm/book3s64/subpage_prot.c:190:
SYSCALL_DEFINE3(subpage_prot, unsigned long, addr,

$ sed -n /SYSCALL.*subpage_prot/,/^}/p \
  linux/arch/powerpc/mm/book3s64/subpage_prot.c \
  |grep return;
return -ENOENT;
return -EINVAL;
return -EINVAL;
return 0;
return -EFAULT;
return -EFAULT;
return err;

$ sed -n /SYSCALL.*subpage_prot/,/^}/p \
  linux/arch/powerpc/mm/book3s64/subpage_prot.c \
  |grep '\<err\>';
int err;
err = -ENOMEM;
err = -ENOMEM;
err = 0;
return err;

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agospu_create.2: Clarify that spu_create() now has 4 arguments but once had only 3
Michael Kerrisk [Fri, 27 Nov 2020 10:15:14 +0000 (11:15 +0100)] 
spu_create.2: Clarify that spu_create() now has 4 arguments but once had only 3

Reported-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agospu_create.2: Relocate paragraph on 'mode' argument
Michael Kerrisk [Fri, 27 Nov 2020 10:05:44 +0000 (11:05 +0100)] 
spu_create.2: Relocate paragraph on 'mode' argument

This paragraph is a little bit hidden at the end of DESCRIPTION;
make it a little more prominent.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agospu_create.2: Add kernel version numbers for SPU_CREATE_AFFINITY_SPU/_MEM
Michael Kerrisk [Fri, 27 Nov 2020 09:13:35 +0000 (10:13 +0100)] 
spu_create.2: Add kernel version numbers for SPU_CREATE_AFFINITY_SPU/_MEM

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agospu_run.2: srcfix
Michael Kerrisk [Fri, 27 Nov 2020 09:05:38 +0000 (10:05 +0100)] 
spu_run.2: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogetpriority.2: wfix
Michael Kerrisk [Fri, 27 Nov 2020 08:29:12 +0000 (09:29 +0100)] 
getpriority.2: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogetpriority.2: ffix
Michael Kerrisk [Fri, 27 Nov 2020 08:28:11 +0000 (09:28 +0100)] 
getpriority.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolink.2: ffix
Michael Kerrisk [Thu, 26 Nov 2020 12:52:10 +0000 (13:52 +0100)] 
link.2: ffix

Reported-by: Alejandro Colomar (man-pages) <alx.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolink.2: ERRORS: add ENOENT when target is deleted
Mathias Rav [Wed, 25 Nov 2020 13:27:32 +0000 (14:27 +0100)] 
link.2: ERRORS: add ENOENT when target is deleted

Linux kernel commit aae8a97d3ec30788790d1720b71d76fd8eb44b73 (part
of kernel release v2.6.39) added a check to disallow creating a
hardlink to an unlinked file.

The manual page already describes the trick of using
AT_SYMLINK_FOLLOW as an alternative to AT_EMPTY_PATH, and for
AT_EMPTY_PATH the manual page already notes that it "will
generally not work if the file has a link count of zero". However,
the precise error (ENOENT) is not mentioned, and the error case
isn't mentioned in the ERRORS section at all.

This makes it easy to overlook the fact that the AT_SYMLINK_FOLLOW
trick on /proc/self/fd/NN won't work on deleted files, as
evidenced by the follow message (which turns up when googling
"linkat deleted ENOENT"):
https://groups.google.com/g/linux.kernel/c/zZO4lqqwp64

Signed-off-by: Mathias Rav <m@git.strova.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agofanotify.7: fix outdated description
Amir Goldstein [Tue, 24 Nov 2020 15:21:09 +0000 (17:21 +0200)] 
fanotify.7: fix outdated description

Reviewed-by: Jan Kara <jack@suse.cz>
Signed-off-by: Amir Goldstein <amir73il@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agopivot_root.2: tfix
Michael Kerrisk [Thu, 26 Nov 2020 09:30:35 +0000 (10:30 +0100)] 
pivot_root.2: tfix

Reported-by: Davide Giorgio <davide@giorgiodavide.it>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogetrusage.2: Note that the 'vtimes' symbol exists only up to glibc 2.32
Michael Kerrisk [Wed, 25 Nov 2020 22:42:44 +0000 (23:42 +0100)] 
getrusage.2: Note that the 'vtimes' symbol exists only up to glibc 2.32

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoset_tid_address.2: SYNOPSIS: Fix set_tid_address() return type
Alejandro Colomar [Mon, 23 Nov 2020 21:59:12 +0000 (22:59 +0100)] 
set_tid_address.2: SYNOPSIS: Fix set_tid_address() return type

The Linux kernel uses 'pid_t' instead of 'long' for the return type.
As glibc provides no wrapper, use the same types the kernel uses.

$ sed -n 34,36p man-pages/man2/set_tid_address.2
.PP
.IR Note :
There is no glibc wrapper for this system call; see NOTES.

$ grep -rn 'SYSCALL_DEFINE.*set_tid_address' linux/
linux/kernel/fork.c:1632:
SYSCALL_DEFINE1(set_tid_address, int __user *, tidptr)

$ sed -n 1632,1638p linux/kernel/fork.c
SYSCALL_DEFINE1(set_tid_address, int __user *, tidptr)
{
current->clear_child_tid = tidptr;

return task_pid_vnr(current);
}

$ grep -rn 'task_pid_vnr(struct' linux/
linux/include/linux/sched.h:1374:
static inline pid_t task_pid_vnr(struct task_struct *tsk)

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agorestart_syscall.2: SYNOPSIS: Fix restart_syscall() return type
Alejandro Colomar [Mon, 23 Nov 2020 20:34:46 +0000 (21:34 +0100)] 
restart_syscall.2: SYNOPSIS: Fix restart_syscall() return type

The Linux kernel uses 'long' instead of 'int' for the return type.
As glibc provides no wrapper, use the same types the kernel uses.

$ grep -rn 'SYSCALL_DEFINE.*(restart_syscall'
kernel/signal.c:2891:SYSCALL_DEFINE0(restart_syscall)

$ sed -n 2891,2895p kernel/signal.c
SYSCALL_DEFINE0(restart_syscall)
{
struct restart_block *restart = &current->restart_block;
return restart->fn(restart);
}

$ grep -rn 'struct restart_block {'
include/linux/restart_block.h:25:struct restart_block {

$ sed -n 25,56p include/linux/restart_block.h
struct restart_block {
long (*fn)(struct restart_block *);
union {
/* For futex_wait and futex_wait_requeue_pi */
struct {
u32 __user *uaddr;
u32 val;
u32 flags;
u32 bitset;
u64 time;
u32 __user *uaddr2;
} futex;
/* For nanosleep */
struct {
clockid_t clockid;
enum timespec_type type;
union {
struct __kernel_timespec __user *rmtp;
struct old_timespec32 __user *compat_rmtp;
};
u64 expires;
} nanosleep;
/* For poll */
struct {
struct pollfd __user *ufds;
int nfds;
int has_timeout;
unsigned long tv_sec;
unsigned long tv_nsec;
} poll;
};
};

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoattributes.7: SEE ALSO: add signal-safety(7)
Michael Kerrisk [Mon, 23 Nov 2020 12:35:04 +0000 (13:35 +0100)] 
attributes.7: SEE ALSO: add signal-safety(7)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolseek64.3: tfix
Michael Kerrisk [Mon, 23 Nov 2020 12:28:12 +0000 (13:28 +0100)] 
lseek64.3: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agopthread_tryjoin_np.3: Note that pthread_timedjoin_np() uses CLOCK_REALTIME, but there...
Michael Kerrisk [Mon, 23 Nov 2020 09:32:03 +0000 (10:32 +0100)] 
pthread_tryjoin_np.3: Note that pthread_timedjoin_np() uses CLOCK_REALTIME, but there's a bug

Learned from an email converasation with Mike Crowe, and
verified by experiment.

Reported-by: Mike Crowe <mac@mcrowe.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agostandards.7: Add LFS (Large File Summit)
Michael Kerrisk [Mon, 23 Nov 2020 09:08:52 +0000 (10:08 +0100)] 
standards.7: Add LFS (Large File Summit)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolseek64.3: NOTES: describe the origin of lseek64() in LFS
Michael Kerrisk [Mon, 23 Nov 2020 09:01:25 +0000 (10:01 +0100)] 
lseek64.3: NOTES: describe the origin of lseek64() in LFS

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolseek64.3: Remove sentence saying lseek64() is an alias for llseek()
Michael Kerrisk [Mon, 23 Nov 2020 08:40:10 +0000 (09:40 +0100)] 
lseek64.3: Remove sentence saying lseek64() is an alias for llseek()

As far as I can see, it is instead simply an alias for a
wrapper that calls _llseek(). Saying it's an alias for "llseek()"
seems confusing.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolseek64.3: Remove section numbers from interface list
Michael Kerrisk [Mon, 23 Nov 2020 08:32:38 +0000 (09:32 +0100)] 
lseek64.3: Remove section numbers from interface list

We're talking of a mix of wrapper functions and system calls
in this page. lseek() is both a system and a wrapper function,
and this page is mostly describing the wrapper

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolseek64.3: wfix
Michael Kerrisk [Mon, 23 Nov 2020 08:27:06 +0000 (09:27 +0100)] 
lseek64.3: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolseek64.3: Minor clarifications
Michael Kerrisk [Mon, 23 Nov 2020 08:20:32 +0000 (09:20 +0100)] 
lseek64.3: Minor clarifications

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolseek64.3: srcfix: add some comments to remind myself of some details
Michael Kerrisk [Mon, 23 Nov 2020 06:26:10 +0000 (07:26 +0100)] 
lseek64.3: srcfix: add some comments to remind myself of some details

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agollseek.2: Point the reader to lseek64(3) for info about llseek(3)
Michael Kerrisk [Mon, 23 Nov 2020 06:18:43 +0000 (07:18 +0100)] 
llseek.2: Point the reader to lseek64(3) for info about llseek(3)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agollseek.2: Note size of 'loff_t' type
Michael Kerrisk [Mon, 23 Nov 2020 06:11:13 +0000 (07:11 +0100)] 
llseek.2: Note size of 'loff_t' type

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolseek64.3: ffix
Michael Kerrisk [Mon, 23 Nov 2020 06:08:12 +0000 (07:08 +0100)] 
lseek64.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogetnameinfo.3: tfix
Michael Kerrisk [Mon, 23 Nov 2020 05:54:02 +0000 (06:54 +0100)] 
getnameinfo.3: tfix

Reported-by: Sebastian Kirmayer <man-pages@kirmayer.eu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolseek64.3: srcfix: Add a lore link to some background on these APIs
Michael Kerrisk [Sun, 22 Nov 2020 23:00:24 +0000 (00:00 +0100)] 
lseek64.3: srcfix: Add a lore link to some background on these APIs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogetnameinfo.3: tfix
Michael Kerrisk [Sun, 22 Nov 2020 22:56:03 +0000 (23:56 +0100)] 
getnameinfo.3: tfix

Reported-by: Sebastian Kirmayer <sebastian@kirmayer.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agollseek.2: Some mild rewriting to ease reading of the info in this page
Michael Kerrisk [Sun, 22 Nov 2020 06:34:56 +0000 (07:34 +0100)] 
llseek.2: Some mild rewriting to ease reading of the info in this page

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agocapget.2, execve.2, readv.2, socketpair.2, utime.2, utimensat.2, getloadavg.3, proc...
Alejandro Colomar [Sat, 21 Nov 2020 22:03:50 +0000 (23:03 +0100)] 
capget.2, execve.2, readv.2, socketpair.2, utime.2, utimensat.2, getloadavg.3, proc.5, mount_namespaces.7, unix.7: ffix

{.IR var [x]} -> {.I var[x]}

There were around 15 entries of the former,
and around 360 of the latter.

Found using:
$ grep -rn '^\.I[ |R].* \[.*\]' |sort

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoutmp.5: Oxford comma
Alejandro Colomar [Sat, 21 Nov 2020 17:39:04 +0000 (18:39 +0100)] 
utmp.5: Oxford comma

Found using:
$ grep -rn '\\f., [^ ]*\\f. and' man?

I also updated the markup in that paragraph: \f -> .

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agofutex.2: tfix
Jing Peng [Sat, 21 Nov 2020 21:08:30 +0000 (16:08 -0500)] 
futex.2: tfix

In the comment of the example program, the peer blocks on fwait()
rather than fpost().

Signed-off-by: Jing Peng <pj.hades@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agostandards.7: Relocate the discussion on POSIX manual pages
Michael Kerrisk [Sat, 21 Nov 2020 06:56:32 +0000 (07:56 +0100)] 
standards.7: Relocate the discussion on POSIX manual pages

Rather than mention these pages under the discussion of one
version of the standard, move that text to the end of the page,
where it is probably a little more obvious.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agostandards.7: Add URL for POSIX.1-2008/SUSv4
Michael Kerrisk [Sat, 21 Nov 2020 06:25:22 +0000 (07:25 +0100)] 
standards.7: Add URL for POSIX.1-2008/SUSv4

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agostandards.7: Fix some URLs for locations of the standards
Michael Kerrisk [Sat, 21 Nov 2020 06:22:51 +0000 (07:22 +0100)] 
standards.7: Fix some URLs for locations of the standards

Reported-by: Rob Landley <rob@landley.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoclock_getres.2: Plae ERRORS in alphabetical order
Michael Kerrisk [Sat, 21 Nov 2020 05:49:25 +0000 (06:49 +0100)] 
clock_getres.2: Plae ERRORS in alphabetical order

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosocket.7: ffix
Michael Kerrisk [Thu, 19 Nov 2020 09:41:47 +0000 (10:41 +0100)] 
socket.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosocket.7: tfix
Michael Kerrisk [Thu, 19 Nov 2020 09:29:25 +0000 (10:29 +0100)] 
socket.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoarch_prctl.2: wfix: "current thread" ==> "calling thread"
Michael Kerrisk [Thu, 19 Nov 2020 09:20:31 +0000 (10:20 +0100)] 
arch_prctl.2: wfix: "current thread" ==> "calling thread"

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoperf_event_open.2: tfix
Michael Kerrisk [Wed, 18 Nov 2020 22:25:41 +0000 (23:25 +0100)] 
perf_event_open.2: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoperf_event_open.2: Minor tweaks
Michael Kerrisk [Wed, 18 Nov 2020 22:17:53 +0000 (23:17 +0100)] 
perf_event_open.2: Minor tweaks

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoperf_event_open.2: Update man page with recent kernel changes
Namhyung Kim [Wed, 18 Nov 2020 12:47:36 +0000 (13:47 +0100)] 
perf_event_open.2: Update man page with recent kernel changes

Signed-off-by: Namhyung Kim <namhyung@gmail.com>
[alx: ffix + tfix]
Cowritten-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Cc: Arnaldo Carvalho de Melo <acme@kernel.org>
Cc: Jiri Olsa <jolsa@redhat.com>
Cc: Ingo Molnar <mingo@kernel.org>
Cc: Peter Zijlstra <peterz@infradead.org>
Cc: Mark Rutland <mark.rutland@arm.com>
Cc: Alexander Shishkin <alexander.shishkin@linux.intel.com>
Cc: Stephane Eranian <eranian@google.com>
Cc: Ian Rogers <irogers@google.com>
Cc: Adrian Hunter <adrian.hunter@intel.com>
Cc: Song Liu <songliubraving@fb.com>
Cc: Kan Liang <kan.liang@linux.intel.com>
Cc: Andi Kleen <ak@linux.intel.com>
Cc: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosignal.7: Add pidfd_send_signal() to list of APIs for sending signals
Michael Kerrisk [Tue, 17 Nov 2020 23:19:44 +0000 (00:19 +0100)] 
signal.7: Add pidfd_send_signal() to list of APIs for sending signals

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosignal.7: ffix
Michael Kerrisk [Tue, 17 Nov 2020 23:15:27 +0000 (00:15 +0100)] 
signal.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosignal.7: Fixes and additions to text on execution of signal handlers
Michael Kerrisk [Tue, 17 Nov 2020 17:04:34 +0000 (18:04 +0100)] 
signal.7: Fixes and additions to text on execution of signal handlers

After comments from Dave Martin.

Reported-by: Dave Martin <Dave.Martin@arm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosigaction.2: Add a cross-reference to signal(7) for further info on 'ucontext_t'
Michael Kerrisk [Tue, 17 Nov 2020 12:18:09 +0000 (13:18 +0100)] 
sigaction.2: Add a cross-reference to signal(7) for further info on 'ucontext_t'

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosignal.7: Mention 'ucontext_t' in the discussion of signal handler execution
Michael Kerrisk [Tue, 17 Nov 2020 12:16:22 +0000 (13:16 +0100)] 
signal.7: Mention 'ucontext_t' in the discussion of signal handler execution

Linking up the info presented on this page with the discussion
in getcontext(3) helps the reader.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agomakecontext.3: Minor rewording
Michael Kerrisk [Tue, 17 Nov 2020 12:11:12 +0000 (13:11 +0100)] 
makecontext.3: Minor rewording

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosignal.7: Fixes to the text of "Execution of signals handlers"
Michael Kerrisk [Tue, 17 Nov 2020 10:43:37 +0000 (11:43 +0100)] 
signal.7: Fixes to the text of "Execution of signals handlers"

See https://lore.kernel.org/linux-man/3fac10ea-7fed-739b-4974-09845f34867f@gmail.com/

Reported-by: Dave Martin <Dave.Martin@arm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogetcontext.3, signal.7: tfix
Michael Kerrisk [Tue, 17 Nov 2020 08:55:02 +0000 (09:55 +0100)] 
getcontext.3, signal.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogetcontext.3: SEE ALSO: add signal(7)
Michael Kerrisk [Tue, 17 Nov 2020 08:53:34 +0000 (09:53 +0100)] 
getcontext.3: SEE ALSO: add signal(7)

The signal(7) manual page has some useful info related
to ucontext_t.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogetcontext.3: Mention SA_SIGINFO flag when talking about 3-argument signal handler
Michael Kerrisk [Mon, 16 Nov 2020 20:54:02 +0000 (21:54 +0100)] 
getcontext.3: Mention SA_SIGINFO flag when talking about 3-argument signal handler

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogetcontext.3: wfix
Michael Kerrisk [Mon, 16 Nov 2020 20:52:17 +0000 (21:52 +0100)] 
getcontext.3: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoAdd script to get modified pages for commit messages
Alejandro Colomar [Mon, 16 Nov 2020 19:42:18 +0000 (20:42 +0100)] 
Add script to get modified pages for commit messages

The script can be used this way:

git commit -sm "$(./scripts/modified_pages.sh): Short commit msg"

And then maybe --amend and add a longer message.

This is especially useful for changes to many pages at once,
usually when running a script to apply some global changes.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agouselib.2, posix_memalign.3, profil.3, rtime.3: Remove some text about libc/libc5
Michael Kerrisk [Mon, 16 Nov 2020 11:20:01 +0000 (12:20 +0100)] 
uselib.2, posix_memalign.3, profil.3, rtime.3: Remove some text about libc/libc5

With this change, there remain almost no vestiges of information
about the long defunct Linux libc.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoioctl_tty.2, matherr.3, cciss.4, sk98lin.4: ffix: use proper table for formatting...
Michael Kerrisk [Mon, 16 Nov 2020 10:17:22 +0000 (11:17 +0100)] 
ioctl_tty.2, matherr.3, cciss.4, sk98lin.4: ffix: use proper table for formatting, not .nf/.fi

This gives better PDF rendering.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agocciss.4: ffix
Michael Kerrisk [Mon, 16 Nov 2020 10:00:53 +0000 (11:00 +0100)] 
cciss.4: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agopidfd_open.2, pidfd_send_signal.2, poll.2, semget.2: ffix: EXAMPLES: use .EX/.EE...
Michael Kerrisk [Mon, 16 Nov 2020 09:52:29 +0000 (10:52 +0100)] 
pidfd_open.2, pidfd_send_signal.2, poll.2, semget.2: ffix: EXAMPLES: use .EX/.EE instead of .nf/.fi

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoman-pages.7: ffix: use a table rather .nf/.fi
Michael Kerrisk [Mon, 16 Nov 2020 09:44:32 +0000 (10:44 +0100)] 
man-pages.7: ffix: use a table rather .nf/.fi

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoMAINTAINER_NOTES: Add a file with some notes for maintainers
Michael Kerrisk [Mon, 16 Nov 2020 08:33:23 +0000 (09:33 +0100)] 
MAINTAINER_NOTES: Add a file with some notes for maintainers

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoscandir.3: srcfix
Michael Kerrisk [Mon, 16 Nov 2020 08:22:28 +0000 (09:22 +0100)] 
scandir.3: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agocheck_unbalanced_macros.sh: A script to look for unbalanced *roff/man macro pairs
Michael Kerrisk [Mon, 16 Nov 2020 07:55:59 +0000 (08:55 +0100)] 
check_unbalanced_macros.sh: A script to look for unbalanced *roff/man macro pairs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoqueue.7: tfix
Michael Kerrisk [Mon, 16 Nov 2020 07:14:55 +0000 (08:14 +0100)] 
queue.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agokernel_lockdown.7: Remove unneeded quotes
Michael Kerrisk [Mon, 16 Nov 2020 07:08:30 +0000 (08:08 +0100)] 
kernel_lockdown.7: Remove unneeded quotes

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agonextafter.3: Remove duplicate "BUGS" section heading
Michael Kerrisk [Mon, 16 Nov 2020 07:05:51 +0000 (08:05 +0100)] 
nextafter.3: Remove duplicate "BUGS" section heading

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agobpf.2: Place EXAMPLES section in correct location
Michael Kerrisk [Mon, 16 Nov 2020 07:04:35 +0000 (08:04 +0100)] 
bpf.2: Place EXAMPLES section in correct location

As per section ordering rules given in man-pages(7).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoCIRCLEQ_EMPTY.3, CIRCLEQ_FIRST.3, CIRCLEQ_FOREACH.3, CIRCLEQ_FOREACH_REVERSE.3, CIRCL...
Michael Kerrisk [Mon, 16 Nov 2020 06:58:24 +0000 (07:58 +0100)] 
CIRCLEQ_EMPTY.3, CIRCLEQ_FIRST.3, CIRCLEQ_FOREACH.3, CIRCLEQ_FOREACH_REVERSE.3, CIRCLEQ_HEAD_INITIALIZER.3, CIRCLEQ_LAST.3, CIRCLEQ_LOOP_NEXT.3, CIRCLEQ_LOOP_PREV.3, CIRCLEQ_NEXT.3, CIRCLEQ_PREV.3: Add missing links to circleq.3

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolist.3: NAME: remove LIST_PREV, which is not documented in this page
Michael Kerrisk [Mon, 16 Nov 2020 06:53:47 +0000 (07:53 +0100)] 
list.3: NAME: remove LIST_PREV, which is not documented in this page

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agopthread_attr_getsigmask_np.3: New link to pthread_attr_setsigmask_np.3
Michael Kerrisk [Mon, 16 Nov 2020 06:48:24 +0000 (07:48 +0100)] 
pthread_attr_getsigmask_np.3: New link to pthread_attr_setsigmask_np.3

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoprctl.2, setns.2: tfix: remove section number from API documented in this page
Michael Kerrisk [Mon, 16 Nov 2020 06:43:02 +0000 (07:43 +0100)] 
prctl.2, setns.2: tfix: remove section number from API documented in this page

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agochroot.2, memfd_create.2, tailq.3: Fix unbalanced .nf/.fi
Michael Kerrisk [Sun, 15 Nov 2020 22:29:00 +0000 (23:29 +0100)] 
chroot.2, memfd_create.2, tailq.3: Fix unbalanced .nf/.fi

Reported-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agouname.2, feature_test_macros.7: ffix
Michael Kerrisk [Sun, 15 Nov 2020 21:28:28 +0000 (22:28 +0100)] 
uname.2, feature_test_macros.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogetutent.3: srcfix
Michael Kerrisk [Sun, 15 Nov 2020 21:07:47 +0000 (22:07 +0100)] 
getutent.3: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogetent.1, fanotify_mark.2, fcntl.2, futex.2, membarrier.2, mmap.2, mount.2, msgctl...
Alejandro Colomar [Sun, 15 Nov 2020 12:32:31 +0000 (13:32 +0100)] 
getent.1, fanotify_mark.2, fcntl.2, futex.2, membarrier.2, mmap.2, mount.2, msgctl.2, readv.2, semctl.2, set_mempolicy.2, shmctl.2, syscalls.2, abs.3, bstring.3, btree.3, ctime.3, drand48.3, fgetc.3, fopen.3, gethostbyname.3, getnetent.3, getprotoent.3, getservent.3, INFINITY.3, __ppc_set_ppr_med.3, inet.3, j0.3, makecontext.3, printf.3, puts.3, resolver.3, sigsetops.3, elf.5, nscd.conf.5, proc.5, inotify.7, ipv6.7, spufs.7, system_data_types.7: Use Oxford comma

Found using:
pcregrep -rnM "^\.[B|I]R .*,\n\.[B|I].*[^,]\nand" man? |grep ^man |sort

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolocale.5, ipv6.7: ffix
Alejandro Colomar [Sun, 15 Nov 2020 11:26:40 +0000 (12:26 +0100)] 
locale.5, ipv6.7: ffix

[.B XX_*] is the most extended form in the pages.

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agofaccessat2.2: New link to access.2
Michael Kerrisk [Sun, 15 Nov 2020 11:46:29 +0000 (12:46 +0100)] 
faccessat2.2: New link to access.2

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoaccess.2: Document faccessat2()
Michael Kerrisk [Sun, 15 Nov 2020 11:44:34 +0000 (12:44 +0100)] 
access.2: Document faccessat2()

faccessat2() was added in Linux 5.8 and enables a fix to
longstanding bugs in the faccessat() wrapper function.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoaccess.2: BUGS: note that faccessat() wrapper function emulation ignores ACLs
Michael Kerrisk [Sun, 15 Nov 2020 11:21:55 +0000 (12:21 +0100)] 
access.2: BUGS: note that faccessat() wrapper function emulation ignores ACLs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoopenat.2: Fix include path, should be linux/openat2.h
Colin Ian King [Sat, 14 Nov 2020 22:15:09 +0000 (22:15 +0000)] 
openat.2: Fix include path, should be linux/openat2.h

The include path is linux/openat2, so fix the manual to reference
this correct path.

Signed-off-by: Colin Ian King <colin.king@canonical.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoshmctl.2: wfix (for consistency with other *ctl.2 pages)
Michael Kerrisk [Sun, 15 Nov 2020 09:26:43 +0000 (10:26 +0100)] 
shmctl.2: wfix (for consistency with other *ctl.2 pages)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agomsgctl.2, semctl.2, shmctl.2: Minor fix
Michael Kerrisk [Sun, 15 Nov 2020 09:18:31 +0000 (10:18 +0100)] 
msgctl.2, semctl.2, shmctl.2: Minor fix

Break text into more paragraphs to ease readability

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agomsgctl.2: Make comments in 'msqid_ds' definition more compact
Michael Kerrisk [Sun, 15 Nov 2020 09:06:50 +0000 (10:06 +0100)] 
msgctl.2: Make comments in 'msqid_ds' definition more compact

The comments do not need to be so verbose, since the main text
provides the full details.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agomsgctl.2: Add description of 'msg_cbytes' field
Michael Kerrisk [Sun, 15 Nov 2020 08:59:13 +0000 (09:59 +0100)] 
msgctl.2: Add description of 'msg_cbytes' field

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agomsgctl.2: Use field name "msg_cbytes" rather than "__msg_cbytes"
Michael Kerrisk [Sun, 15 Nov 2020 08:56:03 +0000 (09:56 +0100)] 
msgctl.2: Use field name "msg_cbytes" rather than "__msg_cbytes"

The shorter name is provided by default (i.e., if _DEFAULT_SOURCE
is defined).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agomsgctl.2: Place list of field descriptions in same order as structure definition
Michael Kerrisk [Sun, 15 Nov 2020 08:49:49 +0000 (09:49 +0100)] 
msgctl.2: Place list of field descriptions in same order as structure definition

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoshmctl.2: Place list of field descriptions in same order as structure definition
Michael Kerrisk [Sun, 15 Nov 2020 08:48:15 +0000 (09:48 +0100)] 
shmctl.2: Place list of field descriptions in same order as structure definition

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