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

5405 Commits

Author SHA1 Message Date
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 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 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 74714ea895 ctime.3, error.3, getmntent.3, getnetent_r.3, getrpcent_r.3, getservent_r.3, pthread_attr_init.3, pthread_getattr_np.3, pthread_tryjoin_np.3, rpc.3, setaliasent.3, setenv.3, unlocked_stdio.3: srcfix: Eliminate some groff warnings 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-26 11:25:22 +02:00
Michael Kerrisk 0b5ff3b662 fmax.3, fmin.3: SEE ALSO: add fdim(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-22 12:10:46 +02:00
Michael Kerrisk c545391400 strtoul.3: SEE ALSO: add a64l(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-22 12:04:15 +02:00
Michael Kerrisk b2f0984e04 strcat.3: Add a program that shows the performance characteristics of strcat() 
In honor of Joel Spolksy's visit to Munich, let's start educating
Schlemiel The Painter.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-21 13:55:09 +02:00
Michael Kerrisk bfb9c7c014 getaddrinfo_a.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-20 14:00:37 +02:00
Michael Kerrisk 67c7e1d53d getaddrinfo_a.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-20 14:00:37 +02:00
Michael Kerrisk 31cc838703 getunwind.2, prctl.2, aio_suspend.3, setenv.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-20 14:00:37 +02:00
Michael Kerrisk 616c2730de remap_file_pages.2, sigaltstack.2, umask.2, wait4.2, basename.3, canonicalize_file_name.3, dlerror.3, dlopen.3, dlsym.3, sockatmark.3, strtok.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-20 14:00:37 +02:00
Michael Kerrisk cd2c21a021 cacos.3, cacosh.3, catan.3, catanh.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-20 14:00:37 +02:00
Tobias Stoeckmann 36f99b9242 getauxval.3: tfix 
Fix typo. It's supposed to be "its" not "it's" in this context.

Signed-off-by: Tobias Stoeckmann <tobias@stoeckmann.org>
 2016-06-15 22:53:03 +02:00
Michael Kerrisk a1476a498c malloc_hook.3: glibc 2.24 removes __malloc_initialize_hook 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-10 16:26:53 +02:00
Michael Kerrisk 6de48cdf60 regex.3: Minor fix to 'info libc' regex reference 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-09 22:12:34 +02:00
Michael Kerrisk 2974f4050a printf.3: Note support in other C libraries for %m and %n 
Reported-by: Shawn Landden <shawn@churchofgit.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-09 22:12:29 +02:00
Michael Kerrisk 1b2385537f memmem.3: Note that memmem() is present on some other systems 
Reported-by: Shawn Landden <shawn@churchofgit.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-09 10:02:56 +02:00
Jakub Wilk d1f84ed72a clone.2, confstr.3, hpsa.4, tcp.7: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
 2016-06-08 11:24:08 +02:00
Jakub Wilk 8d48cea31a termios.3: spfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
 2016-06-06 09:13:54 -05:00
Michael Kerrisk 9b3661c406 assert.3: Clarify details of message printed by assert() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-03 06:38:32 -05:00
Michael Kerrisk 4d644289dd assert.3: Minor clean-ups 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-03 06:38:32 -05:00
Nikos Mavrogiannopoulos f34fcbb86b assert.3: Improved description 
Removed text referring to text not being helpful to users. Provide
the error text instead to allow the reader to determine whether it
is helpful.  Recommend against using NDEBUG for programs to
exhibit deterministic behavior.  Moved description ahead of
recommendations.

Signed-off-by: Nikos Mavrogiannopoulos <nmav@redhat.com>
 2016-06-03 06:37:52 -05:00
Michael Kerrisk c39946e06e mkdtemp.3, mktemp.3: SEE ALSO: add mktemp(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-01 11:02:44 -05:00
Michael Kerrisk 0ee6740485 strcasecmp.3: Minor tweak to strncasecmp() description 
Reported-by: Ori Avtalion <ori@avtalion.name>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-05-29 11:53:38 -05:00
Michael Kerrisk 2392242b06 strcasecmp.3: Make details of strncasecmp() comparison clearer 
Quoting Ori:

The manpage for strncasecmp has a few wording issues that can be improved:

1)
In the DESCRIPTION section, "except it compares only the first n
bytes of s1"

s1 can be shorter than n bytes. Consider adding "(at most)" after
"first".

For comparison with reference materials, POSIX uses the wording
"not more than n bytes", OSX and FreeBSD use "compares at
most [...]".

2)
In the RETURN VALUE section: "if s1 (or the first n bytes
thereof) is found [...] to match [...] s2"

This could theoretically be read to suggest that the first n bytes
of s1 are compared against the FULL s2, which is not the case.
Consider removing the parenthetical altogether (thus, not
mentioning 'n' at all). POSIX doesn't mention 'n' in its RETURN
VALUE section.

3)
The RETURN VALUE section doesn't mention case insensitivity. It's
in the DESCRIPTION, but perhaps it should also be in this section.
POSIX mentions case-insensitivity in RETURN VALUE.

Consider adding "and ignoring case" after "respectively".

Reported-by: Ori Avtalion <ori@avtalion.name>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-05-29 06:52:09 -05:00
Stefan Puiu 04fd9903e3 inet_pton.3: Mention byte order 
Come to think of it, this probably applies to IPv6 as well. Moving to
the paragraph before:
 2016-05-18 13:33:30 +02:00
Michael Kerrisk a03a743568 getauxval.3: tfix 
Reported-by: Håkon Sandsmark <hsandsma@cisco.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-05-13 13:47:25 +02:00
Michael Kerrisk 4590829a1b dlsym.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-05-13 10:59:06 +02:00
Élie Bouttier 819eeff4c6 getaddrinfo_a.3: tfix 
EAI_CANCELED and EAI_NOTCANCELED are defined without double L in resolv/netdb.h from glibc.
See https://sourceware.org/git/?p=glibc.git;a=blob;f=resolv/netdb.h;h=3aba530932c7a62a4f23e3193e9186da677f552b;hb=HEAD#l632
 2016-05-11 08:37:44 +02:00
Michael Kerrisk 5c61e57f56 strtod.3: Improve a detail in RETURN VALUE 
Reported-by: Ed Avis <eda@waniasset.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-05-09 22:53:25 +02:00
Nikola Forró ea5bce080a popen.3: RETURN VALUE: describe successful case 
Reference:
http://pubs.opengroup.org/onlinepubs/9699919799/functions/popen.html
http://pubs.opengroup.org/onlinepubs/9699919799/functions/pclose.html

Signed-off-by: Nikola Forró <nforro@redhat.com>
 2016-05-09 22:45:36 +02:00
Michael Kerrisk 38f55864aa cmsg.3: Minor cosmetic changes in example code 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-04-22 15:38:49 +02:00
Michael Kerrisk 6cd7a2c6da cmsg.3: Minor cosmetic changes to example code 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-04-22 10:00:25 +02:00
Michael Kerrisk 85a4005516 makedev.3: NOTES: mention that <sys/types.h> may also define these macros 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-04-20 14:06:28 +02:00
Mike Frysinger 3350a86413 makedev(3): Use <sys/sysmacros.h> in SYNOPSIS 
Defining these functions via <sys/types.h> causes problems for
some folk. As noted by Zack Wein:

    libstdc++ force-enables _GNU_SOURCE, which means people
    writing in C++ _can't_ avoid these nonstandard macros by
    using a strict conformance mode.

Since glibc has basically always used <sys/sysmacros.h>,
update the docs to have people include that instead.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-04-20 14:06:28 +02:00
Michael Kerrisk a90f441afb readdir.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-26 07:08:16 +13:00
Michael Kerrisk 2c767761a2 Removed trailing white space at end of lines 2016-03-15 17:30:43 +13:00
Michael Kerrisk 979867082b locale.1, localedef.1, _exit.2, accept.2, access.2, acct.2, adjtimex.2, bdflush.2, bind.2, bpf.2, brk.2, chdir.2, chmod.2, chown.2, chroot.2, clock_nanosleep.2, clone.2, close.2, connect.2, copy_file_range.2, create_module.2, delete_module.2, dup.2, epoll_ctl.2, eventfd.2, execve.2, fallocate.2, fanotify_init.2, fcntl.2, flock.2, fork.2, fsync.2, futex.2, get_kernel_syms.2, getdomainname.2, getgroups.2, gethostname.2, getpagesize.2, getpeername.2, getsid.2, getsockname.2, getsockopt.2, gettimeofday.2, init_module.2, ioctl.2, ioctl_list.2, ioperm.2, iopl.2, kexec_load.2, kill.2, killpg.2, link.2, listen.2, llseek.2, lseek.2, madvise.2, memfd_create.2, mincore.2, mkdir.2, mknod.2, mmap.2, mount.2, nanosleep.2, nice.2, open.2, personality.2, pipe.2, poll.2, posix_fadvise.2, read.2, readahead.2, readlink.2, readv.2, recv.2, recvmmsg.2, rename.2, request_key.2, sched_setaffinity.2, sched_setattr.2, select.2, select_tut.2, semctl.2, semop.2, send.2, sendfile.2, sendmmsg.2, seteuid.2, setns.2, setpgid.2, setreuid.2, shutdown.2, sigaction.2, sigaltstack.2, signal.2, signalfd.2, sigpending.2, sigprocmask.2, sigsuspend.2, socketpair.2, splice.2, stat.2, statfs.2, stime.2, symlink.2, sync.2, syscall.2, syscalls.2, times.2, truncate.2, unlink.2, unshare.2, uselib.2, utimensat.2, vfork.2, vhangup.2, wait.2, wait4.2, write.2, a64l.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, aio_read.3, aio_write.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, backtrace.3, cbrt.3, ceil.3, cfree.3, clearenv.3, clock_getcpuclockid.3, clog10.3, cmsg.3, copysign.3, cos.3, cosh.3, ctermid.3, ctime.3, daemon.3, dirfd.3, div.3, dl_iterate_phdr.3, drand48.3, drand48_r.3, dysize.3, ecvt.3, ecvt_r.3, endian.3, erf.3, erfc.3, errno.3, exec.3, exp.3, exp2.3, expm1.3, fabs.3, fdim.3, ferror.3, fexecve.3, ffs.3, fgetgrent.3, fgetpwent.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fopen.3, fpclassify.3, frexp.3, fseeko.3, fts.3, futimes.3, fwide.3, gamma.3, gcvt.3, getaddrinfo.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getline.3, getloadavg.3, getmntent.3, getnameinfo.3, getnetent_r.3, getpass.3, getprotoent_r.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent_r.3, getservent_r.3, getspnam.3, getsubopt.3, getusershell.3, getutent.3, getw.3, gsignal.3, hypot.3, ilogb.3, inet.3, initgroups.3, insque.3, isalpha.3, isgreater.3, iswblank.3, j0.3, ldexp.3, lgamma.3, lio_listio.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, lrint.3, lround.3, makedev.3, matherr.3, mbsnrtowcs.3, mkdtemp.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_receive.3, mq_send.3, nan.3, nextafter.3, on_exit.3, open_memstream.3, opendir.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, psignal.3, pthread_attr_setstack.3, pthread_setaffinity_np.3, putenv.3, putpwent.3, qecvt.3, rand.3, random.3, random_r.3, rcmd.3, readdir.3, realpath.3, remainder.3, remquo.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, scalb.3, scalbln.3, scandir.3, scanf.3, seekdir.3, sem_wait.3, setbuf.3, setenv.3, setjmp.3, setnetgrent.3, siginterrupt.3, signbit.3, significand.3, sigset.3, sigsetops.3, sigvec.3, sigwait.3, sin.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stpcpy.3, stpncpy.3, strdup.3, strerror.3, strftime.3, strlen.3, strnlen.3, strsep.3, strsignal.3, strtod.3, strtok.3, strtol.3, strtoul.3, syslog.3, system.3, tan.3, tanh.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, trunc.3, ttyslot.3, tzset.3, ualarm.3, unlocked_stdio.3, usleep.3, wcpcpy.3, wcpncpy.3, wcscasecmp.3, wcsdup.3, wcsncasecmp.3, wcsnlen.3, wcsnrtombs.3, wprintf.3, y0.3, pts.4, st.4, tty_ioctl.4, elf.5, gai.conf.5, group.5, locale.5, nsswitch.conf.5, proc.5, utmp.5, aio.7, capabilities.7, credentials.7, environ.7, epoll.7, fanotify.7, feature_test_macros.7, inotify.7, ip.7, mq_overview.7, namespaces.7, pipe.7, signal.7, socket.7, standards.7, svipc.7, symlink.7, time.7, unicode.7, unix.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-15 17:30:43 +13:00
Michael Kerrisk 68df07dd4d posix_spawn.3: srcfix: Add license delimiter tags 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-15 17:30:43 +13:00
Nikola Forró 1754f8d0f7 strftime.3: tfix 
Signed-off-by: Nikola Forró <nforro@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-15 06:21:50 +13:00
Jakub Wilk d260f95eb0 readdir_r.3: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-14 08:32:54 +13:00
Michael Kerrisk fca67dd016 strftime.3: Note which 'tm' fields are used to calculate each output string 
See https://bugzilla.redhat.com/show_bug.cgi?id=1162218

Reported-by: Jeremy Harris <jeharris@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-13 10:51:34 +13:00
Michael Kerrisk 8dc9c2d66e strftime.3: Minor reordering of some text 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-13 10:51:16 +13:00
Michael Kerrisk f1e1b550a9 dl_iterate_phdr.3: Note that first object visited by 'callback' is the main program 
See https://bugzilla.kernel.org/show_bug.cgi?id=94141

Reported-by: Simon Que <sque@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-11 20:28:11 +01:00