Commit Graph

3964 Commits

Author SHA1 Message Date
Michael Kerrisk ca8c33fcdd termios.3: SEE ALSO: add tset(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-13 11:08:55 +01:00
Michael Kerrisk ac5ba355d5 pow.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-11 13:58:14 +01:00
Manuel López-Ibáñez 285d20e353 pow.3: Add note on performance characteristics of pow()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-11 13:56:34 +01:00
David Wragg a7bd3dab97 cmsg.3: ensure buf is suitably aligned in sending example
Inspection of the definition of CMSG_FIRSTHDR (both in glibc and
the suggested definition in RFC3542) shows that it yields the
msg_control field.  So when sending, the pointer placed in
msg_control should be suitably aligned as a struct cmsghdr.
In the sending example, buf was declared as a bare char array,
and so is not necessarily suitably aligned.

The solution here involves placing buf inside a union, and is
based on the sockets/scm_rights_send.c sample from The Linux
Programming Interface "dist" source code collection.

Signed-off-by: David Wragg <david@wragg.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-11 10:01:59 +01:00
Michael Kerrisk 34fcd227fb abort.3: Note that SIGABRT is raised as though raise(3) is called
Also note that abort is POSIX.1-2008 compliant.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-09 19:52:34 +01:00
Michael Kerrisk d74f805937 mq_open.3: Document the O_CLOEXEC flag
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-08 13:49:54 +01:00
Michael Kerrisk 8d121cc5c1 mq_open.3: Place 'flags' constants in alphabetical order
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-08 13:37:10 +01:00
Michael Kerrisk 31e025bf45 tgamma.3: Since glibc 2.18, errno is correctly set to EDOM when (x == -infinity))
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-31 07:25:54 +01:00
Michael Kerrisk 8ee4373d37 ilogb.3: Since glibc 2.16, ilogb() does correctly diagnore domain errors
Reported-by: Will Newton <will.newton@linaro.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-31 07:24:37 +01:00
Michael Kerrisk 0ba5517581 exp10.3: Before glibc 2.19, exp() did not give ERANGE error on underflow
http://sources.redhat.com/bugzilla/show_bug.cgi?id=6787

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-30 19:08:26 +01:00
Josh Triplett 4d300f4a48 sysconf.3: Document _SC_NGROUPS_MAX
Already documented in getgroups(2), but not in sysconf(3).

Signed-off-by: Josh Triplett <josh@joshtriplett.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 15:27:16 +01:00
刘湃 78e369ff57 pthread_setschedparam.3: Small fixes to example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 15:02:47 +01:00
Yuri Kozlov d79f2e8c7e lseek64.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-16 13:41:41 +02:00
Simon Paillard ccde3aacfd tzset.3: grfix
The sentence is missing a word somewhere.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-16 11:56:22 +02:00
Michael Kerrisk b8017cf527 Removed trailing white space at end of lines 2014-10-15 11:17:46 +02:00
Michael Kerrisk ad624ff433 readlink.2, readv.2, pthread_rwlockattr_setkind_np.3, signal.7, unix.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-15 11:13:45 +02:00
Michael Kerrisk 3de09c0d9b pthread_rwlockattr_setkind_np.3: srcfix: Add license tag
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-15 11:13:11 +02:00
Michael Kerrisk a21a7c10ba pthread_rwlockattr_setkind_np.3: Edits my mtk
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-14 09:14:27 +02:00
Robert Schweikert 5072376a1b pthread_rwlockattr_getkind_np.3: New link to pthread_rwlockattr_setkind_np(3) 2014-10-14 09:11:44 +02:00
Robert Schweikert 88e15474bf pthread_rwlockattr_setkind_np.3: New page documenting pthread_rwlockattr_[sg]etkind_np(3)
Documents pthread_rwlockattr_setkind_np(3) and
pthread_rwlockattr_getkind_np(3).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-14 09:10:26 +02:00
Michael Kerrisk 63fe502792 abs.3: wfix
Reported-by: Walter Harms <wharms@bfs.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-10 22:13:11 +02:00
Michael Kerrisk 36ad6ae0b4 abs.3: wfix
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-10 22:11:56 +02:00
Michael Kerrisk e890609356 capget.2, ptrace.2, vhangup.2, wait.2, ttyslot.3, console.4, proc.5, utmp.5, boot.7: tfix: page xrefs for init 2014-10-03 08:47:03 +02:00
Michael Kerrisk bc65e77236 ldd.1, execve.2, fanotify_init.2, fanotify_mark.2, getrlimit.2, open.2, readlink.2, sched_setattr.2, sched_setscheduler.2, shmget.2, syscalls.2, vmsplice.2, dlopen.3, fseeko.3, getgrent.3, mq_getattr.3, mq_open.3, realpath.3, armscii-8.7, ascii.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, koi8-r.7, koi8-u.7, sched.7, ld.so.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-02 23:47:51 +02:00
Michael Kerrisk 5d95b7d80a dlopen.3: SEE ALSO: add pldd(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-02 23:10:41 +02:00
Michael Kerrisk 6c1eb6d237 mq_getattr.3: Add an example program
The example program can be used to discover the default
'mq_maxmsg' and 'mq_msgsize' values used to create a queue with
a mq_open(3) call in which 'attr' is NULL.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-02 22:18:09 +02:00
Michael Kerrisk 98c2ef7bc4 mq_getattr.3: Fix: /proc files are described in mq_overview(7) not (mq_open(3))
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-02 22:18:09 +02:00
Michael Kerrisk d8e8fd1053 mq_open.3: Two /proc files control the defaults for the attrp==NULL case
Refer the reader to the discussion in mq_overview(7) for a
discussion of these files, which exist since Linux 3.5.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-02 22:18:09 +02:00
Michael Kerrisk 09795f3425 mq_open.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-02 22:18:09 +02:00
Michael Kerrisk be7d49c178 strcat.3: wfix
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-01 11:56:48 +02:00
Michael Kerrisk 1f63d3ec81 fseeko.3: _FILE_OFFSET_BITS must be defined before including any header file
Reported-by: Thomas Mack <mack@ifis.cs.tu-bs.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-01 11:56:47 +02:00
Michael Kerrisk 23ac32233b euidaccess.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-21 19:53:13 +02:00
Michael Kerrisk 9e4f79d4d3 realpath.3: SEE ALSO: add realpath(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-21 19:51:48 +02:00
Carlos O'Donell 7109ed8103 getgrent.3: Add ENOENT and EAGAIN to error list
It's possible to get ENOENT returned from getgrent()
if the backend, for example say SSSD, isn't configured
or the daemon isn't running. The same can be said of any
of the NSS backend.

As POSIX does not list ENOENT, we can list it ourselves
and define it how we like.

I don't know how you handle errno values that are glibc
specific, but here is the patch that enhances getgrent(3)
to make users aware of what ENOENT is intended to mean
from glibc.

While I'm fixing one I might as well [add EAGAIN].

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-21 19:50:35 +02:00
Michael Kerrisk daf084cc33 clone.2, flock.2, getpid.2, getunwind.2, mount.2, reboot.2, semop.2, seteuid.2, setgid.2, setns.2, setresuid.2, setreuid.2, setuid.2, uname.2, unshare.2, clock.3, drand48.3, proc.5, capabilities.7, credentials.7, mq_overview.7, namespaces.7, pid_namespaces.7, svipc.7, user_namespaces.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-21 11:23:07 +02:00
Michael Kerrisk 3db3ecf0ff drand48.3: Remove crufty text about SVID 3 marking drand48() obsolete
See http://bugs.debian.org/758293

drand48() is in current POSIX. It's unclear why SVID 3 would
have marked it obsolete, but that's crufty information that
only serves to pointlessly worry people.

Reported-by: Lorenzo Beretta <lory.fulgi@infinito.it>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:14:06 -07:00
Michael Kerrisk f35f30b86c clock.3: The switch to the use of clock_gettime() was to improve *accuracy*
Quoting Vincent Lefevre:

    In glibc 2.17 and earlier, clock() was implemented on top of
    times(2).  For improved precision, since glibc 2.18, it is
                      ^^^^^^^^^^^^^^^^^^
    implemented on top of clock_gettime(2) (using the
    CLOCK_PROCESS_CPUTIME_ID clock).

This looks strange. The user doesn't seek improved precision, but
improved accuracy: if one gets more digits but the value itself is
less accurate (i.e. the error against the ideal value is larger),
this is bad. Perhaps changing "precision" to "accuracy" would be
correct (I assume that the real goal of the change was not just
improved precision, but more importantly the resulting improved
accuracy). I've reported a bug about the glibc documentation:

  https://sourceware.org/bugzilla/show_bug.cgi?id=17383

Reported-by: Vincent Lefevre <vincent@vinc17.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 19:35:37 -07:00
Michael Kerrisk 62c76ace78 memusage.1, memusagestat.1, connect.2, fcntl.2, poll.2, errno.3, rtnetlink.3, inotify.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-07 05:03:19 -07:00
Holger Hans Peter Freyther cb7c2ea700 rtnetlink.3: Fix parameters for the send() call in the example
Signed-off-by: Holger Hans Peter Freyther <holger@moiji-mobile.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-01 19:47:32 +02:00
Michael Kerrisk 9af134cdeb getrlimit.2, mmap.2, stat.2, unimplemented.2, dbopen.3, ecvt_r.3, fopen.3, fts.3, getcontext.3, qecvt.3, ip.7, ld.so.8: grfix: Add Oxford comma
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-01 17:57:07 +02:00
Michael Kerrisk c8624d68b2 malloc.3: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-01 17:30:53 +02:00
Michael Kerrisk 00f3b66d62 errno.3: SEE ALSO: add errno(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-25 18:40:57 +02:00
Mike Frysinger ae57731070 getpwnam(3): ffix
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-22 17:53:25 -05:00
Michael Kerrisk bea08fec7e adjtimex.2, bind.2, cacheflush.2, clone.2, fallocate.2, fanotify_init.2, fanotify_mark.2, flock.2, futex.2, getdents.2, getpriority.2, getrlimit.2, gettid.2, gettimeofday.2, ioprio_set.2, kexec_load.2, migrate_pages.2, modify_ldt.2, mount.2, move_pages.2, mprotect.2, msgop.2, nfsservctl.2, perf_event_open.2, pread.2, ptrace.2, recvmmsg.2, rename.2, restart_syscall.2, sched_setattr.2, send.2, shmop.2, shutdown.2, sigaction.2, signalfd.2, syscalls.2, timer_create.2, timerfd_create.2, tkill.2, vmsplice.2, wait.2, aio_init.3, confstr.3, exit.3, fmemopen.3, fopen.3, getaddrinfo.3, getauxval.3, getspnam.3, isalpha.3, isatty.3, mallinfo.3, malloc.3, mallopt.3, psignal.3, pthread_attr_setinheritsched.3, qecvt.3, queue.3, rtnetlink.3, strerror.3, strftime.3, toupper.3, towlower.3, towupper.3, initrd.4, locale.5, proc.5, bootparam.7, capabilities.7, ddp.7, fanotify.7, icmp.7, inotify.7, ip.7, ipv6.7, netdevice.7, netlink.7, path_resolution.7, rtld-audit.7, rtnetlink.7, sched.7, signal.7, socket.7, svipc.7, tcp.7, unix.7, ld.so.8: srcfix: Update FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-21 16:47:44 -05:00
Michael Kerrisk ef4f4031ca Removed trailing white space at end of lines 2014-08-19 12:01:21 -05:00
Michael Kerrisk 8980a50087 access.2, bdflush.2, bind.2, brk.2, chmod.2, chown.2, clone.2, epoll_wait.2, execve.2, fsync.2, getgroups.2, gethostname.2, getpagesize.2, getpriority.2, getrlimit.2, ioperm.2, kexec_load.2, link.2, mkdir.2, mmap.2, msgop.2, perf_event_open.2, process_vm_readv.2, ptrace.2, readlink.2, readv.2, recv.2, rename.2, sched_setaffinity.2, select.2, send.2, seteuid.2, signal.2, sigwaitinfo.2, stat.2, symlink.2, sync.2, sync_file_range.2, sysinfo.2, timer_create.2, uname.2, unlink.2, utime.2, wait.2, abs.3, atoi.3, catopen.3, cerf.3, cexp2.3, clearenv.3, clog2.3, ctime.3, des_crypt.3, ecvt.3, fgetgrent.3, flockfile.3, fseeko.3, ftime.3, ftok.3, ftw.3, getauxval.3, getcwd.3, getdtablesize.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, getline.3, getpass.3, getutent.3, glob.3, insque.3, lseek64.3, memmem.3, mkstemp.3, mktemp.3, on_exit.3, openpty.3, putenv.3, qecvt.3, realpath.3, remove.3, setbuf.3, sigpause.3, strftime.3, strptime.3, strstr.3, strtod.3, tzset.3, updwtmp.3, xcrypt.3, core.5, utmp.5, capabilities.7, charsets.7, environ.7, ipv6.7, man-pages.7, packet.7, vdso.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-19 11:55:41 -05:00
Michael Kerrisk af81e9cd97 isfdtype.3: New page documenting isfdtype(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:24:32 -05:00
Michael Kerrisk 94ed3bb9c6 getgrouplist.3: SEE ALSO: add group_member(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:20:49 -05:00
Michael Kerrisk 701f91bd92 group_member.3: New page documenting group_member(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:20:49 -05:00
Michael Kerrisk 165b96384d putenv.3: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:51 -05:00