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

4864 Commits

Author SHA1 Message Date
Sam Varshavchik 9291ce36fe ffix 2008-09-25 09:50:14 +02:00
Michael Kerrisk 3fb3dc3c07 Fix line-wrapped URLs 
Some long URLs were line wrapped, preventing scripts that
produce HTML versions of the changelog from turning
them into proper hyperlinks.
 2008-09-24 23:40:28 +02:00
Michael Kerrisk ee2c437cd5 update .TH timestamp 2008-09-24 22:50:11 +02:00
Michael Kerrisk c8bd05f909 Add more detail about wrapper functions 
Add a few more details about work generally done by wrapper
functions.  Note that syscall(2) performs the same steps.
 2008-09-24 16:10:00 +02:00
Michael Kerrisk c892873d1a Delete old versions of .Announce and .lsm 2008-09-24 16:08:28 +02:00
Michael Kerrisk 6fcbd98a98 Start of man-pages-3.11: updating Changes and Changes.old 2008-09-24 15:44:24 +02:00
Michael Kerrisk f0463c342b Start of man-pages-3.11: updating .Announce and .lsm files 2008-09-24 15:44:24 +02:00
Michael Kerrisk 116227e960 Start of man-pages-3.11: renaming .Announce and .lsm files 2008-09-24 15:44:23 +02:00
Michael Kerrisk da36d65be4 Ready for 3.10 2008-09-23 15:52:08 +02:00
Michael Kerrisk 71c48553a1 Removed trailing white space at end of lines 2008-09-23 15:51:25 +02:00
Michael Kerrisk 0e22ac924e Expanded tabs 2008-09-23 15:51:17 +02:00
Michael Kerrisk 3fe44d51dd Tweak check of 'val' after tsearch() call. 2008-09-23 15:38:33 +02:00
Michael Kerrisk 12a29fd650 Remove unused sections 2008-09-23 15:06:28 +02:00
Michael Kerrisk cf21356ddf Update timestamp 2008-09-23 15:05:49 +02:00
Michael Kerrisk 7b1f4b14ba Wording fix. 2008-09-23 11:45:57 +02:00
Michael Kerrisk c3ea9f2ded Can't use comma instead of slash to separate port and protocol. 
Remove crufty text about use of comma instead of slash to separate
port and protocol.  It's not true as at glibc 2.8, and it's not
clear if/when it was ever true.
 2008-09-23 11:20:21 +02:00
Michael Kerrisk afeb98dc09 Update changes to protocols.5 and services.5 2008-09-23 10:59:20 +02:00
Michael Kerrisk d394fbfcd7 Remove refs to noonexisent docs. 
Remove SEE ALSO references to nonexistent Guides to Yellow Pages
and Bind/Hesiod docs.
 2008-09-23 10:56:51 +02:00
Michael Kerrisk 91924ca616 Minor wording and orthography fixes. 2008-09-23 10:51:43 +02:00
Michael Kerrisk a2610398b8 Remove some bugs, that no longer seen to be true in glibc 2.8. 2008-09-23 10:46:24 +02:00
Michael Kerrisk 837f7a82d3 Wording and grammar fixes 2008-09-23 10:19:32 +02:00
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