Commit Graph

2199 Commits

Author SHA1 Message Date
Simon Paillard a1fa36afd2 :eventfd.2, fallocate.2, open.2, sendmmsg.2, signalfd.2, proc.5, sched.7, socket.7, udplite.7: spfix: "behaviour": use American spelling "behavior" instead
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-17 07:27:20 +02:00
Michael Kerrisk 91085d8525 Removed trailing white space at end of lines 2014-06-14 08:03:45 +02:00
Michael Kerrisk ad5b45abe5 localedef.1, execve.2, fcntl.2, flock.2, lseek.2, open.2, open_by_handle_at.2, recvmmsg.2, sendmmsg.2, seteuid.2, setresuid.2, setreuid.2, setuid.2, statfs.2, syscalls.2, basename.3, catgets.3, getdate.3, getdirentries.3, getdtablesize.3, iconv.3, lockf.3, malloc_get_state.3, malloc_usable_size.3, matherr.3, mkdtemp.3, mkstemp.3, mq_close.3, mq_unlink.3, siginterrupt.3, system.3, locale.5, bootparam.7, environ.7, man-pages.7, signal.7, unicode.7, utf-8.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-13 17:15:44 +02:00
Yuri Kozlov b545063112 locale.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-11 19:43:06 +02:00
Yuri Kozlov 6cecebf175 locale.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-11 19:42:34 +02:00
Marko Myllynen 9be7476d64 charsets.7: Reword ISO 2022 status slightly
Make its current popularity a bit more ambiguous.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-11 11:29:23 +02:00
Marko Myllynen 83f218d9d1 charsets.7: List CJK encodings in the order of C, J, K
Zero changes to the content, Unicode is now listed as the
last one.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-10 21:53:15 +02:00
Marko Myllynen 79172100b6 unicode.7: Update to reflect past developments
The unicode(7) page will look more modern with few small changes:

- drop old BUGS section, editors cope with UTF-8 ok these days,
  and perhaps the state-of-the-art is better described elsewhere
  anyway than in a man page
- drop old suggestion about avoiding combined characters
- refer to LANANA for Linux zone, add registry file reference
- drop a reference to an inactive/dead mailing list
- update some reference URLs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-10 16:51:19 +02:00
Marko Myllynen c664680afc utf-8.7: Drop an old comment about UTF-8 replacing ISO 8859
And add locale(1) under SEE ALSO.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-10 16:51:11 +02:00
Michael Kerrisk 3f205b20d7 environ.7: SEE ALSO: add env(1), printenv(1), ld.so(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:28:38 +02:00
Michael Kerrisk 79745892b6 charsets.7: Drop unneeded text on UTF-8 for Biblical Hebrew
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-06 06:37:46 +02:00
Michael Kerrisk 42d940faf8 charsets.7: Minor tweaks
And restore a piece about Biblical Hebrew that was
inadvertently deleted by Marko Myllynen's patch.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-05 20:18:02 +02:00
Marko Myllynen a8ed5f7430 charsets.7: Update to reflect past developments
Rewrite the introduction to make Unicode's prominence more obvious.
Reformulate parts of the text to reflect current Unicode world.
Minor clarification for ASCII/ISO sections, some other minor fixes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-05 13:46:36 +02:00
Marko Myllynen 66aa761533 locale.7: Add some SEE ALSO references
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-04 20:54:56 +02:00
Michael Kerrisk ffe8d0b14c bootparam.7: Minor tweaks to Petr Gajdos's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-29 08:17:06 +02:00
Petr Gajdos 1c13782791 bootparam.7: Describe 'rootflags' and 'rootdelay' kernel parameters
Patch based on text from Documentation/kernel-parameters.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-29 08:00:22 +02:00
Michael Kerrisk 1c4b22fb91 man-pages.7: Note that .TH 'date' field is nowadays automatically updated by scripts
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 21:22:47 +02:00
Michael Kerrisk 8efc0168ad signal.7: Clarify text describing EINTR semantics for socket interfaces
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 21:22:47 +02:00
Michael Kerrisk 9c0381af73 signal.7: srcfix: Add FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 21:22:47 +02:00
Michael Kerrisk 88fb4f09f4 signal.7: Describe EINTR semantics for recvmmsg(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 21:22:47 +02:00
Michael Kerrisk bf2633795c credentials.7: Minor layout fixes to make list format more consistent
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 17:05:43 +02:00
Michael Kerrisk 2ef6778bce Removed trailing white space at end of lines 2014-05-28 16:00:50 +02:00
Michael Kerrisk 8660ef9f1d locale.1, adjtimex.2, clone.2, fork.2, getrlimit.2, remap_file_pages.2, set_mempolicy.2, swapon.2, a64l.3, adjtime.3, argz_add.3, bstring.3, envz_add.3, fpathconf.3, fseek.3, gcvt.3, getaddrinfo_a.3, getauxval.3, getnameinfo.3, getrpcent.3, getrpcport.3, getspnam.3, getutent.3, inet.3, inet_net_pton.3, key_setsecret.3, makecontext.3, makedev.3, malloc_trim.3, mq_getattr.3, newlocale.3, nl_langinfo.3, perror.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_sigqueue.3, rcmd.3, re_comp.3, resolver.3, rexec.3, rtime.3, scandir.3, setlocale.3, setnetgrent.3, sigvec.3, tsearch.3, core.5, proc.5, charsets.7, locale.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 15:42:25 +02:00
Marko Myllynen 0eb0bdd201 locale.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 11:50:04 +02:00
Michael Kerrisk 60d02efc1d charsets.7: Remove ancient paragraph on charsets supported in glibc 2.3.2
That test is rather ancient, and probably of little use.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 11:43:12 +02:00
Michael Kerrisk 5b3318fbc9 charsets.7: srcfix: Add FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 11:42:47 +02:00
Michael Kerrisk 37aef8b24f charsets.7: Remove crufty statement that Romanian may be switching to ISO 8859-16
It certainly seems like that change happened some time ago.

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 10:35:26 +02:00
Michael Kerrisk 11e751cbec charsets.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 10:03:43 +02:00
Michael Kerrisk 56a4e1ad7e cpuset.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 09:43:56 +02:00
Michael Kerrisk 39728c234e charsets.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 09:42:46 +02:00
Michael Kerrisk b331e0d0b7 locale.7: Clarify that LOCPATH is used by setlocale(3) and newlocale(3)
Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-26 10:16:11 +02:00
Marko Myllynen 859476f7a9 locale.7: further details of LOCPATH
Helpful for three purposes, 1) shows the expected naming scheme,
2) shows where to point LOCPATH to, and 3) gives an idea to the
attentive how to use a more generic, location independent
directory with location dependent, more specific ones.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-26 10:16:11 +02:00
Heinrich Schuchardt 7a8110f6af inotify.7: munmap() does not generate inotify events
mmap() and msync() were already described as not leading to
inotify events. This patch adds munmap(). I created and executed
a test to verify this.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-26 10:16:05 +02:00
Michael Kerrisk 2483209a9c inotify.7: Minor changes to Heinrich Schuechardt's example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 23:07:08 +02:00
Heinrich Schuchardt ecd96f7c0e inotify.7: Add example program
This example of the usage of the inotify API shows the
usage of inotify_init1(2) and inotify_add_watch(2) as well
as polling and reading from the inotify file descriptor.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 22:42:29 +02:00
Michael Kerrisk 9fb49a3a80 locale.7: Tweaks to Marko Myllynen's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:42:20 +02:00
Marko Myllynen cd2b4f6efd locale.7: Document LOCPATH
Example from https://sourceware.org/glibc/wiki/Locales

After modifying a locale, make sure it compiles, and install it to a
temporary directory for testing:

  unset LC_ALL
  LOCALE=fi_FI
  export I18NPATH=$HOME/locale-test/
  export LOCPATH=$HOME/locale-test/
  mkdir -p $LOCPATH
  localedef --no-archive -f localedata/charmaps/UTF-8 -i localedata/locales/$LOCALE $I18NPATH/$LOCALE.UTF-8
  LC_TIME=$LOCALE.UTF-8 locale -ck LC_TIME
  LC_TIME=$LOCALE.UTF-8 locale -ck date_fmt
  LC_TIME=$LOCALE.UTF-8 date
  LC_CTYPE=$LOCALE.UTF-8 iconv -f UTF-8 -t ASCII//TRANSLIT < translit-test-input.txt
  LC_COLLATE=$LOCALE.UTF-8 sort < sorting-test-input.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:36:13 +02:00
Michael Kerrisk d099bdc501 locale.7: Add further details on various categories
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:28:25 +02:00
Heinrich Schuchardt 864eccb901 fanotify.7: fanotify_read should use aligned buffer
Michael Kerrisk pointed me to alignment issues which may
arise when reading misaligned integers.

On some systems integer values can only be read if they are
correctly aligned. Other system have a lower performance when
reading from or writing to misaligned memory positions.

Therefore, the buffer used to call read(2) for a fanotify
file descriptor should have the same alignment as
struct fanotify_event_metadata.

Due to the casting to char* inside the macros
FAN_EVENT_OK and FAN_EVENT_NEXT we can use any
data structure for the buffer.

With the patch an array of struct fanotify_event_metadata is
used as buffer which seems a natural choice to ensure proper
alignment.

It should be remembered that the offset between events is given
by field event_len and iterating over the array may not be
allowable in future. Instead the macros should be used.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:49:30 +02:00
Michael Kerrisk b8f84ce202 capabilities.7: CAP_SYS_PTRACE allows process_vm_readv(2) and process_vm_writev(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:23:26 +02:00
Michael Kerrisk 5f94327cf5 capabilities.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:23:26 +02:00
Michael Kerrisk eb64a9cb28 capabilities.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:23:26 +02:00
Michael Kerrisk 1a3b63f7a0 capabilities.7: CAP_SYS_ADMIN allows overriding RLIMIT_NPROC
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:23:26 +02:00
Michael Kerrisk 838ad419e2 capabilities.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:23:26 +02:00
Michael Kerrisk 0da5e58ad2 Removed trailing white space at end of lines 2014-05-21 13:16:14 +02:00
Michael Kerrisk 3d15531307 chown.2, fcntl.2, futex.2, recvmmsg.2, sched_setscheduler.2, semget.2, shmget.2, malloc.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_setaffinity_np.3, strcpy.3, capabilities.7, cpuset.7, credentials.7, pthreads.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-21 13:15:30 +02:00
Michael Kerrisk 1aa556aba3 fanotify.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-21 12:47:54 +02:00
Michael Kerrisk 7c0f0ce0f0 fanotify.7: Minor wording changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-21 12:45:21 +02:00
Heinrich Schuchardt 3c36e6351a fanotify.7: Document FAN_EVENT_METADATA_LEN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-21 12:40:35 +02:00
Michael Kerrisk 98f7d53c92 fanotify.7: Fix description of FAN_EVENT_NEXT()
FAN_EVENT_NEXT() does not update 'meta'; rather, it returns a
pointer to the next metadata structure. In addition, generally
rework the description to be a bit clearer and more detailed.

Reviewed-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
2014-05-21 08:59:04 +02:00
Michael Kerrisk 3eba8ff1f2 socket.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-19 09:32:33 +02:00
Michael Kerrisk 91edd9ad79 socket.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-19 09:32:23 +02:00
Michael Kerrisk 35ceb3e029 socket.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-19 09:31:58 +02:00
Michael Kerrisk 0e90cc471c ddp.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-19 09:14:46 +02:00
Michael Kerrisk e100191686 fanotify.7: Minor improvements to Heinrich Schuchardt's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-15 05:40:12 +02:00
Michael Kerrisk 1c61252673 fanotify.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-15 05:40:12 +02:00
Heinrich Schuchardt f96adfdc9f fanotify.7: BUGS: error events can be lost when reading from fanotify FD
Reviewed-by: Jan Kara <jack@suse.cz>
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-15 05:28:56 +02:00
Michael Kerrisk 283d0deff2 credentials.7: Mention sched_getattr() as a place where credentials are checked
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 21:20:10 +02:00
Michael Kerrisk 25ac81736e pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_setaffinity_np.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_yield.3, pthreads.7: Change references to "sched_setscheduler(2)" to "sched(7)"
Change consistent with the fact that the scheduling overview
page is now sched(7) not sched_setscheduler(2).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 21:19:59 +02:00
Michael Kerrisk edf9eec6be cpuset.7: SEE ALSO: add sched(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:29 +02:00
Michael Kerrisk f96787ab34 capabilities.7: Mention sched_setattr(2) under CAP_SYS_NICE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:29 +02:00
Michael Kerrisk dc365816e8 sched.7: Update timestamp after review
SCHED_DEADLINE content has been reviewed by Peter and Juri

Reviewed-by: Juri Lelli <juri.lelli@gmail.com>
Reviewed-by: Peter Zijlstra <peterz@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:29 +02:00
Michael Kerrisk 7bd7f43e80 sched.7: Minor fixes after review by Juri Lelli
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:29 +02:00
Michael Kerrisk 9cc1fa25fc sched.7: Add lots of details on SCHED_DEADLINE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 0756f58ff1 sched.7: Tweak ASCII art
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 91c98da6b4 sched.7: ffix and other minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Peter Zijlstra 7a0d183807 sched.7: Document SCHED_DEADLINE
Raw text from Peter Zijlstra

Cowritten-by: Juri Lelli <juri.lelli@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 0c055c7506 sched.7: Document sched_rt_period_us and sched_rt_runtime_us /proc files
And rework and relocate the text on dealing with runaway
real-time processes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 1608b67143 sched.7: sched_setattr(2) can also be used to set 'nice' value
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 759e1210fc sched.7: Don't mention sched_setscheduler(2) in discussions of setting policies
In a couple of places, sched_setscheduler(2) is mentioned as the
way of setting policies. But now there is sched_setattr(2) as
well, rewrite the text in a more generic way.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 4c2eb0c23f sched.7: Mention sched_setattr(2) in list of APIs that can change policies
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 080a7c57de sched.7: Minor fix to page cross reference
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 2e868ccc47 sched.7: Remove mention of sched_setscheduler() when talking about sched_priority
There are nowadays multiple ways to set sched_priority (and
in fact there always were, since we also had sched_setparam(2)).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 77dab50a68 sched.7: Rework summary text describing sched_setattr(2) and sched_getattr(2)
Note that these APIs are a superset of sched_setscheduler(2)
and sched_getscheduler(2).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk f7a858b447 sched.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 10:10:06 +02:00
Michael Kerrisk 961df2a80e sched.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 09:17:41 +02:00
Michael Kerrisk 1154a064e4 sched.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 09:05:08 +02:00
Michael Kerrisk 9ec47534aa sched.7: Remove crufty text relating to sched_setscheduler()
All of the removed text is in sched_setscheduler(2) and
should have been trimmed from this page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 09:04:03 +02:00
Michael Kerrisk 2a8866c4ac sched.7: Minor fix: remove some crufty text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 08:44:59 +02:00
Michael Kerrisk d630434e64 sched.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 08:44:59 +02:00
Michael Kerrisk 458689edcf sched.7: SEE ALSO: Add Documentation/scheduler/sched-design-CFS.txt
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 08:44:59 +02:00
Michael Kerrisk 3d1ee4971b delete_module.2, perf_event_open.2, sched_setscheduler.2, shmctl.2, gai.conf.5, resolv.conf.5, fanotify.7, man-pages.7: wsfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 08:44:56 +02:00
Michael Kerrisk d50ee7fb40 man-pages.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-11 08:51:42 +02:00
Michael Kerrisk 91f5e870ab sched.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-10 16:27:15 +02:00
Michael Kerrisk 5813ff929b sched.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-10 07:23:15 +02:00
Michael Kerrisk 005eaa8f76 sched.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-10 07:22:47 +02:00
Michael Kerrisk b963d0e33b sched.7: SEE ALSO: Mention more files in Documentation/scheduler/ directory
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 15:21:59 +02:00
Michael Kerrisk 726663fd9d bind.2, connect.2, create_module.2, delete_module.2, execve.2, get_robust_list.2, getpriority.2, getrusage.2, init_module.2, link.2, listen.2, mbind.2, open.2, poll.2, query_module.2, readlink.2, recv.2, remap_file_pages.2, sched_setaffinity.2, semop.2, send.2, stat.2, stime.2, syscall.2, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, remquo.3, rtime.3, sched_getcpu.3, stpcpy.3, stpncpy.3, strcasecmp.3, system.3, fd.4, proc.5, ip.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:31:12 +02:00
Michael Kerrisk e39a52dbba ip.7: BUGS: ephemeral port range exhaustion is diagnosed inconsistently
Different system calls use different 'errno' values to diagnose
exhaustion of the ephemeral port range.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk 630459c88b ip.7: Remove BUGS text on glibc failing to declare in_pktinfo
That was long ago....

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk bd8838ad29 ip.7: Note some more details about assignment of ephemeral ports
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk 509c1c26f0 ip.7: Note cases where an ephemeral port is used
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk bb180c6283 ip.7: Clarify 'ip_local_port_range' and mention the term "ephemeral ports"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk 33964ed992 ip.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk 99a230468c ip.7: Minor clarification for IP_TRANSPARENT
Based on an old email exchange with Balazs Scheidler.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:53 +02:00
Michael Kerrisk 59dc509c55 elf.5, services.5, bootparam.7, glob.7: Minor wording fix ("E.g." ==> "For example")
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:15:37 +02:00
Michael Kerrisk ffb30e75da Removed trailing white space at end of lines 2014-05-08 11:04:30 +02:00
Michael Kerrisk d6fa0283d3 fallocate.2, open_by_handle_at.2, rename.2, syscalls.2, termios.3, inotify.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:03:36 +02:00
Michael Kerrisk 89613d5046 fanotify.7: Add mtk to copyright
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 10:24:22 +02:00
Michael Kerrisk ce87be978f fanotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-07 21:59:08 +02:00
Michael Kerrisk a4cd12a95f fanotify.7: Add some details on event_f_flags
Note the use of fanotify_mark() 'event_f_flags' to control
the file status flags for the file descriptors returned via
'fanotify_event_metadata.fd'.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-07 10:10:28 +02:00
Michael Kerrisk 3253bbc3d4 fanotify.7: Clarify details of buffer size for read() and 'event_len' field
* Using large buffer sizes for read(2) is orthogonal to the
  discussion of variable-length event structures.
* Move the discussion of the read() return value to follow
  discussion of what the read() actually returns in its buffer.
* Related rewordings.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-07 10:10:28 +02:00
Michael Kerrisk 4a57583f50 fanotify.7: Minor wording and formatting fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-07 10:10:28 +02:00
Michael Kerrisk 3302241970 fanotify.7: Minor tweaks to Heinrich's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-07 10:10:28 +02:00
Heinrich Schuchardt a662500625 fanotify.7: Adjust description of the fanotify queue
Update as per http://www.spinics.net/lists/linux-man/msg05624.html
where Jan Kara proposed to clarify the deletion of events from the
fanotify queue and the occurrence of ENOENT when writing to the
fanotify file descriptor.

Reviewed-by: Jan Kara <jack@suse.cz>
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-07 10:10:28 +02:00
Simon Paillard b4112efb58 execve.2, getuid.2, stat.2, termios.3, ttyslot.3, glob.7: ffix: UNIX V6 or V7: use nonbreaking space
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-07 10:10:28 +02:00
Michael Kerrisk 5e443a5f9e fanotify.7: tfix
Reported-by: Jan Kara <jack@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-06 06:55:26 +02:00
Michael Kerrisk 1b24e2ee0e fanotify_init.2, fanotify_mark.2, fanotify.7: srcfix: rewrap long source lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-05 11:48:44 +02:00
Michael Kerrisk 77bba7b589 fanotify.7: spfix
Reported-by: Silvan Jegen <s.jegen@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-05 11:38:07 +02:00
Michael Kerrisk e0ec3e201e mdoc.samples.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-02 08:05:13 +02:00
Michael Kerrisk bfff73cb7a fanotify.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-29 15:35:54 +02:00
Michael Kerrisk b16695a316 sched.7: Add a subsection listing all APIs.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-29 15:00:07 +02:00
Michael Kerrisk 720a5280de sched.7: SEE ALSO: add a few more APIs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-29 15:00:07 +02:00
Michael Kerrisk 59c06be3f6 sched.7: New page providing an overview of the scheduling APIs
Most of this content derives from sched_setscheduler(2). In
preparation for adding a sched_setattr(2) page, it makes
sense to isolate out this general content to a separate
page that is referred to by the other scheduling pages.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-29 15:00:07 +02:00
Michael Kerrisk 17e5494f9b packet.7: Minor fixes to Carsten's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-29 14:05:37 +02:00
Carsten Andrich 43f5be18ff packet.7: Improve sockopt documentation for packet sockets
Acked-by: Neil Horman <nhorman@tuxdriver.com>
Signed-off-by: Carsten Andrich <carsten.andrich@tu-ilmenau.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-29 13:57:47 +02:00
Simon Paillard ab2b391acb libc.7: tfix: missing comma
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-29 06:59:51 +02:00
Michael Kerrisk 2b9b829d52 time.1, get_kernel_syms.2, getitimer.2, open.2, perf_event_open.2, wait.2, alloca.3, bcmp.3, catopen.3, fputwc.3, iconv.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, mbsinit.3, putwchar.3, rcmd.3, rexec.3, sigqueue.3, strverscmp.3, wctrans.3, wctype.3, wcwidth.3, console_codes.4, initrd.4, st.4, elf.5, nss.5, ip.7, netdevice.7, path_resolution.7, socket.7, udp.7, ld.so.8: grfix: s/Otherwise /Otherwise, /
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 10:15:47 +02:00
Michael Kerrisk 0554d3f77a fanotify.7: Add comment to example code noting that queue overflow is ignored
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 20:07:02 +02:00
Heinrich Schuchardt 3b483820b9 fanotify.7: Remove redundant mentioning of bugs
A bug mentioned in fanotify_mark(2) need not be repeated in
fanotify(7) again.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 19:57:11 +02:00
Michael Kerrisk c8cc8bd2cb fanotify.7: Remove ppoll() and poll() from list of primary APIs
poll() and ppoll() are not among the primary calls in the API
(and anyway, select(), pselect(), and epoll were not mentioned).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 14:43:46 +02:00
Michael Kerrisk 5f6231f293 fanotify.7: srcfix: Add FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:10:32 +02:00
Michael Kerrisk 370359a7c6 fanotify.7: Add some whitespace to example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:58:21 +02:00
Michael Kerrisk e1ca5880d4 fanotify.7: Add some comments to example code
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:57:29 +02:00
Michael Kerrisk 616fce491b fanotify.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:55:32 +02:00
Michael Kerrisk 3d4433fe17 fanotify.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:46:40 +02:00
Michael Kerrisk c00ff2dc16 fanotify.7: Add subheading for /proc/PID/fdinfo
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:46:16 +02:00
Michael Kerrisk 679a078389 fanotify.7: Remove a sentence from ETXTBSY description
No file descriptor is actually created...

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:51 +02:00
Michael Kerrisk 68bcc008cc fanotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:51 +02:00
Michael Kerrisk 72b9aa964c fanotify.7: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:51 +02:00
Michael Kerrisk 49894a5a8f fanotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk d7d24d40ec fanotify.7: Add sentence introducing fanotify_response fields
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk f897ec112f fanotify.7: Minor rewording of FAN_CLOSE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk f2ac23e758 fanotify.7: Add introductory sentence for explanation of fanotify_event_metadata
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk ad02dd1f87 fanotify.7: Add a subheading for reading events
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk 75c3e3bd6b fanotify.7: Move the text on event merging
Place it near the discussion of the events bit mask.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk 2932564490 fanotify.7: Rework text on event bits a little
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk c9120323bf fanotify.7: Rework and enhance text introducing read() and events
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk 6c693f6de5 fanotify.7: Move text describing fanotify_mark()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk 488cdd819c fanotify.7: Move epoll/poll/select discussion to its own subsection
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk 7fc5dd9466 fanotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk be8ba5d879 fanotify.7: Rework text on close()
Closing the fanotify FD was discussed in two places.
Merge them into one location, and discard redundant text.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:40 +02:00
Michael Kerrisk d3471a460b fanotify.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk 88145b29e7 fanotify.7: Add some subheadings to structure the DESCRIPTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk 397ff1fd3f fanotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk 02a18e0f7f fanotify.7: Reword FAN_CLOSE_NOWRITE text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk 9d76d63060 fanotify.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk 8d2ee5c85d fanotify.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk 815df19b29 fanotify.7: Declare handle_events() in example code as 'static'
To avoid warning "no previous prototype for..."
when compiling with "-Wmissing-prototypes"

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:11 +02:00
Michael Kerrisk b34cbc4530 fanotify.7: Change a comment in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:10 +02:00
Michael Kerrisk def5c668e8 fanotify.7: Merge two printf() calls
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:10 +02:00
Michael Kerrisk 48fd9fe08a fanotify.7: Change a comment in example code
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:10 +02:00
Michael Kerrisk 8cc4f7a94e fanotify.7: Remove unneeded close() calls
The fanotify file descriptor will be implicitly closed by process
termination, and in any case it was not closed explicitly in all
process termination paths.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:42:57 +02:00
Michael Kerrisk f776794974 fanotify.7: Minor tweaks to example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 10:00:53 +02:00
Michael Kerrisk ddb112c281 fanotify.7: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 09:49:19 +02:00
Michael Kerrisk 6d8c5d015d fanotify.7: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 09:20:45 +02:00
Michael Kerrisk d9b086d625 fanotify.7: Mention inotify(7) in opening paragraph
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 08:06:41 +02:00
Michael Kerrisk 7ea227bdde fanotify.7: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 08:06:41 +02:00
Heinrich Schuchardt f75d27e6b0 inotify.7: SEE ALSO: add fanotify(7)
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 07:57:41 +02:00
Heinrich Schuchardt 597aaea2f7 fanotify.7: New page providing overview of the fanotify API
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 07:55:05 +02:00
Stefan Puiu a29edaeef6 packet.7: Status in PACKET_RX_RING is actually a bit mask
Stefan:
I'm playing with the PACKET_RX_RING option to packet sockets and I
noticed that the status field from the tpacket_hdr structures
inside the mmaped buffer is actually a bit mask. I'm testing with
4Gbps traffic rates and sometimes I get status=5. I'm using Ubuntu
12.04 with a 3.8.0-29 kernel, and at least from the code (I got it
using "sudo apt-get source linux-image-$(uname -r)") it seems the
5 means TP_STATUS_USER | TP_STATUS_LOSING. The 3.8.0 kernel code
has this line in tpacket_rcv():

    /*
     * LOSING will be reported till you read the stats,
     * because it's COR - Clear On Read.
     * Anyways, moving it for V1/V2 only as V3 doesn't need this
     * at packet level.
     */
            if (po->stats.tp_drops)
                    status |= TP_STATUS_LOSING;

Daniel:
Now to your question. It can easily be seen from the if_packet.h header
file http://lingrok.org/xref/linux-net-next/include/uapi/linux/if_packet.h#93
that TP_STATUS_* are individual bits that are set in tp_status field.

TP_STATUS_USER simply means a frame was received in the ring and is
ready for user space to be processed. If the field also indicates
TP_STATUS_LOSING then this means that there were packet drops in the
rx ring itself so a user knows it didn't get all traffic. This bit
is being reset on getsockopt() when querying PACKET_STATISTICS,
otherwise it stays. Drops occur when the ring buffer was not emptied
fast enough by user space (so no free slot with TP_STATUS_KERNEL), e.g.
due to high incoming traffic load. However, the current frame you're
reading that has TP_STATUS_USER|TP_STATUS_LOSING is fine by itself.

Acked-by: Daniel Borkmann <dborkman@redhat.com>
Acked-by: Carsten Andrich <carsten.andrich@tu-ilmenau.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-24 11:52:39 +02:00
Michael Kerrisk ab80da6e17 packet.7: SEE ALSO: add /tools/testing/selftests/net/psock_tpacket.c
Reported-by: Carsten Andrich <carsten.andrich@tu-ilmenau.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 3d4d5a0635 packet.7: Minor tweak to Carsten Andrich's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 896333c57e packet.7: Minor fixes to Carsten Andrich's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Carsten Andrich 8c26e99bce packet.7: PACKET_LOSS has inverse meaning
I stumbled upon an error in packet.7 regarding the meaning of the
PACKET_LOSS socket option. According to the current git version of
linux-man setting PACKET_LOSS causes malformed packets to *not* be
silently dropped.

However it is the other way round. If PACKET_LOSS is *not* set,
malformed packets will be marked TP_STATUS_WRONG_FORMAT and the
transmission process aborted, leaving untransmitted packets in
the ring.  If it *is* set, malformed packets will be silently
skipped, their status set to TP_STATUS_AVAILABLE and the
transmission process continued with the following packet.

This behaviour can be clearly seen in net/packet/af_packet.c:
http://git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git/tree/net/packet/af_packet.c#n2300

The value accompanying TP_PACKET_LOSS translates into po->tp_loss:
http://git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git/tree/net/packet/af_packet.c#n3304

I inverted the meaning of PACKET_LOSS and clarified the
description in the attached patch.

Reviewed-by: Willem de Bruijn <willemb@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk fe8b1358a6 Removed trailing white space at end of lines 2014-04-20 11:06:01 +02:00
Michael Kerrisk 84b349919b madvise.2, msync.2, libc.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-20 11:05:32 +02:00
David Prévot d2c3d8a829 inotify.7: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 07:49:54 +02:00
Michael Kerrisk 85dd46e89b libc.7: srcfix: Reformat to use .UR/.UE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-14 12:50:42 +02:00
Michael Kerrisk ba8b587366 libc.7: Add musl libc
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-14 12:50:41 +02:00
David Prévot f360dbe83d locale.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-14 12:25:18 +02:00
Michael Kerrisk e8a700f9ae capabilities.7: SEE ALSO: add capsh(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-09 15:27:32 +02:00
Michael Kerrisk fa1d49a63c Removed trailing white space at end of lines 2014-04-06 08:47:56 +02:00
Michael Kerrisk b8dbf73de8 bdflush.2, fsync.2, mmap.2, open.2, perf_event_open.2, sync.2, syscall.2, fmemopen.3, getaddrinfo.3, getline.3, mq_notify.3, offsetof.3, aio.7, symlink.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:47:35 +02:00
Michael Kerrisk e449e5f15a inotify.7: Inotify does not report events for mmap(2) and msync(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk e226bed757 inotify.7: Inotify doesn't work for remote and pseudo filesystems
Reported-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk fa51f4d941 inotify.7: Remind reader of the cookie value in discussion of rename events
Reported-by: Jan Kara <jack@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 6f1a495406 inotify.7: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 6b1cc2c9a4 inotify.7: Add paragraph on cache consistency checking
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 67898fdfd0 inotify.7: Reorganize "Limits and caveats"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk da977073d0 inotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 85e179c5c2 inotify.7: Add text on dealing with rename() events
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk a79d28b202 inotify.7: Minor reorganization
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 94d52c1529 inotify.7: Mention cache rebuilding to handle overflow events
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 264276c6b0 inotify.7: Move discussion of application cache to start of "Limitations"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 356911f692 inotify.7: Rewrite introductory section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk ff6e23973d inotify.7: Add subheading for reading from inotify file descriptor
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 1a737afd5a inotify.7: symlink(2) can generate IN_CREATE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk 415f63be17 inotify.7: Add some examples of events generated by various system calls
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk ed17140040 symlink.7: Mention use of readlink(2) to read contents of a symlink
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk 7aa6eb89d4 symlink.7: Minor edits
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk 828b6e3dad symlink.7: Add mtk copyright
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk 58be64a41a symlink.7: f
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk d33b6ed2d8 symlink.7: Add subsection on opening a symbolic link with O_PATH
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk 19d9c23c6a symlink.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk df63d3e84d symlink.7: name_to_handle_at(2) and open_by_handle_at(2) optionally follow symlinks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk b01c936e4b inotify.7: Note that IN_UNMOUNT will be followed by an IN_IGNORED event
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk 39f43968d7 inotify.7: Note that IN_DELETE_SELF will be followed by IN_IGNORED
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk 7a64793b93 inotify.7: Add examples of syscalls that trigger IN_CREAT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk b0e1ac43e0 inotify.7: Add examples of syscalls that trigger IN_ATTRIB
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk 79f8f40ccb inotify.7: Minor wording change
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk f54a125572 inotify.7: Add some examples of syscalls that trigger IN_MODIFY
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk f23fc716d5 inotify.7: Minor list reformatting
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk 49b07b8f8b inotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk 22ae407d3e tcp.7: Document /proc/sys/net/ipv4/tcp_autocorking
Text heavily based on Documentation/networking/ip-sysctl.txt

Cowritten-by: Eric Dumazet <edumazet@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:02 +02:00
Michael Kerrisk 64aa9bcb39 inotify.7: Minor clarification
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 20:59:35 +02:00
Michael Kerrisk 70f70c9d40 inotify.7: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 20:59:31 +02:00
Michael Kerrisk f08cdf85df inotify.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-30 10:30:27 +02:00
Michael Kerrisk a15ead5e9f inotify.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-29 22:07:16 +01:00
Michael Kerrisk 7b5151b7f0 inotify.7: BUGS: IN_ONESHOT does now cause IN_IGNORED when the watch is dropped
A silent change as a result of the fanotify work in kernel 2.6.36.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-29 22:06:48 +01:00
Michael Kerrisk dede00fed9 inotify.7: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 15:41:17 +01:00
Michael Kerrisk f20fc09276 inotify.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 15:33:47 +01:00
Michael Kerrisk c577b95c7b inotify.7: ffix: Reformat events list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 15:33:14 +01:00
Michael Kerrisk 4a1e4cca21 inotify.7: Moving an object to another filesystem generates IN_DELETE_SELF
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 15:25:24 +01:00
Michael Kerrisk 22129aa9f5 inotify.7: srcfix: Note commit that fixed the "coalescing" bug
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 13:43:58 +01:00
Michael Kerrisk 2f48204194 inotify.7: Directory renames may invalidate multiple paths cached by application
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 06:45:17 +01:00
Michael Kerrisk 031de15217 inotify.7: Further describe the race when adding a watch to a new subtree
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 06:43:09 +01:00
Michael Kerrisk c284192003 ip.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 14:01:44 +01:00
Michael Kerrisk 56db9d31d0 socket.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 13:55:56 +01:00
Michael Kerrisk 04161f0875 rtnetlink.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 13:55:13 +01:00
Michael Kerrisk b752509ac2 capabilities.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 13:54:53 +01:00
Michael Kerrisk 3f3698d8a7 inotify.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 13:41:00 +01:00
Michael Kerrisk 8856aab855 inotify.7: Note rationale and consequences of event coalescing
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 13:05:11 +01:00
Michael Kerrisk a7dc2c8052 mdoc.samples.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:18 +01:00
Michael Kerrisk 9b6d6dcc93 posixoptions.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 075972dfef mdoc.samples.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 1be0d8295d bootparam.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 02b69bc6e7 netdevice.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 1c1cbf3db6 signal.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk aa17b6e735 posixoptions.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk eebf8c09a4 socket.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 4d196edb82 raw.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 0a9fd8a4b9 ip.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 1c4070c7f0 epoll.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk baaf1fcc30 x25.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:16 +01:00
Michael Kerrisk 8817c2c829 inotify.7: execve(2) also generates IN_ACCESS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:15 +01:00
Michael Kerrisk 955f23d1e4 man-pages.7: ffix: remove unneeded .ad tags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-20 14:23:23 +01:00
Michael Kerrisk 49a86fb90e rtnetlink.7: ffix: Remove unneeded .na / .ad tags
The result without these tags looks acceptable.
With these tags, the HTML rendering on man7.org
is bit messed up.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-20 14:21:11 +01:00
Michael Kerrisk 0eb65d3aec netlink.7: ffix: Remove unneeded .na / .ad tags
These aren't really needed, and they mess up the HTML pages
at man7.org.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-20 14:21:11 +01:00
Michael Kerrisk 69b77259c0 netlink.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-20 13:52:38 +01:00
Michael Kerrisk d84dea2263 feature_test_macros.7: Document _LARGEFILE_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-20 08:34:52 +01:00
Michael Kerrisk a007cc2904 feature_test_macros.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-20 08:34:52 +01:00
Michael Kerrisk 034a3f2fe1 feature_test_macros.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-20 06:49:33 +01:00
Michael Kerrisk 89576e562e koi8-u.7: Wrap table cell to avoid groff warning
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-19 17:13:41 +01:00
Michael Kerrisk 8c5fcd21e5 fmemopen.3, getaddrinfo.3, mq_notify.3, offsetof.3, aio.7: Print size_t/ssize_t values using %z printf() modifier
There are fewer and fewer systems these days that don't
support the %z specifier mandated in C99.  So replace the
use of %ld/%lu + (long) cast with %zd/%zu.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-19 15:09:14 +01:00
Michael Kerrisk 14e9f7cf4b fcntl.2, strtol.3, strtoul.3, socket.7: ffix in feature test macro names
Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 20:17:50 +01:00
Michael Kerrisk 89851a0054 Removed trailing white space at end of lines 2014-03-18 16:29:34 +01:00
Michael Kerrisk 52d06f483d fts.3, isalpha.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, strerror.3, strftime.3, strtol.3, strtoul.3, toupper.3, towlower.3, towupper.3, wcrtomb.3, wcsnrtombs.3, wcsrtombs.3, wcstombs.3, wctomb.3, locale.5, koi8-u.7, locale.7, uri.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 16:29:06 +01:00
Michael Kerrisk 713167dc50 locale.7: SEE ALSO: add mbstowcs(3) and wcstombs(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk de0f9c1cd5 locale.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk 5f49682efa locale.7: Document LC_IDENTIFICATION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk 7c57cb8027 locale.7: Document LC_MEASUREMENT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk ebb553379b locale.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk 1981ba432b locale.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk 1c59803974 locale.7: Document LC_TELEPHONE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk 798f7baf37 locale.7: Document LC_ADDRESS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:16 +01:00
Michael Kerrisk ba5e9ef309 locale.7: Document LC_NAME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk 0b65297e51 locale.7: Document LC_PAPER
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk 8d63e6ec34 locale.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk 9518a5f419 locale.7: srcfix: update FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk fb844405b1 locale.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk 2fa99a6285 locale.7: Remove reference to LI18NUX2000
LI18NUX2000 is difficult to even find these days, and in any case
thispage does not document gettext(), so notes about gettext()
in the CONFORMING TO section here make no sense.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk 4aeed3697f locale.7: Add subsection on POSIX.1-2008 (originally GNU) extensions to locale API
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk a6ce0ba566 man-pages.7: Add preferred terms "uppercase" and "lowercase"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:13:15 +01:00
Michael Kerrisk efaef3dad0 duplocale.3, isalpha.3, strftime.3, strtol.3, strtoul.3, koi8-u.7, man-pages.7, mdoc.7, mdoc.samples.7, uri.7: Global change: "upper case" ==> "uppercase", "lower case" ==> lowercase"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:12:47 +01:00
Michael Kerrisk a8de62de23 locale.7: SEE ALSO: add newlocale(3) + duplocale(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 14:12:47 +01:00
Michael Kerrisk deed406ee1 feature_test_macros.7: tfix
Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-17 08:46:40 +01:00
Michael Kerrisk 644ee9c73b man-pages.7: Add preferred term "superblock"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-16 05:35:25 +01:00
Michael Kerrisk da6aad026b feature_test_macros.7: Add packaging note for _BSD_SOURCE/_SVID_SOURCE/_DEFAULT_SOURCE
To compile warning-free across glibc < 2.20 and glibc >= 2.20
code may been to define both _DEFAULT_SOURCE and either
_BSD_SOURCE or _SVID_SOURCE.

Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-14 10:37:45 +01:00
Michael Kerrisk 7280750886 feature_test_macros.7: Reword description of C90
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-13 09:21:32 +01:00
Michael Kerrisk cfba52fc5b feature_test_macros.7: Remove mention of bogus _ISOC95_SOURCE macro
The _ISOC95_SOURCE macro is defined in <features.h>, but it
does nothing. So remove discussion of it, and move some of
the discussion of C95 under the ISOC99_SOURCE subhead.

Reported-by: Joseph S. Myers <joseph@codesourcery.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-13 09:15:34 +01:00
Michael Kerrisk e9f22b0ac0 Removed trailing white space at end of lines 2014-03-11 22:33:19 +01:00
Michael Kerrisk ed725bac60 feature_test_macros.7: Note version number for _POSIX_C_SOURCE >= 200112L implies C99/C95
_POSIX_C_SOURCE >= 200112L causes C95 definitions to be
exposed only since glibc 2.12 and C99 definitions only
since 2.10.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 22:32:14 +01:00
Michael Kerrisk 64eb1484fb feature_test_macros.7: _ISOC99_SOURCE also exposes C95 definitions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 11:41:45 +01:00
Michael Kerrisk 08d695652c feature_test_macros.7: _GNU_SOURCE implicitly defines other macros
Saying that _GNU_SOURCE has the "effects of" other macros is not
quite precise.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 11:41:45 +01:00
Michael Kerrisk b694081ac3 feature_test_macros.7: Minor clarification for _POSIX_C_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 11:41:45 +01:00
Michael Kerrisk df553d91c2 feature_test_macros.7: Rework discussion of _ISOC99_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 11:41:40 +01:00
Michael Kerrisk 2b4608d288 feature_test_macros.7: Reword glibc version for _ISOC95_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 08:42:18 +01:00
Michael Kerrisk d4e80b4d09 feature_test_macros.7: _XOPEN_SOURCE may implicitly defined _POSIX_SOURCE and _POSIX_C_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 08:32:17 +01:00
Michael Kerrisk e8349edb50 feature_test_macros.7: _POSIX_C_SOURCE >= 200112L implies C95 and C95 features
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 07:56:06 +01:00
Michael Kerrisk 8effdb2ded feature_test_macros.7: _ISOC11_SOURCE implies the effects of _ISOC99_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 07:44:00 +01:00
Michael Kerrisk d6ced64f1b feature_test_macros.7: Reword glibc version for _ISOC99_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 07:41:45 +01:00
Michael Kerrisk d6472258ec feature_test_macros.7: _BSD_SOURCE and _SVID_SOURCE are deprecated in glibc 2.20
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 17:20:06 +01:00
Michael Kerrisk 3244e6ad0b feature_test_macros.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Michael Kerrisk 199cbeb076 feature_test_macros.7: ffix: add some paragraph breaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Michael Kerrisk dfb1232ca8 feature_test_macros.7: Improve discussion of _DEFAULT_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Michael Kerrisk 841f7fc6f6 locale.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Michael Kerrisk 47e067e500 locale.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-04 13:13:31 +01:00
Michael Kerrisk a33c5137cc locale.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-04 13:12:25 +01:00
Michael Kerrisk 31718129c9 packet.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-03 05:48:49 +01:00
Simon Paillard f8efa4be44 packet.7: wfix
A side-effect: singular

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-03 05:47:43 +01:00
Michael Kerrisk 778fcac982 getifaddrs.3, iswctype.3, sem_post.3, sem_unlink.3, sem_wait.3, packet.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 18:29:17 +01:00
Michael Kerrisk 4d04d4f04c ascii.7: SEE ALSO: add utf-8(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:43:00 +01:00
Michael Kerrisk f854adde57 ascii.7: Remove mention of ISO 8859-1 as being the default encoding on Linux
Reported-by: Duncan de Wet <duncandewet@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:43:00 +01:00
Michael Kerrisk 76f6db57c7 utf-8.7: Minor rewordings in the opening paragraph
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:43:00 +01:00
Michael Kerrisk add6b9f633 ascii.7: Fix rendering of single quote (decimal character 39)
Signed-off-by: Sulaiman Mustafa <seininn@hush.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:42:59 +01:00
Michael Kerrisk a4edbc603b packet.7: Minor changes to Daniel Borkmann's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:42:59 +01:00
Daniel Borkmann 2203837f14 packet.7: Improve PACKET_QDISC_BYPASS description
Signed-off-by: Daniel Borkmann <dborkman@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:42:59 +01:00
Michael Kerrisk 1260477b62 socket.7: Add kernel version number for SO_BUSY_POLL
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:42:59 +01:00
Michael Kerrisk bab78b9c2c packet.7: Add kernel version for PACKET_FANOUT_QM
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:42:59 +01:00
Neil Horman 6a06d7e49a packet.7: Document PACKET_FANOUT_QM fanout mode
Signed-off-by: Neil Horman <nhorman@tuxdriver.com>
CC: mtk.manpages@gmail.com
CC: andi@firstfloor.org
CC: netdev@vger.kernel.org
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:42:59 +01:00
Michael Kerrisk 9cad276e2c socket.7: Add kernel version number for SO_RXQ_OVFL
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:42:59 +01:00
Michael Kerrisk 96a732ffe8 socket.7: srcfix 2014-02-26 17:42:59 +01:00
Michael Kerrisk f4c644e510 socket.7: Minor fixes to Neil's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:42:59 +01:00
Neil Horman 8cfbaec521 socket.7: Document the SO_RXQ_OVFL socket option
Signed-off-by: Neil Horman <nhorman@tuxdriver.com>
CC: mtk.manpages@gmail.com
CC: andi@firstfloor.org
CC: netdev@vger.kernel.org
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:42:59 +01:00
Michael Kerrisk ba1097a1dc armscii-8.7, cp1251.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-u.7: Remove comment that glyphs in column 4 may not display correctly
With the conversion to UTF-8, the glyphs in column 4 of the
tables in these pages will display regardless of whether the
environment is configured for the corresponding character set.

Reported-by: Simon Paillard <spaillard@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-18 10:02:09 +01:00
D. Barbier 711518bc71 iso_8859-11.7, iso_8859-13.7: Fix encoding mistakes in 5f7f4042b8
Fixed via:

  for f in iso_8859-11 iso_8859-13; do
    cp man7/$f.7 $f
    iconv -f utf8 -t latin1 $f | iconv -f iso-${f#iso_} -t utf8 > man7/$f.7
  done

Reported-by: Simon Paillard <spaillard@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-18 09:34:20 +01:00
Michael Kerrisk 5f7f4042b8 armscii-8.7, cp1251.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: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-16 08:32:18 +01:00
Michael Kerrisk b44821fb53 armscii-8.7, cp1251.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: Convert pages contain non-ASCII to use UTF-8
Done using Peter Schiffer's convert_to_utf_8.sh script.
These pages containing non-ASCII in the rendered characters, and
so the script inserts a "coding:" marker into the groff source.

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

Reported-by: Weizhou Pan <cs.wzpan@gmail.com>
Co-written-by: Peter Schiffer <pschiffe@redhat.com
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-16 08:31:46 +01:00
Michael Kerrisk e00c3a0754 close.2, getdomainname.2, getrlimit.2, madvise.2, sysinfo.2, umask.2, encrypt.3, fclose.3, fflush.3, lockf.3, rand.3, strtok.3, toupper.3, updwtmp.3, utmp.5, environ.7, hier.7, suffixes.7: Convert pages contain non-ASCII in source code comments to use UTF-8
Done using a slightly modified version of Peter Schiffer's
convert_to_utf_8.sh script. The script was modified so as *not*
a "coding:" marker to the groff source. For now, we'll only put
that marker on pages that contain non-ASCII characters in the
rendered text.

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

Reported-by: Weizhou Pan <cs.wzpan@gmail.com>
Co-written-by: Peter Schiffer <pschiffe@redhat.com
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-16 08:21:18 +01:00
Michael Kerrisk f2ed63acf0 koi8-u.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-16 08:21:18 +01:00
Michael Kerrisk 3bab9a5117 gettid.2, restart_syscall.2, lockf.3, passwd.5, socket.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-11 11:43:48 +01:00
Michael Kerrisk a2dace6b54 man-pages.7: ATTRIBUTES sections come after VERSIONS
Peng Haitao has consistently ordered the ATTRIBUTES after
VERSIONS, so adjust the text in man-pages.7

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 10:47:25 +01:00
Michael Kerrisk 0ec954eeef gettid.2, restart_syscall.2, passwd.5, socket.7: Fix order of SEE ALSO entries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 10:26:57 +01:00
Michael Kerrisk ec9330d1a3 mq_overview.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 09:35:03 +01:00
Michael Kerrisk 6ea90ba9a0 standards.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 09:34:49 +01:00
Michael Kerrisk f479e3add3 mq_overview.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 09:33:04 +01:00
Michael Kerrisk d067764a99 pthread_cancel.3, string.3, cpuset.7, tcp.7: ffix (mark up page xfrefs using .BR, not .IR)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 08:32:33 +01:00
Simon Paillard 7f4cd55dad ffix: add space between function and () if BR or IR
Detected through the regex:
	git grep -P '^\.(BR|IR) [\w]*\([\d]*\)$'

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-10 08:03:16 +01:00
Michael Kerrisk a797afac4e fcntl.2, msgget.2, ptrace.2, request_key.2, shmget.2, sigaction.2, syscalls.2, dbopen.3, euidaccess.3, getgrnam.3, getpwnam.3, strfmon.3, strtol.3, strtoul.3, cciss.4, hpsa.4, mouse.4, termcap.5, charsets.7, iso_8859-16.7, iso_8859-2.7, koi8-r.7, unicode.7, utf-8.7: Use Oxford comma
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-05 16:09:11 +01:00
Michael Kerrisk 5019071b75 socket.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-05 16:08:12 +01:00
Michael Kerrisk 31df57343d bootparam.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-05 16:05:52 +01:00
David Prévot 9988463a26 tcp.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-04 10:05:00 +01:00
David Prévot bc10fe2007 netdevice.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-04 10:04:04 +01:00
Yuri Kozlov 774038c256 tcp.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-04 09:58:57 +01:00
Yuri Kozlov c30dd39f73 tcp.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-04 09:55:26 +01:00
Michael Kerrisk e154982986 vdso.7: Add words "virtual dynamic shared object" in DESCRIPTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-01 07:55:22 +01:00
Michael Kerrisk 21ffc8d145 vdso.7: wfix
Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-01 07:46:37 +01:00
David Prévot 35432a038b vdso.7: wfix: repetition fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-01 07:45:50 +01:00
David Prévot dd85e7df49 packet.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-01 07:44:46 +01:00
David Prévot ffd045656f packet.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-01 07:44:16 +01:00
David Prévot 28aac7d7a9 man-pages.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-30 09:12:17 +01:00
David Prévot 4a6cd1db14 man-pages.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-29 13:51:21 +01:00
Michael Kerrisk 992787fe8c packet.7: Some fixes to Daniel's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-29 13:51:21 +01:00
Daniel Borkmann 602ce0881b packet.7: Document PACKET_QDISC_BYPASS
New in Linux 3.14.

Signed-off-by: Daniel Borkmann <dborkman@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-29 13:51:21 +01:00
Michael Kerrisk 84fc2a6e35 Removed trailing white space at end of lines 2014-01-24 12:06:21 +01:00
Michael Kerrisk add5f3b10b epoll_wait.2, fallocate.2, gets.3, core.5, man-pages.7, netdevice.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-24 12:05:49 +01:00
Michael Kerrisk 59c4210474 tcp.7: srcfix: Add comments with references for TCP_DEFER_ACCEPT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-24 11:13:48 +01:00
Michael Kerrisk ee8922376d tcp.7: srcfix: Update FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-23 15:36:04 +01:00
Michael Kerrisk bd0e4cd5ea tcp.7: srcfix: Update FIXME for TCP_COOKIE_TRANSACTIONS
TCP_COOKIE_TRANSACTIONS was removed in Linux 3.10

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-23 15:36:04 +01:00
Michael Kerrisk b19af7dec0 tcp.7: Describe format of tcp_*_congestion_control /proc files
Describe format of tcp_allowed_congestion_control and
tcp_available_congestion_control.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-23 15:36:04 +01:00
Michael Kerrisk bf561a0fbc tcp.7: Document TCP_CONGESTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-23 15:36:04 +01:00
Michael Kerrisk 60e01ea4d9 tcp.7: srcfix: Update copyright
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-23 15:36:03 +01:00
Michael Kerrisk 396fe1bceb tcp.7: Document TCP_USER_TIMEOUT
Text slightly adapted from Jerry Chu's (excellent) commit
message (commit dca43c75e7e545694a9dd6288553f55c53e2a3a3).

Cowritten-by: Jerry Chu <hkchu@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-23 15:36:03 +01:00
Michael Kerrisk 5d4f676f68 tcp.7: Fix breakage introduced by 0decd92d55
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-23 15:36:03 +01:00
Michael Kerrisk 9cfc5a0298 tcp.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-23 15:36:03 +01:00
Michael Kerrisk a4668983a0 socket.7: srcfix: Additions to FIXME list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-22 10:47:49 +01:00
Michael Kerrisk 0decd92d55 tcp.7: srcfix: Additions to FIXME list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-22 10:38:30 +01:00
Michael Kerrisk 39c56b849a symlink.7: wfix
Reported-by: Thomas Posch <man-pages@online.posch.name>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-22 04:46:55 +01:00
Simon Paillard 09e311c550 man-pages.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-21 07:16:49 +01:00
Michael Kerrisk 049be102ea socket.7: Minor fixes to SO_BUSY_POLL text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-21 07:11:41 +01:00
Eliezer Tamir 8e57271ad2 socket.7: Add description for SO_BUSY_POLL
Add description for the SO_BUSY_POLL socket option.

Signed-off-by: Eliezer Tamir <eliezer.tamir@linux.intel.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-21 07:11:41 +01:00
Michael Kerrisk f78ed33a65 madvise.2, perf_event_open.2, query_module.2, stat.2, sem_init.3, hpsa.4, rtc.4, st.4, elf.5, filesystems.5, proc.5, environ.7, man-pages.7, regex.7, units.7: Reword to avoid use of "etc."
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 23:58:39 +13:00
Michael Kerrisk 3a6d5615cb environ.7: Improve references for discussion of locale environment variables
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 23:10:02 +13:00
Michael Kerrisk d4d91728d7 environ.7: Correct reference to locale(7) (not locale(5))
locale(7) is the right place for details of the LC_*
environment variables.

See http://bugs.debian.org/638186

Reported-by: Gioele Barabucci <gioele@svario.it>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 23:08:54 +13:00
Michael Kerrisk 342a96c6cd environ.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 23:01:23 +13:00
Michael Kerrisk 5be6f51fee locale.7: SEE ALSO: add catopen(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 22:58:11 +13:00
Michael Kerrisk 6985a63a11 locale.7: SEE ALSO: add locale(5)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 22:57:51 +13:00
Michael Kerrisk 5a6194a405 execve.2, get_robust_list.2, getunwind.2, pipe.2, quotactl.2, clock_getcpuclockid.3, endian.3, fmemopen.3, getgrouplist.3, getservent_r.3, mq_notify.3, qsort.3, rtime.3, mailaddr.7: ffix: replace tabs with white space in code examples
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 20:47:47 +13:00
Michael Kerrisk 1c7b245826 unix.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 20:47:23 +13:00
Yuri Kozlov b834c23e32 ipv6.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-17 21:44:43 +13:00
Tilman Schmidt 5bdd426030 netdevice.7: Document SIOCGIFCONF case ifc_req==NULL
Add the missing description of the possibility to call SIOCGIFCONF
with ifc_req==NULL to determine the needed buffer size, as
described in
http://lkml.indiana.edu/hypermail/linux/kernel/0110.1/0506.html
and verified against source files net/core/dev_ioctl.c and
net/ipv4/devinet.c in the current kernel git tree.
This functionality has been present since the beginning of the 2.6
series. It's about time it gets documented.

While I'm at it, also generally clarify the section on
SIOCGIFCONF.

Signed-off-by: Tilman Schmidt <tilman@imap.cc>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-16 17:22:21 +13:00
Michael Kerrisk 8285d50f68 standards.7: Add C11
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-16 12:46:04 +13:00
Michael Kerrisk f1596307c1 standards.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-16 12:37:03 +13:00
Michael Kerrisk 442bd85578 standards.7: Enhance description of V7
(Nothing of substance now remains from the old intro(2) text.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-16 12:34:30 +13:00
Michael Kerrisk e03fae06a8 man-pages.7: Prefer "usable" over "useable"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-15 17:35:27 +13:00
Michael Kerrisk d35326474f Removed trailing white space at end of lines 2014-01-11 08:04:54 +13:00
Michael Kerrisk babc6dd47b syscall.2, syscalls.2, ftw.3, getauxval.3, mcheck.3, puts.3, scanf.3, strftime.3, libc.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-11 06:44:42 +13:00
Michael Kerrisk f14ae16e57 accept.2, clock_getres.2, mkdir.2, request_key.2, wait.2, printf.3, bootparam.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-11 06:25:02 +13:00
Michael Kerrisk f577d7ef7a netdevice.7, packet.7, udp.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-11 06:21:00 +13:00
Michael Kerrisk 76c637e18c getcpu.2, getunwind.2, kcmp.2, mmap.2, perf_event_open.2, perfmonctl.2, quotactl.2, restart_syscall.2, btree.3, dbopen.3, hash.3, recno.3, sched_getcpu.3, elf.5, bootparam.7, hier.7, netdevice.7, rtnetlink.7: wfix: "xxxx specific" ==> "xxxx-specific" 2014-01-11 06:16:28 +13:00
Michael Kerrisk d840e4faf3 arp.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-11 06:10:39 +13:00
Michael Kerrisk ba694dd0b0 feature_test_macros.7: Document _DEFAULT_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-08 12:14:13 +13:00
Michael Kerrisk 0385c88eda feature_test_macros.7: From glibc 2.19, _BSD_SOURCE no longer causes __FAVOR_BSD
Starting with glibc 2.19, _BSD_SOURCE no longer causes BSD
definitions to be favored in cases where standards conflict.

Reviewed-by: Joseph S. Myers <joseph@codesourcery.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-08 12:14:04 +13:00
Michael Kerrisk 9f0e82b451 man-pages.7: s/Real hyphen/Real minus/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-08 09:35:27 +13:00
Michael Kerrisk 9730fd8493 man-pages.7: Various improvements to style guide
Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-06 12:50:12 +13:00
Michael Kerrisk 9a141bfb1f get_mempolicy.2, mbind.2, mlock.2, set_mempolicy.2, bootparam.7, packet.7: grfix: s/memory mapped/memory-mapped/ when used attributively
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 11:00:31 +13:00
Michael Kerrisk 084cf3d1cd packet.7: wfix: s/network order/network byte order/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 10:52:45 +13:00
Michael Kerrisk 342639d9e9 packet.7: Add kernel version numbers for PACKET_VERSION and PACKET_TIMESTAMP
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 10:51:42 +13:00
Michael Kerrisk c412686c05 packet.7: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 10:44:33 +13:00
Willem de Bruijn dbb4f7516b packet.7: Document fanout, ring, and auxiliary options
The packet socket manual page does not list all socket options.

This patch adds descriptions of the common packet socket options
  PACKET_AUXDATA, PACKET_FANOUT, PACKET_RX_RING, PACKET_STATISTICS,
  PACKET_TX_RING

and the ring-specific options
  PACKET_LOSS, PACKET_RESERVE, PACKET_TIMESTAMP, PACKET_VERSION

It does not yet add descriptions for
  PACKET_COPY_THRESH, PACKET_HDRLEN, PACKET_ORIGDEV,
  PACKET_TX_HAS_OFF, PACKET_TX_TIMESTAMP, PACKET_VNET_HDR

It tries to balance being informative with exposing kernel detail
that is unlikely to be used by most readers or that may change
frequently. For implementation details, the manpage points to the
documentation in kernel Documentation/networking. Let me know if
options should be added or removed.

Source: PACKET_FANOUT, PACKET_RX_RING and PACKET_VERSION are in
/tools/testing/net/psock_fanout.c in the latest Linux kernel source
tree. PACKET_STATISTICS was in the first version of that test.
PACKET_TX_RING I have used elsewhere. The other options are based
on reading kernel code.

 [Very minor fixups. -dborkman]

Acked-by: Daniel Borkmann <dborkman@redhat.com>
Signed-off-by: Willem de Bruijn <willemb@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 10:31:10 +13:00
Michael Kerrisk aa89a58e5a man-pages.7: Minor fixes
Reported-by: Bert Wesarg <bert.wesarg@googlemail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-04 00:42:09 +13:00
Michael Kerrisk 7849287b90 man-pages.7: Add STYLE GUIDE section
Incorporate some of the existing material in the page
into the STYLE GUIDE, and add a lot more material, mainly
drawn from the "Global changes" sections in the release
changelogs.

Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 15:48:48 +13:00
Michael Kerrisk f78f2def0f man-pages.7: Add some further style notes for code examples
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 12:34:35 +13:00
Michael Kerrisk f7407651f6 capabilities.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 10:11:34 +13:00
Michael Kerrisk 91e4f66067 man-pages.7: Add historical note on reason for use of Americal spelling
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 10:04:39 +13:00
Michael Kerrisk 1080506334 man-pages.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 10:02:29 +13:00
Michael Kerrisk dd6b62ec6e vdso.7: Minor fixes
Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 08:12:10 +13:00
Michael Kerrisk 65d28e9870 standards.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 14:45:57 +13:00
Mike Frysinger 8e30d5ac23 libc.7: SEE ALSO: add various entries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk 8635ed1b99 vdso.7: srcfix: wrap some long source lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk f6816de988 vdso.7: Further tweaks after discussion with Mike Frysinger
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk fb634bd8da vdso.7: Clean-ups
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Mike Frysinger 2800db8247 vdso.7: New page documenting the vDSO mapped into each process by the kernel
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk 10850212d0 uselib.2, getfsent.3, regex.3, nsswitch.conf.5, inotify.7, man-pages.7, symlink.7: Replace uses of "e.g." in main text with "for example" or similar
Usual man-pages style is to use "e.g." only within
    parenthetical expressions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk 449dd4e2ab proc.5, unix.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk 88879aebdd eventfd.2, set_mempolicy.2, timerfd_create.2, fwide.3, resolver.3, spufs.7, symlink.7, udplite.7, unicode.7: Replace uses of "i.e.," in main text with "that is" or similar
Usual man-pages style is to use "i.e." only within
parenthetical expressions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk 2c212ccda9 socket.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk eb4df3a032 credentials.7: Add details on controlling terminal and foreground/background jobs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk 299eee5051 credentials.7: List APIs that operate on process groups
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:14 +13:00