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

586 Commits

Author SHA1 Message Date
Michael Kerrisk d5346bba6a Added FIXME. 2006-04-03 01:35:54 +00:00
Michael Kerrisk 1c511da218 Updated FIXME. 2006-04-03 01:35:31 +00:00
Michael Kerrisk 7080c286cd Removed a misleading cross-ref to socket.2. 2006-03-31 22:58:00 +00:00
Michael Kerrisk 16c892d319 Documented EINVAL error for 'len' < 0. 2006-03-31 22:12:10 +00:00
Michael Kerrisk 00d7bbcfbf Expanded discussion of mandatory locking. 2006-03-31 21:14:41 +00:00
Michael Kerrisk db28bfac79 Clarified discussion of file types affected by O_NONBLOCK. 2006-03-31 21:12:45 +00:00
Michael Kerrisk e1a9bc1bc7 Added SEE ALSO entry referring to new core.5 page 2006-03-31 07:10:17 +00:00
Michael Kerrisk 898d60e1c6 Updated FIXME 2006-03-30 06:03:50 +00:00
Michael Kerrisk 4d42c5c3ee Fix broken link 2006-03-26 12:58:24 +00:00
Michael Kerrisk 217b389ac5 Removed FIXME. 2006-03-25 21:29:31 +00:00
Michael Kerrisk e63ad01dce Wrapped long lines (no content changes). 2006-03-25 21:28:28 +00:00
Michael Kerrisk 4b9d4c1ac5 Added FIXME 2006-03-25 21:07:31 +00:00
Michael Kerrisk 1dd97b0c2d Added FIXME 2006-03-25 20:58:01 +00:00
Michael Kerrisk f675ea3792 Add SEE ALSO pointing to the new sem_overview.7 page, which gives an 
overview of the POSIX semaphores AP.
 2006-03-25 20:50:40 +00:00
Michael Kerrisk 7f2e3e4e64 Edited FIXME 2006-03-23 22:00:34 +00:00
Michael Kerrisk 44b35ee067 Chuck Ebbert, with assistance from Daniel Jacobowitz, 
Paolo (Blaisorblade) Giarrusso, and Charles P. Wright;
after a suggestion from Heiko Carstens.
    Document the following ptrace requests: 
        PTRACE_SETOPTIONS (2.4.6)
            plus associated flags:
                PTRACE_O_TRACESYSGOOD (2.4.6)
                PTRACE_O_TRACEFORK (2.5.46)
                PTRACE_O_TRACEVFORK (2.5.46)
                PTRACE_O_TRACECLONE (2.5.46)
                PTRACE_O_TRACEEXEC (2.5.46)
                PTRACE_O_TRACEVFORKDONE (2.5.60)
                PTRACE_O_TRACEEXIT (2.5.60)
        PTRACE_SETSIGINFO (2.3.99-pre6)
        PTRACE_GETSIGINFO (2.3.99-pre6)
        PTRACE_GETEVENTMSG (2.5.46)
        PTRACE_SYSEMU (since Linux 2.6.14)
        PTRACE_SYSEMU_SINGLESTEP (since Linux 2.6.14)
 2006-03-23 22:00:08 +00:00
Michael Kerrisk 218e46f883 Small FIXME formatting fixes 2006-03-23 02:13:08 +00:00
Michael Kerrisk 92c37d8cb0 Modified to document new SCHED_BATCH policy, new in kernel 2.6.16. 
Text describing SCHED_BATCH was added to sched_setscheduler.2,
and was drawn in part from Ingo Molnar's description in the
message containing the patch that implemented this policy.

Various other minor rewordings and formatting fixes.
 2006-03-23 01:06:07 +00:00
Michael Kerrisk ed812a69b4 ffix 2006-03-22 06:25:31 +00:00
Michael Kerrisk 8107e4b78d Clarified the description of MREMAP_FIXED and restructured 
the text to reflect the fact that this flag is exposed
by glibc since version 2.4.
 2006-03-22 06:21:42 +00:00
Michael Kerrisk f4ec7624c9 Added FIXME. 2006-03-22 05:33:42 +00:00
Michael Kerrisk 29514e2da9 Removed old FIXME 2006-03-22 05:22:42 +00:00
Michael Kerrisk 2a5980bb9e MPOL_MF_MOVE_ALL requires CAP_SYS_NICE not CAP_SYS_RESOURCE. 2006-03-21 20:56:33 +00:00
Michael Kerrisk 7d0cab0e22 ffix 2006-03-21 10:59:30 +00:00
Michael Kerrisk 3d5f459509 Various rewordings and updates to 2.6.16 reality. 2006-03-21 05:42:30 +00:00
Michael Kerrisk 5cc01e9c88 Document unshare(2), new in 2.6.16. 2006-03-20 21:29:29 +00:00
Michael Kerrisk 785e717bc1 We won't add unshare(2) just yet, so remove SEE ALSO entries for now. 2006-03-20 06:38:19 +00:00
Michael Kerrisk f4cb7bd37e Not yet ready for 2.26. 2006-03-20 06:33:14 +00:00
Michael Kerrisk c3742154c1 Minor changes 2006-03-20 06:32:39 +00:00
Michael Kerrisk 777f5a9ef7 Updated FIXMEs 2006-03-20 04:46:28 +00:00
Michael Kerrisk 347e325b6a Updated FIXME 2006-03-20 04:31:20 +00:00
Michael Kerrisk cd31a0d631 spfix 2006-03-20 00:52:31 +00:00
Michael Kerrisk c8a55a3d73 spfix 2006-03-20 00:19:11 +00:00
Michael Kerrisk 22ca838f59 ppoll() proto needs _GNU_SOURCE 2006-03-19 23:37:17 +00:00
Michael Kerrisk 9b81374196 pselect() prototype needs "#define _XOPEN_SOURCE 600". 2006-03-19 23:32:26 +00:00
Michael Kerrisk 16718a1c3d Added comment in SYNOPSIS to note that syscall(2) may be 
preferable over _syscallN (see intro(2)).
 2006-03-16 00:50:08 +00:00
Michael Kerrisk cb2431bf34 ffix 2006-03-16 00:28:09 +00:00
Michael Kerrisk e755a587cd Further changes for ppoll.2. 2006-03-16 00:06:34 +00:00
Michael Kerrisk 424a895034 shm_open() is in section 3, not 2. 2006-03-15 22:26:36 +00:00
Michael Kerrisk 2f11acf57e Minor changes 2006-03-15 10:27:09 +00:00
Michael Kerrisk 123a769478 Added MPOL_MF_MOVE and MPOL_MF_MOVE_ALL descriptions, 
from numactl-0.9.2 man page.
Plus a few other smaller fixes.
 2006-03-15 10:26:29 +00:00
Michael Kerrisk 9b54d4fa8b Modified wording referring that refers to raw(8) to 
indicate that this interface is deprecated.
 2006-03-12 21:18:47 +00:00
Michael Kerrisk 5b650f4770 New link to poll.2 2006-03-12 01:45:49 +00:00
Michael Kerrisk af800319ee Added FIXME for SCHED_BATCH 2006-03-12 01:39:10 +00:00
Michael Kerrisk e1dda04bf6 Added FIXME for new MADV_* constants in 2.6.16-rc6 2006-03-12 01:36:27 +00:00
Michael Kerrisk 7bbd888bbb Added a little extra text to clarify EISDIR vs EPERM. 2006-03-11 23:33:50 +00:00
Michael Kerrisk ea4adf4ba9 Added text to note that although POSIX says msg_controllen 
should be socklen_t, glibc actually uses size_t.
Various formatting fixes.
 2006-03-12 19:09:15 +00:00
Michael Kerrisk d02aa9bc8c Fixes for pselect() description. 2006-03-12 03:09:50 +00:00
Michael Kerrisk 19017a1626 ffix 2006-03-12 03:09:28 +00:00
Michael Kerrisk 26a9dd2f79 Fix SYNOPSIS formatting 2006-03-08 02:48:53 +00:00
Michael Kerrisk 77f00d75f1 Noted pselect() treatment of timeout. 2006-03-07 22:38:11 +00:00
Michael Kerrisk cc9befa9ac Updated to reflect the fact that pselect() has been implemented 
in the kernel in 2.6.16; various other minor wording changes.
 2006-03-07 02:25:37 +00:00
Michael Kerrisk 9d7f3355ef Added SEE ALSO pointing to new fexecve.3. 2006-03-07 02:20:16 +00:00
Michael Kerrisk 7fdcdf23b2 ffix 2006-03-06 04:40:24 +00:00
Michael Kerrisk 51fa356ef2 openat(2) is new in 2.6.16. 2006-03-06 04:36:54 +00:00
Michael Kerrisk 28c54d4593 Added SEE ALSO pointing to new openat.2. 
Split out part of the RETURN VALUE text into separate NOTES section.
 2006-03-06 04:36:33 +00:00
Michael Kerrisk a9b305d61e Added SEE ALSO reference to mq_overview.7. 2006-03-05 20:58:40 +00:00
Michael Kerrisk 0f75fe20df Updated FIXME 2006-03-05 20:41:49 +00:00
Michael Kerrisk 51f930362d Updated FIXME 2006-03-05 20:39:53 +00:00
Michael Kerrisk b0c93735cd Removed outdated FIXME 2006-03-05 20:34:30 +00:00
Michael Kerrisk 212dd19f6e Updated FIXMEs 2006-03-05 20:29:47 +00:00
Michael Kerrisk d63e9a260b Added SEE ALSO for new unshare.2 2006-03-05 20:27:43 +00:00
Michael Kerrisk ac5d787d2a Changed FIXME formatting 2006-03-05 20:19:42 +00:00
Michael Kerrisk a19b251fd5 Minor wording changes 2006-03-05 20:19:17 +00:00
Michael Kerrisk 4558058c03 new page describing unshare(2). 2006-03-05 19:11:18 +00:00
Michael Kerrisk e91fec0909 Removed FIXME for IN_ONESHOT, since the bug is now confirmed 
fixed in 2.6.16-rc5
 2006-03-04 03:05:35 +00:00
Michael Kerrisk 60e94b7cef Added FIXME 2006-03-02 05:04:48 +00:00
Michael Kerrisk 248eff92eb Added FIXME 2006-03-02 04:12:55 +00:00
Michael Kerrisk 2374c17872 Add a case to the EINVAL error text. 
Various minor wording fixes
 2006-03-02 00:51:08 +00:00
Michael Kerrisk efb2cf158b wfix 2006-03-01 04:09:19 +00:00
Michael Kerrisk 1f0ea6d8b7 Added SEE ALSO referring to new posix_fallocate.3. 2006-03-01 03:34:07 +00:00
Michael Kerrisk f5441d2af5 Added "#define _XOPEN_SOURCE 600" to prototype. 2006-03-01 03:29:07 +00:00
Michael Kerrisk 82a060204c minor punctuation clarification 2006-02-16 04:55:18 +00:00
Michael Kerrisk 29546c248f Comented out crufty text describing EINVAL error 
for the now obsolete CLONE_DETACHED flag.
Under CLONE_SIGHAND, noted that 'flags' must also include
CLONE_VM if CLONE_SIGHAND is specified.
 2006-02-16 04:00:49 +00:00
Michael Kerrisk 2ccb99ea53 Remove duplicate CLONE_STOPPED text. 2006-02-16 03:17:12 +00:00
Michael Kerrisk efa25b17c6 Modify formatting of copyright notices 2006-02-15 23:19:08 +00:00
Michael Kerrisk 1130df606b Amend copyright notices, in particular those where I had significant 
authorship.
 2006-02-15 23:15:29 +00:00
Michael Kerrisk 2486cacf6d ffix 2006-02-14 18:16:45 +00:00
Michael Kerrisk 3adb464791 tfix 2006-02-13 22:46:01 +00:00
Michael Kerrisk 2d7195b8fb Change "path name" to "pathname" 2006-02-12 22:19:08 +00:00
Michael Kerrisk 2c5f10893e Change "file name" to "filename" 2006-02-12 22:15:41 +00:00
Michael Kerrisk 069c98bab0 Minor wording fix. 2006-02-12 01:54:40 +00:00
Michael Kerrisk 435827ff1d tfix 2006-02-11 20:54:15 +00:00
Michael Kerrisk 360c175e1a Documented the EAGAIN error for msgrcv(). 2006-02-11 20:53:04 +00:00
Michael Kerrisk 0483625f84 ffix 2006-02-11 20:16:44 +00:00
Michael Kerrisk 8548d8e240 Under ERRORS: Separate out EAGAIN error for locking mmaped files. 2006-02-10 20:29:38 +00:00
Michael Kerrisk c533af9d27 Reformatted FIXMEs 2006-02-10 18:46:42 +00:00
Michael Kerrisk dcec8eb551 Formatting fixes 2006-02-09 20:29:51 +00:00
Michael Kerrisk 9ff08aad91 Formatting fixes 2006-02-09 20:24:53 +00:00
Michael Kerrisk c4d4162c93 Modified versions of old GPL pages on kernel modules API. 2006-02-09 19:32:36 +00:00
Michael Kerrisk 0b3189d89a minor wording change 2006-02-08 19:36:09 +00:00
Michael Kerrisk ad31978e25 Minor changes after suggestions from Robert Love. 2006-02-08 19:16:12 +00:00
Michael Kerrisk 92057f4dbc Updated FIXMEs 2006-02-08 09:44:13 +00:00
Michael Kerrisk 64c7bb8a52 Add SEE ALSO for pwrite(2). 2006-02-08 04:18:44 +00:00
Michael Kerrisk 6188db2db4 Add SEE ALSO for pread(2). 
As per Debian bug 351873.
 2006-02-08 04:18:25 +00:00
Michael Kerrisk 4d2b74dded New pages for inotify API 2006-02-08 04:13:22 +00:00
Michael Kerrisk 314093c9cd New pages on NUMA memory allocation policy API. 2006-02-08 03:20:44 +00:00
Michael Kerrisk 1363cf9511 Added xref under dnotify description to inotify.7. 2006-02-06 22:43:15 +00:00
Michael Kerrisk 083ddbc2c7 Added BUGS txt on interaction between MCL_FUTURE and RLIMIT_MEMLOCK. 
See the following LKML thread:
http://marc.theaimsgroup.com/?l=linux-kernel&m=113801392825023&w=2
"Rationale for RLIMIT_MEMLOCK"
 2006-02-03 20:56:21 +00:00
Michael Kerrisk cbea10b39a Small wording change under NOTES to clarify 
what happends when a process sends a signal to itself.
See Debian bug 350236.
 2006-02-03 03:46:54 +00:00
Michael Kerrisk a5a997ca09 On x86, clone() should not be called through vsyscall, 
but directly through "int $0x80".
 2006-02-03 03:32:38 +00:00
Michael Kerrisk 48be114450 Major rewrite. 2006-02-02 19:46:34 +00:00
Michael Kerrisk 21045df8dd Other minor wording changes. 2006-02-02 18:18:55 +00:00
Michael Kerrisk 071dbad970 Added return types to prototypes for FD_SET(), FD_CLR(), 
FD_ZERO, and FD_ISSET().
 2006-02-02 18:15:36 +00:00
Michael Kerrisk 6e0e514c76 Rewrote declaration of 'msgp' to be "void *" in response 
to Debian bug report 350884.
Various other wording fixes.
 2006-02-02 10:47:23 +00:00
Michael Kerrisk 68b93ce208 Small wording changes 2006-02-02 03:25:50 +00:00
Michael Kerrisk bfe9ba6712 Clarify distinction between "file creation flags" and 
"file status flags".
 2006-02-02 03:25:41 +00:00
Michael Kerrisk 74f3f90ba5 Noted that portable applications should specify fd as -1 
when using MAP_ANONYMOUS.
Some rewriting of description of MAP_ANONYMOUS.
 2006-02-01 19:19:59 +00:00
Michael Kerrisk c72dada18f tfix 2006-02-01 18:39:15 +00:00
Michael Kerrisk 04d6ea6b8a Noted that waitid() does not set infop->si_uid field on 
most other implementations.
 2006-01-23 06:41:46 +00:00
Michael Kerrisk d6c1d7e0b5 New link to sigreturn.2 2006-01-17 21:45:31 +00:00
Michael Kerrisk cd84309e6b new link to sigsuspend.2 2006-01-17 21:45:04 +00:00
Michael Kerrisk 736e551b25 tfix 2006-01-16 19:40:20 +00:00
Michael Kerrisk ed645f8762 Clarify relationship between mmap2(2) and mmap64(3) 
A few other small rewordings.
 2006-01-15 20:47:36 +00:00
Michael Kerrisk b50582ebfa Added BUG noting that O_ASYNC can't be enabled via 
open(): fcntl() must be used for this purpose.
 2006-01-15 04:39:23 +00:00
Michael Kerrisk 6e126ed614 Formatting fix 2006-01-14 17:09:59 +00:00
Michael Kerrisk 964d4d9c5c Format fix 2006-01-14 17:05:44 +00:00
Michael Kerrisk e75529df3b Noted bug that could wrongly cause EPERM in unprivileged 
capset() with 'pid' field == getpid().
 2006-01-14 03:25:01 +00:00
Michael Kerrisk 80b50848d0 Replace "SYSV" by "System V" 2006-01-13 09:44:53 +00:00
Michael Kerrisk aa651b3950 Replace "SysV" by "System V" 2006-01-13 09:39:55 +00:00
Michael Kerrisk 62d4f1bd38 Relocate misplaced discussion of MSG_DONTWAIT. 2006-01-13 07:56:23 +00:00
Michael Kerrisk 28d88c1751 Global change to many pages... 
Various pages use inconsistent terms for 'null byte' (which
is the C99/SUSv3 term for the '\0' character).
To rectify this the following changes were made in these pages:

Replace 'zero byte' with 'null byte'.
Replace 'null character' with 'null byte'.
Replace 'nulls' with 'null bytes'.
Replace 'NUL-terminated' by 'null-terminated'.
Replace 'NUL' by 'null byte'.
Replace 'terminating NUL' by 'terminating null byte'.
Replace 'final NUL' by 'terminating null byte'.
Replace 'NUL character' by 'null byte'.
 2006-01-13 02:09:44 +00:00
Michael Kerrisk 16055a24f3 Added GLIBC NOTES describing operation of glibc's 
gethostname() wrapper function.
 2006-01-12 21:53:50 +00:00
Michael Kerrisk fee44d9bff Noted that EPOLLONESHOT was added in 2.6.2 2006-01-04 11:03:07 +00:00
Michael Kerrisk dc81d42e12 Updated FIXME 2006-01-04 10:25:08 +00:00
Michael Kerrisk 34fa629837 Added some text to explain the usual scenario in which 
sigaltstack() is employed.
 2006-01-01 07:02:49 +00:00
Michael Kerrisk 5059acc358 Remove text under EINVAL error: "This may change in the future: 
see linux/unix/sock.c for details."  This behaviour has been
unchanged for a long time, and seems unlikely to change.

Add EADDRINUSE to errors.
 2005-12-19 10:46:01 +00:00
Michael Kerrisk 1df419f2b7 Add cmsg.3 to SEE ALSO. 2005-12-19 09:16:57 +00:00
Michael Kerrisk 69c4c18902 updated FIXME 2005-12-14 16:46:05 +00:00
Michael Kerrisk 512c311c5e Put 'flags' list in alphabetical order. 2005-12-14 16:44:39 +00:00
Michael Kerrisk a28ed21cec Put flags list in alphabetcal order 2005-12-14 16:41:14 +00:00
Michael Kerrisk 145ff0249e Added cross-reference from discussion of MSG_MORE to UDP_CORK in udp(7). 2005-12-14 16:30:49 +00:00
Michael Kerrisk 711672c037 ffix 2005-12-14 11:40:27 +00:00
Michael Kerrisk ffa01655e5 Added mention of AF_INET6 address family. 
Added discussion of sockaddr structure and an example in the Unix domain.
 2005-12-14 11:37:28 +00:00
Michael Kerrisk cde9f44b19 Added comment noting that fork.2 refers to the example program on this 
page.
 2005-12-12 09:19:46 +00:00
Michael Kerrisk d7b0e083ce Added xref to pipe.2 for another example of use of fork(). 2005-12-12 09:18:35 +00:00
Michael Kerrisk 8440a332f7 Formatting fix 2005-12-09 16:37:46 +00:00
Michael Kerrisk 1fa343d1ab Added example program demonstrating use of fork() and waitpid(). 2005-12-09 16:37:05 +00:00
Michael Kerrisk 2f59b1bc3c Added pointer to example of fork() in wait.2. 2005-12-09 16:36:12 +00:00
Michael Kerrisk 15740f8afd Added example program. 2005-12-09 14:24:10 +00:00
Michael Kerrisk be37f2c558 Added SEE ALSO for new pipe.7 page 2005-12-08 18:57:25 +00:00
Michael Kerrisk eeabb34e30 The -1 error return of shmat() should be cast "(void *)". 2005-12-02 08:09:44 +00:00
Michael Kerrisk c1164764b0 Added NOTES about INFTIM contant provided on some other implementations. 2005-12-01 16:03:36 +00:00
Michael Kerrisk f6179c2fbd Formatting fix 2005-12-01 14:05:11 +00:00
Michael Kerrisk a14245c218 Add as new link to vm86.2 2005-11-30 15:24:52 +00:00
Michael Kerrisk 30ecea55d4 Changed SEE ALSO to reflect movement of sig* pages between sections. 2005-11-29 15:01:54 +00:00
Michael Kerrisk e3f86a1c91 Moved to section 3. 2005-11-29 14:58:23 +00:00
Michael Kerrisk c7dd2834b5 These pages will be replaced by a new, better sigvec.3. 2005-11-29 14:46:00 +00:00
Michael Kerrisk c625361fea Noted that si_signo is unused on Linux. 2005-11-28 16:17:54 +00:00
Michael Kerrisk 81551079f0 Added BUGS noting wrapper function problem that existed 
in glibc versions <= 2.2.1.
 2005-11-21 15:05:20 +00:00
Michael Kerrisk 55430ae964 Added text describing the 2.6.[0-7] EPERM bug that occurred 
when sending signals to a process group.
 2005-11-21 13:37:53 +00:00
Michael Kerrisk b2216ffee6 Clarified parts of the discussion of file leases, 
noting effect of open(O_NONBLOCK), interruption
by signal handler, or termination by signal in lease breaker.
In response to Debian bug 339037.
 2005-11-17 14:56:41 +00:00
Michael Kerrisk d3952311d4 Add EWOULDBLOCK error for file leases. 2005-11-17 14:55:31 +00:00
Michael Kerrisk 246a500fe8 Added LINUX NOTES describing nanosecond timestamps. 2005-11-17 13:36:31 +00:00
Michael Kerrisk d636589fde Added FIXME 2005-11-14 13:24:17 +00:00
Michael Kerrisk 3b3ce330e7 Added FIXME 2005-11-14 11:39:08 +00:00
Michael Kerrisk 4989c2f337 Improved description of E2BIG error: it relates to the sum 
of the bytes in both environment and argument list.
 2005-11-08 15:25:07 +00:00
Michael Kerrisk 64f828d585 Updated discussion about lack of prototype in glibc. 2005-11-03 14:14:09 +00:00
Michael Kerrisk bd12ab88af Formatting fixes 2005-11-03 12:47:27 +00:00
Michael Kerrisk 8478ee0279 Formatting fixes 2005-11-02 13:55:25 +00:00
Michael Kerrisk 836f07c1c3 Change things like "NULL-terminated string" to "null-terminated string" 2005-11-02 11:55:24 +00:00
Michael Kerrisk 31e9a9ec99 Change itacised function names and page xrefs to bold 2005-11-02 11:34:24 +00:00
Michael Kerrisk 9961bb4f07 Formatting fix 2005-11-02 11:06:40 +00:00
Michael Kerrisk 197889d00b Formatting fixes 2005-11-02 10:53:26 +00:00
Michael Kerrisk ac7a498150 Added some comments 2005-10-31 09:47:01 +00:00
Michael Kerrisk 6a0f26867c Reworked (cut down) discussion of capabilities, moving part of 
it into capabilities.7
 2005-10-28 17:40:41 +00:00
Michael Kerrisk bb40bc01bd Add text to note that setresuid() always modifies the file 
system UID, and setresgid() likewise always modifies the
file system GID.
 2005-10-28 16:57:37 +00:00
Michael Kerrisk ae050d9ae1 Formatting fixes 2005-10-28 13:40:41 +00:00
Michael Kerrisk 4a04cd9a4d Fix typos 2005-10-28 13:32:01 +00:00
Michael Kerrisk 62efe3ef2d Hello Andries, 
Let us return to path_resolution.2...

> Von: Andries Brouwer <Andries.Brouwer@cwi.nl>
> Betreff: Re: ***UNCHECKED*** man-pages-2.11
> Datum: Mon, 24 Oct 2005 20:43:42 +0200
> 
> On Mon, Oct 24, 2005 at 05:27:56PM +0200, Michael Kerrisk wrote:
> 
> > PS I changed some text in path_rolution.2, where it seems to 
> > me that you made an error.  But I could be wrong -- you 
> > might like to double check it?
> 
> Hmm, I think it was precisely correct and no longer is.
> 
> I see some change in wording that does not actually change anything,
> and the addition of "as well" that may be incorrect.

Let's begin with a diff:

=====
--- man-pages-2.10/man2/path_resolution.2       2005-07-18 18:17:52.000000000 +0200
+++ man-pages-2.11/man2/path_resolution.2       2005-10-24 13:18:13.000000000 +0200
@@ -185,11 +185,13 @@

 Traditional systems do not use capabilities and root (user ID 0) is
 all-powerful. Such systems are presently (2.6.7) handled by giving root
-all capabilities except for CAP_SETPCAP. More precisely, at exec time
-a process gets all capabilities except CAP_SETPCAP and the five capabilities
+all capabilities except for CAP_SETPCAP. More precisely,
+a process gets all capabilities except CAP_SETPCAP
+and the five capabilities
 CAP_CHOWN, CAP_DAC_OVERRIDE, CAP_DAC_READ_SEARCH, CAP_FOWNER, CAP_FSETID,
-in case it has zero effective UID, and it gets these last five capabilities
-in case it has zero fsuid, while all other processes get no capabilities.
+if its effective UID is 0,
+and it gets these last five capabilities if its fsuid is 0 as well,
+while all other processes get no capabilities.

 The CAP_DAC_OVERRIDE capability overrides all permission checking,
 but will only grant execute permission when at least one
====

The main points of change are the following:

1. Removal of discussion of "exec time".

2. Addition of "as well".

I'll start with point 2.  I'm wrong.  I had it in my mind that 
fsuid could only be made 0 if euid was already 0.  But that isn't
true; setfsuid(x) allows us to turn this (somewhat unusual, but
theoretically possible scenario):

Real Eff Saved FS
0    y   y     y

into this (setfsuid() allows us to set the fsuid to any of the R/E/S 
UID values):

Real Eff Saved FS
0    y   y     0

And indeed the process then has the 5 CAP_FS_MASK capabilities,
in its effective set, but none of the others.

I've removed the words "as well".

On to point 1.

I removed "exec time" because it seems misleading.  As far as I can
tell, exec is not directly relevant, except in as much as we exec
a set-user-ID-root program.  The real point is that effective 
capabilities are dropped as a result of changes to the euid and 
fsuid.  Those can happen because we exec a set-user-ID-root program, 
or via manipulations via seteuid(), setfsuid(), and friends.
As such, that change still seems to me to be correct.  But 
perhaps I have still missed something that you were trying to
say.  If so, let me know.

Cheers,

Michael
 2005-10-27 15:33:25 +00:00
Michael Kerrisk 3582e90689 Reworded text around PAGESIZE, noting also that 
sysconf(_SC_PAGESIZE) can be used.
 2005-10-27 11:14:15 +00:00
Michael Kerrisk ed978af23d Added .\" comment about SHMMNI off-by-one error in kernels 2.4.x-2.6.8. 2005-10-26 11:37:47 +00:00
Michael Kerrisk a749f870a8 s/XXX/FIXME/ 2005-10-26 11:27:52 +00:00
Michael Kerrisk f39637fad6 Minor changes 2005-10-26 11:23:22 +00:00
Michael Kerrisk eb57338fe9 Added (brief) description of SHM_HUGETLB. 2005-10-26 10:31:14 +00:00
Michael Kerrisk 75cad98162 Noted that ss_sp is automatically aligned by the kernel. 2005-10-25 15:35:08 +00:00
Michael Kerrisk b270eba946 Added EINVAL error for rlim_cur > rlim_max when calling setrlimit(). 2005-10-24 15:26:31 +00:00
Michael Kerrisk ab2e1a6c34 Repaired discussion of capabilities and file system UID, which 
mistakenly had involved exec() in the discussion.
 2005-10-24 11:18:13 +00:00
Michael Kerrisk 6060319831 formattinf fixes 2005-10-24 09:00:36 +00:00
Michael Kerrisk 1e32103455 Formatting fixes 2005-10-20 15:11:10 +00:00
Michael Kerrisk f87925c6bf Formatting fixes 2005-10-19 16:30:05 +00:00
Michael Kerrisk 4d52e8f81c Formatting fixes 2005-10-19 14:54:31 +00:00
Michael Kerrisk b5cc2ffbaa Formatting fixes 2005-10-19 14:48:35 +00:00
Michael Kerrisk 4a225b7a41 Formatting fixes 2005-10-19 14:16:57 +00:00
Michael Kerrisk a68b4927bf Minor wording fix 2005-10-19 13:54:51 +00:00
Michael Kerrisk d3777ff056 Formatting fix 2005-10-19 13:51:36 +00:00
Michael Kerrisk 35e21ba7ca Formatting fixes 2005-10-19 13:48:50 +00:00
Michael Kerrisk 7eda86b16c Updated FIXME 2005-10-19 13:31:49 +00:00
Michael Kerrisk 3382bd94ff Manual fixes of parentheses formatting 2005-10-19 08:35:30 +00:00
Michael Kerrisk e1d6264d9f Manual fixes for parentheses formatting 2005-10-19 07:29:28 +00:00
Michael Kerrisk 63aa9df02f Automated unformatting of parentheses using unformat_parens.sh 2005-10-19 07:07:02 +00:00
Michael Kerrisk e511ffb6bc Automated addition of parentheses by add_parens_for_own_funcs.sh 2005-10-19 06:54:38 +00:00
Michael Kerrisk a7a0588842 Further improvements to recently changed leases text 2005-10-13 09:30:54 +00:00
Michael Kerrisk 1a6d974a99 Since kernel 2.6.10, a read lease can only be placed on a 
file descriptor that is opened read-only.
See the following LKML thread of Aug 2005
("fcntl(F GETLEASE) semantics??"):
http://marc.theaimsgroup.com/?l=linux-kernel&m=112371777712197&w=2
http://marc.theaimsgroup.com/?l=linux-kernel&m=112374818213000&w=2
http://marc.theaimsgroup.com/?l=linux-kernel&m=112376335305284&w=2
http://marc.theaimsgroup.com/?l=linux-kernel&m=112377294030092&w=2
 2005-10-12 14:54:00 +00:00
Michael Kerrisk 9f8d688afd Added .\" comment pointing out that O_DIRECTORY | O_CREAT causes 
O_DIRECTORY to be ignored
 2005-10-12 10:35:09 +00:00
Michael Kerrisk 4f76dae069 Added description of MREMAP_FIXED and 'new_address' argument under NOTES. 
Revised text of EINVAL error.
 2005-10-11 08:24:39 +00:00
Michael Kerrisk 94604cf710 EINVAL can happen with O_DIRECT 2005-10-10 13:07:32 +00:00
Michael Kerrisk f717467217 s/int/size_t/ for type of 'size' argument (fix from Fedora man-pages-2.07-7 2005-10-04 12:39:34 +00:00
Michael Kerrisk f8ad0aeb4b Added new text for ENOMEM 2005-09-21 15:47:18 +00:00
Michael Kerrisk 314df009da fix version in .TH 2005-09-21 06:28:33 +00:00