LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity
16,350 Commits 1 Branch 197 Tags 93 MiB
Commit Graph

16350 Commits

Author SHA1 Message Date
Michael Kerrisk 45dd509268 proc.5: Minor reworking to Jann's /proc/[pid]/task/[tid]/children patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-04 08:43:08 +10:00
Jann Horn 4a40c703ee proc.5: Document /proc/[pid]/task/[tid]/children 
Document the /proc/[pid]/task/[tid]/children interface from
CRIU, and more importantly, document why it's usually not
a good interface.
 2016-08-04 08:34:23 +10:00
Quentin Rameau c6785202b0 mkstemp.3: Fix _POSIX_C_SOURCE value for mkstemp() 
The correct _POSIX_C_SOURCE value has always been 200809L,
not 200112L.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-04 08:15:25 +10:00
Michael Kerrisk bc91192853 pldd.1: BUGS: pldd has not worked since glibc 2.19 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-02 22:22:38 +10:00
Michael Kerrisk 9539ebc934 open.2: NOTES: kcmp() can be used to test if two FDs refer to the same OFD 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-28 10:31:51 +02:00
Michael Kerrisk 2e4eff1b1d kcmp.2: Add an example program 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-28 10:25:18 +02:00
Michael Kerrisk 79bdcc4a5c clone.2: Mention kcmp() under notes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-28 09:34:52 +02:00
Michael Kerrisk c3a7b4e958 mount.2: wfix 2016-07-28 08:32:32 +02:00
Michael Kerrisk 0ec74e08e3 cgroups.7: tfix 
Reported-by: Local Lembke <logan@blackhillsinfosec.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-27 14:33:30 +02:00
Michael Kerrisk 2a0bd971fa stat.2: _BSD_SOURCE and _SVID_SOURCE no longer expose nanosecond timestamps 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-26 13:02:46 +02:00
Michael Kerrisk cdff989b46 endian.3: SEE ALSO: add bswap(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-24 21:53:46 +02:00
Michael Kerrisk b1bc4fd1ab byteorder.3: SEE ALSO: add bswap(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-24 21:53:46 +02:00
Michael Kerrisk 70811de458 bswap_64.3: New link to new bswap.3 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-24 21:53:46 +02:00
Michael Kerrisk 3dedc90a6e bswap_32.3: New link to new bswap.3 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-24 21:53:46 +02:00
Michael Kerrisk e032ad6e7e bswap_16.3: New link to new bswap.3 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-24 21:53:46 +02:00
Michael Kerrisk 9f0b7bd6b0 bswap.3: New page documenting bswap_16(), bswap_32(), and bswap_64() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-24 21:53:46 +02:00
Michael Kerrisk 110039c1da unix.7: Remove mention of recvmsg() from discussion of EPIPE error 
See https://bugzilla.kernel.org/show_bug.cgi?id=137351

Reported-by: Laurent Georget <laurent.georget@supelec.fr>
Reported-by: Ivan Kharpalev <ivan.kharpalev@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-24 21:27:09 +02:00
Dr. Tobias Quathamer ccfe84ee2a getitimer.2: tfix 2016-07-24 21:02:09 +02:00
Dr. Tobias Quathamer c0d44cf5ae getitimer.2: tfix 2016-07-24 21:02:09 +02:00
Michael Kerrisk 5347399609 proc.5: Add reference to umask(2) in discussion of /proc/PID/status 'Umask' 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-18 17:11:55 +02:00
Michael Kerrisk 8a2de39c05 umask.2: Provide a rationale for the existence of /proc/PID/status 'Umask' field 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-18 17:10:57 +02:00
Michael Kerrisk ac6c297c7b umask.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-18 17:05:14 +02:00
Michael Kerrisk 2383822595 Changes.old: Minor fixes to 4.07 changelog 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-18 07:53:59 +02:00
Michael Kerrisk e4e23158d2 Start of man-pages-4.08: updating Changes and Changes.old 2016-07-17 19:37:46 +02:00
Michael Kerrisk d3064ed7ba Start of man-pages-4.08: updating .Announce and .lsm files 2016-07-17 19:37:46 +02:00
Michael Kerrisk e44a8e8440 Start of man-pages-4.08: renaming .Announce and .lsm files 2016-07-17 19:37:46 +02:00
Michael Kerrisk 51d1370715 Ready for 4.07 2016-07-17 18:10:19 +02:00
Michael Kerrisk 2ae96e8ae8 Removed trailing white space at end of lines 2016-07-17 18:10:19 +02:00
Michael Kerrisk 3df541c0e6 ldd.1, localedef.1, add_key.2, chroot.2, clone.2, fork.2, futex.2, get_mempolicy.2, get_robust_list.2, getitimer.2, getpriority.2, ioctl.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, kcmp.2, kill.2, lookup_dcookie.2, mmap.2, mount.2, open.2, pciconfig_read.2, perf_event_open.2, prctl.2, process_vm_readv.2, ptrace.2, quotactl.2, recv.2, setfsgid.2, setfsuid.2, sysinfo.2, umask.2, umount.2, unshare.2, utimensat.2, wait.2, assert.3, fmax.3, fmin.3, getauxval.3, inet_pton.3, malloc_hook.3, memmem.3, mkdtemp.3, mktemp.3, printf.3, strcasecmp.3, strcat.3, strtoul.3, strxfrm.3, console_codes.4, console_ioctl.4, lirc.4, tty.4, vcs.4, charmap.5, elf.5, locale.5, proc.5, repertoiremap.5, utmp.5, capabilities.7, cgroup_namespaces.7, cgroups.7, charsets.7, cp1251.7, cp1252.7, credentials.7, feature_test_macros.7, iso_8859-1.7, iso_8859-15.7, iso_8859-5.7, koi8-r.7, koi8-u.7, man-pages.7, mount_namespaces.7, namespaces.7, netlink.7, pid_namespaces.7, unix.7, user_namespaces.7, utf-8.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-17 18:10:19 +02:00
Michael Kerrisk 79f9c381f3 Changes: Ready for 4.07 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-17 09:26:42 +02:00
Michael Kerrisk 5231e1bb72 console_ioctl.4: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-16 12:42:06 +02:00
Michael Kerrisk 40c7eed4ef console_ioctl.4: The argument to KDGETMODE is an 'int' 
As reported by Chris:i

    The manual entry for KDGETMODE specifies "argp points to
    a long which is set to one of the above values." At least
    on x86_64-bit Fedora24, the text should probably specify
    argp is an int (32-bit), rather than a long (64-bit).

    [To verify:]
    Open a file descriptor to the local console, and execute
    some code like the following:
        long arg = -1;
        if (-1 == ioctl(fd, KDGETMODE, &arg)) { return -1; }
        printf("KDGETMODE: 0x%lx\n", arg);

    Now try this version:
        int arg = -1;
        if (-1 == ioctl(fd, KDGETMODE, &arg)) { return -1; }
        printf("KDGETMODE: 0x%x\n", arg);

    Result:
    The first version gives this result:
    KDGETMODE: 0xffffffff00000001

    The second version gives this result:
    KDGETMODE: 0x1

Reading the kernel source confirms this point.

Reported-by: Chris Gassib <position0x45@hotmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-16 12:32:19 +02:00
Darrick J. Wong e4fcb7bcc3 ioctl_ficlonerange.2: Mention a subtlety with length == 0 
Passing length == 0 to clonerange actually makes it clone
all the way to EOF.

Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
 2016-07-16 12:25:12 +02:00
Michael Kerrisk a9562222f7 kill.2: Clarify the meaning if sig==0 
Reported-by: John Wiersba <jrw32982@yahoo.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-16 12:23:18 +02:00
Michael Kerrisk e732a1c21d nextdown.3, nextdownf.3, nextdownl.3, nextupf.3, nextupl.3: New links to nextup(3) 2016-07-16 11:20:55 +02:00
Michael Kerrisk ab472b501a nextup.3: Add thread-safety markings 
Based on code inspection and glibc manual mark-up.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-16 11:20:55 +02:00
Michael Kerrisk c484406d06 nextup.3: New page documenting nextup(), nextdown(), and related functions 2016-07-15 23:53:08 +02:00
Cownie, James H 7e318d44a1 getauxval.3: Minor fix to AT_HWCAP text 
Reported-by: Szabolcs Nagy <szabolcs.nagy@arm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-14 08:43:01 +02:00
Michael Kerrisk 291415ef4a getauxval.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-12 22:24:22 +02:00
Cownie, James H 063bf5a777 getauxval.3: Correct AT_HWCAP result description 
The getauxval(3) man page describes the result for AT_HWCAP as
"A pointer to a multibyte mask of bits", however the actual value
returned is not a pointer, but simply the first 32 bits of the
capabilities mask.

This can be observed directly. Note the value shown for AT_HWCAP
is a 32 bit value that is not a pointer (see AT_PHDR or AT_RANDOM
for how pointers are shown).

% LD_SHOW_AUXV=1 cat < /dev/null
AT_SYSINFO_EHDR: 0x7fffe89fe000
AT_HWCAP:        bfebfbff
AT_PAGESZ:       4096
AT_CLKTCK:       100
AT_PHDR:         0x400040
AT_PHENT:        56
AT_PHNUM:        9
AT_BASE:         0x0
AT_FLAGS:        0x0
AT_ENTRY:        0x402634
AT_UID:          515
AT_EUID:         515
AT_GID:          114
AT_EGID:         114
AT_SECURE:       0
AT_RANDOM:       0x7fffe8917be9
AT_EXECFN:       /usr/bin/cat
AT_PLATFORM:     x86_64
 2016-07-12 22:23:29 +02:00
Michael Kerrisk 8c74a1cea4 user_namespaces.7: Clarify details of CAP_SYS_ADMIN and cgroup v1 mounts 
With respect to cgroups version 1, CAP_SYS_ADMIN in the user
namespace allows only *named* hierarchies to be mounted (and
not hierarchies that have a controller).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-07 14:30:01 +02:00
Michael Kerrisk c7e077eaa4 user_namespaces.7: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-07 13:59:24 +02:00
Michael Kerrisk 1d360c2637 strxfrm.3: Remove NOTES section 
strxfrm() and strncpy() are not precisely equivalent in the
POSIX locale, so this NOTES section was not really correct.

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

Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-07 13:44:50 +02:00
Michael Kerrisk c0ada844e0 man-pages.7: Add a few more details on formatting conventions 
Add some more details for Section 1 and 8 formatting.
Separate out formatting discussion into commands, functions,
and "general".

In part triggered by https://bugzilla.kernel.org/show_bug.cgi?id=121211

Reported-by: Josh Triplett <josh@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-07 13:23:13 +02:00
Michael Kerrisk 0b9200154c man-pages.7: Clarify which sections man-pages provides man pages for 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-07 13:23:13 +02:00
Michael Kerrisk cb9dacefe0 locale.1: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-07 13:23:13 +02:00
Jakub Wilk 1481407a2e mount_namespaces.7: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
 2016-07-07 12:16:28 +02:00
Jakub Wilk 26213e0e53 ip.7: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
 2016-07-07 12:15:58 +02:00
Jakub Wilk 076d4cd970 rtc.4: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
 2016-07-07 12:10:10 +02:00
Michael Kerrisk b5eb75f750 perf_event_open.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-07 12:09:35 +02:00