Commit Graph

1082 Commits

Author SHA1 Message Date
Michael Kerrisk 0cf2caa41e unix.7: Document the autobind feature
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-10 07:47:14 +02:00
Michael Kerrisk 6ed236d51a unix.7: Fix description of "pathname" sockets
As reported by Lennart Poettering:

   The part about "pathname" sockets suggests usage of
   sizeof(sa_family_t) + strlen(sun_path) + 1
   for calculating the sockaddr size. Due to alignment/padding
   this is probably not a good idea. Instead, one should use
   offsetof(struct sockaddr_un, sun_path) + strlen() + 1
   or something like that.

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

Reported-by: Lennart Poettering <mzxreary@0pointer.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-10 07:25:45 +02:00
Michael Kerrisk 156a0e0d7e unix.7: Fix description of abstract socket names
As reported by Lennart Poettering:

    The part about "abstract" sockets is misleading as it suggests
    that the sockaddr returned by getsockname() would necessarily
    have the size of sizeof(struct sockaddr), which however is not
    the case: getsockname() returns exactly the sockaddr size that
    was passed in on bind(). In particular, two sockets that are
    bound to the same sockaddr but different sizes are completely
    independent.

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

Reported-by: Lennart Poettering <mzxreary@0pointer.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-10 07:25:39 +02:00
Michael Kerrisk 6074c3e6f8 unix.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-10 06:13:59 +02:00
David Prevot 95406ae00b aio.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-09 16:46:12 +02:00
Michael Kerrisk d46da242bb aio.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-06 07:07:55 +02:00
Michael Kerrisk a9ba82d5b2 sigevent.7: SEE ALSO: Add aio_read(3), aio_write(3), and lio_listio(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-04 06:20:22 +02:00
Michael Kerrisk 59e9285d75 Removed trailing white space at end of lines 2010-10-04 05:04:21 +02:00
Michael Kerrisk 9889b88b02 sigevent.7: Add SEE ALSO referring to new aio(7) page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-04 04:28:50 +02:00
Michael Kerrisk 64be80cfef aio.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-04 04:14:50 +02:00
Michael Kerrisk 4076f2893a aio.7: New page providing an overview of POSIX asynchronous I/O
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-03 17:12:22 +02:00
Michael Kerrisk 09fa72fa1a inotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-27 08:03:27 +02:00
Michael Kerrisk 4d2ddb4ec1 inotify.7: Add a further limitation of API under NOTES
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-27 08:01:30 +02:00
Michael Kerrisk 0f848cbcde sigevent.7: Add SEE ALSO reference to new getaddrinfo_a.3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-27 07:52:54 +02:00
Michael Kerrisk 613836aaa5 inotify.7: Added section noting limiations and caveats of inotify
Reported-by: Jan Kara <jack@suse.cz>
Reported-by: Lennart Poettering <mzjro@0pointer.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-27 04:04:38 +02:00
Michael Kerrisk 66d3a13ba5 hash.3, stdarg.3, unicode.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-26 07:37:23 +02:00
Michael Kerrisk 5fab2e7c9c Changes.old, clone.2, execve.2, fcntl.2, futex.2, getitimer.2, getpriority.2, mmap.2, mount.2, mprotect.2, sched_setscheduler.2, select_tut.2, setuid.2, sigaltstack.2, vfork.2, div.3, fenv.3, fmod.3, memchr.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_getattr_np.3, queue.3, scanf.3, trunc.3, st.4, proc.5, services.5, utmp.5, bootparam.7, capabilities.7, feature_test_macros.7, futex.7, glob.7, man.7, netlink.7, unicode.7: Switch to American usage: "-wards" ==> "-ward"
American English uses "afterward" in preference to "afterwards",
and so on

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-26 07:34:47 +02:00
Michael Kerrisk dd6b86ce9e suffixes.7: Change explanation of ".rpm" to "RPM software package"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-22 18:23:10 +02:00
Michael Kerrisk 0fe5e29835 boot.7: wsfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-22 18:22:13 +02:00
Michael Kerrisk f6b326eba5 Removed trailing white space at end of lines 2010-09-22 18:09:17 +02:00
Michael Kerrisk 516ddeefbd rtnetlink.7: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-22 16:59:10 +02:00
Michael Kerrisk 6de73b14d8 rtnetlink.7: tfix: s/rtaddr/rtattr/
Reported-by: caishuxian@gmail.com
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-22 16:59:09 +02:00
Michael Kerrisk 16ca456457 pthreads.7, signal.7: Add SEE ALSO reference to new sigevent(7) page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-22 16:59:09 +02:00
Petr Baudis bcc5e40713 sigevent.7: New page to centralize description of sigevent structure
Several interfaces use this structure. Best to centralize the
common details in one place. Content taken from the existing
timerfd_create.2 and mq_open.3 pages, with additions by
Petr Baudis and Michael Kerrisk.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-22 16:59:09 +02:00
Yuri Kozlov d2b885c563 boot.7: Update list of major Linux distributions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-22 16:59:09 +02:00
Michael Kerrisk 50831f9b8a _exit.2, brk.2, capget.2, chdir.2, chmod.2, chown.2, chroot.2, getdtablesize.2, gethostname.2, getpagesize.2, getsid.2, killpg.2, mknod.2, mknodat.2, poll.2, posix_fadvise.2, pread.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, abs.3, acos.3, acosh.3, asin.3, asinh.3, atan.3, atan2.3, atoi.3, cbrt.3, ceil.3, copysign.3, cosh.3, dirfd.3, div.3, ecvt.3, erf.3, erfc.3, exp.3, exp2.3, fabs.3, fdim.3, ffs.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fpclassify.3, frexp.3, ftw.3, fwide.3, gcvt.3, getcwd.3, getdate.3, getgrent.3, gethostid.3, getpass.3, getpwent.3, getsubopt.3, getw.3, hypot.3, ilogb.3, index.3, isalpha.3, isgreater.3, iswblank.3, j0.3, ldexp.3, lockf.3, log.3, log10.3, log1p.3, logb.3, lrint.3, lround.3, mkstemp.3, mktemp.3, modf.3, mq_receive.3, mq_send.3, nan.3, nextafter.3, posix_fallocate.3, posix_memalign.3, printf.3, qecvt.3, random.3, realpath.3, remainder.3, remquo.3, rint.3, round.3, scalb.3, scalbln.3, scanf.3, siginterrupt.3, signbit.3, sigset.3, sinh.3, sqrt.3, strcasecmp.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strfry.3, strpbrk.3, strsep.3, strspn.3, strstr.3, strtod.3, strtok.3, strtol.3, strtoul.3, strxfrm.3, tanh.3, tgamma.3, trunc.3, ttyslot.3, ualarm.3, usleep.3, wprintf.3, armscii-8.7, cp1251.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-3.7, iso_8859-5.7, iso_8859-6.7, iso_8859-8.7, koi8-u.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-22 16:59:09 +02:00
Jiri Olsa a6e9960e8f ip.7: Document IP_NODEFRAG
This option is new in Linux 2.6.36

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-11 07:19:10 +02:00
Michael Kerrisk 3ac83a00b6 ip.7: srcfix: Added FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-11 07:08:30 +02:00
Michael Kerrisk 7aed61d9c0 unix.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-11 06:40:34 +02:00
Michael Kerrisk fa57b2089b shm_overview.7: wfix: s/semaphore/shared memory/
Reported-by: Tim Stoakes <tim@stoakes.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 08:15:31 +02:00
Michael Kerrisk b220f1b53a feature_test_macros.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 07:19:12 +02:00
Michael Kerrisk e0530cbbdd feature_test_macros.7: Make text on required placement of macros more prominent
Move the text that notes the requirement that feature test macros
must be defined before including any header files to the top of
the page, and highlight the text further, so that the reader will
not miss this point.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 07:15:16 +02:00
Michael Kerrisk f8b212130c feature_test_macros.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 07:14:41 +02:00
Michael Kerrisk 71a491b144 feature_test_macros.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 07:13:11 +02:00
Michael Kerrisk 86b91fdffb accept.2, clone.2, dup.2, fallocate.2, pipe.2, readahead.2, sched_setaffinity.2, unshare.2, CPU_SET.3, endian.3, euidaccess.3, fexecve.3, getpt.3, getpw.3, getumask.3, getutmp.3, gnu_get_libc_version.3, makedev.3, matherr.3, mbsnrtowcs.3, memfrob.3, pthread_attr_setaffinity_np.3, pthread_getattr_np.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3, tcgetsid.3, wcscasecmp.3, wcsncasecmp.3, wcsnlen.3, wcsnrtombs.3, wcswidth.3, rtld-audit.7: SYNOPSIS: Add reference to feature_test_macros(7)
These pages specify feature test macros in the function
prototypes. Add a reference to feature_test_macros(7),
so that readers are pointed to the information that
feature test macros must be defined before including
*any* header file.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 07:06:22 +02:00
Michael Kerrisk e417acb023 fcntl.2, intro.2, open.2, poll.2, ftw.3, intro.3, matherr.3, system.3, tmpnam.3, unix.7: Note that feature test macros must be defined before *any* includes
Programmers often make the mistake of including a feature test
macro only after having already included some header files.
This patch adds some text at opportune places to remind
programmers to do things the right way.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 06:33:31 +02:00
Michael Kerrisk fbea0f8160 unix.7: Document SIOCINQ ioctl() operation
Reported-by: Jim Belton <jim.belton@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 06:02:16 +02:00
Michael Kerrisk 00c8445384 packet.7: srcfix: added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 06:02:16 +02:00
Michael Kerrisk c2aa3e258c tcp.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 06:02:16 +02:00
Michael Kerrisk e9716a4d96 tcp.7: srcfix: added references to glibc bug report
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 06:02:16 +02:00
Michael Kerrisk f73df7253d tcp.7: Clarify header file details for SIOCINQ and SIOCOUTQ
Also note synonymous FIONREAD and TIOCOUTQ.

Reported-by: Jim Belton <jim.belton@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 06:02:00 +02:00
Denis Barbier 7fcdca3be7 armscii-8.7, cp1251.7, iso_8859-3.7, iso_8859-5.7, iso_8859-6.7, iso_8859-8.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, koi8-u.7: Fix decimal values in encoding tables
Octal and hexadecimal values are right, but there are some
off-by one errors in decimal values.  Correct values are
printed by this command:

  perl -pi -e 'if (s/^([0-7]+)\t([0-9]+)\t([0-9a-fA-F]+)//)
    {printf "%03o\t%d\t%s", hex($3), hex($3), $3;};' man7/*.7

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-09 08:02:12 +02:00
Michael Kerrisk 26ae585e9b socket.7: srcfix: Updated fixme
Signed-off-by: Michael Kerrisk <mtk@konstanz.(none)>
2010-08-31 07:05:20 +02:00
Michael Kerrisk 192e4f2e62 bootparam.7: Minor wfix/ffix
Signed-off-by: Michael Kerrisk <mtk@konstanz.(none)>
2010-08-29 14:45:33 +02:00
Michael Kerrisk 6d7f2c1382 socket.7: srcfix: update FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-19 06:52:28 +02:00
Michael Kerrisk e64e605637 capabilities.7: Add MADV_HWPOISON under CAP_SYS_ADMIN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-19 06:07:06 +02:00
Michael Kerrisk cbd7b9bfbe capabilities.7: Add get_robust_list() info under CAP_SYS_PTRACE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-17 02:34:48 +02:00
Michael Kerrisk 46883521a0 capabilities.7: Document CAP_SYS_RESOURCE and F_SETPIPE_SZ
With CAP_SYS_RESOURCE, a process can increase pipe capacity above
/proc/sys/ps/pipe-max-size.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-17 00:15:39 +02:00
Michael Kerrisk 402ffae30d udp.7: Add FIONREAD warning.
Warn that FIONREAD can't can't distinguish case of a zero-length
datagram from the case where no datagrams are available.

Reported-by: Alexander E. Patrakov <patrakov@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-13 05:00:58 +02:00
Michael Kerrisk e2ec4f17cd socket.7: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-13 04:31:58 +02:00