Commit Graph

18639 Commits

Author SHA1 Message Date
Seonghun Lim e82c474834 acct.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 09:22:45 +01:00
Michael Kerrisk 047a0bb864 userfaultfd.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 08:44:27 +01:00
Mike Rapoport 2a88597361 userfaultfd.2: BUGS: document spurious UFFD_EVENT_FORK
Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 08:43:41 +01:00
Jakub Wilk ad94e27ca0 ioctl_tty.2: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 08:38:10 +01:00
Michael Kerrisk 76f054b155 open.2: Since glibc 2.26, the open() wrapper always uses the openat() syscall
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 08:32:33 +01:00
Michael Kerrisk 93f50c468f sigaltstack.2: Update timestamp
For Acked-by from Stas Sergeev

Acked-by: Stas Sergeev <stsp@list.ru>

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-08 08:39:49 +01:00
Michael Kerrisk a86cae6189 sigaltstack.2: Tighten the BUGS wording a little
From a conversation with Walter Harms:

    > i am confused, i understand that:
    >            ss.ss_sp = malloc(SIGSTKSZ);
    >
    >            ss.ss_size = SIGSTKSZ;
    >            ss.ss_flags = 0;
    >            if (sigaltstack(&ss, NULL) == -1)
    >
    > is equivalent to:
    >            ss.ss_sp = malloc(SIGSTKSZ);
    >
    >            ss.ss_size = SIGSTKSZ;
    >            ss.ss_flags = SS_ONSTACK ;
    >            if (sigaltstack(&ss, NULL) == -1)
    >
    > but also to
    >            ss.ss_sp = malloc(SIGSTKSZ);
    >
    >            ss.ss_size = SIGSTKSZ;
    >            ss.ss_flags = SS_ONSTACK | SOMETHING_FLAG ;
    >            if (sigaltstack(&ss, NULL) == -1)
    >
    > so the use of SS_ONSTACK would result in ss.ss_flags = 0 no matter what.
    > OR
    > SS_ONSTACK is a no-op in Linux

    I see what you mean. The point is back then that SS_ONSTACK was
    the only flag that could (on Linux) be specified in ss.ss_flags,
    so that "SS_ONSTACK | SOMETHING_FLAG" was a nonexistent case.
    These days, it's possible to specify the new SS_AUTODISARM
    flag in ss.ss_flags, which I think is why you are doubtful
    about the new page text.

Reported-by: Walter Harms <wharms@bfs.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-08 08:36:50 +01:00
Michael Kerrisk 006ac5f09d sigaltstack.2: Reword BUGS text to be a little clearer
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-08 08:36:50 +01:00
Michael Kerrisk c854094fc0 sigaltstack.2: Add use os sigaction() to example code
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-08 08:36:50 +01:00
Michael Kerrisk 93c33be846 sigaltstack.2: Add explicit error handling to example code
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-08 08:36:50 +01:00
Michael Kerrisk 55f780fe47 sigaltstack.2: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-08 08:36:50 +01:00
Michael Kerrisk eff26dcec6 sigaltstack.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-08 08:36:50 +01:00
Michael Kerrisk cfdc176b44 sigaltstack.2: Document SS_AUTODISARM flag added in Linux 4.7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-08 08:36:50 +01:00
Lucas Werkmeister e4631a3524 system.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-07 23:14:27 +01:00
Michael Kerrisk 946924bd33 capget.2: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-07 21:20:40 +01:00
Michael Kerrisk fd39ef0c05 capabilities.7: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-07 21:20:40 +01:00
Michael Kerrisk 68ea3ce60e capabilities.7: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-07 21:20:40 +01:00
Michael Kerrisk c0f82ec111 capget.2: wfix: consistently use "VFS capabilities"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-07 21:20:40 +01:00
Michael Kerrisk 6a65cff8dd capabilities.7: Add a reference to xattr(7) in the discussion of extended attributes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-07 20:55:35 +01:00
Michael Kerrisk c350d86d00 capget.2: Clarify discussion of kernels that have no VFS capability support
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-07 13:58:18 +01:00
Michael Kerrisk fb89201a9b capget.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-07 13:45:26 +01:00
Michael Kerrisk 39352d918f filesystems.5: Refer to VFAT as an extended FAT (not DOS) filesystem
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-06 23:23:09 +01:00
Michael Kerrisk 23014116a5 filesystems.5: Replace crufty URL reference for 'smb' with up-to-date URL
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-06 23:19:42 +01:00
Lucas Werkmeister 81c8aeb649 proc.5: Clarify permissions in /proc/[pid]/fd/
Since the symbolic links for pipes and sockets do not refer to real
files in the file system tree, it can be hard to discover that they
still have mode and ownership information (revealed e.g. by `stat -L`),
so let's point this out in the manpage.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-06 22:25:13 +01:00
Lucas Werkmeister d6bd89f3e5 proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-06 22:23:01 +01:00
Michael Kerrisk 247bbcf00c ffs.3: glibc 2.27 relaxes the FTM requriements for ffsl() nand ffsll()
glibc 2.27 relaxes the FTM requriements for ffsl() and
ffsll() to _DEFAULT_SOURCE.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-02 08:20:26 +01:00
Elliot Hughes 0e1a31ea79 recvmmsg.2, sendmmsg.2: Type fixes in SYNOPSIS
[mtk: The raw system calls use "unsigned int", but the glibc
wrappers have "int" for the 'flags' argument.]

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-02 07:49:07 +01:00
Michael Kerrisk 74f254908f mmap.2: SEE ALSO: add ftruncate(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-31 08:24:13 +01:00
Michael Kerrisk c19250adee mmap.2: Add explicit text noting that 'length' must be greater than 0
Currently, this detail is hidden in ERRORS. Make it clear in
the main text.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-31 08:21:43 +01:00
Michael Kerrisk 5f70d096ae stdio.3: Remove crufty reference to pc(1)
I'm not sure what compiler is referred to by "pc(1)",
but "dnf whatprovides" and web searches turn up no
mention of a compiler by that name.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-29 13:23:55 +01:00
Michael Kerrisk 3242546c6e stdio.3: Use proper section cross references in function list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-29 13:23:55 +01:00
Michael Kerrisk dc4674ac40 core.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-27 21:20:20 +02:00
Michael Kerrisk 404fb8d3fe mq_overview.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-27 17:41:42 +02:00
G. Branden Robinson 9ab7f611ed Replace Latin abbreviation "cf.".
People seem to be using "cf." ("confere"), which means "compare",
to mean "see" instead, for which the Latin abbreviation would be
"q.v." ("quod vide" -> "which see").

In some cases "cf." might actually be the correct term but it's
still not clear what specific aspects of a function/system call
one is supposed to be comparing.

I left one use in place in hope of obtaining clarification,
because it looks like it might be useful there, if contextualized.

Migrate these uses to English and add them to the list of
abbreviations to be avoided.

If the patch to vfork(2) is not accepted, then the cf. still needs
an \& after it because it is at the end of the line but not the
end of a sentence.

Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-27 17:39:33 +02:00
Michael Kerrisk 47d0313853 pid_namespaces.7: tfix + srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 17:43:45 +02:00
Michael Kerrisk 8eb13afb83 proc.5: Add reference to pid_namespaces(7) for /proc/sys/kernel/ns_last_pid
Add reference to pid_namespaces(7) for the description of
/proc/sys/kernel/ns_last_pid.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 17:30:12 +02:00
Michael Kerrisk 10bd75534e pid_namespaces.7: Document /proc/sys/kernel/ns_last_pid
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 17:27:58 +02:00
G. Branden Robinson e789e07cb1 man-pages.7: Add a use case for real minus character
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 06:44:52 +02:00
G. Branden Robinson 679f40d6a5 hier.7: tfix
Escape hyphen in man page cross reference.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 06:43:57 +02:00
G. Branden Robinson b3f480154d ipv6.7: tfix
Use correct indefinite article before noun beginning with vowel sound.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 06:43:39 +02:00
G. Branden Robinson 9b13f7700e connect.2, ioprio_set.2, dbopen.3, group.5, fifo.7: tfix
Fix nonstandard usage.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 06:41:59 +02:00
G. Branden Robinson fedb2ff513 open.2: tfix
This one crept in during the first bit of the "will fail" -> "fails"
migration.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 06:34:09 +02:00
Michael Kerrisk 86683c22ca lp.4: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-22 08:49:27 +02:00
Michael Kerrisk e05f3710a2 lp.4: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-22 08:36:21 +02:00
Michael Kerrisk 37f343855c Changes: infnan.3 is removed
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-22 08:04:38 +02:00
Michael Kerrisk 84fe93c843 infnan.3: Remove page
This function was in libc4 and libc5, but never part
of glibc. It ceased to be relevant nearly 20 years
ago. Time to remove the page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-22 08:04:30 +02:00
G. Branden Robinson 59524c5eb3 pthread_spin_init(3): tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-22 07:50:53 +02:00
Michael Kerrisk 26cd31fd4a access.2, delete_module.2, eventfd.2, fallocate.2, fcntl.2, getrandom.2, init_module.2, open.2, seccomp.2, timerfd_create.2, openpty.3, pthread_spin_lock.3, shm_open.3, tempnam.3, fifo.7, keyrings.7, pid_namespaces.7, sched.7, thread-keyring.7: wfix (will fail --> fail/fails)
Reported-by: Pedro Alves <palves@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 16:55:10 +02:00
Michael Kerrisk cdcc4450a0 getrlimit.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 16:43:11 +02:00
Michael Kerrisk a23d8efafc capget.2, fanotify_init.2, fcntl.2, ioctl_tty.2, madvise.2, mbind.2, prctl.2, sched_setaffinity.2, hash.3, isgreater.3, posix_fallocate.3, sigvec.3, full.4, sd.4, wavelan.4, core.5, host.conf.5, epoll.7, signal.7, unix.7, user_namespaces.7: wfix (will fail --> fail/fails)
Reported-by: Pedro Alves <palves@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 16:36:57 +02:00