Commit Graph

6260 Commits

Author SHA1 Message Date
Frederic Brault af6e958b58 pthread_create.3: Note default thread stack size for several architectures
I am trying to fix a FIXME in the pthread_create.3 manpage.
It says info about default thread stack size should be put in
pthread_attr_setstacksize.3.

And pthread_attr_setstacksize.3 says "For details on the default
stack size of new threads, see pthread_create(3)".

So I list the default values for several architectures, starting
from glibc 2.12 (and still valid on current git glibc).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-04-05 20:12:07 +02:00
Jann Horn f23ba9ce98 tsearch.3: tdelete() can return dangling pointers
POSIX says that deleting the root node must cause tdelete() to
return some unspecified non-NULL pointer. Glibc implements it by
returning a dangling pointer to the (freed) root node:

$ cat bogus_tdelete.c

static void *root = NULL;

static void *xmalloc(unsigned n) {
    void *p;
    p = malloc(n);
    if (!p)
        err(1, "malloc");
    return p;
}

static int compare(const void *pa, const void *pb) {
    if (*(int *) pa < *(int *) pb)
        return -1;
    if (*(int *) pa > *(int *) pb)
        return 1;
    return 0;
}

int main(void) {
    int *ptr;
    void *val, *parent;

    ptr = xmalloc(sizeof(int));
    *ptr = 1234;
    val = tsearch((void*)ptr, &root, compare);
    assert(*(int**)val == ptr);
    printf("root: %p\n", root);

    parent = tdelete((void*)ptr, &root, compare);
    printf("tdelete return value: %p; new root: %p\n", parent, root);

    return 0;
}
$ gcc -o bogus_tdelete bogus_tdelete.c -std=gnu99 -Wall
$ gdb ./bogus_tdelete
GNU gdb (GDB) 7.9-gg19
[...]
(gdb) break free
Function "free" not defined.
Make breakpoint pending on future shared library load? (y or [n]) y
Breakpoint 1 (free) pending.
(gdb) run
Starting program: /usr/local/google/home/jannh/tmp/bogus_tdelete
[...]
root: 0x555555756030

Breakpoint 1, 0x00007ffff7ab54e0 in free () from [...]
(gdb) print (void*)$rdi
$1 = (void *) 0x555555756030
(gdb) cont
Continuing.
tdelete return value: 0x555555756030; new root: (nil)
[Inferior 1 (process 56564) exited normally]
(gdb) quit

Therefore, explicitly note that tdelete() may return bad pointers
that must not be accessed.

Signed-off-by: Jann Horn <jannh@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-03-27 22:29:10 +02:00
Jann Horn f119ba87ea tsearch.3: Clarify items vs nodes
The manpage claimed that tsearch() returns a pointer to a data
item. This is incorrect; tsearch() returns a pointer to the
corresponding tree node, which can also be interpreted as a
pointer to a pointer to the data item.

Since this API is quite unintuitive, also add a clarifying
sentence.

Signed-off-by: Jann Horn <jannh@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-03-27 22:25:29 +02:00
Michael Kerrisk 517b7ac44a makedev.3: Since glibc 2.28, <sys/types.h> no longer defines these macroa
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-19 18:39:15 +01:00
Michael Kerrisk 0512f57cea atexit.3: wfix
Reported-by: Robin Kuzmin <kuzmin.robin@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-09 07:00:17 +01:00
Mike Frysinger 724127aa2d put(3): fix formatting of trailing period
The period after the function call is incorrectly marked with bold.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-04 07:32:04 +01:00
Michael Kerrisk 8538a62b4c iconv.1, bpf.2, copy_file_range.2, fcntl.2, memfd_create.2, mlock.2, mount.2, mprotect.2, perf_event_open.2, pkey_alloc.2, prctl.2, read.2, recvmmsg.2, s390_sthyi.2, seccomp.2, sendmmsg.2, syscalls.2, unshare.2, write.2, errno.3, fgetpwent.3, fts.3, pthread_rwlockattr_setkind_np.3, fuse.4, veth.4, capabilities.7, cgroups.7, ip.7, man-pages.7, namespaces.7, network_namespaces.7, sched.7, socket.7, user_namespaces.7, iconvconfig.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-02 07:38:54 +01:00
Michael Kerrisk a25748e649 pthread_mutexattr_setrobust.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 23:20:46 +01:00
Michael Kerrisk 41a64b30fc dl_iterate_phdr.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 23:16:04 +01:00
Michael Kerrisk 7de982f8af basename.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 23:15:08 +01:00
Michael Kerrisk 7ebb909a80 getnameinfo.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 23:03:46 +01:00
Michael Kerrisk 0335565faa resolver.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 22:51:26 +01:00
Michael Kerrisk a2d427c1a6 initgroups.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 22:50:06 +01:00
Michael Kerrisk 7457600f6e getutent.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 22:49:28 +01:00
Michael Kerrisk d0b8a8d817 getmntent.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 22:48:20 +01:00
Michael Kerrisk 0578c69df2 fgetpwent.3: Add missing ATTRIBUTES preamble
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 22:46:28 +01:00
Michael Kerrisk d2cd45885b errno.3: 'errno -s' can be used to search for errors by string in description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-12-23 08:43:20 +01:00
Michael Kerrisk 10b6adae8a fts.3: fts_pathlen = strlen(fts_path) + strlen(fts_name)
As noted by Pradeep (and I tested also the code on OpenBSD):

The man page for fts library call states both the following:

     short          fts_pathlen;  /* strlen(fts_path) */

     fts_pathlen The length of the string referenced by fts_path

However, for the structures returned from fts_children() function,
fts_pathlen is strlen(fts_path) + strlen(fts_name), which contradicts
the man page statement. So I believe that there is either a bug in the
man page or the fts_children() library call.

The following program can be used for verification:

int main() {
	struct passwd *pwd_entry = getpwuid(getuid());
	char *paths[] = {pwd_entry->pw_dir, NULL};
	FTS* fts = fts_open(paths, FTS_LOGICAL, NULL);
	FTSENT* ftsent = fts_read(fts);
	FTSENT* child = fts_children(fts, 0);
	while (child != NULL) {
		printf("\n %s %s %d %lu", child->fts_path, child->fts_name,
				child->fts_pathlen, strlen(child->fts_path));
		child = child->fts_link;
	}
	return 0;
}

Reported-by: Pradeep Kumar <pradeepsixer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-12-19 07:24:41 +01:00
Michael Kerrisk 3ca4400d74 usleep.3: Minor wording fix
Reported-by: Eric Benton <erbenton@comcast.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-12-18 17:19:07 +01:00
Michael Kerrisk 6386c0c862 errno.3: Add Linux error text corresponding to ENOMEM
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-12-16 00:09:16 +01:00
G. Branden Robinson 777411ae61 iconv.1, pthread_rwlockattr_setkind_np.3, man-pages.7, socket.7, iconvconfig.8: Standardize on "nonzero"
Also add this term to the style guide in man-pages(7).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-12-05 22:27:13 +01:00
roblabla 0f24751222 pthread_mutexattr_init.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-12-05 22:27:06 +01:00
Michael Kerrisk 1c6f59c276 getpid.2, pipe.2, abort.3, daemon.3, pthread_yield.3, stdio.3, sysconf.3, tty.4, shells.5, sysfs.5, fifo.7, hier.7, icmp.7, path_resolution.7, pid_namespaces.7, standards.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-26 12:38:46 +01:00
Michael Kerrisk d2414cb5a1 makedev.3: Minor fixes to Adrian Bunk's patch
Note glibc version where deprecation occurred.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-25 14:23:05 +01:00
Adrian Bunk 1e50980d0f makedev.3: glibc has deprecated exposing the definitions via <sys/types.h>
Compile warning with glibc 2.25:

    warning: In the GNU C Library, "makedev" is defined by
    <sys/sysmacros.h>. For historical compatibility, it is
    currently defined by <sys/types.h> as well, but we plan to
    remove this soon.  To use "makedev", include <sys/sysmacros.h>
    directly. If you did not intend to use a system-defined macro
    "makedev", you should undefine it after including
    <sys/types.h>.

Background: glibc commit dbab6577c6684c62bd2521c1c29dc25c3cac966f

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-25 14:18:41 +01:00
Michael Kerrisk 7d4151a5c3 errno.3: Remove an unnecessary sentence
Reported-by: Walter Harms <wharms@bfs.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 21:24:53 +01:00
Michael Kerrisk b01ecc5e1d errno.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 21:24:21 +01:00
Michael Kerrisk 5a99c72245 errno.3: Note the use of perror(3) and strerror(3)
Reported-by: Walter Harms <wharms@bfs.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 10:49:32 +01:00
Michael Kerrisk afde18c00a errno.3: Minor wording change
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 10:39:59 +01:00
Michael Kerrisk f79214781c errno.3: Explicitly note that error numbers vary also across UNIX systems
Reported-by: Walter Harms <wharms@bfs.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 10:39:01 +01:00
Michael Kerrisk 6eb4b782a0 errno.3: Recast the advice against manually declaring 'errno'
Recast the advice against manually declaring 'errno' to
a more modern perspective. It's 13 years since the original
text was added, and even then it was describing old behavior.
Cast the description to be about behavior further away in
time, and note more clearly that manual declaration will
cause problems with modern C libraries.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 10:39:01 +01:00
Michael Kerrisk 5db92f96f4 errno.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 10:39:01 +01:00
Michael Kerrisk 44a35dc807 errno.3: Note use of errno(1) to look up error names and numbers
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 10:39:01 +01:00
Michael Kerrisk bf3683a153 errno.3: Note that error numbers vary somewhat across architectures
Added after a patch from Wesley Aptekar-Cassels that proposed
to add error numbers to the text.

Reported-by: Wesley Aptekar-Cassels <w.aptekar@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 10:39:01 +01:00
Michael Kerrisk 9d1a5fa63e errno.3: Error numbers are positive values (rather than nonzero values)
POSIX.1-2008 noted the explicitly the change (to align with
the C standards) that error numbers are positive, rather
than nonzero.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 10:39:01 +01:00
Michael Kerrisk b89ec85240 errno.3: Reorganize the text and and some subheadings
Restructure the text and add some subheadings for better
readability. No (intentional) content changes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 10:39:01 +01:00
Michael Kerrisk c288d6b50d errno.3: Note the <errno.h> also provides the symbolic error names
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 10:10:12 +01:00
Michael Kerrisk a9641f84a1 errno.3: Minor text reorganization
No content changes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 10:10:12 +01:00
Michael Kerrisk e4a5b66224 errno.3: Minor rewording/reformatting
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 10:10:12 +01:00
Michael Kerrisk 5a63455fb3 errno.3: Update error list for POSIX.1-2008
POSIX.1-2008 specified a couple of new errors not present in
POSIX.1-2001.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 10:10:12 +01:00
Michael Kerrisk c106a226b3 errno.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 10:10:12 +01:00
Michael Kerrisk 975c0f87a2 errno.3: Add some missing errors
Based on comparing the filtered content of the two main
kernel errno files:

    cat include/uapi/asm-generic/errno.h \
        include/uapi/asm-generic/errno-base.h | grep define | \
        grep -v 'define _' | awk '{print $2}' | sort -u

to see what is absent from this page, and used in either kernel
or glibc.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-23 10:10:12 +01:00
Michael Kerrisk 7a951861cb exec.3: glibc 2.24 dropped CWD from the defaul path
Document the glibc 2.24 change that dropped CWD from the default
search path employed by execlp(), execvp() and execvpe() when
PATH is not defined.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 20:31:12 +01:00
Michael Kerrisk fefbc57db0 popen.3: Add a cross reference to Caveats in system(3)
All of the same risks regarding system() also apply to popen().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 15:17:10 +01:00
Michael Kerrisk 2e039d4db5 system.3: Mention file capabilities in discussion of privileged programs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 15:15:10 +01:00
Michael Kerrisk 067f80642b system.3: Note that user input for system() should be carefully sanitized
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 15:15:10 +01:00
Michael Kerrisk 1f87e63922 system.3: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 15:03:09 +01:00
Michael Kerrisk a1a1c8ce19 system.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 15:02:14 +01:00
Michael Kerrisk 3b9f2b67e7 system.3: Mention PATH explicitly in discussion of system and set-UID programs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 15:00:56 +01:00
Michael Kerrisk bd64aa6435 system.3: Correctly note which shell Debian uses as (noninteractive) /bin/sh
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 15:00:56 +01:00
Michael Kerrisk a6be81bab9 system.3: Create a "Caveats" subsection to hold warnings about the use of system()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 14:54:00 +01:00
Seonghun Lim 0fd299bf6c strverscmp.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 09:34:05 +01:00
Seonghun Lim d42ffdf8e3 sockatmark.3: Fix cruft in code example
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 09:33:26 +01:00
Seonghun Lim 35ed4d7ea0 random_r.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 09:30:29 +01:00
Seonghun Lim 6da3279c45 stdio.3: wsfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 09:28:08 +01:00
Seonghun Lim 6968bea38c stdin.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 09:27:07 +01:00
Seonghun Lim be4c9c66c1 atexit.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 09:26:36 +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 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
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
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
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
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 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
Michael Kerrisk b858495171 pthread_spin_init.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:49 +02:00
Michael Kerrisk 5017fc28ec pthread_spin_init.3: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:49 +02:00
Michael Kerrisk 28c15b63d6 pthread_spin_init.3: Add more caveats on use of spin locks
Cowritten-by: Thomas Gleixner <tglx@linutronix.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:49 +02:00
Michael Kerrisk 34d46b816e pthread_spin_init.3: Strengthen note about when spin locks should (not) be used
Reported-by: Zack Weinberg <zackw@panix.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:49 +02:00
Michael Kerrisk 0e905edca8 pthread_spin_init.3: Operations on copies of *lock yield undefined behavior
Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk eb93621d10 pthread_spin_init.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk af79528ece pthread_spin_lock.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 4eea22f5ae pthread_spin_lock.3: wfix
Reported-by: Zack Weinberg <zackw@panix.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 07fa47a568 pthread_spin_lock.3: Fixes suggested by Carlos O'Donell
Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk f3861c72a9 pthread_spin_lock.3: Refer reader to important details in NOTES in pthread_spin_init(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 8cbd1d9e4d pthread_spin_init.3: Warn about deadlock with spin locks
Reported-by: Thomas Gleixner <tglx@linutronix.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 2dea72418d pthread_spin_init.3: Spin locks should be used with real-time scheduling policies
Reported-by: Peter Zijlstra <peterz@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 41041696d3 pthread_yield.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 77e0fbc201 pthread_spin_trylock.3, pthread_spin_unlock.3: New links to new pthread_spin_lock3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk ce42a8cf5f pthread_spin_lock.3: New page describing functions that lock and unlock spin locks
Add a page descrbing pthread_spin_lock(3), pthread_spin_unlock(3),
and pthread_spin_trylock(3).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 14bffcef9c pthread_spin_destroy.3: New link to new pthread_spin_init.3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 7f5f8925ce pthread_spin_init.3: New page describing pthread_spin_init(3) and pthread_spin_destroy(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk cddd55a004 pthread_yield.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 09:58:54 +02:00
Michael Kerrisk d304c13dac posix_fallocate.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 09:26:12 +02:00
Michael Kerrisk 9ea5bc667b clone.2, getcpu.2, shmget.2, syscall.2, dladdr.3, proc.5, vdso.7: Consistently use "x86-64", not "x86_64"
When referring to the architecture, consistently use "x86-64",
not "x86_64". Hitherto, there was a mixture of usages, with
"x86-64" predominant.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 09:26:12 +02:00
Michael Kerrisk 98f24fc65c abort.3: SEE ALSO: add assert(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 16:19:58 +02:00
Michael Kerrisk 46dc471b8d abort.3: Starting with glibc 2.27, abort() does not attempt to flush streams
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 16:19:47 +02:00
Fangrui Song 8a3f19c369 pow10.3: tfix
Signed-off-by: Fangrui Song <i@maskray.me>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 10:52:25 +02:00
Jakub Wilk e40be343f7 mallinfo.3: Fix the example
Remove reference to non-standard "tlpi_hdr.h" and replace calls to
functions that were declared in this header.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-05 20:34:40 +02:00
Michael Kerrisk 2050975ecc setlocale.3: The standards do not specify all of the locale categories
Reported-by: Křištof Želechovski <giecrilj@stegny.2a.pl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-03 15:23:37 +02:00
Michael Kerrisk 46f2cf80f4 pthread_yield.3: pthread_yield() is intended for use with real-time scheduling policies
Reported-by: Peter Zijlstra <peterz@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-29 22:46:28 +02:00
Michael Kerrisk 454f90d7b7 backtrace.3: Minor tweaks to Stefan Puiu's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-29 20:36:55 +02:00
Stefan Puiu ca5d5169cb backtrace_symbols_fd() can trigger a call to malloc()
Currently, the backtrace(3) manual page says this about backtrace_symbols_fd():

back‐
       trace_symbols_fd() does not call malloc(3), and so can be
employed in situations where the latter function might fail.

However, I watched a video of a presentation about signal handling and
the speaker was saying that calling backtrace() can trigger a call to
malloc - indirectly. That happens because the backtrace*() functions
are part of libgcc, which gets dynamically loaded whenever needed;
dynamic loading would, in turn, trigger a malloc. The talk can be
found here: http://free-electrons.com/pub/video/2008/ols/ols2008-gilad-ben-yossef-fault-handlers.ogg

I decided to test it out, and it seems that this is still true (at
least on Ubuntu 12.04). I compiled the attached program (I used
CXXFLAGS = '-Wall -g -std=c++0x', the -std= part is not really needed)
and ran it through gdb, putting a breakpoint on the line where
backtrace is called. When that breakpoint is hit, I set a breakpoint
on malloc, continued and voila:

Breakpoint 2, __GI___libc_malloc (bytes=36) at malloc.c:2910
2910    malloc.c: No such file or directory.
(gdb) bt
"/lib/x86_64-linux-gnu/libgcc_s.so.1") at dl-load.c:162
"libgcc_s.so.1", type=2, trace_mode=0, mode=-1879048191,
nsid=<optimized out>) at dl-load.c:2473
errstring=0x7fffffffdd00, mallocedp=0x7fffffffdd0f,
operate=0x7ffff7ded700 <dl_open_worker>, args=0x7fffffffdcb0) at
dl-error.c:178
"libgcc_s.so.1", mode=-2147483647, caller_dlopen=0x7ffff7b260a9,
nsid=-2, argc=1, argv=<optimized out>, env=0x7fffffffe068) at
dl-open.c:639
errstring=0x7fffffffded0, mallocedp=0x7fffffffdeef,
operate=0x7ffff7b4bc20 <do_dlopen>, args=0x7fffffffdeb0) at
dl-error.c:178
operate=0x7ffff7b4bc20 <do_dlopen>) at dl-libc.c:48
out>) at dl-libc.c:165
../sysdeps/x86_64/../ia64/backtrace.c:104

Reviewed-by: Walter Harms <wharms@bfs.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-29 20:32:23 +02:00
Michael Kerrisk 76f23c9448 pthread_detach.3: Improve sentence describing freeing of resources on process termination
As reported by Rahul, the existing sentence could be read as
meaning that resources of joined and terminated detached
threads are freed at only at process termination. Eliminate
that possible misreading.

Reported-by: Rahul Bedarkar <rpal143@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-29 18:24:22 +02:00
Mike Frysinger 3144b41214 perror.3: tfix: add missing period
Signed-off-by: Mike Frysinger <vapier@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 17:21:12 +02:00
Michael Kerrisk f6cf8f80bc lround.3: Minor tweaks to .TH line
A further follow-up to
https://bugzilla.kernel.org/show_bug.cgi?id=194601

Reported-by: David Eckardt <david.eckardt@sociomantic.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 08:56:18 +02:00
Michael Kerrisk 940bdd7ece daemon.3: SEE ALSO: add daemon(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 13:06:24 +02:00
Michael Kerrisk f620444aea malloc.3: SEE ALSO: add valgrind(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 12:14:07 +02:00
Michael Kerrisk 8f7a89b0fb daemon.3: SEE ALSO: add logrotate(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 12:05:09 +02:00
Michael Kerrisk 39a6b7e8fb sysconf.3: Mention get_nprocs_conf(3)
Mention get_nprocs_conf(3) in discussion of _SC_NPROCESSORS_CONF
and _SC_NPROCESSORS_ONLN.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 11:53:51 +02:00
Michael Kerrisk c9cfbbe945 get_nprocs_conf.3: SEE ALSO: add nproc(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 11:53:16 +02:00
Michael Kerrisk a448a0c6c3 get_nprocs_conf.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 11:51:26 +02:00
Michael Kerrisk ce08dedca4 lround.3: Clarify that lround() rounds *halfway cases" away from zero
See https://bugzilla.kernel.org/show_bug.cgi?id=194601

Reported-by: David Eckardt <david.eckardt@sociomantic.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-24 09:53:49 +02:00
Julien Gomes 13e69b6c6a openpty.3: tfix
Signed-off-by: Julien Gomes <julien@arista.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 10:04:56 +02:00
Michael Kerrisk c551100943 fexecve.3: Add some detail on the glibc implementation of fexecve() via execveat(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk 136badedfd fexecve.3: Minor tweaks to Cristian's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Cristian Rodríguez b71753c1fc fexecve.3: fexecve() is now implemented with execveat(2), where available
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk 046a128700 fexecve.3: O_PATH file descriptors are also usable with fexecve()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:38:21 +02:00
Michael Kerrisk 4b8c67d976 iconv.1, ldd.1, locale.1, localedef.1, memusage.1, memusagestat.1, mtrace.1, pldd.1, sprof.1, time.1, _syscall.2, add_key.2, alloc_hugepages.2, arch_prctl.2, bpf.2, cacheflush.2, capget.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clock_nanosleep.2, clone.2, close.2, connect.2, copy_file_range.2, create_module.2, delete_module.2, dup.2, epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, execve.2, execveat.2, fallocate.2, fanotify_init.2, fcntl.2, flock.2, fork.2, fsync.2, futex.2, futimesat.2, get_kernel_syms.2, get_mempolicy.2, get_robust_list.2, getcpu.2, getdents.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getitimer.2, getpagesize.2, getpeername.2, getpriority.2, getrandom.2, getresuid.2, getrlimit.2, getrusage.2, getsid.2, getsockname.2, getsockopt.2, gettid.2, gettimeofday.2, getuid.2, getunwind.2, init_module.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, intro.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioctl_console.2, ioctl_fat.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, ioctl_getfsmap.2, ioctl_iflags.2, ioctl_list.2, ioctl_ns.2, ioctl_tty.2, ioctl_userfaultfd.2, ioperm.2, iopl.2, ioprio_set.2, ipc.2, kcmp.2, kexec_load.2, keyctl.2, kill.2, link.2, listen.2, listxattr.2, llseek.2, lookup_dcookie.2, lseek.2, madvise.2, mbind.2, membarrier.2, memfd_create.2, migrate_pages.2, mincore.2, mkdir.2, mknod.2, mlock.2, mmap.2, mmap2.2, modify_ldt.2, move_pages.2, mprotect.2, mq_getsetattr.2, mremap.2, msgctl.2, msgget.2, msgop.2, msync.2, nanosleep.2, nfsservctl.2, nice.2, open.2, open_by_handle_at.2, outb.2, perf_event_open.2, perfmonctl.2, personality.2, pivot_root.2, pkey_alloc.2, poll.2, posix_fadvise.2, prctl.2, pread.2, process_vm_readv.2, ptrace.2, query_module.2, quotactl.2, read.2, readahead.2, readdir.2, readlink.2, readv.2, reboot.2, recv.2, recvmmsg.2, remap_file_pages.2, rename.2, request_key.2, restart_syscall.2, rt_sigqueueinfo.2, s390_pci_mmio_write.2, s390_runtime_instr.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setattr.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, seccomp.2, select.2, select_tut.2, semctl.2, semget.2, semop.2, send.2, sendfile.2, sendmmsg.2, set_mempolicy.2, set_thread_area.2, set_tid_address.2, seteuid.2, setfsgid.2, setfsuid.2, setgid.2, setns.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, sgetmask.2, shmctl.2, shmget.2, shmop.2, sigaction.2, sigaltstack.2, signal.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, socketcall.2, socketpair.2, splice.2, spu_create.2, spu_run.2, stat.2, statfs.2, statx.2, subpage_prot.2, swapon.2, symlink.2, sync.2, sync_file_range.2, syscall.2, syscalls.2, sysctl.2, sysfs.2, sysinfo.2, syslog.2, tee.2, time.2, timer_create.2, timer_getoverrun.2, timer_settime.2, timerfd_create.2, times.2, tkill.2, truncate.2, umask.2, umount.2, uname.2, unimplemented.2, unlink.2, unshare.2, uselib.2, userfaultfd.2, ustat.2, utime.2, utimensat.2, vfork.2, vmsplice.2, wait.2, wait4.2, write.2, CPU_SET.3, INFINITY.3, __ppc_get_timebase.3, __ppc_set_ppr_med.3, __ppc_yield.3, __setfpucw.3, acos.3, acosh.3, adjtime.3, aio_fsync.3, aio_init.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, backtrace.3, basename.3, bindresvport.3, bsd_signal.3, bsearch.3, bswap.3, btree.3, byteorder.3, bzero.3, canonicalize_file_name.3, carg.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cexp.3, cfree.3, clearenv.3, clock.3, clock_getcpuclockid.3, clog.3, clog10.3, clog2.3, cmsg.3, confstr.3, copysign.3, cos.3, cosh.3, crypt.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctime.3, dbopen.3, dl_iterate_phdr.3, dladdr.3, dlerror.3, dlinfo.3, dlopen.3, dlsym.3, drand48.3, drand48_r.3, duplocale.3, encrypt.3, end.3, endian.3, envz_add.3, erf.3, erfc.3, err.3, errno.3, error.3, ether_aton.3, euidaccess.3, exec.3, exit.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fcloseall.3, fdim.3, fenv.3, ferror.3, fexecve.3, fflush.3, ffs.3, fgetc.3, fgetgrent.3, fgetpwent.3, finite.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fmtmsg.3, fopen.3, fopencookie.3, fpclassify.3, fpurge.3, fputwc.3, fputws.3, frexp.3, fseek.3, fseeko.3, ftime.3, fts.3, ftw.3, futimes.3, gamma.3, gcvt.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcontext.3, getcwd.3, getdate.3, getentropy.3, getenv.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getifaddrs.3, getipnodebyname.3, getline.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent.3, getnetent_r.3, getopt.3, getprotoent.3, getprotoent_r.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getrpcent_r.3, getrpcport.3, gets.3, getservent.3, getservent_r.3, getspnam.3, getsubopt.3, getttyent.3, getumask.3, getutent.3, getwchar.3, glob.3, gnu_get_libc_version.3, grantpt.3, gsignal.3, hash.3, hsearch.3, hypot.3, iconv.3, iconv_close.3, iconv_open.3, if_nameindex.3, if_nametoindex.3, ilogb.3, inet.3, inet_net_pton.3, inet_ntop.3, inet_pton.3, initgroups.3, insque.3, intro.3, isalpha.3, isgreater.3, j0.3, key_setsecret.3, killpg.3, ldexp.3, lgamma.3, lio_listio.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, makedev.3, mallinfo.3, malloc.3, malloc_get_state.3, malloc_info.3, malloc_stats.3, malloc_trim.3, malloc_usable_size.3, mallopt.3, matherr.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mcheck.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mpool.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mtrace.3, newlocale.3, nextafter.3, nextup.3, nl_langinfo.3, ntp_gettime.3, offsetof.3, on_exit.3, open_memstream.3, opendir.3, openpty.3, perror.3, popen.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, posix_openpt.3, posix_spawn.3, pow.3, pow10.3, printf.3, profil.3, program_invocation_name.3, psignal.3, pthread_atfork.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_detach.3, pthread_exit.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_join.3, pthread_kill.3, pthread_kill_other_threads_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_testcancel.3, pthread_tryjoin_np.3, ptsname.3, putgrent.3, putpwent.3, qsort.3, random.3, random_r.3, rcmd.3, re_comp.3, readdir.3, realpath.3, recno.3, regex.3, remainder.3, remove.3, remquo.3, resolver.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, rtime.3, scalb.3, scalbln.3, scandir.3, scanf.3, sched_getcpu.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_wait.3, setaliasent.3, setbuf.3, setenv.3, setlocale.3, setlogmask.3, setnetgrent.3, shm_open.3, signbit.3, significand.3, sigpause.3, sigqueue.3, sigset.3, sigvec.3, sin.3, sincos.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stdarg.3, stdin.3, strcasecmp.3, strcat.3, strchr.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfmon.3, strfromd.3, strftime.3, strptime.3, strsignal.3, strstr.3, strtod.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, syslog.3, system.3, sysv_signal.3, tan.3, tanh.3, telldir.3, tempnam.3, termios.3, tgamma.3, timeradd.3, tmpnam.3, toupper.3, towlower.3, towupper.3, trunc.3, ttyslot.3, tzset.3, ualarm.3, ulimit.3, undocumented.3, unlocked_stdio.3, updwtmp.3, uselocale.3, usleep.3, wcrtomb.3, wcsdup.3, wcsnrtombs.3, wcsrtombs.3, wcstombs.3, wctob.3, wcwidth.3, wordexp.3, wprintf.3, xcrypt.3, xdr.3, y0.3, cciss.4, console_codes.4, dsp56k.4, fuse.4, hd.4, hpsa.4, initrd.4, intro.4, loop.4, random.4, rtc.4, sd.4, sk98lin.4, st.4, wavelan.4, acct.5, core.5, elf.5, filesystems.5, host.conf.5, hosts.5, locale.5, nologin.5, proc.5, resolv.conf.5, rpc.5, slabinfo.5, utmp.5, aio.7, arp.7, bootparam.7, capabilities.7, cgroup_namespaces.7, cgroups.7, charsets.7, cpuset.7, ddp.7, environ.7, epoll.7, fanotify.7, feature_test_macros.7, futex.7, inode.7, inotify.7, ip.7, ipv6.7, keyrings.7, locale.7, man-pages.7, man.7, math_error.7, mount_namespaces.7, mq_overview.7, namespaces.7, netdevice.7, netlink.7, packet.7, pipe.7, pkeys.7, pthreads.7, pty.7, raw.7, rtld-audit.7, rtnetlink.7, sched.7, session-keyring.7, signal.7, sock_diag.7, socket.7, spufs.7, suffixes.7, tcp.7, udp.7, udplite.7, unicode.7, units.7, unix.7, uri.7, user_namespaces.7, vdso.7, x25.7, xattr.7, iconvconfig.8, ld.so.8, ldconfig.8, sln.8: Update timestamps
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 12:44:56 +02:00
Yubin Ruan 91fd35ad46 pthread_mutexattr_setrobust.3: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:53:17 +02:00
Michael Kerrisk 336e15b267 malloc.3: Minor fix: reword to ease understanding
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:33:02 +02:00
Jonas Grabber c87d084b87 getrlimit.2, mmap.2, malloc.3: RLIMIT_DATA affects mmap (2) since Linux 4.7
Starting with Linux kernel 4.5 and 84638335900f1995
(mm: rework virtual memory accounting) RLIMIT_DATA affects
mmap(2).  With d977d56ce5b3e88 (mm: warn about VmData over
RLIMIT_DATA) only warnings are emmitted when going over the
specified RLIMIT_DATA in 4.5.

As of 4.7 and f4fcd55841fc9 (mm: enable RLIMIT_DATA by default
with workaround for valgrind) going over RLIMIT_DATA through
mmap(2) is forbidden.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:33:02 +02:00
Michael Kerrisk a40d006b5d strptime.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-14 15:47:15 +02:00
Michael Kerrisk 6c22b2c593 strchr.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-14 15:46:44 +02:00
Michael Kerrisk 1a14615c34 pthread_mutexattr_init.3: SEE ALSO: add pthread_mutexattr_getpshared(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:32 +02:00
Michael Kerrisk 2fdf4c5f1e pthread_mutexattr_setpshared.3: New link to new pthread_mutexattr_getpshared.3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:32 +02:00
Michael Kerrisk b967efeb5b pthread_mutexattr_getpshared.3: New page for pthread_mutexattr_getpshared(3) and pthread_mutexattr_setpshared.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:32 +02:00
Michael Kerrisk 7cff199dfc pthread_mutexattr_destroy.3: New link to new pthread_mutexattr_init.3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:32 +02:00
Michael Kerrisk 9d48165364 pthread_mutexattr_init.3: New page for pthread_mutexattr_init(3) and pthread_mutexattr_destroy(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:32 +02:00
Michael Kerrisk a126d04055 pthread_mutex_consistent.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:32 +02:00
Michael Kerrisk cf5744eb46 pthread_mutex_consistent.3: Point out that the application must make shared data consistent
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:32 +02:00
Michael Kerrisk 2fe9fbf168 pthread_mutex_consistent.3: Clarify that EOWNERDEAD is returned by pthread_mutex_lock()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk a9e45d2423 pthread_mutex_consistent.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk f49ed5cd38 pthread_mutex_consistent.3: Refer to example in pthread_mutexattr_setrobust(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk 77988d6276 pthread_mutex_consistent_np.3: New link to new pthread_mutex_consistent.3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk 99fa587d0d pthread_mutex_consistent.3: Mention pthread_mutex_consistent_np()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk 5214dd2066 pthread_mutex_consistent.3: Add VERSIONS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk abdad18584 pthread_mutex_consistent.3: Add feature test macro requirements and CONFORMING TO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk da9fc02934 pthread_mutex_consistent.3: srcfix: rewrap source lines at sentence boundaries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk fcc827bc2d pthread_mutex_consistent.3: tfix: fix spelling errors and grammar
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk de2fba0e1a pthread_mutex_consistent.3: srcfix: remove blank lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk 700b4034e9 pthread_mutexattr_setrobust.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk 8fbf748dd0 pthread_mutexattr_setrobust.3: SEE ALSO: add get_robust_list(2) and set_robust_list(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 5ede40bbc8 pthread_mutexattr_setrobust.3: On Linux execve(2) also causes EOWNERDIED notification
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 143e516fbd pthread_mutexattr_setrobust.3: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 8524bca574 pthread_mutexattr_setrobust.3: EXAMPLE: show example run of program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk f6569f44bd pthread_mutexattr_setrobust.3: Minor rewording in example
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk a205ca43a4 pthread_mutexattr_setrobust.3: Various improvements to the example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 5d26c00fc9 pthread_mutexattr_setrobust.3: EXAMPLE: use a more conventional name for the mutex variable
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk d1524d1813 pthread_mutexattr_setrobust.3: Various rewordings and improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 99afed9ead pthread_mutexattr_setrobust.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 5514936a31 pthread_mutexattr_setrobust.3: Add VERSIONS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 06ae85bd18 pthread_mutexattr_setrobust.3: Add feature test macro requirements plus CONFORMING TO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 61265f77f7 pthread_mutexattr_setrobust.3: Move the "_np" interfaces to NOTES
Move the old GNU nonportable APIs into notes. Having them
in the main text is a distraction.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 52124b96e4 pthread_mutexattr_setrobust.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 37f0c285e1 pthread_mutexattr_setrobust.3: Fix minor type error in SYNOPSIS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 4057660b6e pthread_mutexattr_setrobust.3: Minor tweaks to the example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk ad2825bf83 pthread_mutexattr_setrobust.3: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 2db681968e pthread_mutexattr_setrobust.3: Minor: spelling fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk f899f232b9 pthread_mutexattr_setrobust.3: srcfix: rewrap source lines at sentence boundaries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 150a51c660 pthread_mutexattr_setrobust.3: srcfix: trim trailing white space
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 3a2b5cc7a9 pthread_mutexattr_setrobust.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 92e6bd77f2 pthread_mutexattr_setrobust_np.3: New link to new pthread_mutexattr_setrobust.3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 1bb9b395d3 pthread_mutexattr_getrobust_np.3: New link to new pthread_mutexattr_setrobust.3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 1c50bb7393 pthread_mutexattr_getrobust.3: New link to new pthread_mutexattr_setrobust.3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Yubin Ruan 6d7934260e pthread_mutex_consistent.3: New page documenting pthread_mutex_consistent(3)
Signed-off-by: Yubin Ruan <ablacktshirt@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Yubin Ruan cb5f05898c pthread_mutexattr_setrobust.3: New page describing robust mutex attribute functions
>Document pthread_mutexattr_setrobust(3) and
pthread_mutexattr_getrobust(3).

Signed-off-by: Yubin Ruan <ablacktshirt@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 18523cfc81 exit.3: SEE ALSO: add get_robust_list(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:12:38 +02:00
Michael Kerrisk ee7c8e26e9 exit.3: Mention the prctl(2) PR_SET_PDEATHSIG operation
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:10:27 +02:00
Michael Kerrisk 5088242f95 exit.3: Add a heading to delimit discussion of signals sent to other processes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:10:27 +02:00
Michael Kerrisk cffa795059 exit.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:10:27 +02:00
Michael Kerrisk 268bac1ffa sincos.3: Note that sincos() is intended to be more efficient than sin() + cos()
On a current x86-64 i7 system, sincos() is about 15% faster than
sin()+cos() according to the following test program.

/*
 * Build with: cc -O -lm -fno-fast-math -fno-builtin
 */

int
main(int argc, char *argv[])
{
    double arg, rsin, rcos;
    int loop, i;

    arg = strtod(argv[1], NULL);
    loop = 10000000;
    if (argc > 2)
        loop = atoi(argv[2]);

    if (argc > 3) {
        printf("sin + cos\n");
        for (i = 0; i < loop; i++) {
            rsin = sin(arg);
            rcos = cos(arg);
        }
    } else {
        printf("sincos\n");
        for (i = 0; i < loop; i++) {
            sincos(arg, &rsin, &rcos);
        }
    }
}

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 07:42:42 +02:00
Michael Kerrisk 6354e66208 pow10.3: Note that pow10() is now obsolete in favor of exp10()
Also, the pow10() functions are no longer supported by glibc,
starting with version 2.27.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-10 12:50:11 +02:00
Michael Kerrisk b9f5883bd5 pow10.3: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-10 08:49:54 +02:00
Michael Kerrisk d64b372593 add_key.2, backtrace.3, syslog.3: Fix misordered SEE ALSO entries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 21:06:48 +02:00
Michael Kerrisk 3b3b8d5dcc getdents.2, ioctl_fat.2, mkdir.2, process_vm_readv.2, get_phys_pages.3, nextup.3, operator.7: srcfix: fix unbalanced .nf/.fi pairs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 20:43:22 +02:00
Michael Kerrisk a3847715fe clock_getres.2, ctime.3, tgamma.3: srcfix: fix unbalanced .RS/.RE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 20:38:25 +02:00
Michael Kerrisk 34a2ee189b ftw.3: Fix misordering of sections
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 18:08:09 +02:00
Michael Kerrisk a2d7a55eca cfree.3: Fix misordering of sections
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 18:07:04 +02:00
Michael Kerrisk 59d99553ae crypt.3: Note glibc version that added 'rounds' parameter
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-05 20:15:43 +02:00
Michael Kerrisk 42079b0179 crypt.3: Rework text describing 'rounds' parameter
The text reads a little more clearly if we talk about
'xxx' rather than 'the supplied number'.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-05 20:13:18 +02:00
Michael Kerrisk 4c130fabc3 crypt.3: Minor wording improvements to Konstantin's patches
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-05 20:13:18 +02:00
Konstantin Shemyak 84bee58c24 crypt.3: Add description of previously undocumented 'rounds' parameter
Files crypt/sha{256,512}-crypt.c in the glibc source define
macros:

    /* Default number of rounds if not explicitly specified.  */
    #define ROUNDS_DEFAULT 5000
    /* Minimum number of rounds.  */
    #define ROUNDS_MIN 1000
    /* Maximum number of rounds.  */
    #define ROUNDS_MAX 999999999

And the main encryption function __sha512_crypt_r() sets:

    rounds = MAX (ROUNDS_MIN, MIN (srounds, ROUNDS_MAX));

One can check that for example

    crypt("key", "$5$rounds=1$salt")

returns the string

    $5$rounds=1000$salt$PWLKU7MTJ0s5M/mjBPcqnMsorm3qKyoBctxmZ1mNwn2

This parameter has been introduced in glibc 2.7.

Signed-off-by: Konstantin Shemyak <konstantin@shemyak.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-05 19:49:35 +02:00
Konstantin Shemyak d32b36982d crypt.3: Clarify that ending of the salt string with '$' is optional
In crypt/sha512-crypt.c::__sha512_crypt_r() and the similar
sha256 function, the length of the actually used salt is
calculated as:

  salt_len = MIN (strcspn (salt, "$"), SALT_LEN_MAX);

Thus the trailing '$' is optional in the salt string. One can
check that

    crypt("key", "$5$salt")

yields the same result as

    crypt("key", "$5$salt$").

Signed-off-by: Konstantin Shemyak <konstantin@shemyak.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-05 19:48:35 +02:00
Konstantin Shemyak 893c609dcd crypt.3: Encryption isn't done with SHA-xxx, but with a function based on SHA-xxx
The encryption is done by glibc functions __shaxxx_crypt_r() in
files crypt/shaxxx-crypt.c. They implement a nontrivial algorithm
to construct the inputs for the hashing functions and to apply
them iteratively.

Signed-off-by: Konstantin Shemyak <konstantin@shemyak.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-05 19:47:52 +02:00
Konstantin Shemyak 266d8f7ef1 crypt.3: ffix
Signed-off-by: Konstantin Shemyak <konstantin@shemyak.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-04 01:27:21 +02:00
Michael Kerrisk 4d53aa005e MB_LEN_MAX.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-25 21:41:03 +02:00
Michael Kerrisk 2a2ecb8753 MB_LEN_MAX.3: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-25 21:41:03 +02:00
Michael Kerrisk b96315d884 queue.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-25 20:54:52 +02:00
Michael Kerrisk b5360edbd3 MB_CUR_MAX.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-25 20:51:31 +02:00
Michael Kerrisk 73593f0d3b matherr.3: Note that glibc 2.27 removes the 'matherr' mechanism
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-23 12:36:40 +02:00
Michael Kerrisk d4f849a29d matherr.3: Remove crufty feature test macro requirements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-23 12:12:11 +02:00
Michael Kerrisk b48303402a sin.3, sincos.3, sinh.3, sqrt.3, stdio_ext.3, strdup.3, strfry.3, strtoimax.3, tan.3, tanh.3, toupper.3, trunc.3, updwtmp.3, wcstoimax.3, y0.3, sk98lin.4: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 13:07:41 +02:00
Michael Kerrisk 301adac41e setjmp.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 13:07:41 +02:00
Michael Kerrisk bfcd3eb0b3 __setfpucw.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 13:07:41 +02:00
Michael Kerrisk a0ce17b14f remquo.3, rint.3, round.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 13:07:37 +02:00
Michael Kerrisk 4a2b2c2ce1 regex.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:55:23 +02:00
Michael Kerrisk a1048f8e1d j0.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, log2.3, lrint.3, lround.3, modf.3, netlink.3, opendir.3, pow.3, pow10.3, printf.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:55:02 +02:00
Michael Kerrisk 8f92fd96a8 INFINITY.3, exec.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fenv.3, fgetwc.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmod.3, fmtmsg.3, fpathconf.3, fpurge.3, fputwc.3, frexp.3, getgrent_r.3, getgrnam.3, gethostbyname.3, glob.3, hsearch.3, hypot.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:50:24 +02:00
Michael Kerrisk 3f89e93db7 encrypt.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:44:34 +02:00
Michael Kerrisk c8ee75723b confstr.3, copysign.3, cos.3, cosh.3, cpow.3, crypt.3, ctime.3, div.3, drand48_r.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:44:18 +02:00
Michael Kerrisk 9910d338e7 cmsg.3: Reorganize the text somewhat (no content changes)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:41:32 +02:00
Michael Kerrisk 79e1824a12 abs.3, acosh.3, aio_suspend.3, asin.3, asinh.3, atan.3, atanh.3, atoi.3, cbrt.3, ceil.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:33:21 +02:00
Michael Kerrisk 7e4e1fdb60 strcat.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:16:46 +02:00
Michael Kerrisk 67f2fdfef6 queue.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 10:27:58 +02:00
Michael Kerrisk 692637965f string.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 10:00:05 +02:00
Michael Kerrisk b9c93deb3d getgroups.2, getrlimit.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, semop.2, difftime.3, getpw.3, malloc_hook.3, mbrtowc.3, newlocale.3, offsetof.3, pthread_tryjoin_np.3, rand.3, rtnetlink.3, setbuf.3, strtol.3, fuse.4, feature_test_macros.7, pkeys.7: ffix: fix mismatched .EX/.EE tags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 22:16:47 +02:00
Michael Kerrisk 9bc87ed07a ctime.3, drand48.3, fmtmsg.3, getnameinfo.3, gsignal.3, strftime.3, strptime.3, cciss.4, console_codes.4, sd.4, sk98lin.4, st.4, proc.5, charsets.7, cpuset.7, pty.7, suffixes.7, udplite.7, unix.7: Use en-dash for ranges
Based on a patch by Bjarni Ingi Gislason.

Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 22:01:55 +02:00
Michael Kerrisk d2fdb1e30a memusage.1, time.1, ioctl_console.2, mmap.2, msync.2, perf_event_open.2, syslog.2, strptime.3, hd.4, sd.4: Use en-dash for ranges
Based on a patch by Bjarni Ingi Gislason.

Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 21:42:31 +02:00
Michael Kerrisk c788525612 getrlimit.2, signalfd.2, statfs.2, tee.2, dlopen.3, duplocale.3, ftw.3, get_nprocs.3, mbstowcs.3, posix_spawn.3, strftime.3, full.4, fanotify.7, inotify.7, ip.7, netdevice.7, rtld-audit.7, unix.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 21:02:23 +02:00
Michael Kerrisk 408731d435 intro.1, locale.1, ioctl_list.2, listxattr.2, memfd_create.2, nfsservctl.2, open_by_handle_at.2, perf_event_open.2, poll.2, process_vm_readv.2, ptrace.2, select.2, select_tut.2, semop.2, sendmmsg.2, shmget.2, sigaction.2, spu_run.2, umask.2, wait4.2, nan.3, setlocale.3, feature_test_macros.7, glob.7, posixoptions.7, rtld-audit.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:27 +02:00
Michael Kerrisk a2b7a14421 sinh.3, sockatmark.3, stdarg.3, stpcpy.3, syslog.3, system.3, tanh.3, termios.3, wctrans.3, wctype.3, wcwidth.3, wordexp.3, cciss.4, fuse.4, initrd.4, loop.4, acct.5, hosts.5, nss.5, operator.7, unix.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:27 +02:00
Michael Kerrisk 207050fa9e _syscall.2, shmget.2, stat.2, syscall.2, sysctl.2, utimensat.2, wait.2, CPU_SET.3, a64l.3, alloca.3, atexit.3, basename.3, cacos.3, cacosh.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, ccos.3, ccosh.3, cexp.3, cimag.3, clearenv.3, clog.3, conj.3, cosh.3, creal.3, csin.3, csinh.3, ctan.3, ctanh.3, difftime.3, div.3, dl_iterate_phdr.3, encrypt.3, envz_add.3, expm1.3, fenv.3, fmtmsg.3, fopen.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getcontext.3, getline.3, getpt.3, getpwnam.3, getsubopt.3, getttyent.3, getutent.3, hsearch.3, log1p.3, malloc_hook.3, malloc_info.3, mallopt.3, matherr.3, mbsinit.3, mempcpy.3, mtrace.3, nan.3, nl_langinfo.3, printf.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3, rpmatch.3, rtime.3, rtnetlink.3, scalb.3, scalbln.3, sigvec.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:27 +02:00
Michael Kerrisk b8302363ed execve.2, ioctl_console.2, ioctl_iflags.2, ioctl_ns.2, ioctl_userfaultfd.2, kcmp.2, kexec_load.2, keyctl.2, link.2, listxattr.2, membarrier.2, memfd_create.2, mmap.2, modify_ldt.2, mprotect.2, msgctl.2, nanosleep.2, open_by_handle_at.2, perf_event_open.2, poll.2, posix_fadvise.2, process_vm_readv.2, ptrace.2, query_module.2, quotactl.2, readdir.2, readv.2, recv.2, recvmmsg.2, request_key.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setattr.2, sched_setscheduler.2, seccomp.2, select.2, select_tut.2, semctl.2, semop.2, send.2, sendmmsg.2, set_thread_area.2, setns.2, shmctl.2, shmget.2, sigaction.2, sigaltstack.2, signal.2, sigwaitinfo.2, stat.2, statfs.2, statx.2, sync_file_range.2, syscall.2, sysctl.2, sysinfo.2, tee.2, timer_create.2, timer_settime.2, timerfd_create.2, unshare.2, userfaultfd.2, ustat.2, utime.2, utimensat.2, vmsplice.2, wait.2, adjtime.3, aio_init.3, backtrace.3, basename.3, bswap.3, btree.3, clock_getcpuclockid.3, cmsg.3, confstr.3, dbopen.3, dl_iterate_phdr.3, dladdr.3, dlinfo.3, dlopen.3, duplocale.3, encrypt.3, end.3, endian.3, err.3, errno.3, ether_aton.3, fgetgrent.3, fgetpwent.3, fmemopen.3, frexp.3, ftime.3, fts.3, getaddrinfo.3, getaddrinfo_a.3, getdate.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, getifaddrs.3, getipnodebyname.3, getmntent.3, getnameinfo.3, getnetent.3, getopt.3, getprotoent.3, getprotoent_r.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getservent.3, getservent_r.3, getspnam.3, getttyent.3, glob.3, gnu_get_libc_version.3, hash.3, hsearch.3, if_nameindex.3, inet.3, inet_net_pton.3, inet_pton.3, insque.3, isalpha.3, makecontext.3, mallinfo.3, malloc_info.3, mallopt.3, matherr.3, mbstowcs.3, mcheck.3, memchr.3, mq_getattr.3, mq_open.3, mq_receive.3, mq_send.3, mtrace.3, newlocale.3, ntp_gettime.3, posix_openpt.3, printf.3, pthread_attr_init.3, pthread_attr_setschedparam.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, pthread_tryjoin_np.3, readdir.3, realpath.3, recno.3, regex.3, rpc.3, scanf.3, sched_getcpu.3, sem_wait.3, setaliasent.3, sigqueue.3, statvfs.3, strcat.3, strcpy.3, strftime.3, strtok.3, strtol.3, strverscmp.3, toupper.3, ttyslot.3, xdr.3, fuse.4, loop.4, rtc.4, st.4, acct.5, core.5, elf.5, slabinfo.5, aio.7, arp.7, capabilities.7, cgroup_namespaces.7, cgroups.7, ddp.7, fanotify.7, feature_test_macros.7, inode.7, inotify.7, ip.7, keyrings.7, locale.7, mount_namespaces.7, namespaces.7, netdevice.7, netlink.7, packet.7, pkeys.7, pthreads.7, sched.7, session-keyring.7, sock_diag.7, socket.7, spufs.7, udplite.7, unix.7, user_namespaces.7, vdso.7, x25.7, ld.so.8: Use consistent markup for code snippets
Change .nf/.fi to .EX/.EE

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:27 +02:00
Michael Kerrisk e646a1bad9 ioctl_console.2, ioctl_getfsmap.2, ioctl_iflags.2, ioctl_list.2, ioctl_ns.2, kcmp.2, kexec_load.2, keyctl.2, link.2, mmap.2, modify_ldt.2, msgctl.2, poll.2, query_module.2, quotactl.2, recv.2, recvmmsg.2, sched_setscheduler.2, seccomp.2, select.2, semctl.2, semop.2, send.2, set_thread_area.2, setns.2, shmctl.2, shmget.2, sigaction.2, sysinfo.2, timer_create.2, timerfd_create.2, uname.2, unshare.2, userfaultfd.2, ustat.2, utimensat.2, vmsplice.2, wait.2, adjtime.3, backtrace.3, bswap.3, btree.3, clock_getcpuclockid.3, confstr.3, dbopen.3, dl_iterate_phdr.3, dlinfo.3, duplocale.3, encrypt.3, end.3, endian.3, err.3, errno.3, fmemopen.3, fopencookie.3, frexp.3, fts.3, ftw.3, getaddrinfo.3, getaddrinfo_a.3, getcontext.3, getgrouplist.3, getifaddrs.3, getipnodebyname.3, getnameinfo.3, getopt.3, getprotoent_r.3, getpwent_r.3, getrpcent.3, getservent_r.3, getttyent.3, getumask.3, glob.3, gnu_get_libc_version.3, hash.3, hsearch.3, inet.3, inet_pton.3, insque.3, isalpha.3, makecontext.3, mallopt.3, mbstowcs.3, mcheck.3, memchr.3, mq_getattr.3, mq_open.3, mtrace.3, newlocale.3, ntp_gettime.3, offsetof.3, posix_openpt.3, printf.3, pthread_setname_np.3, pthread_setschedparam.3, rpc.3, scanf.3, sched_getcpu.3, sem_wait.3, setaliasent.3, sigqueue.3, sigvec.3, stdarg.3, strcat.3, strcpy.3, strftime.3, strtol.3, toupper.3, ttyslot.3, fuse.4, loop.4, st.4, elf.5, cgroup_namespaces.7, cgroups.7, feature_test_macros.7, inode.7, inotify.7, keyrings.7, man-pages.7, math_error.7, mount_namespaces.7, mq_overview.7, pthreads.7, sched.7, session-keyring.7, udplite.7, unix.7, vdso.7: Use consistent markup for code snippets
The preferred form is

    .PP/.IP
    .in +4n
    .EX
    <code>
    .EE
    .in
    .PP/.IP

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:26 +02:00
Michael Kerrisk c4b7e5ac34 add_key.2, alloc_hugepages.2, execve.2, fanotify_init.2, getrlimit.2, listxattr.2, mmap.2, shmget.2, malloc.3, random.4, st.4, bootparam.7, epoll.7, keyrings.7, pipe.7, xattr.7: Use non-breaking space for measurement units
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:10 +02:00
Michael Kerrisk ee8655b59a arch_prctl.2, ioctl_fideduperange.2, ioctl_getfsmap.2, kexec_load.2, madvise.2, mbind.2, mmap.2, mmap2.2, mprotect.2, perf_event_open.2, process_vm_readv.2, set_mempolicy.2, shmget.2, subpage_prot.2, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, regex.3, wavelan.4, filesystems.5, proc.5, bootparam.7, raw.7, tcp.7, units.7, ld.so.8: Add a non-breaking space between a number and a unit (prefix)
Based on a patch by Bjarni Ingi Gislason.

According to SI, ""The numerical value always precedes the unit,
and a space is always used to separate the unit from the number
[...] The only exceptions to this rule are for the unit symbols
for degree, minute, and second for plane angle."

Cowritten-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 12:12:59 +02:00
Michael Kerrisk ab5736e921 btree.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 11:28:10 +02:00
Michael Kerrisk 11ac5b5109 add_key.2, bpf.2, fcntl.2, futex.2, listxattr.2, perf_event_open.2, prctl.2, request_key.2, sigaltstack.2, __ppc_set_ppr_med.3, __ppc_yield.3, getw.3, setbuf.3, setjmp.3, lirc.4, core.5, securetty.5, inode.7, keyrings.7, process-keyring.7, user-keyring.7, ld.so.8: srcfix: use .PP instead of .P
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 01:13:44 +02:00
Michael Kerrisk dd3568a147 getent.1, intro.1, time.1, _exit.2, alloc_hugepages.2, arch_prctl.2, clock_getres.2, getitimer.2, getrusage.2, intro.2, ioctl_console.2, ioctl_list.2, ioctl_tty.2, kill.2, madvise.2, mlock.2, mmap.2, mount.2, open.2, outb.2, perf_event_open.2, ptrace.2, quotactl.2, reboot.2, recv.2, remap_file_pages.2, select.2, semctl.2, send.2, set_tid_address.2, seteuid.2, shmop.2, statfs.2, times.2, truncate.2, uname.2, uselib.2, vm86.2, wait.2, a64l.3, aio_cancel.3, aio_fsync.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, atexit.3, basename.3, bindresvport.3, cacos.3, cacosh.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, catgets.3, catopen.3, cexp.3, cfree.3, cimag.3, clog.3, conj.3, creal.3, ctime.3, des_crypt.3, dirfd.3, div.3, dlopen.3, envz_add.3, exit.3, fenv.3, flockfile.3, fmtmsg.3, fpclassify.3, fpurge.3, fseeko.3, ftime.3, ftok.3, ftw.3, getcontext.3, getcwd.3, getdate.3, getfsent.3, getgrent.3, getgrnam.3, gethostbyname.3, getipnodebyname.3, getlogin.3, getpwnam.3, getrpcent.3, getspnam.3, getutent.3, gsignal.3, hsearch.3, lockf.3, logb.3, login.3, lseek64.3, makecontext.3, malloc.3, malloc_hook.3, nan.3, nl_langinfo.3, openpty.3, posix_spawn.3, putenv.3, realpath.3, remainder.3, rint.3, rpc.3, rtime.3, scandir.3, setlogmask.3, shm_open.3, sigpause.3, statvfs.3, stdio_ext.3, strfmon.3, strftime.3, strptime.3, strtod.3, strtol.3, strtoul.3, swab.3, sysconf.3, syslog.3, tcgetpgrp.3, tempnam.3, termios.3, tmpfile.3, tmpnam.3, ttyslot.3, tzset.3, ualarm.3, usleep.3, wordexp.3, xcrypt.3, xdr.3, cciss.4, console_codes.4, full.4, hd.4, loop.4, mem.4, null.4, pts.4, ram.4, random.4, tty.4, ttyS.4, vcs.4, networks.5, nsswitch.conf.5, protocols.5, resolv.conf.5, slabinfo.5, termcap.5, ascii.7, boot.7, bootparam.7, charsets.7, icmp.7, inode.7, man.7, netdevice.7, posixoptions.7, ld.so.8: srcfix: use .PP instead of .LP
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 01:12:54 +02:00
Michael Kerrisk 51f5698d3c capget.2, gettimeofday.2, nanosleep.2, process_vm_readv.2, readv.2, seccomp.2, semop.2, sigaction.2, sigwaitinfo.2, dbopen.3, dladdr.3, ether_aton.3, fenv.3, fgetgrent.3, fgetpwent.3, frexp.3, ftime.3, gamma.3, getaddrinfo.3, getaddrinfo_a.3, getgrent_r.3, getgrnam.3, gethostbyname.3, getifaddrs.3, getipnodebyname.3, getmntent.3, getnetent.3, getprotoent.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getservent.3, getspnam.3, getutent.3, glob.3, hsearch.3, if_nameindex.3, inet.3, mq_receive.3, putgrent.3, putpwent.3, rand.3, sigqueue.3, strfromd.3, strptime.3, strtol.3, termios.3, timeradd.3, lp.4, tty.4, ip.7, ipv6.7, netdevice.7, raw.7, rtnetlink.7, units.7, zic.8: ffix: replace .sp by .PP
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 01:00:48 +02:00
Michael Kerrisk bdd915e20f _syscall.2, capget.2, ioprio_set.2, semop.2, send.2, ctime.3, dysize.3, fenv.3, fmtmsg.3, ftok.3, ftw.3, getaddrinfo.3, getgrent_r.3, gethostbyname.3, getopt.3, getpw.3, getpwent_r.3, getsubopt.3, getutent.3, glob.3, if_nameindex.3, inet.3, lseek64.3, malloc_hook.3, mbrtowc.3, mkstemp.3, mq_receive.3, mq_send.3, posix_spawn.3, putgrent.3, putpwent.3, qsort.3, raise.3, rand.3, rtime.3, setaliasent.3, setbuf.3, shm_open.3, significand.3, sigqueue.3, statvfs.3, strfromd.3, strptime.3, strtol.3, strtoul.3, termios.3, tgamma.3, timeradd.3, tsearch.3, tzset.3, updwtmp.3, usleep.3, wcstok.3, console_codes.4, hd.4, hpsa.4, mem.4, null.4, ram.4, sd.4, ttyS.4, filesystems.5, group.5, passwd.5, shells.5, termcap.5, ttytype.5, tzfile.5, utmp.5, ascii.7, bootparam.7, complex.7, cpuset.7, epoll.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-17 23:40:17 +02:00
Michael Kerrisk ba39b288ab fcntl.2, ioctl_tty.2, kcmp.2, prctl.2, semop.2, swapon.2, atof.3, atoi.3, bsearch.3, cfree.3, ctime.3, drand48.3, errno.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-17 13:41:27 +02:00
Michael Kerrisk e7d0bb4715 memusage.1, clone.2, eventfd.2, futex.2, getdents.2, ioctl_fat.2, ioctl_ns.2, kcmp.2, keyctl.2, mmap.2, mprotect.2, msgop.2, recvmmsg.2, request_key.2, sched_setaffinity.2, seccomp.2, setns.2, tee.2, timer_create.2, timerfd_create.2, unshare.2, userfaultfd.2, wait.2, __ppc_get_timebase.3, backtrace.3, bswap.3, clock_getcpuclockid.3, dl_iterate_phdr.3, dlinfo.3, dlopen.3, duplocale.3, end.3, endian.3, fmemopen.3, fopencookie.3, frexp.3, ftw.3, getdate.3, getgrouplist.3, getifaddrs.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, if_nameindex.3, inet.3, inet_net_pton.3, inet_pton.3, insque.3, makecontext.3, mallinfo.3, malloc_info.3, mallopt.3, matherr.3, mbstowcs.3, mcheck.3, mq_getattr.3, mq_notify.3, newlocale.3, offsetof.3, posix_spawn.3, pthread_attr_init.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_create.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, scandir.3, sem_wait.3, strcat.3, strftime.3, strtok.3, strtol.3, strverscmp.3, loop.4, core.5, aio.7, fanotify.7, feature_test_macros.7, inotify.7, pkeys.7, unix.7, user_namespaces.7: Use .EX/.EE for EXAMPLE programs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 10:44:33 +02:00
Michael Kerrisk 75b8c5b935 strfmon.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 05:16:19 +02:00
Michael Kerrisk 847e0d8871 CPU_SET.3, INFINITY.3, __ppc_get_timebase.3, __ppc_set_ppr_med.3, __ppc_yield.3, __setfpucw.3, acos.3, acosh.3, adjtime.3, aio_fsync.3, aio_init.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, backtrace.3, basename.3, bindresvport.3, bsd_signal.3, bsearch.3, bswap.3, btree.3, byteorder.3, bzero.3, canonicalize_file_name.3, carg.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cexp.3, clearenv.3, clock.3, clog.3, clog10.3, clog2.3, confstr.3, copysign.3, cos.3, cosh.3, crypt.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctime.3, dbopen.3, dl_iterate_phdr.3, dladdr.3, dlerror.3, dlinfo.3, dlopen.3, dlsym.3, drand48_r.3, duplocale.3, encrypt.3, end.3, endian.3, envz_add.3, erf.3, erfc.3, err.3, errno.3, error.3, euidaccess.3, exec.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fcloseall.3, fdim.3, fenv.3, ferror.3, fexecve.3, fflush.3, ffs.3, fgetc.3, finite.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fmtmsg.3, fopen.3, fopencookie.3, fpclassify.3, fpurge.3, fputwc.3, fputws.3, frexp.3, fseek.3, fseeko.3, ftime.3, fts.3, ftw.3, futimes.3, gamma.3, gcvt.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcwd.3, getdate.3, getentropy.3, getenv.3, getfsent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getifaddrs.3, getline.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent.3, getnetent_r.3, getopt.3, getprotoent.3, getprotoent_r.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getrpcent_r.3, getrpcport.3, gets.3, getservent.3, getservent_r.3, getspnam.3, getsubopt.3, getttyent.3, getutent.3, getwchar.3, glob.3, gnu_get_libc_version.3, grantpt.3, gsignal.3, hash.3, hsearch.3, hypot.3, iconv.3, iconv_close.3, iconv_open.3, if_nameindex.3, if_nametoindex.3, ilogb.3, inet.3, inet_net_pton.3, inet_ntop.3, initgroups.3, insque.3, intro.3, isalpha.3, isgreater.3, j0.3, key_setsecret.3, killpg.3, ldexp.3, lgamma.3, lio_listio.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, makedev.3, mallinfo.3, malloc_get_state.3, malloc_info.3, malloc_stats.3, malloc_trim.3, malloc_usable_size.3, mallopt.3, matherr.3, mbsnrtowcs.3, mbsrtowcs.3, mcheck.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mpool.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mtrace.3, newlocale.3, nextafter.3, nextup.3, nl_langinfo.3, ntp_gettime.3, offsetof.3, on_exit.3, open_memstream.3, opendir.3, openpty.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, program_invocation_name.3, psignal.3, pthread_atfork.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_detach.3, pthread_exit.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_join.3, pthread_kill.3, pthread_kill_other_threads_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_testcancel.3, pthread_tryjoin_np.3, ptsname.3, putgrent.3, putpwent.3, qsort.3, random.3, random_r.3, rcmd.3, re_comp.3, readdir.3, realpath.3, recno.3, regex.3, remainder.3, remove.3, remquo.3, resolver.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, rtime.3, scalb.3, scalbln.3, scandir.3, scanf.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_wait.3, setbuf.3, setenv.3, setlocale.3, setlogmask.3, setnetgrent.3, shm_open.3, signbit.3, significand.3, sigpause.3, sigqueue.3, sigset.3, sigvec.3, sin.3, sincos.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stdarg.3, stdin.3, strcasecmp.3, strcat.3, strchr.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfmon.3, strfromd.3, strftime.3, strptime.3, strsignal.3, strstr.3, strtod.3, strtok.3, strtol.3, strtoul.3, syslog.3, system.3, sysv_signal.3, tan.3, tanh.3, telldir.3, tempnam.3, termios.3, tgamma.3, timeradd.3, tmpnam.3, toupper.3, towlower.3, towupper.3, trunc.3, tzset.3, ualarm.3, ulimit.3, undocumented.3, unlocked_stdio.3, updwtmp.3, uselocale.3, usleep.3, wcrtomb.3, wcsdup.3, wcsnrtombs.3, wcsrtombs.3, wcstombs.3, wctob.3, wcwidth.3, wordexp.3, wprintf.3, xcrypt.3, xdr.3, y0.3: Formatting fix: replace blank lines with .PP/.IP
Blank lines shouldn't generally appear in *roff source (other
than in code examples), since they create large vertical
spaces between text blocks.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 05:13:02 +02:00
Sukadev Bhattiprolu cf699fb57e cmsg.3: Add a scatter/gather buffer to sample code
Add a simple scatter/gather buffer to the cmsg sample code.

It appears that the scatter/gather buffer is required even though
it may not be used. In my testing (on Fedora 24
4.8.7-200.fc24.x86_64 as well as a 4.11 based kernel) return value
of sendmsg() was the number of bytes in the scatter/gather buffer
(1 with the patch below).

Without the iovec buffer, sendmsg() returns 0 which means no bytes
were transferred and the corresponding recvmsg() blocks
indefinitely.

Signed-off-by: Sukadev Bhattiprolu <sukadev@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 02:29:29 +02:00
Michael Kerrisk d8026103cb posix_memalign.3, loop.4: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 00:15:02 +02:00
Alex Henrie 523e7e59ad log1p.3: Document fixes to give EDOM or ERANGE on error
The bug https://www.sourceware.org/bugzilla/show_bug.cgi?id=6792
was fixed in glibc 2.22.

Signed-off-by: Alex Henrie <alexhenrie24@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 20:45:09 +02:00
Michael Kerrisk dbfe9c700e _syscall.2, clock_getres.2, clone.2, copy_file_range.2, create_module.2, delete_module.2, fallocate.2, futex.2, get_kernel_syms.2, get_robust_list.2, getcpu.2, getdents.2, gettid.2, gettimeofday.2, getunwind.2, init_module.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioctl_userfaultfd.2, ioprio_set.2, kcmp.2, kexec_load.2, keyctl.2, link.2, llseek.2, memfd_create.2, mmap.2, mq_getsetattr.2, msgctl.2, msgget.2, open_by_handle_at.2, outb.2, perf_event_open.2, pivot_root.2, process_vm_readv.2, query_module.2, readdir.2, recvmmsg.2, rename.2, request_key.2, restart_syscall.2, rt_sigqueueinfo.2, s390_pci_mmio_write.2, s390_runtime_instr.2, sched_setattr.2, seccomp.2, select.2, select_tut.2, send.2, sendmmsg.2, set_thread_area.2, set_tid_address.2, sgetmask.2, shmop.2, sigaction.2, sigprocmask.2, splice.2, spu_create.2, spu_run.2, statx.2, subpage_prot.2, sync_file_range.2, syscall.2, sysctl.2, sysfs.2, tee.2, timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, tkill.2, uselib.2, utimensat.2, vmsplice.2, wait.2, aio_init.3, asinh.3, atan2.3, atanh.3, backtrace.3, basename.3, bswap.3, bzero.3, catgets.3, catopen.3, dladdr.3, dlsym.3, endian.3, envz_add.3, erf.3, erfc.3, error.3, ferror.3, ffs.3, fgetc.3, fmemopen.3, fopen.3, fopencookie.3, fseek.3, ftw.3, futimes.3, getdate.3, getenv.3, getline.3, getlogin.3, getrpcent.3, getsubopt.3, getutmp.3, getw.3, gnu_get_libc_version.3, inet_net_pton.3, isalpha.3, lio_listio.3, makedev.3, malloc_get_state.3, malloc_stats.3, malloc_trim.3, malloc_usable_size.3, matherr.3, memchr.3, nextup.3, ntp_gettime.3, posix_madvise.3, program_invocation_name.3, pthread_atfork.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cleanup_push_defer_np.3, pthread_detach.3, pthread_equal.3, pthread_exit.3, pthread_join.3, pthread_kill.3, pthread_kill_other_threads_np.3, pthread_rwlockattr_setkind_np.3, pthread_self.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setschedprio.3, pthread_testcancel.3, pthread_tryjoin_np.3, pthread_yield.3, puts.3, random.3, random_r.3, rpc.3, sched_getcpu.3, setnetgrent.3, sigwait.3, stdin.3, strerror.3, strfmon.3, timeradd.3, tmpnam.3, toupper.3, towlower.3, towupper.3, ttyname.3, uselocale.3, xdr.3, dsp56k.4, sigevent.7, vdso.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 19:39:04 +02:00
Michael Kerrisk f90f031e0f _exit.2, accept.2, chmod.2, dup.2, getgroups.2, keyctl.2, link.2, mkdir.2, mknod.2, pipe.2, poll.2, reboot.2, rename.2, select.2, select_tut.2, stat.2, symlink.2, unlink.2, __ppc_get_timebase.3, abs.3, bzero.3, crypt.3, dbopen.3, dl_iterate_phdr.3, dlinfo.3, dlsym.3, duplocale.3, encrypt.3, err.3, ffs.3, fpurge.3, ftw.3, getdate.3, gethostbyname.3, getlogin.3, getmntent.3, getpwent_r.3, getpwnam.3, getspnam.3, inet_pton.3, insque.3, isfdtype.3, mallinfo.3, mallopt.3, matherr.3, mcheck.3, mempcpy.3, mkfifo.3, mq_getattr.3, newlocale.3, open_memstream.3, openpty.3, perror.3, posix_memalign.3, posix_spawn.3, printf.3, pthread_attr_init.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_create.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_setaffinity_np.3, pthread_setschedparam.3, pthread_sigmask.3, pthread_sigqueue.3, regex.3, resolver.3, rpmatch.3, rtnetlink.3, scanf.3, setbuf.3, strchr.3, strfromd.3, strverscmp.3, termios.3, tsearch.3, unlocked_stdio.3, updwtmp.3, netlink.7, rtld-audit.7, sock_diag.7, unix.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 17:44:09 +02:00
Michael Kerrisk 68e4db0a44 _exit.2, bpf.2, cacheflush.2, capget.2, chdir.2, chmod.2, chroot.2, clock_getres.2, clock_nanosleep.2, close.2, connect.2, create_module.2, dup.2, epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, execve.2, execveat.2, exit_group.2, fanotify_mark.2, flock.2, fork.2, fsync.2, futex.2, futimesat.2, get_kernel_syms.2, get_mempolicy.2, get_robust_list.2, getcpu.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getitimer.2, getpagesize.2, getpeername.2, getpid.2, getpriority.2, getrandom.2, getresuid.2, getrlimit.2, getrusage.2, getsid.2, getsockname.2, getsockopt.2, gettid.2, gettimeofday.2, getuid.2, getunwind.2, getxattr.2, idle.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, ioctl.2, ioctl_fat.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, ioctl_getfsmap.2, ioctl_tty.2, ioperm.2, iopl.2, keyctl.2, kill.2, link.2, listen.2, listxattr.2, llseek.2, lseek.2, madvise.2, mbind.2, membarrier.2, memfd_create.2, migrate_pages.2, mincore.2, mkdir.2, mknod.2, mlock.2, mmap.2, mmap2.2, modify_ldt.2, mount.2, move_pages.2, mprotect.2, mq_getsetattr.2, mremap.2, msgop.2, msync.2, nanosleep.2, nfsservctl.2, nice.2, pause.2, pciconfig_read.2, perf_event_open.2, perfmonctl.2, personality.2, pkey_alloc.2, poll.2, posix_fadvise.2, prctl.2, pread.2, process_vm_readv.2, ptrace.2, query_module.2, read.2, readahead.2, readdir.2, readv.2, reboot.2, recv.2, remap_file_pages.2, removexattr.2, rename.2, request_key.2, rmdir.2, rt_sigqueueinfo.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, select.2, select_tut.2, semctl.2, semget.2, semop.2, send.2, sendfile.2, set_mempolicy.2, set_tid_address.2, seteuid.2, setfsgid.2, setfsuid.2, setgid.2, setns.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, setup.2, setxattr.2, sgetmask.2, shmctl.2, shmget.2, shutdown.2, sigaction.2, sigaltstack.2, sigpending.2, sigprocmask.2, sigsuspend.2, sigwaitinfo.2, socket.2, socketcall.2, socketpair.2, stat.2, statfs.2, stime.2, swapon.2, symlink.2, sync.2, sysctl.2, sysinfo.2, syslog.2, time.2, timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, timerfd_create.2, times.2, tkill.2, truncate.2, umask.2, umount.2, uname.2, unlink.2, unshare.2, uselib.2, userfaultfd.2, ustat.2, utime.2, utimensat.2, vfork.2, vhangup.2, vm86.2, wait.2, wait4.2, write.2, CPU_SET.3, INFINITY.3, __ppc_get_timebase.3, __ppc_set_ppr_med.3, __ppc_yield.3, __setfpucw.3, a64l.3, abort.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, aio_cancel.3, aio_error.3, aio_fsync.3, aio_init.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, atof.3, atoi.3, basename.3, bcmp.3, bcopy.3, bsd_signal.3, bsearch.3, bstring.3, btowc.3, byteorder.3, cabs.3, cacos.3, cacosh.3, canonicalize_file_name.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, catopen.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cexp.3, cexp2.3, cfree.3, cimag.3, clearenv.3, clock.3, clock_getcpuclockid.3, clog.3, clog10.3, clog2.3, closedir.3, cmsg.3, confstr.3, conj.3, copysign.3, cos.3, cosh.3, cpow.3, cproj.3, creal.3, crypt.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctermid.3, ctime.3, daemon.3, difftime.3, dirfd.3, div.3, dlerror.3, dlopen.3, dlsym.3, drand48.3, drand48_r.3, duplocale.3, dysize.3, ecvt.3, ecvt_r.3, encrypt.3, endian.3, erf.3, erfc.3, err.3, errno.3, ether_aton.3, euidaccess.3, exec.3, exit.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fclose.3, fcloseall.3, fdim.3, fenv.3, ferror.3, fexecve.3, fflush.3, ffs.3, fgetc.3, fgetgrent.3, fgetpwent.3, fgetwc.3, fgetws.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fmtmsg.3, fnmatch.3, fopen.3, fpathconf.3, fpclassify.3, fpurge.3, fputwc.3, fputws.3, fread.3, frexp.3, fseek.3, fseeko.3, ftime.3, ftok.3, fts.3, ftw.3, futimes.3, fwide.3, gamma.3, gcvt.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcontext.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getentropy.3, getenv.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getifaddrs.3, getipnodebyname.3, getline.3, getloadavg.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent.3, getnetent_r.3, getopt.3, getpass.3, getprotoent.3, getprotoent_r.3, getpt.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent_r.3, getrpcport.3, gets.3, getservent.3, getservent_r.3, getspnam.3, getsubopt.3, getttyent.3, getumask.3, getusershell.3, getutent.3, getw.3, getwchar.3, glob.3, grantpt.3, group_member.3, gsignal.3, hsearch.3, hypot.3, iconv.3, iconv_close.3, iconv_open.3, if_nameindex.3, if_nametoindex.3, ilogb.3, index.3, inet.3, inet_net_pton.3, inet_ntop.3, infnan.3, initgroups.3, insque.3, isalpha.3, isatty.3, isfdtype.3, isgreater.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, j0.3, key_setsecret.3, killpg.3, ldexp.3, lgamma.3, localeconv.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, malloc.3, malloc_get_state.3, malloc_hook.3, malloc_info.3, matherr.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, mcheck.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, mempcpy.3, memset.3, mkdtemp.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mpool.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mq_unlink.3, mtrace.3, nan.3, netlink.3, newlocale.3, nextafter.3, nl_langinfo.3, offsetof.3, on_exit.3, open_memstream.3, opendir.3, openpty.3, perror.3, popen.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, posix_openpt.3, pow.3, pow10.3, printf.3, profil.3, psignal.3, pthread_atfork.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_detach.3, pthread_equal.3, pthread_exit.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_join.3, pthread_kill.3, pthread_rwlockattr_setkind_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_testcancel.3, pthread_tryjoin_np.3, pthread_yield.3, ptsname.3, putenv.3, putgrent.3, putpwent.3, puts.3, putwchar.3, qecvt.3, qsort.3, raise.3, rand.3, random.3, random_r.3, rcmd.3, re_comp.3, readdir.3, realpath.3, remainder.3, remove.3, remquo.3, resolver.3, rewinddir.3, rexec.3, rint.3, round.3, rpmatch.3, rtime.3, rtnetlink.3, scalb.3, scalbln.3, scandir.3, scanf.3, sched_getcpu.3, seekdir.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_post.3, sem_unlink.3, sem_wait.3, setaliasent.3, setbuf.3, setenv.3, setlocale.3, setlogmask.3, setnetgrent.3, shm_open.3, siginterrupt.3, signbit.3, significand.3, sigpause.3, sigqueue.3, sigset.3, sigvec.3, sigwait.3, sin.3, sincos.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stdarg.3, stdio.3, stdio_ext.3, stpcpy.3, stpncpy.3, strcasecmp.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfmon.3, strfromd.3, strfry.3, strftime.3, strlen.3, strnlen.3, strpbrk.3, strptime.3, strsep.3, strsignal.3, strspn.3, strstr.3, strtod.3, strtoimax.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, strxfrm.3, swab.3, sysconf.3, syslog.3, system.3, sysv_signal.3, tan.3, tanh.3, tcgetpgrp.3, tcgetsid.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, toupper.3, towctrans.3, towlower.3, towupper.3, trunc.3, tsearch.3, ttyname.3, ttyslot.3, tzset.3, ualarm.3, ulimit.3, ungetwc.3, unlocked_stdio.3, unlockpt.3, updwtmp.3, uselocale.3, usleep.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscasecmp.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcsdup.3, wcslen.3, wcsncasecmp.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstoimax.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wordexp.3, wprintf.3, xcrypt.3, y0.3, dsp56k.4, random.4, rtc.4, st.4, ddp.7, ip.7, ipv6.7, packet.7, rtnetlink.7, socket.7, tcp.7, udp.7, udplite.7, x25.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 17:16:29 +02:00
Michael Kerrisk 019d9ee872 getauxval.3, cciss.4, cpuid.4, msr.4, proc.5, tmpfs.5, man-pages.7, pid_namespaces.7, ld.so.8, nscd.8: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 16:15:21 +02:00
Michael Kerrisk aa80442a5d readdir_r.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-14 13:35:45 +02:00
Michael Kerrisk 6db9f2db52 sigsetops.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-14 09:12:50 +02:00
Michael Kerrisk 7736b88651 setjmp.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-14 09:11:00 +02:00
Michael Kerrisk 0c545d6712 setjmp.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-14 09:09:13 +02:00
Michael Kerrisk f47758ba0a strverscmp.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 22:29:51 +02:00
Michael Kerrisk 172070f8dc strverscmp.3: srcfix: remove excess .in tag
Reported-by: Sam Varshavchik <mrsam@courier-mta.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 22:27:59 +02:00
Alex Henrie 377ec1fda7 exp2.3: Remove C89 designation
[mtk: Confirmed by consulting C90 draft standard]

Signed-off-by: Alex Henrie <alexhenrie24@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-22 09:23:16 +02:00
Michael Kerrisk 230ed8339d Removed trailing white space at end of lines 2017-07-13 14:22:45 +02:00
Michael Kerrisk f55a6d598d Changes, ldd.1, chown.2, epoll_wait.2, get_mempolicy.2, ioctl_getfsmap.2, madvise.2, membarrier.2, mount.2, pipe.2, readv.2, seccomp.2, sigaltstack.2, splice.2, tee.2, timer_create.2, vmsplice.2, acosh.3, asinh.3, atanh.3, bsd_signal.3, dl_iterate_phdr.3, dlsym.3, flockfile.3, fpathconf.3, ftw.3, getaddrinfo.3, getcontext.3, getgrent.3, if_nametoindex.3, malloc.3, nl_langinfo.3, posix_madvise.3, ptsname.3, rand.3, resolver.3, sigpause.3, sigwait.3, strtol.3, sysconf.3, ttyslot.3, unlocked_stdio.3, unlockpt.3, capabilities.7, cgroup_namespaces.7, inode.7, man.7, pipe.7, sigevent.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-13 14:22:45 +02:00
Long Wang f0e956cafb getline.3: wfix
Signed-off-by: Long Wang <w@laoqinren.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-12 19:36:34 +02:00
Alex Henrie 7cada58cad acosh.3, asinh.3, atanh.3: Remove C89 designation.
See https://bugzilla.kernel.org/show_bug.cgi?id=196319

[mtk: confirmed from review of draft of C90 standard]

Signed-off-by: Alex Henrie <alexhenrie24@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-11 09:59:50 +02:00
Joe Brown 5df38b3325 getaddrinfo.3: wsfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:39:08 +02:00
Carlos O'Donell 0d4f6d6f88 getcontext.3: Exemplar structure should use 'ucontext_t'.
In glibc we just finished a round of purging 'struct ucontext'
which is not in the POSIX reserved namespace of *_t tags. This has
some consequences to applications using the non-standard struct
ucontext:
https://sourceware.org/glibc/wiki/Release/2.26#Removal_of_.27struct_ucontext.27
but it also fixes a namespace conformance issue which is always a
longterm pain for large portable programs.

It was noted by Peter Maydell
(https://sourceware.org/bugzilla/show_bug.cgi?id=21457) that the
linux man pages still had references to 'struct ucontext' but only
in the form of an exemplar structure.

The patch fixes the exemplar to match what is in glibc
and therefore it won't ever suggest users can use 'struct
ucontext'.

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:29:59 +02:00
Dr. Tobias Quathamer be3b29c722 posix_madvise.3: Remove paragraph about POSIX_FADV_NOREUSE
POSIX_FADV_NOREUSE is documented for posix_fadvise, and a
corresponding POSIX_MADV_NOREUSE flag is not specified by POSIX.

Thanks to Marc Lehmann <debian-reportbug@plan9.de>
See https://bugs.debian.org/865699

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:26:46 +02:00
Jakub Wilk c52ba260ff ttyslot.3: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:19:25 +02:00
Michael Kerrisk 2ad31d9de8 ttyname.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-25 12:15:59 +02:00
Michael Kerrisk f57d94ca99 malloc.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 16:29:50 +02:00
Michael Kerrisk bc045fdd60 malloc.3: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 16:29:50 +02:00
Michael Kerrisk 081eeee527 malloc.3: Document the reallocarray() added in glibc 2.26
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 16:29:50 +02:00
Michael Kerrisk 4b80e269ee malloc.3: Minor clarification to CONFORMING TO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 15:42:17 +02:00
Michael Kerrisk ceaad4d829 cfree.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 15:35:55 +02:00
Michael Kerrisk bc051678fe fpathconf.3: srcfix: Add self to copyright notice
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 21:15:57 +02:00
Michael Kerrisk 3509905bd8 fpathconf.3: Largely rewrite the description of _PC_CHOWN_RESTRICTED
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 21:14:56 +02:00
Michael Kerrisk 6cde427101 fpathconf.3: Rewrite description of _PC_PIPE_BUF
The existing description was not accurate, and lacked details.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:58:17 +02:00
Michael Kerrisk 09c8f2e4ea fpathconf.3: Add an errors section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:50:53 +02:00
Michael Kerrisk a282334152 fpathconf.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:31:06 +02:00
Michael Kerrisk 5425e5c59c fpathconf.3: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:29:49 +02:00
Michael Kerrisk 081a3c719b fpathconf.3: Rework RETURN VALUE description to add more detail
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:29:49 +02:00
Michael Kerrisk 480ef6d924 sysconf.3: Rework RETURN VALUE description to add more detail
Make the discussion clearer, and add a few details.
Also, fix the problem report from Pavel Tikhomirov
who noted that the man page falsely said that errno
is not changed on a successful return.

Addresses https://bugzilla.kernel.org/show_bug.cgi?id=195955

Reported-by: Pavel Tikhomirov <ptikhomirov@virtuozzo.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:29:49 +02:00
Michael Kerrisk 386732aa86 sysconf.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-17 10:40:40 +02:00
Michael Kerrisk 646896d32c sysconf.3: Add ERRORS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-17 09:53:56 +02:00
Michael Kerrisk 26bab9df0b getgrent.3, sigwait.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:45 +02:00
Michael Kerrisk bccf0b0760 getgrent.3: Note glibc 2.22 changes for feature test macro requirements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:45 +02:00
Michael Kerrisk 2079d4344e sigpause.3: Note glibc 2.26 changes to feature test macro requirements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:45 +02:00
Michael Kerrisk cc7fb6123a sigpause.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:45 +02:00
Michael Kerrisk 4c931ba32b nl_langinfo.3: Note feature test macro requirements for nl_langinfo_l()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk 06adeea53d sigwait.3: Note glibc 2.26 feature test macro changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk 940758abfe bsd_signal.3: Note feature test macro requirements changes for glibc 2.26
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk a97ae929a6 flockfile.3: Note glibc 2.24 feature test macro requirement changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk f83b1bbc94 unlocked_stdio.3: Note glibc 2.24 feature test macro requirement changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk 7676eafe87 ptsname.3: Since glibc 2.26, ptsname_r() no longer gives EINVAL for buf==NULL
Reported-by: Arjun Shankar <arjun.is@lostca.se>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Ferdinand Thiessen c2ba3716a9 grantpt.3, ptsname.3, unlockpt.3: Update feature test macro-requirements for glibc 2.24
Cowritten-by: Michael Kerrisk <mtk.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk b49377954c rand.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk c3a558fae9 rand.3: Note glibc 2.24 feature test macro requirement changes for rand_r()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk f30306c4a2 ttyslot.3: Note feature test macro requirements changes in glibc 2.24
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk 3f1873a8e3 ttyslot.3: Fix error in feature test macro requirements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk f8c8a9031d ttyslot.3: Clarify details of use of <stdlib.h> file
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk 62dc68ae00 ttyslot.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk ab67ced080 resolver.3: Add basic notes on 'op' argument of res_nmkquery() and res_mkquery()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 07:49:06 +02:00
Quentin Rameau 94db8ae182 getaddrinfo.3: Fix _POSIX_C_SOURCE value for getaddrinfo()
The correct _POSIX_C_SOURCE value is 200112L, not 201112L in features.h.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-11 08:14:05 +02:00
Michael Kerrisk 687d31a42f ftw.3: BUGS: document a probable glibc regression in FTW_SLN case
See https://bugzilla.redhat.com/show_bug.cgi?id=1422736
and http://austingroupbugs.net/view.php?id=1121.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-10 21:52:48 +02:00
Michael Kerrisk cbc091e863 ftw.3: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-10 20:58:35 +02:00
Michael Kerrisk b8f9afd0ad ftw.3: Minor clarification of 'ftwbuf' argument to callback function
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-10 20:58:26 +02:00
Michael Kerrisk 75970bd63f getnameinfo.3: wfix
Reported-by: Cameron Wright <wright18@uw.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-03 18:45:15 +02:00
Michael Kerrisk 3a9a2ecbe1 shm_open.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-26 14:32:26 +02:00
Michael Kerrisk 475fea9aeb memcpy.3: wfix
Reported-by: Henry Bent <henry.r.bent@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-21 11:47:00 +02:00
Michael Kerrisk f9ce70d255 dlsym.3: _GNU_SOURCE is needed to get RTLD_DEFAULT and RTLD_NEXT definitions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-14 12:02:38 +02:00
Michael Kerrisk 797981eb03 dl_iterate_phdr.3: dl_iterate_phdr() shows the order in which objects were loaded
dl_iterate_phdr() tells us not just which objects are
loaded, but also the order in which they are loaded
(the "link-map order"). Since the order is relevant for
understanding symbol resolution, give the reader this clue.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-13 11:33:00 +02:00
Michael Kerrisk 91a2771d06 dl_iterate_phdr.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-12 13:43:56 +02:00
Michael Kerrisk 6736a8024c dl_iterate_phdr.3: Expand the code example, and show sample output
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-12 13:43:56 +02:00
Michael Kerrisk c4054f820e dl_iterate_phdr.3: List values for the 'p_type' field
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-12 13:26:22 +02:00
Douglas Caetano dos Santos 1187f16f2d if_nametoindex.3: Add ENODEV error for if_nametoindex()
Checked against glibc and kernel code: when given name isn't
a valid interface, kernel returns ENODEV and glibc just
forwards it.

Signed-off-by: Douglas Caetano dos Santos <douglascs@taghos.com.br>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-09 21:19:06 +02:00
Douglas Caetano dos Santos d0cdb0ef0a if_nameindex.3: tfix
Signed-off-by: Douglas Caetano dos Santos <douglascs@taghos.com.br>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-09 21:18:18 +02:00
Heinrich Schuchardt e5b5658c6e strtol.3: Mention 0X prefix
The prefix 0x may be capitalized as 0X.

See ISO/IEC 9899:1999.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-08 11:00:20 +02:00
Michael Kerrisk 734882f4c4 _exit.2, alarm.2, chmod.2, clone.2, epoll_ctl.2, fcntl.2, fork.2, fsync.2, getdents.2, getpid.2, ioctl.2, ioctl_console.2, ioctl_list.2, ioctl_ns.2, ioctl_tty.2, ioctl_userfaultfd.2, kexec_load.2, lseek.2, mincore.2, mkdir.2, mknod.2, mmap.2, open.2, poll.2, posix_fadvise.2, prctl.2, rename.2, sched_setaffinity.2, select.2, select_tut.2, sigaction.2, signalfd.2, sigprocmask.2, sigwaitinfo.2, socketcall.2, stat.2, statx.2, syscalls.2, truncate.2, umask.2, unshare.2, userfaultfd.2, utime.2, utimensat.2, wait.2, bzero.3, cfree.3, exit.3, getentropy.3, grantpt.3, insque.3, shm_open.3, syslog.3, termios.3, ttyname.3, wcsdup.3, console_codes.4, tty.4, vcs.4, elf.5, nsswitch.conf.5, proc.5, slabinfo.5, tmpfs.5, bootparam.7, environ.7, hostname.7, inotify.7, mailaddr.7, man-pages.7, namespaces.7, pid_namespaces.7, pthreads.7, pty.7, sem_overview.7, signal.7, socket.7, tcp.7, termio.7, user_namespaces.7, xattr.7, ld.so.8, zdump.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-03 19:27:48 +02:00
Jakub Wilk ba7fd6d583 ulimit.3: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-02 22:17:23 +02:00
Marko Myllynen 78cba5ac49 getentropy.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-27 14:29:03 +02:00
Michael Kerrisk 3b2a285b58 cfree.3: cfree() is removed from glibc in version 2.26
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:37 +02:00
Michael Kerrisk af70d80c47 getrpcport.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 21:19:08 +02:00
Michael Kerrisk e9d4c9a033 insque.3: SEE ALSO: add queue(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 21:16:38 +02:00
Michael Kerrisk 413579fc3b queue.3: SEE ALSO: add insque(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 21:16:38 +02:00
Michael Kerrisk 2c43dda391 ttyname.3: wfix
Reported-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk 0289964456 ttyname.3: Minor edits to Christian Brauner's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Christian Brauner 953385d532 ttyname(3): NOTES: warn about a confusing case that may occur with mount namespaces
Signed-off-by: Christian Brauner <christian.brauner@ubuntu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk baf7fedbab setjmp.3: tfix
Reported-by: Ben Dog <wsy2220@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk 14ecabec05 errno.3: wfix
Reported-by: 丁贵强<dingguiqiang@foxmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-20 21:21:51 +02:00
Michael Kerrisk f0ed97100f getentropy.3: Some improvements to Nikos Mavrogiannopoulos's patch
Reported-by: Florian Weimer <fw@deneb.enyo.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 14:10:11 +02:00
Michael Kerrisk 419ba7b3c5 getentropy.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 14:02:54 +02:00
Nikos Mavrogiannopoulos 9cf011f94b getentropy.3: Correct header file
Signed-off-by: Nikos Mavrogiannopoulos <nmav@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 14:00:22 +02:00
Michael Kerrisk 61428042e2 bzero.3: Add correct header file for exlicit_bzero()
Reported-by: Zack Weinberg <zackw@panix.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:50 +02:00
Michael Kerrisk e6af0066c8 bzero.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:50 +02:00
Michael Kerrisk 547afefe40 shm_open.3: Clarify that POSIX shared memory uses tmpfs(5)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:49 +02:00
Michael Kerrisk a9168840a2 ioctl.2, ioctl_console.2, select_tut.2, termios.3, tty.4, pty.7, termio.7: Change page cross-references from tty_ioctl(4) to ioctl_tty(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-29 12:30:50 +02:00
Michael Kerrisk d49a22201d ioctl.2, termios.3, console_codes.4, tty.4, tty_ioctl.4, vcs.4: Change page cross-references for console_ioctl(4) to ioctl_console(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-29 12:29:18 +02:00
Michael Kerrisk 84ec7d432b syslog.3: SEE ALSO: add journalctl(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-26 14:19:54 +02:00
Michael Kerrisk 1d8ee5b8ff syslog.3: Various rewordings and improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-26 14:19:54 +02:00
Michael Kerrisk 6b5652c1aa syslog.3: Note default value for 'facility' when calling openlog()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-26 14:19:54 +02:00
Michael Kerrisk d302d9c917 syslog.3: Various minor improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-26 14:19:54 +02:00
Michael Kerrisk aad9077cbb syslog.3: Reorganize page text for easier parsing and better readability
Inspired by comments from Ian Abbott and Walter Harms

Reported-by: Ian Abbott <abbotti@mev.co.uk>
Reported-by: Walter Harms <wharms@bfs.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-26 14:19:33 +02:00
Michael Kerrisk aadc226bb7 pthread_atfork.3: New page describing pthread_atfork(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-25 08:20:24 +01:00
Dmitry V. Levin 1e88383bc3 ttyname.3: Document ENODEV error code
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-24 14:34:23 +01:00
Michael Kerrisk 6dcadb9beb grantpt.3: Tell a more nuanced story about what grantpt() does or does not do
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-23 10:34:31 +01:00
Jan Heberer a150608c2c wcsdup.3: RETURN VALUE: fix error in return value description
Return value for failure was accidentally changed from NULL to
-1 in man-pages commit 572acb41c4.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-20 17:49:46 +01:00
Michael Kerrisk 69060c5fc8 openpty.3: Minor wording improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-18 00:48:16 +01:00
Michael Kerrisk 71e876839d exit.3: Improve discussion of zombie processes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-17 06:54:32 +01:00
Michael Kerrisk 4426609333 exit.3: Minor text restructuring for clarity
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-17 06:54:32 +01:00
Michael Kerrisk d75c6df907 getentropy.3: SYNOPSIS: add missing return type for getentropy() declaration
Reported-by: Frank Theile

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-15 05:54:53 +01:00
Michael Kerrisk 7c5ad0dfb9 sigsetops.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-14 15:23:18 +01:00
Michael Kerrisk 31a1b45ece add_key.2, execve.2, fork.2, fsync.2, getrandom.2, getrlimit.2, getxattr.2, inotify_add_watch.2, ioctl.2, ioctl_fat.2, kcmp.2, keyctl.2, link.2, listxattr.2, lseek.2, madvise.2, mincore.2, mlock.2, nanosleep.2, poll.2, posix_fadvise.2, read.2, readv.2, recv.2, request_key.2, select.2, send.2, setxattr.2, sigaction.2, stat.2, statfs.2, syscall.2, tkill.2, truncate.2, unlink.2, vfork.2, write.2, __ppc_set_ppr_med.3, aio_suspend.3, backtrace.3, bcmp.3, bcopy.3, bzero.3, exec.3, fopen.3, fts.3, ftw.3, getline.3, getmntent.3, getopt.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, memset.3, random.3, random_r.3, resolver.3, scandir.3, scanf.3, sem_post.3, sem_wait.3, setjmp.3, sleep.3, strerror.3, strverscmp.3, system.3, random.4, core.5, intro.5, resolv.conf.5, slabinfo.5, environ.7, ip.7, keyrings.7, man.7, persistent-keyring.7, pipe.7, process-keyring.7, random.7, session-keyring.7, signal-safety.7, signal.7, thread-keyring.7, unix.7, user-keyring.7, user-session-keyring.7, ld.so.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-13 21:14:49 +01:00
Michael Kerrisk 4f9d01a93e backtrace.3: SEE ALSO: add addr2line(1) and gdb(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-07 09:26:56 +01:00
Michael Kerrisk cf3ecd874c posix_spawn.3: tfix
Reported-by: Paul Fee <paul.f.fee@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-03 15:43:05 +01:00
Michael Kerrisk 88f78c4aa7 ftw.3: Correctly handle use of stat info for FTW_NS in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-24 05:17:40 +01:00
Michael Kerrisk d252ac9d8b ftw.3: Clarify that stat buffer is undefined for FTW_NS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-24 05:15:07 +01:00
Michael Kerrisk e186d0ca34 mq_receive.3, mq_send.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:40:52 +01:00
Michael Kerrisk 1ce0421b98 mq_open.3: Include definition of the 'mq_attr' structure in this man page
Make the reader's life a little easier by saving them from
having to refer to mq_getattr(3).

Reported-by: Adam Martindale <adam.john.martindale@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:40:52 +01:00
Michael Kerrisk c1b9bce2ed mq_send.3: Refer to mq_overview(7) for details on range of message priority
Reported-by: Adam Martindale <adam.john.martindale@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:40:52 +01:00
Michael Kerrisk c76ea16ab4 fts.3: Clarify meaning of zero as 'instr' value for fts_set()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:18 +01:00
Michael Kerrisk 71ddeb19dc fts.3: Improve explanation of 'fts_errno'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 90882d77f2 fts.3: Give a hint that there are further fields in the FTSENT structure
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 6110d89af1 fts.3: Fix minor error in FTSENT structure definition
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 17b0c3ad68 fts.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 822ffd7cb6 fts.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 1fcf641193 fts.3: Use better argument name for fts_children() and fts_set()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:07 +01:00
Michael Kerrisk 8b65f73d05 fts.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 20:03:47 +01:00
Michael Kerrisk 5c71ea83df fts.3: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 12:10:58 +01:00
Michael Kerrisk c9e5b0e128 fts.3: Minor fix: make the meaning of "stream" a little more obvious
"Stream" was used lower in the page, without first
being defined.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 12:10:58 +01:00
Michael Kerrisk f6c7968375 fts.3: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 12:10:58 +01:00
Michael Kerrisk 58c744401a fts.3: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 12:10:58 +01:00
Michael Kerrisk 211c7df8cf hsearch.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 08:50:24 +01:00
Michael Kerrisk 1ed246aedd printf.3: Fix a small bug in example code
Move the second call to va_end(ap) to above the if-block that
precedes it, so that the va_list 'ap' will be cleaned up in
all cases.

Reported-by: Erik Roland van der Meer <ervdmeer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 09:33:04 +13:00
Michael Kerrisk 5d048f53d3 strerror.3: Minor tweak's to Heinrich Schuchardt's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 09:13:02 +13:00
Michael Kerrisk 154e01afc1 strerror.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 09:11:37 +13:00
Heinrich Schuchardt e9cf84ab1d strerror.3: Indicate reasonable buffer size for strerror_r() and strerror_l()
Add a hint which buffer size is needed for
strerror_r() and strerror_l().

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 09:09:51 +13:00
Michael Kerrisk 9f2791e93e explicit_bzero.3: New link to bzero.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 08:25:18 +13:00
Michael Kerrisk 55e04d2370 bzero.3: Document explicit_bzero() (new in glibc 2.25)
Also, reword the description of bzero somewhat.

By now, over time, I've completely rewritten the page,
so change the copyright as well.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 08:25:18 +13:00