Commit Graph

5035 Commits

Author SHA1 Message Date
Michael Kerrisk e7d807b715 Wording fix. 2008-09-23 06:58:51 +02:00
John Reiser a1d48abb60 Fine tune discussion of getpid() caching bug.
The error by getpid() in the presence of clone() occurs
only for a fork-like clone (one that omits CLONE_VM from the flags.)
This is a low-level detail, but there is no problem [known-to-me]
for thread-like clone().
2008-09-23 06:55:29 +02:00
Michael Kerrisk c60237c9b5 Clarify text describing getpid() caching bug for clone() wrapper.
See also: http://sourceware.org/bugzilla/show_bug.cgi?id=6910
and https://bugzilla.redhat.com/show_bug.cgi?id=417521
2008-09-23 05:04:49 +02:00
Michael Kerrisk 3e7a52936d Fix 'dir' argument name: should be 'dirp'.
The page formerly used both 'dir' and 'dirp'(!).
POSIX.1-2008 and glibc call this argument 'dirp' (consistent
with the fact that it is a *pointer* to a DIR structure).
2008-09-23 04:25:35 +02:00
Michael Kerrisk 67f0f50d07 Describe getpid()'s PID caching and its consequences.
getpid() caches the PID after the first call.  This relies
on support in the glibc wrappers for fork()/vfork()/clone().
However, if syscall() is used to directly invoke fork()/vfork()/clone(),
the cache is not updated, and getpid() in the child procudes the wrong
result.
2008-09-23 04:12:27 +02:00
Timothy S. Nelson 59bf85dffc Fix Timothy's name in changelog 2008-09-23 02:10:15 +02:00
Michael Kerrisk 83f25499d3 Set up for start of 3.10 2008-09-23 01:47:28 +02:00
Michael Kerrisk 5071e2eba3 Set up changelogs for start of 3.10 2008-09-23 01:44:36 +02:00
Michael Kerrisk 0743fbdae3 spelling fix 2008-09-23 01:42:50 +02:00
Michael Kerrisk 9ab1bf07fd Rename lsm and Announce file for start of 3.10. 2008-09-23 01:40:42 +02:00
Michael Kerrisk 81468e1308 3.09 2008-09-10 14:00:14 +00:00
Michael Kerrisk 6d9c5c4848 cleanups 2008-09-10 13:09:43 +00:00
Michael Kerrisk 3c0a215097 Cleaups 2008-09-10 12:58:04 +00:00
Michael Kerrisk d4e9903bb7 Removed trailing white space at end of lines 2008-09-10 12:39:34 +00:00
Michael Kerrisk 43c57288bc Removed tabs 2008-09-10 12:39:13 +00:00
Michael Kerrisk a4fad1c6bb nop 2008-09-10 11:40:29 +00:00
Michael Kerrisk bda049a5d9 Place .so line start if file 2008-09-10 11:32:21 +00:00
Michael Kerrisk aef0a6413e Fix order of sched_setscheduler entry;
update version number of Changes header
2008-09-10 11:04:08 +00:00
Michael Kerrisk 8bdf768822 sync 2008-09-10 10:51:06 +00:00
Michael Kerrisk 82d2be3d9d > > Additionally, you may want to make a note in the stat/lstat man page that on
> > Linux, lstat(2) will generally not trigger automounter action, whereas
> > stat(2) will.
> 
> I don't understand this last piece.  Can you say some more.  (I'm not
> familiar with automounter details.)
 
An automounter (either an explicit one, like autofs, or an implicit
one, such as are used by AFS or NFSv4) is something that triggers
a mount when something is touched.
 
However, it's undesirable to automount, say, everyone's home
directory just because someone opened up /home in their GUI
browser or typed "ls -l /home".  The early automounters simply
didn't list the contents until you accessed it by name;
this is still the case when you can't enumerate a mapping
(say, all DNS names under /net).  However, this is extremely
inconvenient, too.
 
The solution we ended up settling on is to create something
that looks like a directory (i.e. reports S_IFDIR in stat()),
but behaves somewhat like a symlink.  In particular, when it is
accessed in a way where a symlink would be dereferenced,
the automount triggers and the directory is mounted.  However,
system calls which do *not* cause a symlink to be dereferenced,
like lstat(), also do not cause the automounter to trigger.
This means that "ls -l", or a GUI file browser, can see a list
of directories without causing each one of them to be automounted.
 
        -hpa
2008-09-10 10:40:01 +00:00
Michael Kerrisk da1eef3d9d tstamp 2008-09-10 10:35:15 +00:00
Michael Kerrisk 30da961413 tstamp 2008-09-10 10:19:15 +00:00
Michael Kerrisk 19eee0a623 s/stat(2)/lstat(2)/ when discussin d_type (since we
are talking about a case where we might be interested to
whether the file itself is a symbolic link).
2008-09-10 10:18:53 +00:00
Michael Kerrisk 9da1822fd8 tfix 2008-09-10 09:18:38 +00:00
Michael Kerrisk d6a591bc7f tfix 2008-09-10 09:05:33 +00:00
Michael Kerrisk 67da52673e Start new sentence on new source line. 2008-09-10 03:45:09 +00:00
Michael Kerrisk eeeffe2d3b grfix 2008-09-10 03:41:35 +00:00
Michael Kerrisk ade562fbcc grfix 2008-09-10 03:40:20 +00:00
Michael Kerrisk 1930dbe6d1 grfix 2008-09-10 03:38:18 +00:00
Michael Kerrisk 99d8a684b3 start new sentence on new source line 2008-09-10 03:33:15 +00:00
Michael Kerrisk 1614be9f1f Update FIXME. 2008-09-09 10:48:13 +00:00
Michael Kerrisk 6dec79368a tstamp 2008-09-09 05:48:35 +00:00
Michael Kerrisk 79bf8cdcf3 Document fopencookie(3), a library function that allows
custom implementation of a stdio stream.
2008-09-09 05:48:00 +00:00
Michael Kerrisk 86d89e4c89 Add more detail in mount options that prevent updates to atime. 2008-09-09 05:25:25 +00:00
Michael Kerrisk e21a7c25fe s/filesystem/file system/ 2008-09-09 05:13:34 +00:00
Michael Kerrisk 614aae4105 Add "512B" to comment for st_blocks 2008-09-09 05:12:17 +00:00
Michael Kerrisk 6557e38407 tfix 2008-09-08 14:01:42 +00:00
Michael Kerrisk 037273a620 Describe "shift sequence" input. 2008-09-08 13:50:13 +00:00
Michael Kerrisk 5b0dc1baed s/time zone/timezone/ for consistency across pages and with POSIX.1. 2008-09-07 04:17:25 +00:00
Michael Kerrisk 7df94fa933 sync 2008-09-07 04:12:37 +00:00
Michael Kerrisk e957764019 Rewrite description of getdate_r() and integrate into main text
(rather than describing in NOTES).
Other parts rewritten for greater clarity.
Make it clearer in the main text that glibc does not implement %Z;
remove discussion of that point from NOTES.
Added an example program.
2008-09-07 04:11:07 +00:00
Michael Kerrisk 057dce78b1 Move description of negative l_len from NOTES, integrating
it into the discussion of file locking.
Minor rewrites of the text on file locking.
2008-09-05 12:23:14 +00:00
Michael Kerrisk 68e0696a74 More clearly and consistently describe the whether or not the third
argument to fnctl() is required, and what its type should be.
2008-09-05 11:46:06 +00:00
Michael Kerrisk b905d225d2 Add "Link with -lrt" to SYNOPSIS; remove now redundant
sentence mentioning librt from NOTES.
2008-09-05 10:04:06 +00:00
Michael Kerrisk e8b5972889 sync 2008-09-05 07:03:41 +00:00
Michael Kerrisk 435ecb8e42 Update kernel version numbers relating to real-time support. 2008-09-05 06:11:29 +00:00
Michael Kerrisk ed26d24c76 Taken from Debian, with light edits 2008-09-04 14:02:12 +00:00
Michael Kerrisk 0927f4c5cf tweaks 2008-09-03 10:32:22 +00:00
Michael Kerrisk 222815390a sync 2008-09-03 08:10:20 +00:00
Michael Kerrisk 74f7e82aa9 Updated changelog 2008-09-03 08:09:40 +00:00