Commit Graph

6067 Commits

Author SHA1 Message Date
Michael Kerrisk 419b9d89e6 crypt.3: srcfix: rewrap source lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-04-13 17:02:28 +02:00
Carlos O'Donell 629a86ecb7 crypt.3, encrypt.3: Add notes about _XOPEN_CRYPT
The distribution may choose not to support _XOPEN_CRYPT in the
case that the distribution has transitioned from glibc crypt to
libxcrypt.

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-04-13 17:02:28 +02:00
Michael Kerrisk 40b7acf14d getcwd.3: Minor tweaks to Carlos O'Donell's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-04-12 13:49:40 +02:00
Michael Kerrisk c26d16c8de getcwd.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-04-12 13:47:03 +02:00
Carlos O'Donell 294851f3fa getcwd.3: Mention that "(unreachable)" is no longer returned for glibc >= 2.27.
With glibc fix 52a713fdd0a30e1bd79818e2e3c4ab44ddca1a94 for
CVE-2018-1000001 (Sourceware BZ #22679) the implementation in the
just released glibc 2.27 has been changed such that instead of
returning "(unreachable)" the implementation now returns ENOENT
as it would have if the current directory had been unlinked.

I see that in 2015 the quirk was documented in commit
a2ac97c78b, and this is no longer
true with glibc 2.27, but may continue to be true in other C libraries,
so I reference NOTES from the paragraph in the central text.

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-04-12 13:44:51 +02:00
Michael Kerrisk 169d728330 pthread_create.3: Minor fix: reorder table items
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-04-05 20:12:18 +02:00
Michael Kerrisk 8efada9938 pthread_create.3: Minor tweaks to Frederic Brault's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-04-05 20:12:18 +02:00
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