LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity
4,993 Commits 1 Branch 197 Tags 93 MiB
Commit Graph

4993 Commits

Author SHA1 Message Date
George Spelvin 7134d7e62c Clarify closedir()'s treatment of underlying file descriptor. 
At the end of the paragraph in opendir(3) describing fdopendir(), I
think it's worth adding "The file descriptor will be closed when
closedir() is called."  It's a bit ambiguous if the file descriptor
is closed or "given back" at closedir time.

(I've tested this and verified that it's true, BTW.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-09-23 08:55:50 +02:00
Michael Kerrisk 6dea120e68 Fix 'dir' argument name: should be '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 08:45:52 +02:00
Michael Kerrisk 998ad4a620 Note changes to tsearch.3 in changelog. 2008-09-23 08:26:05 +02:00
Michael Kerrisk 2390bfe8fd Add feature test macro to example program 
tdestroy() needs _GNU_SOURCE.
 2008-09-23 08:22:22 +02:00
André Goddard Rosa 6fa5dff6b4 tsearch.3: dispose properly of allocated resources in example code 
As there are many users who base their own code on these examples,
we should avoid leaking memory when using functions of tsearch() family.
In the provided example, tsearch() leaks memory whenever it tries to
insert a number which was already inserted before.

Also: include use of tdestroy() in example program.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-09-23 08:20:29 +02:00
Michael Kerrisk 314c8ff41d Wording fix 2008-09-23 07:22:43 +02:00
Sam Varshavchik 33fb70ba7c s/it_interval/it_value/ when talking about TIMERFD_ABSTIME (bis). 2008-09-23 07:17:40 +02:00
Sam Varshavchik c3afed740a s/it_interval/it_value/ when talking about TIMERFD_ABSTIME. 2008-09-23 07:07:55 +02:00
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