bfb9c7c014
getaddrinfo_a.3: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-20 14:00:37 +02:00
67c7e1d53d
getaddrinfo_a.3: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-20 14:00:37 +02:00
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
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
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
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
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
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
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
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
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
8d48cea31a
termios.3: spfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
2016-06-06 09:13:54 -05:00
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
4d644289dd
assert.3: Minor clean-ups
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-03 06:38:32 -05:00
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
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
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
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
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
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
4590829a1b
dlsym.3: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-13 10:59:06 +02:00
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
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
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
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
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
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
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
a90f441afb
readdir.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-26 07:08:16 +13:00
2c767761a2
Removed trailing white space at end of lines
2016-03-15 17:30:43 +13:00
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
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
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
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
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
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
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
9b14ad2db5
dl_iterate_phdr.3: Describe 'struct dl_phdr_info' fields added in glibc 2.4
...
See https://bugzilla.kernel.org/show_bug.cgi?id=103011
Reported-by: Paul Pluzhnikov <ppluzhnikov@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 19:59:46 +01:00
1893b64807
recv.2, cmsg.3: Note that cmsg_len is typed as socklen_t in POSIX.1
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 16:58:07 +01:00
4ecc4f795f
cmsg.3: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 16:53:52 +01:00
aea45daeee
recv.2, cmsg.3: Fix type of cmsg_len member of cmsghdr structure
...
The type shown for cmsg_len member of cmsghdr structure is socklen_t,
but the actual type used by glibc and the kernel is size_t.
The information was obtained from glibc source code:
http://bit.ly/21m1RMp
Signed-off-by: Nikola Forró <nforro@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 16:51:07 +01:00
1182ddb36a
fmemopen.3: Update timestamp (page reviewed by Adhemerval Zanella)
...
Reviewed-by: Adhemerval Zanella <adhemerval.zanella@linaro.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 15:38:57 +01:00
501934a934
timegm.3: Expand DESCRIPTION a little
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 00:43:05 +01:00
25a0440e45
timegm.3: Remove sample implementation of timegm()
...
Stephen and Mats both question the wisdom of showing a portable
*non-thread-safe* implementation of timegm(), and I find it
hard to disagree. So, remove this code.
See https://bugzilla.kernel.org/show_bug.cgi?id=103701
Reported-by: Stephen Hurd <shurd@sasktel.net>
Reported-by: Mats Wichmann <mats@linuxfoundation.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 00:42:36 +01:00
ddef8b9573
fmemopen.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 21:05:11 +01:00
cf486e4aa9
CPU_SET.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 16:31:50 +01:00
7d02e97e66
pthread_setaffinity_np.3: SEE ALSO: add CPU_SET(3)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 15:56:14 +01:00
8a61b8f5db
readdir.3: tfix
...
Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 15:50:12 +01:00
77c73ca424
open_memstream.3: SEE ALSO: add setbuf(3)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 02:57:14 +01:00
207f4520b8
open_memstream.3: Minor reworking
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 02:57:14 +01:00
493e0eb3c2
fmemopen.3: srcfix: update copyright
...
Little or no text remains from Walters initial version
10 years ago.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 11:41:58 +01:00
8190a9eeac
open_memstream.3: srcfix: Update copyright info
...
The open_memstream() text was jsut by me.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 11:41:24 +01:00
b5a636d650
fmemopen.3: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 05:20:12 +01:00
e3d1b1b740
open_memstream.3: Rework text describing dynamic allocation
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 05:12:56 +01:00
31a3c48847
open_memstream.3: Add some details on current buffer position
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 05:12:56 +01:00
a6bd38c621
fopen.3: SEE ALSO: add open_memstream(3)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 05:12:56 +01:00
8e23ae0316
open_wmemstream.3: Update link to point to new open_memstream(2) page
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 05:12:56 +01:00
09ffd9ca50
fmemopen.3, open_memstream.3: Split open_memstream() and open_wmemstream() out to separate page
...
The current fmemopen(3) page documents too many functions.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:55:07 +01:00
551c427e75
fmemopen.3: srcfix: copyright date
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:36:48 +01:00
36ad378145
fmemopen.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:34:31 +01:00
d779692dc7
fmemopen.3: Small clarification to the discussion of write errors
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:31:40 +01:00
82aa5cf962
fmemopen.3: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:20:13 +01:00
f29c8cd8e9
fmemopen.3: Minor fix: reorder a paragraph
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:19:52 +01:00
f39842ae12
fmemopen.3: ffix: add a subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:18:33 +01:00
0b54423fb5
fmemopen.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:15:13 +01:00
c7de29d451
fmemopen.3: Expand discussion of "current position" for fmemopen() stream
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:15:13 +01:00
1e9eb6c1b6
fmemopen.3: Rework discussion of the (obsolete) binary mode
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:15:13 +01:00
2841079cd0
fmemopen.3: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:15:13 +01:00
9c8b5ebfc4
fmemopen.3: Rework description of 'buf' and 'len' arguments
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:15:13 +01:00
58c55bb87b
fmemopen.3: Greatly expand description of 'mode' argument
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 03:42:26 +01:00
02989b144e
fmemopen.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 03:09:36 +01:00
93bb19b18c
fmemopen.3: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 03:09:36 +01:00
0edb356c58
fmemopen.3: Small improvements to the description of open_memstream()
...
Make it a little more evident that the caller should not
pass a previously allocated buffer to open_memstream().
Reported-by: Rasmus Villemoes <Rasmus.Villemoes@decode.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 02:49:57 +01:00
d9b4881f64
fmemopen.3: Fix "Usage" message
...
Reported-by: Rasmus Villemoes <Rasmus.Villemoes@decode.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 02:33:45 +01:00
852d92f7ae
getnameinfo.3: Update FTM requirements
...
The FTM requirements changed in glibc 2.22
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 02:28:38 +01:00
5358a2546d
getaddrinfo.3: Update FTM requirements for glibc 2.22
...
Since glibc 2.22 getaddrinfo() etc. are only declared for
POSIX.1-2001 or later.
Reported-by: Andreas Schwab <schwab@suse.de>
Reported-by: Orion Poplawski <orion@cora.nwra.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 02:19:11 +01:00
c50730b607
gamma.3: gamma() was documented in SVID 2
...
Reported-by: Alan Cox <etchedpixels@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 01:05:16 +01:00
f1e369b09f
ntp_adjtime.3: New link to adjtimex(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 00:36:16 +01:00
4d70ca99ed
posix_fallocate.3: ERRORS: add EINTR
...
The glibc implementation of posix_fallocate(), which calls
fallocate(), may be interrupted. The fallocate() emulation
also makes use of pread()/pwrite(), which may also be
interrupted.
Signed-off-by: Jérémie Galarneau <jeremie.galarneau@efficios.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 00:34:48 +01:00
85c30f7eab
ntp_gettime.3: Add ATTRIBUTES section
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 11:15:18 +01:00
39ad98a088
sysconf.3: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 11:15:18 +01:00
b5133e9ad9
ntp_gettime.3: Note that these APIs always succeed
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 11:15:18 +01:00
cfb9b2f966
ntp_gettimex.3: New link to ntp_gettime.3
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 01:36:29 +01:00
6d78bc966a
ntp_gettime.3: New page describing ntp_gettime(3) and ntp_gettimex(3)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 01:34:55 +01:00
82b43a7692
posix_spawn.3: Tweak a few more details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-05 10:26:32 +01:00
5356204785
posix_spawn.3: Add note on "posix_fspawn" functionality
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-05 10:26:32 +01:00
7b5e3ad522
posix_spawn.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-05 10:26:32 +01:00
c0d82fb9cb
posix_spawnp.3: New link to new posix_spawn.3 page
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-05 10:26:32 +01:00
10069ed030
posix_spawn.3: Major reworking of and additions to contributed page
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-05 10:26:32 +01:00
a5458d4938
posix_spawn.3: New man page for posix_spawn(3) and posix_spawnp(3)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-05 10:26:32 +01:00
df383cdf95
posix_memalign.3: Note posix_memalign()'s treatment of 'memptr' on error
...
Reported-by: Eric Blake <eblake@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-05 08:52:29 +01:00
9c048ec195
fmemopen.3: Note one more memory stream bug that was fixed in glibc 2.22
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-02 16:23:19 +01:00
39ef79baad
fmemopen.3: Note various fmemopen() bugs that were fixed in glibc 2.22
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-02 16:23:19 +01:00
f435db47cd
opendir.3: Help the reader by explicitly mentioning the use of readdir(3)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-02 12:32:04 +01:00
0fdfbd140d
readdir.3: Minor tweaks to 'd_name' text
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-02 12:30:32 +01:00
307b34a803
readdir.3: Add a lot more detail on portable use of the 'd_name' field
...
Include also some information from comments by Florian Weimer,
Paul Eggert, and Rich Felker.
Reported-by: Florian Weimer <fweimer@redhat.com>
Reported-by: Rich Felker <dalias@aerifal.cx>
Reported-by: Paul Eggert <eggert@cs.ucla.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-02 12:30:32 +01:00
6550b8275b
readdir.3: Near complete restructuring of the page and add some further details
...
The mixture of information across DESCRIPTION and NOTES did
not lend itself to easy reading...
While we're at it, add some missing details as well.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-02 12:30:32 +01:00
df7a8fc91e
readdir.3: Explain how to distinguish end of stream from an error
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-02 08:41:26 +01:00
96604453fd
readdir.3, readdir_r.3: Split readdir_r() content into separate page
...
As suggested by Florian Weimer:
It may make sense to move this documentation to a separate
manual page, specific to readdir_r. This will keep the
readdir() documentation nice and crisp. Most programmers
will never have to consult all these details.
Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 21:07:01 +01:00
c48f13805c
readdir.3: Remove misleading code example using pathconf()
...
As noted by Florian:
The kernel does not return valid values for _PC_NAME_MAX and
some file systems (such as CIFS, and CD-ROMs with Joliet
extensions once a kernel bug is fixed). The CIFS limit is
somewhere around 765, and not 255 as reported by the kernel.
If I recall correctly, Windows SMB servers can actually
exceed the 255 byte limit. The reason is that Windows NTFS
has a limit based on 16-bit UCS-2 characters, and after
UTF-8 conversion, the maximum length is more than 255 bytes.
Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:31:56 +01:00
0c52f6d623
readdir.3: Explain why readdir_r() is deprecated and readdir() is preferred
...
Based on Florian Weimer's text that was added to the glibc manual;
relicensed for use in this man page by permission of Florian.
See http://www.austingroupbugs.net/view.php?id=696
and https://sourceware.org/bugzilla/show_bug.cgi?id=14699
Cowritten-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:25:51 +01:00
cff459dea2
kill.2, sigaction.2, sigpending.2, sigprocmask.2, sigsuspend.2, ctermid.3, ferror.3, fopen.3, getaddrinfo.3, getnameinfo.3, longjmp.3, rand.3, setjmp.3, sigsetops.3, sigwait.3, tzset.3: Simply FTM requirements
...
_XOPEN_SOURCE implies _POSIX_C_SOURCE >=2, so simplify FTM
requirements in various pages.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:05 +01:00
d59161f912
ctime.3, ffs.3, finite.3, flockfile.3, gethostbyname.3, getnameinfo.3, getw.3, insque.3, isalpha.3, popen.3, printf.3, siginterrupt.3, strdup.3, strtok.3, toascii.3, tzset.3, unlocked_stdio.3: Update FTM requirements (mostly _DEFAULT_SOURCE)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:05 +01:00
97ff735155
tmpnam.3: Remove mention od _BSD_SOURCE and _SVID_SOURCE
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
6b8b0e500c
strtok.3: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
9db90c7cc9
getgrent.3, getgrnam.3, getpwent.3, getpwnam.3: Updaye FTM requirements (mostly _DEFAULT_SOURCE)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
c1016e8767
kill.2, sigaction.2, sigpending.2, sigprocmask.2, sigsuspend.2, ctermid.3, ctime.3, ferror.3, flockfile.3, fopen.3, getaddrinfo.3, getgrnam.3, getnameinfo.3, getpwnam.3, rand.3, sigsetops.3, sigwait.3, strtok.3, tzset.3, unlocked_stdio.3, feature_test_macros.7: Remove mention of the obsolete _POSIX_SOURCE macro from SYNOPSIS
...
_POSIX_SOURCE was a POSIX.1-1990 creation that was soon made
obsolete bu _POSIX_C_SOURCE. Retaining mention of it
in the feature test macro requirements section of the
SYNOPSIS doesn't contain important information, and may
mislead readers into actually trying to use this macro.
A few mentions of it a maintained in a some pages where
defining _POSIX_SOURCE inhibits some behavior.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
c4a256e267
strerror.3: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
a30128b4cc
dirfd.3, readdir.3, scandir.3, seekdir.3, telldir.3: Update FTM requirements (mostly _DEFAULT_SOURCE)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
2b1b042487
a64l.3, atoi.3, clearenv.3, drand48.3, drand48_r.3, ecvt.3, ecvt_r.3, gcvt.3, mkstemp.3, mktemp.3, posix_memalign.3, putenv.3, random.3, random_r.3, realpath.3, setenv.3, strtol.3, strtoul.3: Update FTM requirements (mostly _DEFAULT_SOURCE)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
6e0869f758
getcwd.3, getdtablesize.3, getpass.3, lockf.3, ualarm.3, usleep.3: Update FTM requirements (mainly _DEFAULT_SOURCE)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
e0a68e13d9
acosh.3, asinh.3, atanh.3: Update FTM requirements (_DEFAULT_SOURCE)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
827cdae3f1
_exit.2, abs.3, acos.3, acosh.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, cbrt.3, ceil.3, copysign.3, cos.3, cosh.3, div.3, erf.3, erfc.3, exp.3, exp2.3, expm1.3, fabs.3, fdim.3, finite.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fpclassify.3, frexp.3, fwide.3, hypot.3, ilogb.3, isalpha.3, isgreater.3, iswblank.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, log2.3, logb.3, lrint.3, lround.3, modf.3, nan.3, nextafter.3, pow.3, printf.3, remainder.3, remquo.3, rint.3, round.3, scalbln.3, scanf.3, signbit.3, sin.3, sinh.3, sqrt.3, strtod.3, strtol.3, strtoul.3, tan.3, tanh.3, tgamma.3, trunc.3, wprintf.3: Remove "or 'cc -std=c99'" from SYNOPSIS
...
Under the FTM requirements all of these pages document the
requirement for _ISOC99_SOURCE. And feature_test_macros(7) now
documents that "cc -std=c99" produces the same effect as defining
_ISOC99_SOURCE. So, all of these pages don't additionally need
to specify "or 'cc -std=c99'" under the FTM requirements
in the SYNOPSIS. Removing that redundant text also simplifies
the SYNOPSIS a little.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
cd2d5ec163
exp2.3, finite.3, fwide.3, log2.3, nextafter.3, printf.3, rint.3, wprintf.3: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
636ed4d58d
acosh.3, asinh.3, atanh.3, cbrt.3, erf.3, erfc.3, expm1.3, fpclassify.3, gamma.3, hypot.3, ilogb.3, j0.3, lgamma.3, log1p.3, logb.3, matherr.3, nextafter.3, remainder.3, rint.3, scalb.3, scalbln.3, significand.3, y0.3: Update FTM requirements (_DEFAULT_SOURCE)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
e9d91bcf4c
acos.3, asin.3, atan.3, atan2.3, ceil.3, copysign.3, cos.3, cosh.3, exp.3, fabs.3, floor.3, fmod.3, frexp.3, ldexp.3, log.3, log10.3, modf.3, pow.3, sin.3, sinh.3, sqrt.3, tan.3, tanh.3: Update FTM requirements (_DEFAULT_SOURCE)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
aa573adabf
dirfd.3: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
51c612fb9f
getgroups.2, gettimeofday.2, mincore.2, readv.2, stime.2, wait4.2, addseverity.3, adjtime.3, cfree.3, dysize.3, fgetgrent.3, fgetpwent.3, futimes.3, getdirentries.3, getgrent_r.3, getgrouplist.3, getmntent.3, getnetent_r.3, getprotoent_r.3, getpwent_r.3, getrpcent_r.3, getservent_r.3, getspnam.3, gsignal.3, initgroups.3, mkdtemp.3, on_exit.3, perror.3, psignal.3, putpwent.3, rcmd.3, rpmatch.3, setbuf.3, setnetgrent.3, sigvec.3, strsep.3, syslog.3, tempnam.3, termios.3, timegm.3, timeradd.3: Update FTM requirements (_DEFAULT_SOURCE)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
3dd87b7c99
setjmp.3: Remove reference to obsolete _XOPEN_SOURCE_EXTENDED
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
b40ec4cbf8
ttyslot.3: Update FTM requirements (_DEFAULT_SOURCE)
...
And remove mention of obsolete _XOPEN_SOURCE_EXTENDED
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
cf7fa0a179
brk.2, chdir.2, chmod.2, chown.2, chroot.2, getpagesize.2, getsid.2, killpg.2, mknod.2, readlink.2, setpgid.2, setreuid.2, sigaltstack.2, stat.2, symlink.2, sync.2, truncate.2, vfork.2, wait.2, wait4.2, a64l.3, acosh.3, asinh.3, atanh.3, cbrt.3, ecvt.3, expm1.3, gcvt.3, getcwd.3, getdate.3, getdtablesize.3, getgrent.3, gethostid.3, getpass.3, getpwent.3, getsubopt.3, ilogb.3, insque.3, lockf.3, log1p.3, logb.3, mkstemp.3, mktemp.3, nextafter.3, posix_memalign.3, random.3, realpath.3, remainder.3, rint.3, scalb.3, siginterrupt.3, sigset.3, strdup.3, ualarm.3, usleep.3: Remove references to _XOPEN_SOURCE_EXTENDED in SYNOPSIS
...
_XOPEN_SOURCE_EXTENDED is obsolete (it existed in SUSv1, but not
subsequent standards). _XOPEN_SOURCE >= 500 produces the same
effects as (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED). Modifying
the SYNOPSIS of various ages that contain:
_XOPEN_SOURCE\ >=\ 500 ||
_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
to just:
_XOPEN_SOURCE\ >=\ 500
This has the following benefits:
a) Simplifying the SYNOPSIS by removing ancient
historical information.
b) Preventing users from being misled into using
_XOPEN_SOURCE_EXTENDED in new source code.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
7f0ec8eed6
endian.3, getloadavg.3, getutent.3, inet.3, makedev.3, rexec.3: Update FTM requirements (_DEFAULT_SOURCE)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
e1d0532862
scandir.3: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
b0da7b8b76
access.2, chmod.2, chown.2, link.2, mkdir.2, open.2, readlink.2, rename.2, stat.2, symlink.2, unlink.2, utimensat.2, vfork.2, dirfd.3, fexecve.3, ffs.3, fmemopen.3, getcwd.3, gethostbyname.3, getline.3, mbsnrtowcs.3, mkdtemp.3, mkfifo.3, opendir.3, printf.3, psignal.3, qecvt.3, scandir.3, stpcpy.3, stpncpy.3, strdup.3, strnlen.3, strsignal.3, ualarm.3, usleep.3, wcpcpy.3, wcpncpy.3, wcscasecmp.3, wcsdup.3, wcsncasecmp.3, wcsnlen.3, wcsnrtombs.3: Simply FTM requirements
...
Looking at <features.h> (or feature_test_macros(7)), one can
see that when _XOPEN_SOURCE is defined with the value 700
(or greater), then _POSIX_C_SOURCE is defined with the value
200809L (or greater). Therefore, terms in the man pages such as
_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
can be simpified to:
_POSIX_C_SOURCE\ >=\ 200809L
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
e464f0546d
_exit.2, brk.2, abs.3, acos.3, acosh.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, cbrt.3, ceil.3, copysign.3, cos.3, cosh.3, div.3, erf.3, erfc.3, exp.3, expm1.3, fabs.3, fdim.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fpclassify.3, frexp.3, hypot.3, ilogb.3, isalpha.3, isgreater.3, iswblank.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, logb.3, lrint.3, lround.3, modf.3, nan.3, nextafter.3, posix_memalign.3, pow.3, remainder.3, remquo.3, round.3, scalbln.3, scanf.3, signbit.3, sin.3, sinh.3, sqrt.3, strtod.3, strtol.3, strtoul.3, tan.3, tanh.3, tgamma.3, trunc.3: Simplify FTM requirements
...
Looking at <features.h> (or feature_test_macros(7)), one can
see that when _XOPEN_SOURCE is defined with the value 600
(or greater), then _POSIX_C_SOURCE is defined with the value
200112L (or greater). Therefore, terms in the man pages such as
_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
can be simplified to:
_POSIX_C_SOURCE\ >=\ 200112L
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>`
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
a446ac0c68
brk.2, chroot.2, clock_nanosleep.2, getpagesize.2, posix_fadvise.2, select.2, select_tut.2, seteuid.2, clock_getcpuclockid.3, ecvt.3, exp2.3, fseeko.3, gcvt.3, getdtablesize.3, getpass.3, getw.3, log2.3, mktemp.3, mq_receive.3, mq_send.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, pthread_attr_setstack.3, rint.3, sem_wait.3, setenv.3, sockatmark.3, strerror.3: Simplify FTM requirements
...
Looking at <features.h> (or feature_test_macros(7)), one can
see that when _XOPEN_SOURCE is defined with the value 600
(or greater), then _POSIX_C_SOURCE is defined with the value
200112L (or greater). Therefore, terms in the man pages such as
_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
can be simpified to:
_POSIX_C_SOURCE\ >=\ 200112L
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
d054453419
acct.2, getdomainname.2, gethostname.2, vhangup.2, daemon.3, gethostid.3, getusershell.3, profil.3: Update feature test macro requirements
...
Update to use _DEFAULT_SOURCE, and also changes brought by
glibc commit 266865c0e7b79d4196e2cc393693463f03c90bd8.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
b105252461
readdir.3: Reorder text describing readdir_r()
...
(This is done in preparation for discussing glibc 2.23 changes.)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 11:01:27 +01:00
119cb943f0
readdir.3: srcfix: add missing 2008 copyright note
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 11:01:27 +01:00
cefcfd92d5
backtrace.3: Minor reworking in example program
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 11:01:27 +01:00
40da0793a6
getaddrinfo.3: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-28 14:39:01 +01:00
a222234619
backtrace.3: Small fixes to example program
...
Reported-by: Martin Gebert <Murphy.Gebert@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 16:45:17 +01:00
271ee1bf63
termios.3: SEE ALSO: add tty(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 13:20:09 +01:00
23ec905b42
setbuf.3: SEE ALSO: add stdbuf(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 12:58:44 +01:00
9bfa6a8427
sleep.3: SEE ALSO: add sleep(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 12:32:13 +01:00
b936906ac9
getcwd.3: SEE ALSO: add pwd(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 12:30:10 +01:00
06cdf61aca
fts.3: BUGS: glibc-2.23 now has LFS support for the fts functions
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-22 09:21:45 +01:00
c66649c835
clearenv.3: Clarify the use and effect of clearenv()
...
See http://bugs.debian.org/679323
Reported-by: Matt Zimmerman <mdz@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-19 13:07:58 +01:00
e44a70d63b
clearenv.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-19 13:07:58 +01:00
f34269b6ed
clearenv.3: Variables can be added to the environment after calling clearenv()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-19 13:07:58 +01:00
e8f9c18c31
clearenv.3: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-19 13:07:57 +01:00
d2229a2b2f
clog10.3: Show an alternative equivalence for clog10()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-19 13:07:57 +01:00
d8334b03a5
clog10.3: Update CONFORMING TO
...
Fix grammar error and add C11.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-19 13:07:57 +01:00
5c6de1fc37
strnlen.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-18 14:17:29 +01:00
5af40309cc
strlen.3: CONFORMING TO: add C11
...
Reported-by: Alan Aversa <alan.aversa@cox.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-18 14:10:15 +01:00
b357f2c97c
strlen.3: wfix
...
Reported-by: Alan Aversa <alan.aversa@cox.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-18 14:09:49 +01:00
2ddb74c035
strlen.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-18 13:27:02 +01:00
988c4c4263
termios.3: Further improvements to recent tweaks of canonical mode 4096 char limit
...
Reported-by: Peter Hurley <peter@hurleysoftware.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-18 12:23:21 +01:00
4a66305922
printf.3: tfix
...
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=756599
Reported-by: Jakub Wilk <jwilk@debian.org>
Reported-by: Stéphane Aulery <lkppo@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-17 13:10:37 +01:00
332aaf19ff
setjmp.3: wfix
...
Reported-by: Stephan Bergmann <sbergman@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-17 12:08:38 +01:00
082efcce8b
signal.7: Note the interactions of longjmp() and non-async-signal-safe functions
...
See http://austingroupbugs.net/view.php?id=516#c1195 .
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-16 15:48:36 +01:00
f1d6ee6211
setjmp.3: Note the interactions of longjmp() and non-async-signal-safe functions
...
POSIX.1-2008 TC2 adds explicit text on this point.
See http://austingroupbugs.net/view.php?id=516#c1195
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-16 15:48:36 +01:00
b51ef507b8
longjmp.3: Replace page with link to setjmp(3), which now incorporates longjmp()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-16 15:48:36 +01:00
a26c590b88
siglongjmp.3: Rewire link to point to setjmp(3)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-16 15:48:36 +01:00
efc626f8f5
setjmp.3: Rewrite and merge longjmp()/siglongjmp() discussion into this page
...
The discussion of nonlocal gotos is much easier to read if
setjmp() and longjmp() are discussed in the same page. While
we're at it, rework almost the entire text and add several
more details.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-16 15:48:30 +01:00
84d75c06d5
longjmp.3: Refer the reader to NOTES in setjmp(3)
...
There the reader will see the just expanded discussion of
why nonlocal gotos can make code harder to maintain.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-16 15:48:30 +01:00
405180660c
setjmp.3: Explain why nonlocal gotos make code harder to maintain
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-16 15:48:26 +01:00
57f79036a4
setjmp.3: Reword warning on longjmp() to function that has already returned
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-16 12:55:08 +01:00
fa03b85f87
longjmp.3: Remove redundant warning
...
The warning that nonlocal gotos make a program hard to maintain
is also given in setjmp(3). No need to repeat it here.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-16 12:50:19 +01:00
7a727dc4ab
termios.3: Tweaks to Tobias's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-15 16:24:50 +01:00
5ad8a9d73b
termios.3: Document line length in canonical mode
...
See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/drivers/tty/n_tty.c#n1673
See https://bugs.debian.org/797479
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-15 16:18:13 +01:00
45a2419dac
queue.3: Remove double CONFORMING TO section
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-15 16:16:59 +01:00
4cf9fe6b53
sigpause.3: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-15 13:34:44 +01:00
88cc4cb6cc
perror.3: Suggest use of strerror(3) in place of deprecated 'sys_errlist'
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-08 16:23:13 +01:00
f1b7532ba7
isgreater.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-08 16:11:58 +01:00
24a31d632b
accept.2, bind.2, connect.2, getpeername.2, getsockname.2, recv.2, recvmmsg.2, select_tut.2, send.2, sendmmsg.2, getaddrinfo.3, getnameinfo.3, epoll.7, unix.7: Use consistent argument/variable names for socket addresses and lengths
...
As noted by Carlos, there's quite a bit of inconsistency across
pages. Use 'addr' and 'addrlen' consistently in variables and
function arguments.
Cowritten-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 14:08:29 +01:00
787dd4ad3a
membarrier.2, crypt.3, dladdr.3, duplocale.3, fmemopen.3, gethostbyname.3, mallopt.3, newlocale.3, resolver.3, sigsetops.3, strfmon.3, tzset.3, console_ioctl.4, lirc.4, loop.4, vcs.4, dir_colors.5, locale.5, proc.5, tzfile.5, attributes.7, bootparam.7, capabilities.7, feature_test_macros.7, icmp.7, man-pages.7, netlink.7, path_resolution.7, pipe.7, socket.7, unix.7, vdso.7: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 09:14:22 +01:00
b353ceb4a0
basename.3: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 08:46:35 +01:00
def04e1ccf
chown.2, futex.2, membarrier.2, memfd_create.2, mount.2, msgop.2, open.2, open_by_handle_at.2, perf_event_open.2, readv.2, sched_setscheduler.2, syslog.2, basename.3: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-03 08:46:16 +01:00
254f636a4c
exp.3: SEE ALSO: add expm1(3)
...
Reported-by: Joachim Wuttke <j.wuttke@fz-juelich.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-01 15:30:45 +01:00
c72249c562
fork.2, read.2, sendfile.2, splice.2, write.2, aio_read.3, aio_write.3, proc.5: Wording fix: "current file offset" ==> "file offset"
...
"File offset" is the preferred POSIX terminology.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:13:47 +01:00
99bf434550
mcheck.3: tfix
...
Remove duplicated word.
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-25 14:33:30 +01:00
00e295fb10
system.3: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-20 22:04:22 +01:00
7e16fc97b2
perror.3: tfix
...
Signed-off-by: Alexander Miller <alex.miller@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-19 12:52:04 +01:00
c32f10a179
rcmd.3: Add missing condition concerning .rhosts file
...
The list of conditions determining if iruserok() and ruserok()
functions automatically fail is incomplete. According to glibc
source code, the functions also fail if the .rhosts file
is hard linked anywhere.
[Information verified from iruserfopen() function in inet/rcmd.c]
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-17 17:05:24 +01:00
1cd9229c06
mq_close.3: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-16 11:19:31 +01:00
6c15ab2dd1
exec.3: SEE ALSO: add system(3)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-16 10:37:37 +01:00
fb7a9afd3b
system.3: SEE ALSO: add execve(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-16 10:36:07 +01:00
bb2e799782
system.3: Minor fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-16 10:35:51 +01:00
bb492d9dc2
toupper.3: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-08 20:19:17 +01:00
9f895e62e5
errno.3: Add some explanation of ENOENT error
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 13:33:13 +01:00
bb14af394e
clock_nanosleep.2, fallocate.2, nanosleep.2, request_key.2, sigsuspend.2, statfs.2, getgrent.3, getgrnam.3, getpwent.3, getpwnam.3, lio_listio.3, statvfs.3, tmpfile.3, ualarm.3: ERRORS: add reference to signal(7) in description of EINTR
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 13:15:06 +01:00
d9cb0d7d3f
Various pages: Word "descriptor" more precisely
...
Use either "file descriptor" or message queue descriptor".
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 12:29:37 +01:00
3eec7952d6
bindresvport.3: Minor wording fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 12:28:37 +01:00
39d5f56976
undocumented.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 16:08:33 +01:00
4b7c4868dc
strerror_l.3: New link to strerror.3
...
Fix missing link
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 16:07:24 +01:00
325d0d830d
isalpha_l.3: New link to isalpha.3
...
Fix missing link.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 16:06:06 +01:00
e24fbf1098
Removed trailing white space at end of lines
2015-12-29 13:51:32 +01:00
29b41e747f
accept.2, acct.2, bind.2, clock_getres.2, connect.2, dup.2, epoll_create.2, eventfd.2, execve.2, fanotify_init.2, fcntl.2, fork.2, futex.2, get_robust_list.2, getcpu.2, getpeername.2, getrlimit.2, getsockname.2, getsockopt.2, gettimeofday.2, inotify_init.2, listen.2, membarrier.2, memfd_create.2, mlock.2, mmap.2, personality.2, pipe.2, poll.2, recv.2, send.2, sendfile.2, shmget.2, shutdown.2, sigreturn.2, socket.2, socketcall.2, socketpair.2, spu_create.2, swapon.2, time.2, timerfd_create.2, uselib.2, dlerror.3, dlopen.3, drand48.3, errno.3, fnmatch.3, getgrent.3, getgrnam.3, getlogin.3, getpwent.3, getpwnam.3, iconv.3, mq_open.3, opendir.3, random_r.3, sem_open.3, shm_open.3, tmpfile.3, tzset.3, random.4, fanotify.7, futex.7, vdso.7, ld.so.8: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-29 13:48:42 +01:00
b664d38dd5
fnmatch.3: Describe the FNM_EXTMATCH flag and pattern syntax
...
Signed-off-by: Pádraig Brady <P@draigBrady.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-27 17:14:55 +01:00
e258766bf4
accept.2, acct.2, epoll_create.2, execve.2, futex.2, inotify_init.2, mmap.2, open.2, pipe.2, shmget.2, socket.2, socketpair.2, spu_create.2, swapon.2, uselib.2, getgrent.3, getgrnam.3, getlogin.3, getpwent.3, getpwnam.3, mq_open.3, opendir.3, sem_open.3, shm_open.3, tmpfile.3, fanotify.7: ERRORS: standardize text for ENFILE error
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-27 17:10:23 +01:00
4a5c6f9f2c
errno.3: Note probable cause of ENFILE error
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-27 17:03:41 +01:00
26c32fabec
accept.2, dup.2, eventfd.2, execve.2, fcntl.2, memfd_create.2, open.2, perf_event_open.2, pipe.2, signalfd.2, socket.2, socketpair.2, spu_create.2, timerfd_create.2, getgrent.3, getgrnam.3, getlogin.3, getpwent.3, getpwnam.3, mq_open.3, opendir.3, sem_open.3, shm_open.3, tmpfile.3: ERRORS: standardize text for EMFILE error
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-27 16:37:03 +01:00
ea1127509f
scanf.3: Minor wording tweaks in RETURN VALUE
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-27 16:00:29 +01:00
aeb4ba7602
dlerror.3: Clarify that the string returned by dlerror() is null terminated
...
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-26 16:58:46 +01:00
77227d3697
CPU_SET.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-19 06:05:09 +01:00
b62ea03aa4
drand48.3: Correct descriptions of ranges returned by these functions
...
See http://bugs.debian.org/803459
Reported-by: Vincent Lefevre <vincent@vinc17.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-17 15:02:52 +01:00
61f6d1af1c
random_r.3: Clarify need to use initstate_r()
...
As noted by Archie Cobbs:
I was trying to use srandom_() and initstate_r() and fell into
the exact same trap this this fellow did:
http://stackoverflow.com/questions/18569523/segfault-at-srandom-r ,
resulting in a segfault.
The man page is really unclear here. It leads one to believe
(falsely) that invoking setrandom_r() is sufficient to initialize
a struct random_data, but this is not the case. In fact
srandom_r() is not like srandom() at all in this respect.
Reported-by: Archie Cobbs <archie.cobbs@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-17 09:36:37 +01:00
17e9724a2e
tzset.3: Clarify "daylight" and remove erroneous note
...
When tzset is run the value of daylight is computed
by looking at all available rules for the application
of daylight savings. This includes reading the tzdata
files to determine if there is a transition or not for
the current timezone. It also includes parsing TZ env
to see if it specifies custom rules which are used in
precedence to any tzdata rules. Therefore daylight is
going to be set if there is a daylight saving rule past,
present, or future that indicates a transition. We clarify
that in the man page.
Lastly, the note about tz_dsttime is not correct and is
removed. The earlier paragraph about daylight makes it
clear that it doesn't mean "daylight saving rule applies
now", and the interaction with tz_dsttime is not correct
for glibc on Linux (as outlined in my gettimeofday.3 patch
sent here: http://marc.info/?l=linux-man&m=144977768703615&w=2 ).
Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-16 16:43:45 +01:00
c89ca4366c
iconv.3: NOTES: describe correct usage for flushing partially buffered input
...
The following came up yesterday on the wget list.
The iconv.3 man page says
"... 2. The input byte sequence has been entirely converted,
i.e. *inbytesleft has gone down to 0."
and
"A different case is when inbuf is NULL or *inbuf is NULL,
but outbuf is not NULL and *outbuf is not NULL. In this case,
the iconv function attempts to set cd's conversion state to the
initial state and store a corresponding shift sequence at
*outbuf."
The POSIX page says
"For state-dependent encodings, the conversion descriptor cd is
placed into its initial shift state by a call for which inbuf
is a null pointer, or for which inbuf points to a null pointer.
When iconv() is called in this way, and if outbuf is not a null
pointer or a pointer to a null pointer, and outbytesleft points
to a positive value, iconv() shall place, into the output buffer,
the byte sequence to change the output buffer to its initial
shift state."
These texts are slightly misleading, in the sense that, in the
present implementation, iconv() may implement conversion
from an encoding that is not state-dependent in a way that
uses an artificial shift state to store lookahead bytes.
That means that after conversion, when *inbytesleft has gone
down to 0, it may be that contrary to what iconv.3 suggests not
all output has been stored, and a final flushing call is needed.
Maybe this violates POSIX.
A minimal warning is added by this patch.
--- man-pages-4.03/man3/iconv.3 2015-12-05 10:45:25.000000000 +0100
+++ ./iconv.3 2015-12-16 01:41:38.253049938 +0100
@@ -161,6 +161,11 @@
.SH CONFORMING TO
POSIX.1-2001, POSIX.1-2008.
.SH NOTES
+In each series of calls to
+.BR iconv (),
+the last should be one with \fIinbuf\fP or \fI*inbuf\fP equal to NULL,
+in order to flush out any partially converted input.
+
Although
.I inbuf
and
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-16 11:27:36 +01:00
Michael Kerrisk