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

2037 Commits

Author SHA1 Message Date
Michael Kerrisk 852ae8c875 mount.2: List a few other file systems that we may see in /proc/filesystems 
Add some modern file systems to that list (xfs, jfs, ext3, reiserfs).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-06 13:19:51 +02:00
Michael Kerrisk a3b00c37dc mount.2: wfix: remove redundant "Linux Notes" subheading 2008-10-06 13:18:33 +02:00
Michael Kerrisk 5614f73308 mount.2, umount.2: split umoun*() out into a separate page 
The length of this page means that it's becoming difficult to parse
which info is specific to mount() versus umount()/umount2(), so split
the umount material out into its own page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-06 13:09:26 +02:00
Michael Kerrisk 9b9b4a8137 spfix 2008-10-06 11:49:27 +02:00
Michael Kerrisk cd7b18e735 pause.2: remove mention of words "library function" 
This really is a system call.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-05 07:20:58 +02:00
Michael Kerrisk 374af67a42 getrlimit.2: refer to execve(2) for RLIMIT_STACK's effect on ARG_MAX 
Refer the reader to new text in execve(2) that describes how
(since Linux 2.6.23) RLIMIT_STACK determines the value of ARG_MAX.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-05 06:24:36 +02:00
Michael Kerrisk 3a9dc9ff79 execve.2: _SC_ARG_MAX is no longer necessarily constant 
POSIX.1-2001 says that the values returned by sysconf()
are constant for the life of the process.
But the fact that, since Linux 2.6.23, ARG_MAX is settable
via RLIMIT_STACK means _SC_ARG_MAX is no longer constant,
since it can change at each execve().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-05 05:59:32 +02:00
Michael Kerrisk f202015b45 execve.2: Linux now imposes a floor on the ARG_MAX limit 
Starting with Linux 2.6.23, the ARG_MAX limit became settable via
(1/4 of) RLIMIT_STACK.  This broke ABI compatibility if RLIMIT_STACK
was set such that ARG_MAX was < 32 pages.  Document the fact that
since 2.6.25 Linux imposes a floor on ARG_MAX, so that the old limit
of 32 pages is guaranteed.

For some background on the changes to ARG_MAX in kernels 2.6.23 and
2.6.25, see:
    http://sourceware.org/bugzilla/show_bug.cgi?id=5786
    http://bugzilla.kernel.org/show_bug.cgi?id=10095
    http://thread.gmane.org/gmane.linux.kernel/646709/focus=648101,
    checked into 2.6.25 as commit a64e715fc74b1a7dcc5944f848acc38b2c4d4ee2.

Also some reordering/rewording of the discussion of ARG_MAX.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-05 05:57:52 +02:00
Michael Kerrisk 00e8730f78 getrlimit.2: Reword/relocate discussion of BSD's historical RLIMIT_OFILE 
The old sentence sat on its own in an odd place, and anyway the
modern BSDs use the name RLIMIT_NOFILE.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-05 05:42:32 +02:00
Michael Kerrisk f3504b0292 srcfix 2008-10-05 03:29:35 +02:00
Michael Kerrisk 3fb46b2b3b sigaction.2: wfix 2008-10-04 08:27:56 +02:00
Michael Kerrisk f7d174ea1b sigaction.2: refer reader to signal(7) for an overview of signals 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Gergely Soos <sogerc1@gmail.com>
 2008-10-04 08:01:49 +02:00
Michael Kerrisk 0ac0def44d sigaction.2: explain semantics of signal disposition during fork() and execve() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-04 07:49:53 +02:00
Michael Kerrisk 0178675542 sigwaitinfo.2: distinguish per-thread and process-wide signals 
A sentence clarifying that pending signal set is union of
per-thread and process-wide pending signal sets.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-04 07:39:50 +02:00
Michael Kerrisk 1218ca8771 sigwaitinfo.2: these interfaces have per-thread semantics 
The page was previously fuzzy about whether the these interfaces
have process-wide or per-thread semantics.  (E.g., now the
page states that the calling *thread* (not process) is suspended
until the signal is delivered.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-04 07:36:18 +02:00
Michael Kerrisk 55aa29202c semop.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-04 07:14:34 +02:00
Michael Kerrisk dfcc37a6ab getrusage.2: rusage measures are preserved across execve(2) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-04 07:10:35 +02:00
Michael Kerrisk 6d01795229 sigaltstack.2: explain inheritance of alternate signal stack across fork(2) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-04 06:58:36 +02:00
Michael Kerrisk a6b7b51147 sigpending.2: explain effect of fork() and execve() for pending signal set 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-04 06:38:30 +02:00
Michael Kerrisk 7acce9fb90 sigpending.2: explain how thread's pending signal set is defined 
The pending set is the union of per-thread pending signals and process-wide
pending signals.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-04 06:34:38 +02:00
Michael Kerrisk eebf482da2 sigprocmask.2: explain effects of fork() and execve() for signal mask 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-04 06:30:10 +02:00
Michael Kerrisk 4c5bcd47bf sigaction.2: refer to signal(7) for more details on signal mask. 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-04 05:49:12 +02:00
Michael Kerrisk bf50110267 execve.2: updated FIXME (for argv==NULL) in source comments 2008-10-03 06:04:03 +02:00
Michael Kerrisk 1dfd87eee5 readdir.2: The programmer must declare the old_linux_dirent structure 
Glibc does not provide a definition of this structure.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-02 13:30:23 +02:00
Michael Kerrisk 8c1e7c9c47 wspacefix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-02 13:28:02 +02:00
Michael Kerrisk b82f860abd readdir.2: s/dirent/old_linux_dirent/ 
Nowadays, this is the name of the structure in the kernel sources.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-02 13:26:33 +02:00
Michael Kerrisk f8c4a80874 readdir.2: remove words "which may change" 
These words are slightly bogus: although the interface is obsolete,
for ABI-compatibility reasons, the kernel folk should never be changing
this interface.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-02 13:23:25 +02:00
Michael Kerrisk 30508251e3 readdir.2: remove header files from SYNOPSIS 
glibc doesn't provide any support for readdir(2),
so remove these header files (which otherwirse suggest
that glibc does provide the required pieces).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-02 13:20:39 +02:00
Michael Kerrisk d03fa0d508 getdents.2: Add an example program 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-02 13:15:42 +02:00
Michael Kerrisk 5ff3825e41 getdents.2: comment out linux_dirent fields with varying location 
The location of the fields fater d_name varies according to
the size of d_name.  We can't properly declare them in C;
therefore, put those fields inside a comment.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-02 13:07:58 +02:00
Michael Kerrisk 5df2ee037d getdents.2: The DT_* constants are defined in <dirent.h> 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-02 11:35:50 +02:00
Michael Kerrisk 298c502435 getdents.2: emove header files from SYNOPSIS 
None of the header files provides what is needed.
Calls are made via syscall(2).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-02 11:33:34 +02:00
Michael Kerrisk 64150629a7 getdents.2: The programmer must define the linux_dirent structure 
Point out that this structure is not defined in glibc headers.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-02 11:27:17 +02:00
Michael Kerrisk affa1ac7b6 getdents.2: s/dirent/linux_dirent/ 
The structure isn't currently defined in glibc headers, and the kernel
name of the structure is 'linux_dirent' (as was already used in some,
but not all, places in this page).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-02 11:15:28 +02:00
Michael Kerrisk 6d32be0960 tkill.2: EINVAL error can also occur for invalid TGID 
The EINVAL error on an invalid TGID for tgkill() was
not documented; this change documents it.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-10-01 16:46:11 +02:00
Michael Kerrisk f1b0cf261c Document MS_SILENT (and MS_VERBOSE) 
Maxin suggested a patch, which I've rewritten and expanded.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Maxin B. John <maxin.john@ap.sony.com>
 2008-10-01 15:17:47 +02:00
Michael Kerrisk efb92ba155 getdents.2, readdir.3: d_type is currently only supported on ext[234] 
As at kernel 2.6.27, only ext[234] support d_type.
On other file systems, d_type is always set to DT_UNKNOWN (0).

Reported-by: Ricardo Catalinas Jimnez <jimenezrick@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-09-29 15:06:36 +02:00
Michael Kerrisk bc0a3def1d utimensat.2: POSIX.1-2008 revision will likely affect FTMs for futimens() 
Make it clear that the POSIX.1 revision that is likely
to affect the feature test macro requirements for futimens() is
POSIX.1-2008.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Nicolas Franois <nicolas.francois@centraliens.net>
 2008-09-29 12:52:30 +02:00
Nicolas Franois 26b42bb4bf utimensat.2: Make various wordings a little more precise. 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

The times argument point to *an array of* structures, and the
man-page should say that consistently.
 2008-09-29 12:42:09 +02:00
Michael Kerrisk 2dd5352dae send.2: make kernel version for MSG_CONFIRM more precise 
s/2.3+ only/Since Linux 2.3.15/

Reported-by: Nicolas Franois <nicolas.francois@centraliens.net>
 2008-09-29 12:35:13 +02:00
Nicolas Franois aab31be272 move_pages.2: Make a detail og EPERM error more precise 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-09-29 12:20:39 +02:00
Nicolas Franois 5f3fb725ab recv.2: Move kernel version number to first mention to MSG_ERRQUEUE. 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-09-29 11:46:01 +02:00
Nicolas Franois 494b842ba0 Remove a line of junk text. 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-09-29 11:30:57 +02:00
Nicolas Franois 178d104e83 Minor wording fixes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-09-29 11:09:52 +02:00
Nicolas Franois 44e5793157 Typo and wording fixes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-09-29 11:00:36 +02:00
Kirill A. Shutemov afc4edc132 semop.2: fix typo in example 
(The '&' before sop in the semop() call is unneeded.)
Signed-off-by: Kirill A. Shutemov <kirill@shutemov.name>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2008-09-29 09:49:35 +02:00
Michael Kerrisk e0d16ae5e7 wait4.2: wait3() is a library function layered on wait4(). 
On Linux wait3() is a library function implemented on top of wait4().
(Knowing this is useful when using strace(2), for example.)
 2008-09-29 03:51:49 +02:00
Michael Kerrisk 986992f30d splice.2: note that SPLICE_F_MOVE is a no-op since kernel 2.6.21 2008-09-26 07:31:14 +02:00
Michael Kerrisk 901d59b5ce mlock.2: tweaks to Maxin John's patch 2008-09-25 11:18:08 +02:00
Michael Kerrisk 1ad3882cf8 tstamp 2008-09-25 11:11:53 +02:00
Maxin John 9fdc5b1260 mlock.2: add EAGAIN error. 
Summary from mtk: recent work on mlock caused Maxin to notice that
the EAGAIN error was not documented.  KOSAKI Motohiro noted
that this behavior is longstanding.
=====
Dear Michael,

    As per the mlock(2) implementation bugfix which is present in
Linux 2.6.27-rc2 git commit,
(http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=commitdiff;h=a477097d9c37c1cf289c7f0257dffcfa42d50197),
the mlock(2) man page should be modified to reflect the latest changes
in the kernel.

See the LKML thread regarding this commit :
http://www.nabble.com/mlock()-return-value-issue-in-kernel-2.6.23.17-td18751601.html

This patch modifies the mlock(2) behaviour as per the SUSv3 specification.

[ENOMEM]
    Some or all of the address range specified by the addr and
    len arguments does not correspond to valid mapped pages
    in the address space of the process.

[EAGAIN]
    Some or all of the memory identified by the operation could not
    be locked when the call was made.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Signed-off-by: Maxin B. John <maxin.john@ap.sony.com>

=====
From: KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
To: "Maxin John" <maxin.john@gmail.com>
Subject: Re: mlock(2) man page modifications
Cc: kosaki.motohiro@jp.fujitsu.com,
        "Michael Kerrisk" <mtk.manpages@googlemail.com>, man@vger.kernel.org
Date: Thu, 25 Sep 2008 15:04:49 +0900 (JST)

Hi Maxin,

Thank you for your attention.
I think your point and your patch are right.

However, my patch is trivial regression fix, not behavior change.
An older kernel can return EAGAIN at memory stavation.
my patch has following hunk.

> +++ b/mm/mlock.c
> @@ -78,8 +78,6 @@ success:
>  
>         mm->locked_vm -= pages;
>  out:
> -       if (ret == -ENOMEM)
> -               ret = -EAGAIN;

In addition, 2.6.11 (oldest code of git repository) has following code.


static int mlock_fixup(struct vm_area_struct * vma, 
        unsigned long start, unsigned long end, unsigned int newflags)
{
(snip)
        vma->vm_mm->locked_vm -= pages;
out:
        if (ret == -ENOMEM)
                ret = -EAGAIN;
        return ret;
}


that behavior is linux mlock's behavior for long long time.

Thanks!
 2008-09-25 11:09:31 +02:00
Sam Varshavchik 9291ce36fe ffix 2008-09-25 09:50:14 +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 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 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
Michael Kerrisk 63e28ad443 Lee Schermerhorn 
Misc cleanup of get_mempolicy(2):
+ mention that any mode flags will be saved with mode.
I don't bother to document mode flags here because we
already have a pointer to set_mempolicy(2) for more info
on memory policy.  mode flags are discussed there.
+ remove some old, obsolete [IMO] NOTES and 'roff comments.
 2008-08-08 19:47:20 +00:00
Michael Kerrisk d4c8c97c31 s/PF_/AF_/ for socket family constants. Reasons: the AF_ and 
PF_ constants have always had the same values; there never has
been a protocol family that had more than one address family,
and POSIX.1-2001 only specifies the AF_* constants.
 2008-08-08 16:47:53 +00:00
Michael Kerrisk 77117f4fc5 Reverting blunder in commit 4699 2008-08-08 16:41:48 +00:00
Michael Kerrisk 10874173db s/PF_/AF_/ for socket family conistants. Reasons: the AF_ and 
PF_ constants have always had the same values; there never has
been a protocol family that had more than one address family,
and POSIX.1-2001 only specifies the AF_* constants.
 2008-08-08 16:28:06 +00:00
Michael Kerrisk bfcecf8a76 Fix error conditions, now that the kernel silently ignores 
nodes outside the task's cpuset, as long as one valid node remains.

Now that cpuset man page exists, we can refer to it.  Remove
stale comment regarding lack thereof.
 2008-08-08 15:22:56 +00:00
Michael Kerrisk cdba92536d Lee Schermerhorn 
Fix up the error return for nodemask containing nodes disallowed by
the process' current cpuset.  Disallowed nodes are now silently ignored,
as long as the nodemask contains at least one node that is on-line,
allowed by the process' cpuset and has memory.

Now that we have a cpuset man page, we can refer to cpusets directly
in the man page text.
 2008-08-07 12:19:08 +00:00
Michael Kerrisk 6c48afffcf wfix 2008-08-07 11:08:15 +00:00
Michael Kerrisk 2fb19a1619 The floating-point environment is reset to the default 
during an execve().
 2008-08-07 10:54:18 +00:00
Michael Kerrisk b05757449e ffix 2008-08-06 20:46:09 +00:00
Michael Kerrisk 9fcbe835d8 ffix 2008-08-06 20:45:26 +00:00
Michael Kerrisk f36903108a ffix 2008-08-06 20:41:47 +00:00
Michael Kerrisk 89b3c6b808 ffix 2008-08-06 20:33:17 +00:00
Michael Kerrisk b546318a5f In the ipc_perm structure definition, some fields were 
incorrectly named: s/key/__key/ and s/seq/__seq/.
 2008-08-06 20:22:46 +00:00
Michael Kerrisk 58413227bf ffix 2008-08-06 20:20:52 +00:00
Michael Kerrisk 765eec1080 Last change was really: 
In the ipc_perm structure definition, some fields were
incorrectly named: s/key/__key/ and s/seq/__seq/.
 2008-08-06 20:19:17 +00:00
Michael Kerrisk 2d2892fc42 ffix 2008-08-06 20:18:38 +00:00
Michael Kerrisk 6edbac015c ffix 2008-08-06 20:17:27 +00:00
Michael Kerrisk 116e7cd9df tfix 2008-08-06 20:09:41 +00:00
Michael Kerrisk b101827706 In ipc_perm structure definition, some fields were incorrectly 
named: s/key/__key/ and s/seq/__seq/.
 2008-08-06 20:09:12 +00:00
Michael Kerrisk a2a11a45ec ffix 2008-08-06 20:08:09 +00:00
Michael Kerrisk c153f4a6fb ffix 2008-08-06 19:58:00 +00:00
Michael Kerrisk 22b2283175 Remove EFAULT from errors. Under ENOMEM error, note that EFAULT 
was the error produced in some cases for kernels before 2.4.19.
 2008-08-06 19:41:51 +00:00
Michael Kerrisk 05c1f95677 Remove FIXME 2008-08-06 10:46:47 +00:00
Michael Kerrisk 5a54a60bf9 POSIX.1-2008 removes the specification of vfork(). 2008-08-06 10:46:26 +00:00
Michael Kerrisk 0524a4fccf POSIX.1-2008 marks utime() obsolete. 
POSIX.1-2008 removes the POSIX.1-2001 LEGACY marking of utimes(),
so mention of this point has been removed from the page.
 2008-08-06 10:45:14 +00:00
Michael Kerrisk 55cfc5749f POSIX.1-2008 marks setpgrp() obsolete. 2008-08-06 10:36:11 +00:00
Michael Kerrisk 7a6f621e22 POSIX.1-2008 marks getitimer() and setitimer() obsolete. 2008-08-06 10:30:51 +00:00
Michael Kerrisk da3a4661d3 Remove FIXME 2008-08-06 10:27:57 +00:00
Michael Kerrisk 3d15e15d04 tfix 2008-08-06 10:26:43 +00:00
Michael Kerrisk 257688032a Fix mis-ordered (.SH) sections. 2008-08-05 16:42:24 +00:00
Michael Kerrisk c45bd688fd s/floating point/floating-point/ when used attributively. 2008-07-23 02:57:20 +00:00
Michael Kerrisk 94d5cb11d0 s/resp./respectively,/ 2008-07-22 15:08:19 +00:00
Michael Kerrisk bbae62c333 Remove ambiguity in description of support for O_EXCL on NFS. 
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=491791.
 2008-07-22 05:48:27 +00:00
Michael Kerrisk 0d568afbc3 ffix 2008-07-18 03:55:11 +00:00
Michael Kerrisk 90d75949c5 SEE ALSO: add end(3). 2008-07-17 14:03:27 +00:00
Michael Kerrisk 88989295a8 Place options in some semblance of alphabetical order. 
(No content or formatting changes were made.)
 2008-07-16 14:01:02 +00:00
Michael Kerrisk fd7193f57a Removed trailing white space at end of lines 2008-07-16 13:11:30 +00:00
Michael Kerrisk fccde10fbe Remove FIXME. 2008-07-16 08:56:16 +00:00
Michael Kerrisk 61dd016f86 Documents utimensat(2), new in kernel 2.6.22, working properly in 2.6.26. 2008-07-16 08:42:14 +00:00
Michael Kerrisk c57f36c572 SEE ALSO: add utimensat(3). 2008-07-16 08:40:14 +00:00
Michael Kerrisk f09c8e9806 SEE ALSO: add utimensat(2), futimens(3). 2008-07-16 08:30:35 +00:00
Michael Kerrisk 6267a52b02 Add section number in page xrefs 2008-07-15 20:41:46 +00:00
Michael Kerrisk 4e3b3468e4 wfix 2008-07-15 20:36:58 +00:00
Michael Kerrisk 520f92e735 spfix 2008-07-15 20:35:22 +00:00
Michael Kerrisk 2b21301b01 remove section number from self-ref 2008-07-15 20:10:02 +00:00
Michael Kerrisk 44a2c3286c Even when the CONFORMING TO section is just a list of standards, 
they should be terminated by a period.
 2008-07-15 13:39:17 +00:00
Michael Kerrisk efcd957a99 tstamp 2008-07-14 21:18:06 +00:00
Michael Kerrisk 485eb4ad7a Clarify "zero timeout" case. 2008-07-14 21:17:23 +00:00
Michael Kerrisk 3787794c31 Added .\" comment with pointer to RT wiki page. 2008-07-14 18:50:30 +00:00
Michael Kerrisk f0c34053bc Put SEE ALSO section into alphabetical order. 2008-07-14 15:52:21 +00:00
Michael Kerrisk f655694b5e add FIXME 2008-07-14 13:49:01 +00:00
Michael Kerrisk 6eb4bccc16 Noted which flags appered in Linux 2.2. 2008-07-14 05:26:06 +00:00
Michael Kerrisk 64aae2b17b Reword RETURN VALUE text. 2008-07-12 11:11:58 +00:00
Michael Kerrisk aae1ff184d Fix error in, and reword, RETURN VALUE text. 2008-07-12 11:11:42 +00:00
Michael Kerrisk 84811e86e2 wfix 2008-07-12 11:01:09 +00:00
Michael Kerrisk 7a81055256 Update copyright notice. 2008-07-11 11:25:06 +00:00
Michael Kerrisk 98e1ece326 Rewrote and expnaded discussion of portability. 2008-07-11 11:16:14 +00:00
Michael Kerrisk 49b7166902 Minor rewording w.r.t. use of the term "parameter". 2008-07-10 20:56:42 +00:00
Michael Kerrisk c4bb193f3c s/parameter/argument/ when talking about the things given 
to a function call, for consistency with majority usage.
 2008-07-10 20:53:08 +00:00
Michael Kerrisk c126cfd6b6 Minor rewording w.r.t. use of the term "parameter". 2008-07-10 20:10:28 +00:00
Michael Kerrisk 74aace8a7f Small wording fixes -- express <= and >= in words when in running text. 2008-07-09 19:38:19 +00:00
Michael Kerrisk 4f9f83f047 ffix 2008-07-09 15:40:36 +00:00
Michael Kerrisk 8ee190da4a s/UNIX/Unix/, when not used as part of a trademark, 
for consistency with majority usage in pages.
 2008-07-09 14:17:06 +00:00
Michael Kerrisk 2914a14d30 Removed trailing white space at end of lines 2008-07-09 13:55:24 +00:00
Michael Kerrisk 8ab8b43f0e Document PR_CAPBSET_READ and PR_CAPBSET_DROP. 
Document PR_GET_TSC and PR_SET_TSC.
Document PR_SET_SECCOMP and PR_GET_SECCOMP.
PR_SET_KEEPCAPS and PR_GET_KEEPCAPS operate on a per-thread
setting, not a per-process setting.
Clarify fork(2) details for PR_SET_PDEATHSIG.
Add description of PR_SET_SECUREBITS and PR_GET_SECUREBITS,
as well as pointer to further info in capabilities(7).
PR_GET_ENDIAN returns endianness info in location pointed to by
arg2 (not as function result, as was implied by previous text).
Expand description of PR_SET_NAME and PR_GET_NAME.
RETURN VALUE: bring up to date for various options.
Various improvements in ERRORS.
Note that PR_SET_TIMING setting of PR_TIMING_TIMESTAMP is not
currently implemented.
Minor changes:
* Clarify wording for PR_GET_UNALIGN, PR_GET_FPEMU, and PR_GET_FPEXC.
* Some reformatting of kernel version information.
* Reorder PR_GET_ENDIAN and PR_SET_ENDIAN entries.
 2008-07-09 11:53:48 +00:00
Michael Kerrisk 94ce95ef07 Document RUSAGE_THREAD, new in 2.6.26. 
Improve description of RUSAGE_CHILDREN.
Add pointer to /proc/PID/stat in proc(5).
Other minor clean-ups.
 2008-07-09 11:42:02 +00:00
Michael Kerrisk 949892a7fe Update in line with addition of file capabilities and 
64-bit capability sets in kernel 2.6.2[45].
 2008-07-09 11:38:16 +00:00
Michael Kerrisk 33fc47716e Since Linux 2.6.26, MS_RDONLY honors bind mounts. 2008-07-09 11:37:44 +00:00
Michael Kerrisk 2837268c9d Updated FIXME. 2008-07-08 19:25:37 +00:00
Michael Kerrisk d3df61c415 Update type used for cpusetsize argument in SYNOPSIS. 2008-07-08 18:22:31 +00:00
Michael Kerrisk ab04533a88 ffix 2008-07-08 14:36:09 +00:00
Michael Kerrisk bf5a72471e Added "Copyright" string to lines that had "([Cc])" for copyright. 2008-07-08 14:32:54 +00:00
Michael Kerrisk f37855d179 Add "Copyright" word to copyright notices 2008-07-08 14:21:20 +00:00
Michael Kerrisk 5e5c87978d tfix 2008-07-08 11:56:30 +00:00
Michael Kerrisk d22faa3469 Since Linux 2.6.25, CAP_SYS_ADMIN is longer required to set 
a low priority (IOPRIO_CLASS_IDLE).
 2008-07-08 10:12:21 +00:00
Michael Kerrisk 4aeb366b72 Add "Link with -lrt" to SYNOPSIS. 2008-07-08 08:58:06 +00:00
Michael Kerrisk d292d0f75e tfix 2008-07-08 08:39:50 +00:00
Michael Kerrisk 018991f6c4 Updated .\" 2008-07-08 07:27:14 +00:00
Michael Kerrisk ec774e61b9 Fix 2 * version number typo for MAX_SWAPFILES discussion: 
s/2.6.10/2.4.10/
 2008-07-07 12:10:55 +00:00
Michael Kerrisk c810983b11 Document si_overrun and si_tid fields of siginfo structure. 
Add some text for si_trapno field.
The si_errno field is *generally* unused.
Put descriptions of SA_* constants in alphabetical order.
 2008-07-07 09:17:21 +00:00
Michael Kerrisk d0fe4db73c Modify description of ssi_trapno field. 2008-07-07 08:46:23 +00:00
Michael Kerrisk c17a5c8b30 Removed trailing white space at end of lines 2008-07-07 07:46:36 +00:00
Michael Kerrisk 76e533c419 Add ref to signal(7) under EINTR error. 2008-07-07 05:24:15 +00:00
Michael Kerrisk 6602d44be1 Add reference to signal(7) for EINTR error. 2008-07-07 04:40:49 +00:00
Michael Kerrisk 3d54a9102a Wrapped long source lines 2008-07-06 15:10:32 +00:00
Michael Kerrisk 34e8ac037a wrap long source lines / ffix 2008-07-06 14:54:26 +00:00
Michael Kerrisk 8587f5c022 ffix + tfix 2008-07-06 14:26:07 +00:00
Michael Kerrisk 40d5cf23dd Updated FIXME 2008-07-04 21:10:31 +00:00
Michael Kerrisk 3ade1aa962 ERRORS: Added EINTR error. 
A few minor rewordings.
 2008-07-04 16:21:39 +00:00
Michael Kerrisk 01538d0d51 ERRORS: Added reference to signal(7) in dicussion of EINTR. 2008-07-04 15:50:36 +00:00
Michael Kerrisk f96bf6e9a3 tstamp 2008-07-04 15:45:55 +00:00
Michael Kerrisk e51412ea9e ERRORS: Add EINTR error 2008-07-04 15:44:19 +00:00
Michael Kerrisk 359f6e5e02 ERRORS: Add EINTR error 2008-07-04 15:40:42 +00:00
Michael Kerrisk 00b7d497e3 small wording fix 2008-07-04 15:23:23 +00:00
Michael Kerrisk bbd7e60a1b Note that SA_NOCLDSTOP is only meaningful if establishing a 
handler for SIGCHLD.
Describe POSIX specification, and Linux semantics for
SA_NOCLDWAIT when establishing a handler for SIGCHLD.
Add pointer under SA_RESTART to new text in signal(7)
describing system call restarting.
Other minor edits.
 2008-07-04 11:26:27 +00:00
Michael Kerrisk 21399189b4 Remove statement that WUNTRACED and WCONTINUED only have effect 
if SA_NOCLDSTOP has not been set for SIGCHLD.  That's not true.
 2008-07-04 10:31:50 +00:00
Michael Kerrisk 367fe71f1f tweak 2008-07-03 19:53:25 +00:00
Michael Kerrisk e91751c96b wfix, alphabetize SEE ALSO 2008-07-03 15:25:03 +00:00
Michael Kerrisk 59280ec051 tweaks 2008-07-03 12:29:17 +00:00
Michael Kerrisk 830cdc8b69 tweaks 2008-07-03 12:23:52 +00:00
Michael Kerrisk 90fe01c523 tweaks 2008-07-03 12:22:43 +00:00
Michael Kerrisk fa23e0232e SEE ALSO: Add getcpu(2). 2008-07-03 12:20:42 +00:00
Michael Kerrisk 3ee953ef7d wfix 2008-07-03 11:35:54 +00:00
Michael Kerrisk 80997bc33c Documents getcpu() system call, introduced in 2.6.19. 2008-07-03 11:31:29 +00:00
Michael Kerrisk 00ac6ce430 Removed trailing white space at end of lines 2008-07-02 13:43:42 +00:00
Michael Kerrisk 7c85aa6ba5 SEE ALSO: Add sigwait(3). 2008-07-02 13:30:54 +00:00
Michael Kerrisk 124fa3b75a Describe behavior when multiple threads are blocked in 
sigwaitinfo()/sigtimedwait().
 2008-07-02 13:29:00 +00:00
Michael Kerrisk 65af053c1b wfix 2008-07-02 13:00:16 +00:00
Michael Kerrisk 6c74a96694 wfix 2008-07-02 11:58:38 +00:00
Michael Kerrisk f93af9c668 SEE ALSO: add shm_overview(7). 2008-07-02 05:01:23 +00:00
Michael Kerrisk 0425de01c7 s/ / / 2008-07-01 14:15:13 +00:00
Michael Kerrisk d03d9a05b3 Added FIXME. 2008-06-30 08:59:04 +00:00
Michael Kerrisk 6387216bb2 Wrap lines at sentence breaks. 2008-06-28 04:57:20 +00:00
Michael Kerrisk 0678a1d4d1 Added a bit more detail on what sigreturn() actually does. 2008-06-27 15:51:26 +00:00
Michael Kerrisk 02afffe0fb Documents clock_nanosleep(2). 2008-06-27 13:16:40 +00:00
Michael Kerrisk 1b4cf8f4c7 wfix 2008-06-27 12:21:32 +00:00
Michael Kerrisk 41dcd05490 Remove superfluous text from RETURN VALUE. 2008-06-27 12:12:07 +00:00
Michael Kerrisk 4ca71d176e wfix 2008-06-27 12:10:15 +00:00
Michael Kerrisk bb5c8705d2 wfix 2008-06-27 12:07:36 +00:00
Michael Kerrisk abb02d5e20 spfix 2008-06-27 11:09:14 +00:00
Michael Kerrisk ddaec46d7f s/host name/hostname/ 2008-06-27 03:37:56 +00:00
Michael Kerrisk ae4a72b7b2 Remove orphaned formatting macros. 2008-06-26 13:39:26 +00:00
Michael Kerrisk b818c6776e SEE ALSO: Add symlink(7). 2008-06-26 13:35:02 +00:00
Michael Kerrisk 80d26cefad ffix 2008-06-26 13:28:19 +00:00
Michael Kerrisk 5b8dbfd4d0 ffixes 2008-06-26 13:23:48 +00:00
Michael Kerrisk cd60dedde9 Removed trailing white space at end of lines 2008-06-25 15:32:01 +00:00
Michael Kerrisk 6abd35c3d2 tstamp 2008-06-24 14:57:45 +00:00
Michael Kerrisk 8c54c588e3 wfix 2008-06-24 12:42:33 +00:00
Michael Kerrisk 0102b0ab21 Noted that POSIX.1 leaves interactions with alarm(), sleep(), 
and usleep() unspecified.
Linux 2.6.16 removed the MAX_SEC_IN_JIFFIES ceiling on timer values.
Other minor changes.
 2008-06-23 10:28:23 +00:00
Michael Kerrisk 8964c1a227 spfix 2008-06-23 09:56:09 +00:00
Michael Kerrisk b0040075af Remove crufty discussion of HZ, and replace with a pointer to time(7). 
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=485636
Replace mentions of "process' by "thread".
NOTES: describe case where clock_nanosleep() can be preferable.
NOTES: describe CLOCK_REALTIME versus CLOCK_NANOSLEEP
See also http://thread.gmane.org/gmane.linux.kernel/696854/
"nanosleep() uses CLOCK_MONOTONIC, should be CLOCK_REALTIME?"
Some minor rewrites.
 2008-06-23 09:41:18 +00:00
Michael Kerrisk 1d7c4d16b2 SEE ALSO: add time(7) 2008-06-23 08:48:25 +00:00
Michael Kerrisk 364008baa4 tfix 2008-06-23 06:00:09 +00:00
Michael Kerrisk a64c6ae1fb s/AIO request blocks/AIO control blocks/ 2008-09-18 12:30:46 +00:00
Michael Kerrisk 84db13a46f Document ENOSYS error, which can occur if kernel was built 
without CONFIG_PRINTK.
 2008-09-18 12:30:45 +00:00
Michael Kerrisk bddd0b2edc Alphabetize SEE ALSO. 2008-09-18 12:30:44 +00:00
Michael Kerrisk 8846324af9 Clarify description of 'times' array for utrimes(). 2008-09-18 12:30:41 +00:00
Michael Kerrisk 61792fc66b ffix 2008-09-18 12:30:41 +00:00
Michael Kerrisk 7c40de088e wfix 2008-09-18 12:30:37 +00:00
Michael Kerrisk 24d2f49a4f Describe the unconventional error return provided by the wrapper 
function in libaio (and contrast with behavior if the system call
is invoked via syscall(2)).
 2008-06-18 20:24:08 +00:00