Commit Graph

1777 Commits

Author SHA1 Message Date
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
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 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 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 5b0dc1baed s/time zone/timezone/ for consistency across pages and with POSIX.1. 2008-09-07 04:17:25 +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 435ecb8e42 Update kernel version numbers relating to real-time support. 2008-09-05 06:11:29 +00:00
Michael Kerrisk fca860f5c5 Remove old sentence about where to send updates for this page. 2008-09-02 09:06:49 +00:00
Michael Kerrisk ec113208a5 tfix 2008-09-02 09:05:17 +00:00
Michael Kerrisk 0f200f076c Add/fix feature test macro requirements. 2008-08-29 15:50:13 +00:00
Michael Kerrisk 0302f1019a SEE ALSO: Add clock(3), clock_gettime(3). 2008-08-28 11:16:36 +00:00
Michael Kerrisk 835363b211 NOTES: Add text mention the shell 'ulimit' (or 'limit')
built-in command for setting resource limits.
2008-08-26 04:19:07 +00:00
Michael Kerrisk 2c0cfe3ccc grfix 2008-08-26 04:11:43 +00:00
Michael Kerrisk effee74c4b Remove FIXME 2008-08-21 08:45:05 +00:00
Michael Kerrisk 491cd2f039 spfix 2008-08-21 07:00:26 +00:00
Michael Kerrisk 5144e45f51 These interfaces are specified in POSIX.1-2008. 2008-08-21 06:16:15 +00:00
Michael Kerrisk 5db9708db3 CONFORMING TO: POSIX.1-2008 specifies utimensat() and futimens(). 2008-08-21 06:05:08 +00:00
Michael Kerrisk f428c08ac0 CONFORMING TO: POSIX.1-2008 marks gettimeofday() as obsolete. 2008-08-21 06:01:46 +00:00
Michael Kerrisk e1146d332c F_DUPFD_CLOEXEC is specified in POSIX.1-2008. 2008-08-21 05:15:16 +00:00
Michael Kerrisk aaec1423d7 Add FIXME 2008-08-21 05:11:22 +00:00
Michael Kerrisk 115e8dca06 Add a reference to linkat(2) for an interface that allows
precise control of the treatment of symbolic links.
2008-08-21 04:54:14 +00:00
Michael Kerrisk 08a3addfa4 O_CLOEXEC is specified in POSIX.1-2008. 2008-08-21 04:51:54 +00:00
Michael Kerrisk 1f8f8acb44 grfix 2008-08-21 04:44:02 +00:00
Michael Kerrisk e2067e32d7 Note kernel version where Linux stopped following symbolic
links in 'oldpath'; see also http://lwn.net/Articles/294667.
POSIX.1-2008 makes it implementation-dependent whether or not
'oldpath' is dereferenced if it is a symbolic link.
2008-08-21 04:38:03 +00:00
Michael Kerrisk c368e7ca76 Add kernel version numbers for MAP_32BIT.
Add some details on MAP_32BIT (see http://lwn.net/Articles/294642).
2008-08-21 04:14:14 +00:00
Michael Kerrisk 1d0ab60002 grfix 2008-08-20 19:45:18 +00:00
Michael Kerrisk cc40d64d21 ffix 2008-08-19 18:07:03 +00:00
Michael Kerrisk 2269e87064 s/d/domain/ for name of argument.
Add reference to socket(2) for further information on
domain, type, and protocol arguments.
2008-08-19 14:34:48 +00:00
Michael Kerrisk 20e5fb78ea When an eventfd overflows, select() indicates the file as both
readable and writable (not as having an exceptional condition).
2008-08-18 11:09:15 +00:00
Michael Kerrisk 43be23955e SEE ALSO: remove duplicate entry. 2008-08-18 06:19:19 +00:00
Michael Kerrisk adfbcbebf0 Add reference to numa(7) for information on library support.
Added  a VERSIONS section.
SEE ALSO: Add numa(7).
2008-08-13 08:20:30 +00:00
Michael Kerrisk 69f06e4f98 Add reference to numa(7) for information on library support.
Added  a VERSIONS section.
SEE ALSO: Add numa(7).
2008-08-13 08:19:47 +00:00
Michael Kerrisk b000a5203b SEE ALSO: Add numa(7).
Added  a VERSIONS section.
2008-08-13 08:16:43 +00:00
Michael Kerrisk c6b29f0e9e SEE ALSO: Add numa(7).
Added  a VERSIONS section.
Remove material on library support and numactl; that material
is now in numactl.7.
2008-08-13 08:15:51 +00:00
Michael Kerrisk 8b9c69b6f7 Added VERSIONS (from kernel 2.6.18) and CONFORMING TO sections. 2008-08-13 05:51:20 +00:00
Michael Kerrisk 5a35e62092 Removed trailing white space at end of lines 2008-08-12 10:27:05 +00:00
Michael Kerrisk abe7c8711b Documentation of the move_pages() system call.
This page was formerly part of the numactl package, but really
belongs in man-pages (since it describes a kernel interface).
2008-08-12 09:22:42 +00:00
Michael Kerrisk ad6eeaf0f3 grfix 2008-08-11 09:01:40 +00:00
Michael Kerrisk a0c1c6f017 s/task/process/g 2008-08-11 09:00:23 +00:00
Michael Kerrisk bdd7bc29e2 Attempt to clarify discussion of MPOL_DEFAULT. 2008-08-11 05:31:24 +00:00
Michael Kerrisk 58a69c3c86 tstamp 2008-08-11 05:28:31 +00:00
Michael Kerrisk 4a459ba1ab Add brief discussion of mode flags. 2008-08-11 05:27:30 +00:00
Michael Kerrisk 1313d29781 tweaks 2008-08-11 05:21:24 +00:00
Michael Kerrisk f98b728e0a Lee Schermerhorn
Another attempt to rationalize description of MPOL_DEFAULT.

Since ~2.6.25, the system default memory policy is "local allocation".
MPOL_DEFAULT itself is a request to remove any non-default policy and
"fall back" to the surrounding context.  Try to say that without delving
into implementation details.
2008-08-11 05:11:50 +00:00
Michael Kerrisk fb67fb2902 Fix URI reference for libnuma. 2008-08-11 04:25:50 +00:00
Michael Kerrisk 20ca75a0d7 Lee Schermerhorn
Update the get_mempolicy(2) man page to add in the description of
the MPOL_F_MEMS_ALLOWED flag, added in 2.6.23.
mtk
Document additional EINVAL error that occurs is MPOL_F_MEMS_ALLOWED
is specified with either MPOL_F_ADDR or MPOL_F_NODE.
2008-08-08 20:02:56 +00:00