Commit Graph

59 Commits

Author SHA1 Message Date
Michael Kerrisk d1c9ea80c3 unix.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-15 06:36:53 +01:00
Michael Kerrisk cd0221ea32 unix.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-15 06:29:39 +01:00
Michael Kerrisk ec55a2b613 unix.7: Added ENOENT error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-15 06:29:21 +01:00
Michael Kerrisk 1fe284ab4b unix.7: Reworded the text of various errors
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-15 06:26:41 +01:00
Yuri Kozlov 40656bc7d0 unix.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-15 06:18:31 +01:00
Michael Kerrisk 0b80cf56e3 Changes, clone.2, mount.2, nanosleep.2, sigaltstack.2, statfs.2, timer_settime.2, ctime.3, fmemopen.3, nl_langinfo.3, posix_memalign.3, pthread_attr_init.3, pthread_setaffinity_np.3, pthread_setschedprio.3, pthread_testcancel.3, setjmp.3, sigwait.3, tty_ioctl.4, epoll.7, posixoptions.7, unix.7: Add section number to references to functions documented in other pages
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 08:07:28 +01:00
Michael Kerrisk 4891f52a48 recv.2, cmsg.3, unix.7: global fix: s/UNIX socket/UNIX doamin socket/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-12 06:49:35 +02:00
Michael Kerrisk 008f1ecc43 intro.1, time.1, accept.2, bind.2, connect.2, execve.2, flock.2, getdents.2, getpriority.2, getuid.2, intro.2, ioctl.2, mincore.2, mknod.2, personality.2, ptrace.2, read.2, recv.2, select_tut.2, send.2, sendfile.2, shmctl.2, sigaction.2, signal.2, stat.2, times.2, truncate.2, umask.2, wait.2, MB_CUR_MAX.3, MB_LEN_MAX.3, argz_add.3, btowc.3, clearenv.3, clock.3, cmsg.3, end.3, endian.3, errno.3, exit.3, fgetwc.3, fgetws.3, fopen.3, fputwc.3, fputws.3, fseek.3, fwide.3, getfsent.3, getgrnam.3, gethostid.3, getipnodebyname.3, getmntent.3, getpwnam.3, getwchar.3, grantpt.3, iconv.3, iconv_close.3, iconv_open.3, insque.3, intro.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, malloc.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, mkstemp.3, mktemp.3, nl_langinfo.3, openpty.3, posix_openpt.3, printf.3, ptsname.3, putwchar.3, qecvt.3, rcmd.3, readdir.3, rexec.3, rpc.3, setnetgrent.3, shm_open.3, sigpause.3, stdin.3, stpcpy.3, strftime.3, strptime.3, syslog.3, towctrans.3, towlower.3, towupper.3, ttyslot.3, ungetwc.3, unlocked_stdio.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscasecmp.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcsdup.3, wcslen.3, wcsncasecmp.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wprintf.3, console_ioctl.4, pts.4, elf.5, filesystems.5, hosts.5, proc.5, ttytype.5, boot.7, capabilities.7, credentials.7, epoll.7, glob.7, koi8-r.7, path_resolution.7, pty.7, signal.7, suffixes.7, time.7, unicode.7, unix.7, uri.7, utf-8.7: global fix: s/Unix/UNIX/
The man pages were rather inconsistent in the use of "Unix"
versus "UNIX". Let's go with the trademark usage.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-12 06:49:17 +02:00
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
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 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 24b74457e7 accept.2, access.2, acct.2, clock_nanosleep.2, mbind.2, mincore.2, remap_file_pages.2, sched_setscheduler.2, set_mempolicy.2, splice.2, stat.2, syslog.2, timer_create.2, timerfd_create.2, truncate.2, fenv.3, ferror.3, fflush.3, fgetwc.3, fgetws.3, flockfile.3, fputwc.3, fputws.3, fread.3, getopt.3, gets.3, getwchar.3, glob.3, iconv.3, longjmp.3, pow.3, printf.3, puts.3, putwchar.3, regex.3, rpc.3, scanf.3, setjmp.3, termios.3, unlocked_stdio.3, wcswidth.3, hd.4, rtc.4, st.4, core.5, dir_colors.5, elf.5, proc.5, arp.7, ascii.7, boot.7, bootparam.7, charsets.7, futex.7, ip.7, iso_8859-11.7, man-pages.7, man.7, mdoc.samples.7, path_resolution.7, pipe.7, posixoptions.7, unicode.7, unix.7, uri.7, utf-8.7, ld.so.8: s/non-/non/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 18:20:12 +01:00
Michael Kerrisk d603cc27b6 execve.2, fallocate.2, futex.2, sched_rr_get_interval.2, select_tut.2, shmget.2, timer_getoverrun.2, times.2, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_cleanup_push_defer_np.3, pthread_getattr_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3, sem_open.3, stdin.3, rtc.4, tty_ioctl.4, unix.7: Global fix: s/non-portable/nonportable/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 17:46:09 +01:00
Michael Kerrisk 77e75b9077 unix.7: Unix domain sockets don't support the recv() MSG_TRUNC flag
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:44 -05:00
Michael Kerrisk 19e19f5f8a unix.7: Retitled subsection "(Un)supported features" to "Sockets API"
This is consistent with the recent change in tcp(7).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:08 -05:00
Michael Kerrisk 1bc510f506 unix.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:08 -05:00
Michael Kerrisk b1587ca86e Since glibc 2.8, _GNU_SOURCE must be defined in order to get
the definition of the ucred structure from <sys/socket.h>.
2008-09-01 14:57:49 +00:00
Michael Kerrisk d4c8c97c31 s/PF_/AF_/ for socket family constants. Reasons: the AF_ and
PF_ constants have always had the same values; there never has
been a protocol family that had more than one address family,
and POSIX.1-2001 only specifies the AF_* constants.
2008-08-08 16:47:53 +00:00
Michael Kerrisk 77117f4fc5 Reverting blunder in commit 4699 2008-08-08 16:41:48 +00:00
Michael Kerrisk 10874173db s/PF_/AF_/ for socket family conistants. Reasons: the AF_ and
PF_ constants have always had the same values; there never has
been a protocol family that had more than one address family,
and POSIX.1-2001 only specifies the AF_* constants.
2008-08-08 16:28:06 +00:00
Michael Kerrisk 27e8d1a56d ffix 2008-07-01 16:32:22 +00:00
Michael Kerrisk a1d5601bee Removed trailing white space at end of lines 2008-06-12 11:52:08 +00:00
Michael Kerrisk 94b40171e1 Provide a clear description of the three types of address that can
appear in the sockaddr_un structure: pathname, unnamed, and abstract.
2008-06-11 22:11:06 +00:00
Michael Kerrisk f81fb4445b s/\\'/\\(aq/ 2008-06-09 15:49:35 +00:00
Michael Kerrisk f8a07a2154 s/'/\\'/ to improve rendering in UTF-8. 2008-06-05 17:52:37 +00:00
Michael Kerrisk 64d6219cf0 s/since kernel x.y.z/since Linux s.y.z/ 2008-05-07 13:33:52 +00:00
Michael Kerrisk 24d01c530c s/filesystem/file system/ 2008-03-19 07:26:08 +00:00
Michael Kerrisk a08ea57c20 Make the standard indent for code samples, shell session
logs, etc. to be ".in +4n".
2007-12-19 05:53:30 +00:00
Michael Kerrisk c11b1abf2e Change mtk's email address 2007-09-20 06:52:22 +00:00
Michael Kerrisk eab6469656 Order ERRORS alphabetically. 2007-08-27 07:56:52 +00:00
Michael Kerrisk f19a0f03ee ffix 2007-06-23 07:56:56 +00:00
Michael Kerrisk 097585edcb ffix 2007-06-22 20:40:07 +00:00
Michael Kerrisk 988db66164 strip trailing white space 2007-06-21 22:55:04 +00:00
Michael Kerrisk d9bfdb9c21 Convert to American spelling conventions 2007-06-08 09:56:56 +00:00
Michael Kerrisk 53a1443cce Add SEE ALSO link to new credentials.7. 2007-06-08 07:57:18 +00:00
Michael Kerrisk a7413163f9 Added EXAMPLE section with pointer to bind.2 EXAMPLE. 2007-05-28 15:50:37 +00:00
Michael Kerrisk 8d548bfe96 Removed out-of-date FIXME 2007-05-21 10:10:10 +00:00
Michael Kerrisk 2b2581ee37 Fix inconsistencies in order of .SH sections 2007-05-19 04:30:20 +00:00
Michael Kerrisk 69289f8a29 Fix inconsistencies in .TH line 2007-05-18 10:09:18 +00:00
Michael Kerrisk 63f6a20a1a Add section numbers to page xrefs 2007-05-11 23:29:44 +00:00
Michael Kerrisk c13182efa3 Wrapped long lines, wrapped at sentence boundaries; stripped trailing
white space.
2007-04-12 22:42:49 +00:00
Michael Kerrisk cf0a9ace57 ffix 2007-04-05 12:36:57 +00:00
Michael Kerrisk 3547839964 wrap long source lines 2006-12-27 03:54:41 +00:00
Michael Kerrisk 4291b3e4c4 wfix 2006-07-19 12:55:37 +00:00
Michael Kerrisk 8786649296 Wrap long lines; .ta + TABs with spaces in code examples 2006-03-07 02:02:26 +00:00
Michael Kerrisk 28d88c1751 Global change to many pages...
Various pages use inconsistent terms for 'null byte' (which
is the C99/SUSv3 term for the '\0' character).
To rectify this the following changes were made in these pages:

Replace 'zero byte' with 'null byte'.
Replace 'null character' with 'null byte'.
Replace 'nulls' with 'null bytes'.
Replace 'NUL-terminated' by 'null-terminated'.
Replace 'NUL' by 'null byte'.
Replace 'terminating NUL' by 'terminating null byte'.
Replace 'final NUL' by 'terminating null byte'.
Replace 'NUL character' by 'null byte'.
2006-01-13 02:09:44 +00:00