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

1791 Commits

Author SHA1 Message Date
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
Michael Kerrisk ddc676f488 Add comment to 'ee_pad' field in structure definition. 2008-06-18 12:57:21 +00:00
Michael Kerrisk 16d2122c01 tfix 2008-06-18 09:10:22 +00:00
Michael Kerrisk 2fadbfb588 For consistency, "fix" cases where aregument of .B or .I was on the following source line. 2008-06-18 08:57:49 +00:00
Michael Kerrisk 382d87bd5f Document d_type field; other minor edits. 2008-06-17 21:51:05 +00:00
Michael Kerrisk 602995ec2c Minor wording fixes. 2008-06-17 20:50:39 +00:00
Michael Kerrisk a18e2edbf8 SEE ALSO: Add cpuset(7). 2008-06-17 08:32:41 +00:00
Michael Kerrisk 04af291ff4 Small wording fix. 2008-06-16 14:27:44 +00:00
Michael Kerrisk b11e2adf59 Further tweaks 2008-06-16 11:35:40 +00:00
Michael Kerrisk ea6100ea21 SEE ALSO: Add Documentation/scheduler/sched-rt-group.txt 2008-06-16 11:11:10 +00:00
Michael Kerrisk dc2f55497e Added system call history back to version 1.2. 
Fix typo on kernel version for pivot_root().
 2008-06-16 10:07:46 +00:00
Michael Kerrisk 4e5925162e Add more detail to the rules that are applied when an unprivileged process with a non-zero 
RLIMIT_RTPRIO limit changes policy and priority.
 2008-06-16 08:41:43 +00:00
Michael Kerrisk 35a09d71ec SYNC_FILE_RANGE_WRITE can block on writes greater than request 
queue size.  For some background, see
http://thread.gmane.org/gmane.linux.kernel/687713/focus=688340
 2008-06-13 10:51:02 +00:00
Michael Kerrisk a1d5601bee Removed trailing white space at end of lines 2008-06-12 11:52:08 +00:00
Michael Kerrisk 5fda4d2588 Link to getcwd.3 2008-06-12 10:24:34 +00:00
Michael Kerrisk 34dcae5481 Fix text that warns against use of NULL argv and envp. 
Using a NULL envp does in fact seem to be portable (works
on Solaris and FreeBSD), but the Linux semantics for a NULL
argv certainly aren't consistent with other implementations.
See http://bugzilla.kernel.org/show_bug.cgi?id=8408.
 2008-06-12 10:11:21 +00:00
Michael Kerrisk 20523df7ef Wrap source lines so that new sentence starts on new line. 2008-06-12 06:09:19 +00:00
Michael Kerrisk a3a22b7fc3 Add pointer to discussion of RLIMIT_RTTIME in getrlimit.2. 
Rewrote and restructured various parts of the page for greater clarity.
 2008-06-12 05:43:11 +00:00
Michael Kerrisk b5c0095ae9 Clarify discussion of return value of sbrk(). 
DESCRIPTION: Add some sentences giving an overview of these interfaces.
Add note recommending use of malloc(3).
Change name of brk() argument to the simpler 'addr'.
Add "(void *)" cast to "-1" for error return of sbrk().
Removed some incorrect text about "brk(0)".
Note that SUSv2 specified the return value of sbrk().
Added a detail on the glibc brk() wrapper.
Remove discussions of standards old (C89 and POSIX.1-1990);
CONFORMING TO already discusses the situation with respect
to more recent standards.
 2008-06-12 04:47:47 +00:00
Michael Kerrisk 3cde6db55c Add a few more words to DESCRIPTION. 
NOTES: Add pointer to acct(5).
 2008-06-11 22:42:23 +00:00
Michael Kerrisk bf1082be77 Describe rules governing ownership of new files (bsdgroups 
versus sysvgroups, and the effect of the parent directory's
set-group-ID permission bit).
 2008-06-11 22:24:45 +00:00
Michael Kerrisk ad22ad5568 ffix 2008-06-11 22:19:03 +00:00
Michael Kerrisk 0689a4da14 Clarify description of chmod() and fchmod(). 
Add further detail on S_ISUID, S_ISGID, and S_ISVTX permissions.
Reformat list of permissions bits.
 2008-06-11 22:14:00 +00:00
Michael Kerrisk 23ce0537cb Add description of RLIMIT_RTTIME limit, new in 2.6.25. 2008-06-11 22:04:51 +00:00
Michael Kerrisk c734b9f234 NOTES: Note that access mode flags are not single bits, 
and document the Linuxism "access mode 3".
See also http://thread.gmane.org/gmane.linux.kernel/653123.
 2008-06-11 22:04:37 +00:00
Michael Kerrisk a9cfde1dbc SEE ALSO: add symlink.7 2008-06-11 21:50:53 +00:00
Michael Kerrisk 9d6299e824 Note that EEXIST applies, even if the pathname is a 
(possibly dangling) symbolic link.
 2008-06-11 15:26:41 +00:00
Michael Kerrisk c4e453903d Re-order ERRORS and SEE ALSO entries to be alphabetical. 2008-06-11 13:57:31 +00:00
Michael Kerrisk e04e8187d2 tfix 2008-06-11 06:57:00 +00:00
Michael Kerrisk 2581c94554 ffix 2008-06-11 06:42:14 +00:00
Michael Kerrisk bed63c46ad Clarify description a little. 
s/changes the root directory/changes the root directory of the calling process/
 2008-06-11 06:41:06 +00:00
Michael Kerrisk ffe84477ec s/process/calling process/ so as to that the alarm signal is 
delivered to the calling process.
 2008-06-11 06:31:49 +00:00
Michael Kerrisk be095d1e02 tfix 2008-06-11 06:24:39 +00:00
Michael Kerrisk 9708eb3749 Quote fixes 2008-06-10 12:29:07 +00:00
Michael Kerrisk f81fb4445b s/\\'/\\(aq/ 2008-06-09 15:49:35 +00:00
Michael Kerrisk 84c517a450 Change use of quote characters to get better UTF-8 rendering. 2008-06-05 20:14:50 +00:00
Michael Kerrisk f8a07a2154 s/'/\\'/ to improve rendering in UTF-8. 2008-06-05 17:52:37 +00:00
Michael Kerrisk 41325efd9a tfix 2008-06-03 12:24:19 +00:00
Michael Kerrisk 65132f861c Update timestamp 2008-06-03 09:44:05 +00:00
Michael Kerrisk a6d57a94af tfix 2008-06-03 09:19:38 +00:00
Michael Kerrisk d051e0c01e Update FIXME. 2008-06-03 09:19:25 +00:00
Michael Kerrisk f95ef6d51f Reformat DESCRIPTION and RETURN VALUE sections to be more 
consistent with man-pages style.
Add some more detail to descriptions of system calls.
Clarified what happens if caller of getgroups() is a member of
more than 'size' supplementary groups.
ERRORS: Add ENOMEM.
 2008-06-03 09:07:36 +00:00
Michael Kerrisk 55b8a252d7 NGROUPS_MAX increased in kernel 2.6.4. 
SEE ALSO: Add credentials(7).
 2008-06-02 21:15:41 +00:00
Michael Kerrisk 25fddfcd83 Note that this system is made obsolete by utimensat(2). 2008-06-02 14:12:37 +00:00
Michael Kerrisk 04527fe52c wfix 2008-05-30 14:12:46 +00:00
Michael Kerrisk 46cdb99741 wfix 2008-05-30 13:25:25 +00:00
Michael Kerrisk 23b98a4c61 Update timestamp 2008-05-29 08:02:43 +00:00