Commit Graph

11247 Commits

Author SHA1 Message Date
Michael Kerrisk 6024e7332f fcntl.2: Describe how to check whether the kernel supports a particular command
Reported-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk 102b34d811 fcntl.2: ERRORS: add EINVAL for invalid 'cmd'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk d9312ec7c0 fcntl.2: Minor wording improvement
Reported-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk 9044058e60 fcntl.2: Add an explicit note that mandatory locking is not in POSIX
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk f5cdb4b0fc fcntl.2: Make the warning that mandatory locks are unreliable more prominent
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk 6799ba26c9 fcntl.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk 9acee57885 fcntl.2: Rewrite introductory paragraphs on mandatory locking
Make the structure more logical, and also explicitly mention
OFD locks.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk 4b5c506a2c fcntl.2: Add EINVAL error for OFD locks where 'l_pid' is not 0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk c11b47b3b1 fcntl.2: CONFORMING TO: note that OFD locks are Linux-specific
But they make their way into the next POSIX release

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk 97e03523e5 fcntl.2: Describe semantics for compatible and conflicting OFD locks
And describe how threads can use OFD locks to ensure
exclusive access to a file.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk 1a93af040c fcntl.2: Detail the limitations of traditional (process-associated) locks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk bfb147160f fcntl.2: Minor fixes to introductory par on OFD locks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk 38702b6ccc fcntl.2: OFD locks are Linux-specific and available since Linux 3.15
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk 99b5ab7933 fcntl.2: Tweaks and rewrites of pieces of Jeff Layton's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Jeff Layton 2d3e4b83a3 fcntl.2: Document open file description locks
As provided by the fcntl() operations F_OFD_SETLK,
F_OFD_SETLKW, and F_OFD_GETLK

Signed-off-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk 7562b10e23 fcntl.2: Add para introducing advisory locks and noting existence of OFD locks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk 86fbd8d849 fcntl.2: Minor change: move some NOTES text on record locking
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk 15b4459067 fcntl.2: wfix + ffix: fine-tuning on NFSv4 client locking text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk 70fd304581 fcntl.2: Add NOTES subhead for record locking and NFS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk da0d60febb fcntl.2: nfsv4leasetime controls the "contact lost" interval for NFSv4
Jeff Layton:
   The difference here is subtle. The gracetime is how long after a reboot
   should knfsd allow clients to reclaim state (and deny the creation of
   new locks and opens). The leasetime is how long the NFSv4 lease period
   is. There is a relationship between the two that's illustrated in the
   comments above write_gracetime:

     /**
      * write_gracetime - Set or report current NFSv4 grace period time
      *
      * As above, but sets the time of the NFSv4 grace period.
      *
      * Note this should never be set to less than the *previous*
      * lease-period time, but we don't try to enforce this.  (In the common
      * case (a new boot), we don't know what the previous lease time was
      * anyway.)
      */

   The value you're interested in here is the nfsv4leasetime. If the
   client doesn't renew its lease within that period, then it's subject to
   the server giving up on it and dropping any state that it holds on that
   clients' behalf.

   Note that this is not a firm timeout. The server runs a job
   periodically to clean out expired stateful objects, and it's likely
   that there is some time (maybe even up to another whole lease period)
   between when the timeout expires and the job actually runs. If the
   client gets a RENEW in there within that window, its lease will be
   renewed and its state preserved.

Reported-by: Jeff Layton <jlayton@poochiereds.net>
Cowritten-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk af8713605a fcntl.2: Refine discussion of locks when NFSv4 client loses contact with server
Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk 6ca357f965 fcntl.2: Note treatment of locks when an NFS client loses contact with the server
Based on text sent by Neil Brown.

Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk 9584daf7f3 fcntl.2: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk cf118c620f fcntl.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:47 +02:00
Michael Kerrisk 91ac17b2c7 fcntl.2: Reword discussion of mandatory lock bug a litte
Jeff Layton confirmed that the bug remains even in modern kernels.

Reviewed-by: Jeff Layton <jlayton@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:47 +02:00
Michael Kerrisk 05a0fb665a flock.2: In some modern BSDs, fcntl() and flock() locks do interact
So, reword and extend the discussion of this topic in NOTES.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:38 +02:00
Michael Kerrisk b1b70920af flock.2: Move NOTES text describing implementation of flock()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:30:37 +02:00
Michael Kerrisk e449654fdb flock.2: Add more details on NFS, including Linux 2.6.37 changes
Also: move NOTES text describing interaction of fcntl()
and flock() locks.

Reviewed-by: NeilBrown <neilb@suse.de>
Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:30:37 +02:00
Peng Haitao fee98b6e5c mkdtemp.3: ATTRIBUTES: Note function that is thread-safe
The function mkdtemp() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:28:42 +02:00
Peng Haitao 61d995d649 basename.3: ATTRIBUTES: Note functions that are thread-safe
The functions basename() and dirname() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:28:42 +02:00
Peng Haitao 527c8d41b9 system.3: ATTRIBUTES: Note function that is thread-safe
The function system() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:28:42 +02:00
Michael Kerrisk f4dc1f56ee catgets.3: wfix
Reported-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:28:42 +02:00
Peng Haitao 8114fa1417 catgets.3: ATTRIBUTES: Note function that is thread-safe
The function catgets() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:28:42 +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
Yuri Kozlov f2f50fed25 fanotify_mark.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-08 21:16:39 +02:00
Yuri Kozlov d1c05d0b78 send.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-08 21:16:06 +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
Marko Myllynen 03ba14f978 localedef.1: Align with recent charmap(5) / repertoiremap(5) changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-05 20:18:02 +02:00
Marko Myllynen 83d1d0dd86 charmap.5: Update to match current glibc
charmap(5) was outdated, bring it to closer to reality by fixing
syntax descriptions to match current glibc code and practices,
adding missing options, removing obsolete comments and references,
and removing now incorrect examples.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-05 20:18:02 +02:00
Marko Myllynen d98127cdea repertoiremap.5: New page for repertoiremap(5)
Rather obsolete feature but localedef(1) refers to repertoiremaps.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-05 20:18:02 +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
Peng Haitao dfc41d9cfb mq_send.3: ATTRIBUTES: Note functions that are thread-safe
The functions mq_send() and mq_timedsend() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-04 21:16:54 +02:00
Peng Haitao db17fccda4 mq_receive.3: ATTRIBUTES: Note functions that are thread-safe
The functions mq_receive() and mq_timedreceive() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-04 21:16:38 +02:00
Peng Haitao 73d140c732 mq_open.3: ATTRIBUTES: Note function that is thread-safe
The function mq_open() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-04 21:16:26 +02:00
Peng Haitao ebd03e2998 posix_openpt.3: ATTRIBUTES: Note function that is thread-safe
The function posix_openpt() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-04 21:15:55 +02:00
Peng Haitao 955269b430 posix_fallocate.3: ATTRIBUTES: Note function that is thread-safe
The function posix_fallocate() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-04 21:12:41 +02:00
Marko Myllynen 0c2dbad182 locale.5: Clarify AM/PM settings a bit
localedef(1) complains if really undefined, should be empty instead.
Also: add some SEE ALSO references.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-04 21:12:36 +02:00
Marko Myllynen 8a7f7e6635 locale.1: Add FILES section, add charmap(5) reference
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-04 20:59:48 +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