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

670 Commits

Author SHA1 Message Date
Michael Kerrisk 39179b3eec wfix 2006-04-21 18:17:12 +00:00
Michael Kerrisk 5e01a1de98 Improve opening para describing purpose of select(). 2006-04-21 10:41:09 +00:00
Michael Kerrisk 50e5322c85 Added SEE ALSO reference to ftm.7 2006-04-21 06:49:34 +00:00
Michael Kerrisk fb961f311e Simplified wording about requirement for _BSD_SOURCE macro. 2006-04-21 06:28:54 +00:00
Michael Kerrisk 2c5e151c7f ipc.7 --> svipc.7 2006-04-21 03:53:43 +00:00
Michael Kerrisk 6319e935b0 Add text noting that contents of newly created segment are zero values. 2006-04-21 02:02:05 +00:00
Michael Kerrisk af5b2ef2cc fifo.4 --> fifo.7 2006-04-21 01:46:04 +00:00
Michael Kerrisk a8bda63671 complex.5 --> complex.7 2006-04-21 01:24:06 +00:00
Michael Kerrisk aa949e2d59 environ.5 --> environ.7 2006-04-21 00:45:46 +00:00
Michael Kerrisk 922436594f ipc.5 --> ipc.7 2006-04-21 00:38:38 +00:00
Michael Kerrisk 2315114c72 epoll.4 is now epoll.7 2006-04-21 00:29:37 +00:00
Michael Kerrisk 22f348ca27 Note more clearly that fd_set args can be NULL; various other minor edits and ffixes 2006-04-20 21:21:42 +00:00
Michael Kerrisk 1c382af469 Point out more explicitly that 'tz' argument should normally be NULL. 
Various other minor edits and formatting fixes.
 2006-04-20 21:07:10 +00:00
Michael Kerrisk 9c1c7397a0 Added NOTE that st_size is always returned as zero for most /proc files. 2006-04-19 20:44:55 +00:00
Michael Kerrisk 601dff4a19 Remove mention of SOCK_RDM from this page, since this socket 
type does not support accept()ing connections.
 2006-04-18 07:39:12 +00:00
Michael Kerrisk f595890250 Updates SEE ALSO 2006-04-06 08:48:43 +00:00
Michael Kerrisk 8f352ee52b new for symlinkat.2. 2006-04-06 08:42:43 +00:00
Michael Kerrisk 16d863a465 new for unlinkat(2). 2006-04-06 08:41:33 +00:00
Michael Kerrisk 552dfd96f4 New for rename(2). 2006-04-06 08:41:21 +00:00
Michael Kerrisk db01a90324 new for linkat(2). 2006-04-06 08:41:08 +00:00
Michael Kerrisk 97c0488f3e Minor changes 2006-04-06 05:19:00 +00:00
Michael Kerrisk 64603adfb7 Substantial rewrite of NOTES; minor changes elsewhere. 2006-04-05 05:43:00 +00:00
Michael Kerrisk 7fe3091da4 Minor changes 2006-04-05 05:42:36 +00:00
Michael Kerrisk 66e46895b9 new page for mknodat(2). 2006-04-05 05:17:23 +00:00
Michael Kerrisk 5b4255672a Added SEE ALSO entry referring to new mknodat.2 2006-04-05 05:14:55 +00:00
Michael Kerrisk 4a929ee119 New page for mkdirat(2). 2006-04-05 04:44:07 +00:00
Michael Kerrisk d2927a1b1e Added SEE ALSO mkdirat(2). 2006-04-05 04:43:40 +00:00
Michael Kerrisk 6d03c00944 Added comment on inconsistent naming of *at() functions. 2006-04-04 19:48:23 +00:00
Michael Kerrisk 6057e7a9fa Added BUGS text on 2.6.x handling of RLIMIT_CPU limit 
of zero seconds.  See
http://marc.theaimsgroup.com/?l=linux-kernel&m=112256338703880&w=2
 2006-04-04 04:12:36 +00:00
Michael Kerrisk 9aad1caae1 Since 2.6.17-rc1, shmdt() gives the error EINVAL in a further 
circumstance: if shmaddr is not aligned on a page boundary.
 2006-04-04 02:59:37 +00:00
Michael Kerrisk cdc9620e3a Remove text saying that specifying invalid flags "is likely 
to cause compatibility problems" since the kernel now
(2.6.17-rc1) contains an explicit check for invalid buts
with a consequent EINVAL error.
 2006-04-03 23:55:40 +00:00
Michael Kerrisk 0c373d0150 Added FIXME. 2006-04-03 23:35:16 +00:00
Michael Kerrisk 70f4032165 removed tabs 2006-04-03 21:25:43 +00:00
Michael Kerrisk 5250b79560 Removed out-of-date FIXME 2006-04-03 20:36:48 +00:00
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
Michael Kerrisk 9eabf77ada fix typo 2005-09-21 06:28:16 +00:00
Michael Kerrisk 614f40af1d Further reorking of RLIMIT_NICE text. 
Noted 2.6.12 change in credentials checking for setpriority().
 2005-09-20 17:45:12 +00:00
Michael Kerrisk cedd678ff7 Further reworking of discussion or RLIMIT_NICE and RLIMIT_RTPRIO 2005-09-20 17:43:58 +00:00
Michael Kerrisk 8ba10b3e91 Added cross-reference to setrlimit(2) for discussion on RLIMIT_NICE. 2005-09-20 17:42:39 +00:00
Michael Kerrisk afdee10dbc Further reworking of text on privileges and RLIMIT_RTPRIO 2005-09-20 14:52:34 +00:00
Michael Kerrisk 6151ea9a91 Noted 2.6.12 off-by-one error for RLIMIT_NICE. 2005-09-20 06:52:49 +00:00
Michael Kerrisk 23b1b9bc40 Uncommented text that I wrote earlier that added mention of RLIMIT_NICE 
and a cross reference to getrlimit.2 under the description of the EACCES 
error.
 2005-09-19 14:57:58 +00:00
Michael Kerrisk a23bf8a396 Uncommented description of RLIMIT_NICE that I wrote earlier 2005-09-19 14:57:05 +00:00
Michael Kerrisk 58d323a7f7 Formatting fix 2005-09-19 12:18:57 +00:00
Michael Kerrisk b327744384 Wording improvements to new dumpable text 2005-09-16 15:36:12 +00:00
Michael Kerrisk c0dc044574 Since kernel 2.6.13 PR_SET_DUMPABLE can also have the value 2. 2005-09-16 14:05:39 +00:00
Michael Kerrisk 1b6145807d fix typo in version number 2005-09-15 12:29:07 +00:00
Michael Kerrisk 1176900f3e formatting fix 2005-09-15 12:06:26 +00:00
Michael Kerrisk 924dca35fe New page created by splitting out from sigaction.2 
Added NOTES on usage.
Added new text to DESCRIPTION.
Changed CONFORMING TO.
 2005-09-15 11:50:30 +00:00
Michael Kerrisk 7ff599e2ac New page created by splitting out from sigaction.2 
Added text on effect of NULL for 'set' argument.
Added text noting effect of ignoring SIGBUS, SIGFPE, SIGILL,
       and SIGSEGV.
Noted that sigprocmask() can't be used in multithreaded process.
Fixed EINVAL error diagnostic.
Changed CONFORMING TO.
 2005-09-15 11:48:46 +00:00
Michael Kerrisk bfac9793eb New page created by splitting out from sigaction.2 
Changed CONFORMING TO.
 2005-09-15 11:48:01 +00:00