Commit Graph

4979 Commits

Author SHA1 Message Date
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
Michael Kerrisk fc5911e1ea glibc headers: s/ret/retval/; s/tab/htab/.
Integrate discussion of reentrant functions into main discussion
(rather than as a short paragraph at the end).
Other minor additions and changes.
2008-09-03 08:07:02 +00:00
Michael Kerrisk 7a4076fa06 tweaks 2008-09-03 05:55:36 +00:00
Michael Kerrisk 55fbb69b35 Fix return type of ptsname_r() in SYNOPSIS. 2008-09-03 05:23:11 +00:00
Michael Kerrisk bc65b056e3 sync 2008-09-02 14:26:09 +00:00
Michael Kerrisk 4f5aae8404 Update changelog 2008-09-02 14:25:59 +00:00
Michael Kerrisk fe80e23e06 Noted that table size as specified by 'nel' is immutable.
Described differences between hsearch() and hsearch_r().
Added missing pieces to RETURN VALUE.
Added a number of new entries under ERRORS.
NOTES: added some basic advice on sizing the hash table;
noted that when a table is destroyed, the caller is responsible
for freeing the buffers pointed to by 'key' and 'data' fields.
One of the BUGS was fixed in glibc 2.3.
Rewrote and clarified various other pieces.
2008-09-02 14:06:20 +00:00