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

1925 Commits

Author SHA1 Message Date
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
Michael Kerrisk 7ce14e4094 Remove statement that (SYNC_FILE_RANGE_WAIT_BEFORE | 
SYNC_FILE_RANGE_WRITE | SYNC_FILE_RANGE_WAIT_AFTER) is
a traditional fdatasync(2) operation.
See https://bugzilla.mozilla.org/show_bug.cgi?id=421482 comments 129 to 131.
 2008-05-29 07:55:33 +00:00
Michael Kerrisk 7921f13b4c SEE ALSO: add shmat(2). 2008-05-27 02:59:06 +00:00
Michael Kerrisk 54504ac3d3 SEE ALSO: add mprotect(2). 2008-05-27 02:57:24 +00:00
Michael Kerrisk 5b524e2533 SYNOPSIS: s/size_t \*len/size_t len/ 2008-05-26 11:12:19 +00:00
Michael Kerrisk 8660aec07e Re PTRACE_PEEKUSER: the offsets and data returned might not 
match with the defintion of struct user.
 2008-05-21 20:23:25 +00:00
Michael Kerrisk da36351ec7 FUTEX_FD has been removed, as of kernel 2.6.26. 2008-05-21 13:48:54 +00:00
Michael Kerrisk 80d17cfa1a NOTES: Added details on mapping address that is selected by 
kernel when MAP_FIXED is / isn't specified.
 2008-05-21 12:33:21 +00:00
Michael Kerrisk ba1eb78cfb Clarify that "unused" fields in shminfo structure are 
"unused within the kernel".
Minor rewordings in comments for shminfo structure.
 2008-05-20 21:20:38 +00:00
Michael Kerrisk ffc19357d9 Clarify that "unused" fields in seminfo structure are 
"unused within the kernel".
Minor rewordings in comments for seminfo structure.
 2008-05-20 21:20:07 +00:00
Michael Kerrisk 767b89e84b Clarify that "unused" fields in msginfo structure are 
"unused within the kernel".
msginfo.msgpool is measured in kilobytes, not bytes.
Minor rewordings in comments for msginfo structure.
 2008-05-20 21:18:59 +00:00
Michael Kerrisk 2be221988c Added FIXME 2008-05-20 08:09:35 +00:00
Michael Kerrisk 9967820f26 Add NOTES section pointing out that 'size' argument is unused 
since kernel 2.6.8.
 2008-05-17 21:03:05 +00:00
Michael Kerrisk 42ab9eb994 Rename 'buf' argument of utime() to 'times' (like utimes()). 
Clarify explanation of EACCES and EPERM errors.
Remove BUGS section, since it doesn't seem add useful information.
Clarified discussion of capabilities, and noted that
CAP_DAC_OVVERIDE also has a role.
Other minor rewordings.
 2008-05-16 13:40:15 +00:00
Michael Kerrisk b77e081d31 wfix 2008-05-14 06:46:09 +00:00
Michael Kerrisk bd9ff0c9e4 tfix 2008-05-14 06:25:03 +00:00
Michael Kerrisk 79ad39a7d4 Clarify meaning of "BSD group semantics". 2008-05-13 12:42:43 +00:00
Michael Kerrisk a3bf802265 Add chown.2/chmod.2 to SEE ALSO 2008-05-13 11:29:39 +00:00
Michael Kerrisk 373485dde6 spfix--This line, and those below, will be ignored-- 
M    man2/chown.2
 2008-05-13 10:57:08 +00:00
Michael Kerrisk 8b39ad6681 More than just ext2 supports "mount -o bsdgroups" nowadays, so make the 
discussion about group ownership of new files a bit more generic.
 2008-05-13 10:54:22 +00:00
Michael Kerrisk d77eb76422 spfix 2008-05-12 14:38:18 +00:00
Michael Kerrisk ba7cb080d9 spfix 2008-05-12 14:37:02 +00:00
Michael Kerrisk 61b7c1e18f spfix/wfix 2008-05-12 14:30:24 +00:00
Michael Kerrisk 7364dea652 wfix 2008-05-12 12:35:13 +00:00
Michael Kerrisk 8bc3375d27 The location of the numactl package has changed. 2008-05-12 12:34:54 +00:00
Michael Kerrisk a20e907fde Remove out-of-date FIXME 2008-05-09 21:15:33 +00:00
Michael Kerrisk 60948d6886 Add .\" comment 2008-05-09 21:09:04 +00:00
Michael Kerrisk 3eed760e97 Remove wrongheaded FIXME 2008-05-09 21:08:14 +00:00
Michael Kerrisk 6f56387016 POSIX.1 also allows EEXIST for the ENOTEMPTY error condition. 2008-05-09 13:48:47 +00:00
Michael Kerrisk 31daf529b7 Reformat kernel version information for flags. 2008-05-07 13:43:44 +00:00
Michael Kerrisk f99fc19730 ffix 2008-05-07 13:41:18 +00:00
Michael Kerrisk 64d6219cf0 s/since kernel x.y.z/since Linux s.y.z/ 2008-05-07 13:33:52 +00:00
Michael Kerrisk 24ad90c3b4 Added FIXME. 2008-05-06 23:14:31 +00:00
Michael Kerrisk f38fa944aa MAP_POPULATE supports both file and anonymous mappings. 
Since 2.6.23, MAP_POPULATE supports private mappings.
Since 2.6.23, MAP_NONBLOCK causes MAP_POPULATE to be a no-op.
 2008-05-05 20:10:11 +00:00
Michael Kerrisk 22cddee1cd SEE ALSO: Add getgrouplist(3). 2008-05-04 18:31:25 +00:00
Michael Kerrisk 15b17877ea tfix 2008-05-04 08:35:01 +00:00
Michael Kerrisk bb1abbbd18 Small tidy up of language relating to permissions/capabilities. 2008-04-29 13:45:56 +00:00
Michael Kerrisk 49d3590362 s/posix_madvise (2)/posix_madvise (3)/; 
(The page referred-to page still doesn't exit yet, but hopefully
will do sometime soon.)
 2008-04-28 18:27:36 +00:00
Michael Kerrisk bac0a11532 Added FIXME 2008-04-28 18:25:49 +00:00
Michael Kerrisk 275714d8e6 Minor edits to structure definition. 2008-04-28 08:58:41 +00:00
Michael Kerrisk 4731cd2e39 Up to date as at 2.6.25 2008-04-28 08:58:21 +00:00
Michael Kerrisk 527bf3f688 Remove shmop from NAME section. 2008-04-27 15:04:18 +00:00
Michael Kerrisk 04a58fd379 Remove msgop from NAME section. 2008-04-27 15:04:07 +00:00
Michael Kerrisk 49237f3d7b Added .\" comment 2008-04-27 15:03:45 +00:00
Michael Kerrisk be5e709854 Add FIXME? 2008-04-25 10:55:41 +00:00
Michael Kerrisk 53c94269ec wfix 2008-04-25 09:53:45 +00:00
Michael Kerrisk b75101c34b Removed trailing white space at end of lines 2008-04-25 06:57:43 +00:00
Michael Kerrisk ff4e3b35c4 tstamp 2008-04-25 06:50:26 +00:00
Michael Kerrisk f0e92583e1 tfix 2008-04-25 06:21:55 +00:00
Michael Kerrisk df18528cf0 Added FIXME 2008-04-24 09:36:55 +00:00
Michael Kerrisk 84a275c4c8 ffix 2008-04-24 09:36:45 +00:00
Michael Kerrisk 148468921a Added some comments to code in NOTES. 2008-04-24 08:54:08 +00:00
Michael Kerrisk 2e001ad4f9 Add fixme 2008-04-24 08:40:38 +00:00
Michael Kerrisk 275515f226 Added FIXME. 2008-04-23 21:03:43 +00:00
Michael Kerrisk 49ecc7a09a Various minor rewordings and restructurings for clarity. 2008-04-23 20:59:00 +00:00
Michael Kerrisk 8e76d139b0 Remove unnecessary subheading for utimes(). 2008-04-23 18:00:52 +00:00
Michael Kerrisk de5f7e2851 Added some .SS headings to make structure of page a little more obvious. 2008-04-23 15:37:15 +00:00
Michael Kerrisk 6a27a99853 Added FIXME 2008-04-23 15:36:48 +00:00
Michael Kerrisk 1717fa1b98 Add FIXME 2008-04-23 15:05:47 +00:00
Michael Kerrisk 6cb0b6a045 Add FIXME 2008-04-23 15:05:40 +00:00
Michael Kerrisk 3ee895129b If the 'sigmask' is NULL, the ppoll() is equivalent to poll() 
with respect tio signal mask manipulations.
 2008-04-23 14:49:53 +00:00
Michael Kerrisk 14946d05f3 tstamp 2008-04-23 14:42:14 +00:00
Michael Kerrisk c98759f3ea wfix 2008-04-23 14:40:47 +00:00
Michael Kerrisk 8d30cbf478 Added some FIXMEs. 2008-04-23 09:10:40 +00:00
Michael Kerrisk f974b97592 Removed out-of-date FIXME 2008-04-22 12:55:50 +00:00
Michael Kerrisk 429e98671d NOTES: since glibc 2.3.3, the glibc NPTL fork() wrapper bypasses the 
fork() system call to invoke clone() with appropriate flags.
 2008-04-22 04:18:32 +00:00
Michael Kerrisk 14f5ae6dc8 Change name of 'start' argument to 'addr' for consistency with: 
* other memory related interfaces
* POSIX specification (for those interfaces in POSIX)
* Linux and glibc source code (in at least some cases)
 2008-04-21 07:51:17 +00:00
Michael Kerrisk cd56f36fe6 Add .\" comment 2008-04-19 07:33:45 +00:00
Michael Kerrisk 3736a895a2 Updated FIXME 2008-04-18 17:00:53 +00:00
Michael Kerrisk 090ed1ef8e Improve wording for EAGAIN error in discussion of MSG_DONTWAIT. 2008-04-18 16:17:12 +00:00
Michael Kerrisk 407252794e Batch wfix/ffix 2008-04-18 15:52:17 +00:00
Michael Kerrisk 0527ad7f3a Add text explicitly noting that sig==0 can be used to check for 
the existence of a PID or PGID.
Other minor rewordings.
 2008-04-18 15:26:30 +00:00
Michael Kerrisk 25c8faf595 Reworded BUGS text a little. 2008-04-18 15:01:39 +00:00
Michael Kerrisk 7cbaba9031 Various wording cleanups 2008-04-18 07:40:33 +00:00
Michael Kerrisk 5db77de4ff The MS_REMOUNT changes in 2.4 were at 2.4.10 (not 2.4). 2008-04-17 14:59:13 +00:00
Michael Kerrisk efd9a49f5a Updated FIXME 2008-04-17 07:44:38 +00:00
Michael Kerrisk 17c6928974 Clarify description of setpgid() a little. 2008-04-14 15:57:39 +00:00
Michael Kerrisk 12afd1b404 Added VERSIONS section noting that this system call first appeared in 2.4.11. 2008-04-14 14:46:47 +00:00
Michael Kerrisk ef37eaf2e8 Added note that CLONE_STOP (which no-one ever used anyway) is now deprecated. 2008-04-14 13:03:17 +00:00
Michael Kerrisk ff902aca81 tfix 2008-04-13 20:03:28 +00:00
Michael Kerrisk 6aedbf95cb Looks like the sigqueue() data bug will be fixed in 2.6.25. 2008-04-13 05:48:46 +00:00
Michael Kerrisk 5a776a3bef Small fix to example code 2008-04-12 16:27:05 +00:00
Michael Kerrisk 81307e98f7 Added FIXME. 2008-04-11 11:49:22 +00:00
Michael Kerrisk 4443f8c37c Added comments describing fields in signalfd_siginfo structure. 2008-04-10 10:39:24 +00:00
Michael Kerrisk dbe108ed3d Added BUGS text noting that up to kernel 2.625, the ssi_int 
and ssi_ptr fields are not set.
 2008-04-10 10:33:35 +00:00
Michael Kerrisk ffd3fb5531 Added FIXME. 2008-04-09 15:24:39 +00:00
Michael Kerrisk a279595bf7 Minor change to example program. 2008-04-09 12:21:34 +00:00
Michael Kerrisk dc55661bef Minor wording fix 2008-04-09 09:33:49 +00:00
Michael Kerrisk d372f252fa Update fields names in example program (s/signo/ssi_signo/). 2008-04-08 18:32:29 +00:00
Michael Kerrisk 7d2c10f46f Various small fixes, and remove duplicated sentence. 2008-04-08 13:46:51 +00:00
Michael Kerrisk fb43427b28 Remove duplicated text. 2008-04-08 13:45:37 +00:00
Michael Kerrisk 3a2f381997 tfix 2008-04-08 13:30:53 +00:00
Michael Kerrisk f7e9afe8bd ffix+tfix 2008-04-08 13:25:47 +00:00
Michael Kerrisk 635d395977 wfix 2008-04-08 13:04:03 +00:00
Michael Kerrisk 9f91e36c26 Note that O_CLOEXEC is in next POSIX revison. 
Added a FIXME for other upcoming POSIX changes.
 2008-04-08 11:28:12 +00:00
Michael Kerrisk 0e464c2f72 Add a sentence clarifying that even though the default disposition 
of SIGCHLD is "ignore", explicitly setting the disposition to
SIG_IGN results in different treatment of zombies.
 2008-04-07 21:09:02 +00:00
Michael Kerrisk 302ea01382 CONFORMING TO: utimes() is in POSIX.1-2001. 2008-03-20 06:09:01 +00:00
Michael Kerrisk 12a1a9e794 Added FIXME relating to SUSv4 chhanges 2008-03-19 15:09:59 +00:00
Michael Kerrisk 501d2485ba Update FIXME 2008-03-19 14:07:29 +00:00
Michael Kerrisk 83ea1eee87 Minor rewording. 2008-03-19 13:23:18 +00:00
Michael Kerrisk eba722884d s/nonzero/non-zero/ 2008-03-19 13:16:39 +00:00
Michael Kerrisk 1f04cc9731 s/nonempty/non-empty/ 2008-03-19 13:11:38 +00:00
Michael Kerrisk 2103596438 s/normal file/regular file/ 2008-03-19 11:56:53 +00:00
Michael Kerrisk 972a8ec74e grfix 2008-03-19 11:52:55 +00:00
Michael Kerrisk ecccf7c284 grfix 2008-03-19 08:56:26 +00:00
Michael Kerrisk cf50118f48 Use "run time" when non-attributive, "run-time" when attributive. 2008-03-19 08:46:32 +00:00
Michael Kerrisk 76c44d83f3 s/command line/command-line/ when used attributively. 2008-03-19 08:37:35 +00:00
Michael Kerrisk 24d01c530c s/filesystem/file system/ 2008-03-19 07:26:08 +00:00
Michael Kerrisk 10d76543fe Modify the license on these pages to be the standard verbatim license. 2008-03-18 14:47:54 +00:00
Michael Kerrisk 647d1abbdb Added some .\" comments, and a FIXME. 2008-03-18 14:25:00 +00:00
Michael Kerrisk 6982cdd87c Minor wording change 2008-03-18 14:11:57 +00:00
Michael Kerrisk b69987f6de s/time stamp/timestamp/ 2008-03-18 09:52:36 +00:00
Michael Kerrisk c18c014112 Change description in NAME line ("or" is not correct: these calls 
always change *both* timestamps).
Other minor wording fixes.
 2008-03-18 09:50:51 +00:00
Michael Kerrisk bb9bfecda6 Updated timestamp 2008-03-14 13:24:17 +00:00
Michael Kerrisk 5d5b47f890 Added portability note to BUGS text for EPOLL_CTL_DEL. 2008-03-14 13:23:39 +00:00
Michael Kerrisk 222ccf0944 spfix 2008-03-11 12:53:16 +00:00
Michael Kerrisk ef22088864 spfix 2008-03-11 12:48:45 +00:00
Michael Kerrisk 0f5546a1fe spfix 2008-03-11 12:38:48 +00:00
Michael Kerrisk 5ada556d56 spfix 2008-03-11 12:37:48 +00:00
Michael Kerrisk e935e108ac Replace (il)legal by "permitted" or "valid" 2008-03-10 10:04:03 +00:00
Michael Kerrisk cf0961b079 tfix 2008-03-10 08:02:43 +00:00
Michael Kerrisk d68b271378 spfix 2008-03-10 07:09:31 +00:00
Michael Kerrisk a522769fdb Add text in NOTES about the punchier effect of nice values in 
kernel 2.6.23 and later.
Add Documentation/scheduler/sched-nice-design.txt to SEE ALSO list.
 2008-03-05 15:22:42 +00:00
Michael Kerrisk 6958017ffd Refine previous changes a little. 2008-03-05 15:22:09 +00:00
Michael Kerrisk c00194abf0 Add description of SCHED_IDLE policy (new in 2.6.23). 
Tweak description of SCHED_BATCH.
 2008-03-03 14:20:27 +00:00
Michael Kerrisk 31981fa15b Removed trailing white space at end of lines 2008-03-03 13:24:34 +00:00
Michael Kerrisk c0ced2c258 Fix type for ssi_ptr field. 2008-03-03 10:12:18 +00:00
Michael Kerrisk 4e698277c0 Move discussion of 'mode' argument under description of O_CREAT. 2008-02-28 14:47:54 +00:00
Michael Kerrisk f946c58059 wfix 2008-02-28 11:35:53 +00:00
Michael Kerrisk c15e4069f6 Added FIXME. 2008-02-22 15:38:58 +00:00
Michael Kerrisk e5a7fca5cc Clarify detail of RLIMIT_STACK/4 limit for argv+environ. 2008-02-22 15:18:34 +00:00
Michael Kerrisk 0df29603da Add timerfd_create(), timerfd_settime(), and timerfd_gettime() to list. 2008-02-22 13:57:17 +00:00
Michael Kerrisk 86e4fb05c7 Remove FIXMES + some othe rsmall clean-ups. 2008-02-22 13:45:59 +00:00
Michael Kerrisk ffaecbc128 minot wording fixes 2008-02-22 13:34:34 +00:00
Michael Kerrisk bc5ec13168 Minor rewordings. 2008-02-22 07:57:30 +00:00
Michael Kerrisk dffa9f2b3c Minor fix to description of type==3 and type==4. 2008-02-14 15:04:20 +00:00
Michael Kerrisk 0527015d62 Add info on command type 10. 
Add details on types 6, 7, 8, and 9.
Minor grammar fix.
Update LOG_BUF_LEN details.
Update RETURN VALUE section.
Notes capability requirements under EPERM error.
Other minor edits.
 2008-02-14 10:32:04 +00:00
Michael Kerrisk c33a62d8c1 Added SEE ALSO entry referring to timerfd_create.2. 2008-02-12 14:40:53 +00:00
Michael Kerrisk 957532b1ba Removed out-of-date FIXMES. 2008-02-12 14:40:24 +00:00
Michael Kerrisk df00cf8359 Links to new timerfd_create.2 page. 2008-02-12 14:35:18 +00:00
Michael Kerrisk 45b81c9c67 Describes timerfd_create(), timerfd_settime(), and timerfd_gettime(), 
new in 2.6.2.25.
 2008-02-12 14:32:46 +00:00
Michael Kerrisk b2a23ade68 Update .TH timestamp 2008-02-11 11:49:23 +00:00
Michael Kerrisk 058c11652c Add SEE ALSO entry referring to new signalfd.2 page. 2008-02-11 11:41:18 +00:00
Michael Kerrisk 8b4280907b New page describing eventfd(2) system call. 2008-02-11 11:40:03 +00:00
Michael Kerrisk 5b0bafdd0a New page describing signalfd() system call. 2008-02-11 11:39:31 +00:00
Michael Kerrisk ddc4d3392c Greatly expand the detail on O_DIRECT. 2008-02-11 10:38:24 +00:00
Michael Kerrisk 350d584d17 Fix RETURN VALUE description: in some cases reboot() does not return. 
Rename the 'flag' argument to 'cmd', since that is more meaningful,
and also what is used in the kernel source.
Other minor wording changes.
 2008-02-11 10:05:05 +00:00
Michael Kerrisk 21a0b03de8 Added FIXMEs 2008-02-11 09:02:41 +00:00
Michael Kerrisk 9eb143a1db Improve wording describing error returns. 2008-01-31 13:29:11 +00:00
Michael Kerrisk 27e42cd904 spfix 2008-01-31 13:20:52 +00:00
Michael Kerrisk 5b4b27342b Update date in .TH 2008-01-31 11:01:28 +00:00
Michael Kerrisk c4aae9a738 Fix types for 2 and 4 arguments in splice prototype. 2008-01-31 10:49:03 +00:00
Michael Kerrisk f867dcc700 Explicitly describe return value in the event of an error. 2008-01-31 10:41:08 +00:00
Michael Kerrisk 4701fc284e Add ENOSYS error to errors. 2008-01-31 10:35:05 +00:00
Michael Kerrisk 55ae3c86d1 Clarify description of return value for WNOHANG. 2008-01-31 10:30:12 +00:00
Michael Kerrisk cfc621b5d9 Added FIXME 2008-01-30 10:46:05 +00:00
Michael Kerrisk f5e74ede79 Added discussion of directory streams. 
Removed "#include <sys/types>" from SYNOPSIS.
Changed authorship notice.
 2008-01-13 17:00:19 +00:00
Michael Kerrisk 955f4c381a ffix 2008-01-13 09:40:31 +00:00
Michael Kerrisk 325f18dab4 Minor wording chnages. 2008-01-13 08:57:48 +00:00
Michael Kerrisk a0d39abb92 Rewrote DESCRIPTION; emphasized that tkill() is obsoleted by tgkill(). 2008-01-12 17:38:58 +00:00
Michael Kerrisk ed0da723be spfix 2008-01-12 16:30:12 +00:00
Michael Kerrisk a4e3b1bc3e Reordered text in DESCRIPTION and added some details for dup2(). 2008-01-12 13:19:03 +00:00
Michael Kerrisk fd48405669 Rewrote DESCRIPTION; noted that thread ID is not the same 
thing as a POSIX thread ID.
 2008-01-12 12:43:44 +00:00
Michael Kerrisk da8cb51e61 Fix unbalanced quotes in formatting macros. 2008-01-12 08:57:58 +00:00
Michael Kerrisk c10faeadb3 tfix 2008-01-12 08:20:07 +00:00
Michael Kerrisk 0d26ae944e Removed trailing white space at end of lines 2008-01-09 17:35:14 +00:00
Michael Kerrisk 8d3a62d67e A few rewrites and additions. 2008-01-09 17:26:35 +00:00
Michael Kerrisk 9d227bc540 Rewrote DESCRIPTION; minor additions to EXAMPLE text. 2008-01-09 10:17:51 +00:00
Michael Kerrisk eacd521cd9 minor wording change. 2008-01-09 09:41:21 +00:00
Michael Kerrisk 7db44341af Minor fix to O_EXCL changes in previous release. 2008-01-05 04:50:10 +00:00
Michael Kerrisk a028f2edaf ffix 2008-01-04 04:30:10 +00:00
Michael Kerrisk 447bb15ee0 Removed trailing white space at end of lines 2008-01-03 16:06:22 +00:00
Michael Kerrisk f4b9d6a511 Clarify initial description of O_EXCL. 
Clarify description of behavious of O_CREAT | O_EXCL for symbolic links.
Clarify text describing use of lockfiles without O_EXCL.
O_EXCL is supported on NFSv3 and later, with Linux 2.6 and later.
 2008-01-03 08:12:02 +00:00
Michael Kerrisk ca92ce95a3 Remove/replace extraneous .sp macros. 2008-01-01 14:13:55 +00:00
Michael Kerrisk 984886049d Remove exstraneous .sp macros. 2008-01-01 13:44:49 +00:00
Michael Kerrisk 2b53dd031e Remove extraneous .br macro before/after .SH/.SS. 2008-01-01 13:38:33 +00:00
Michael Kerrisk 6c9e43eb5c spfix 2008-01-01 07:49:57 +00:00
Michael Kerrisk 4989f80d27 Removed trailing white space at end of lines 2007-12-30 09:18:45 +00:00
Michael Kerrisk 20b627b65d Remove unneeded formatting macro 2007-12-30 05:54:29 +00:00
Michael Kerrisk 3c5e62b618 Fix a/an usage 2007-12-29 18:01:05 +00:00
Michael Kerrisk 763f0e477c Fix usage of a/an before following vowel/consonant. 2007-12-29 17:42:38 +00:00
Michael Kerrisk c1660a22f4 hyphenation fix 2007-12-29 15:00:06 +00:00
Michael Kerrisk faa1d321d4 Fix section number in .TH line. 2007-12-29 14:58:51 +00:00
Michael Kerrisk e23e4c2685 Use proper tables for layout, and various formatting fixes. 2007-12-29 10:01:04 +00:00
Michael Kerrisk 92f9f654ef Put EPERM in right alphabetical position in ERRORS list. 2007-12-28 13:36:26 +00:00
Michael Kerrisk 4ee6a53ec5 Remove section numbers for page self refs 2007-12-28 08:11:15 +00:00
Michael Kerrisk c8b55e76ea ffix 2007-12-28 06:52:31 +00:00
Michael Kerrisk e4b4caa6b8 wfix 2007-12-28 04:39:57 +00:00
Michael Kerrisk a1ffe9f5a2 s/current process/calling process/ 2007-12-27 16:06:35 +00:00
Michael Kerrisk edd1fa35e3 s/cwd/current working directory/ 2007-12-27 16:01:37 +00:00
Michael Kerrisk 0786e30815 Add credentials(7) to SEE ALSO, and updated copyright credits, 
to reflect my rewrite of a few months ago.
 2007-12-27 15:47:08 +00:00
Michael Kerrisk 78110b787e Add getsid(2) and credentials(7) to SEE ALSO. 2007-12-27 15:32:43 +00:00
Michael Kerrisk 24e4598352 Add getresgid(2) and credentials(7) to SEE ALSO. 2007-12-27 15:26:51 +00:00
Michael Kerrisk 520b53c642 Add getresuid(2) and credentials(7) to SEE ALSO. 2007-12-27 15:26:12 +00:00
Michael Kerrisk 5a3dd911f2 Rewrote various parts. 2007-12-27 15:19:31 +00:00
Michael Kerrisk 1e48734a07 Rewrote various parts. 2007-12-27 15:06:07 +00:00
Michael Kerrisk 791ce3b986 Minor rewrites 2007-12-27 14:37:14 +00:00
Michael Kerrisk 938576af95 Since kernel 2.2, AF_UNSPEC for unconnecting a connected socket *is* supported. --This line, and those below, will be ignored-- 
M    man2/connect.2
 2007-12-26 16:41:58 +00:00
Michael Kerrisk e57ba8a908 Remove FIXME 2007-12-26 16:33:56 +00:00
Michael Kerrisk 1f74d4c4cc Added FIXME. 2007-12-26 11:51:09 +00:00
Michael Kerrisk 34bdd96ab0 Hyphenation fixes 2007-12-26 11:46:23 +00:00
Michael Kerrisk 12d8baeb45 Clarify relationship of file descriptor and open file description. 2007-12-26 11:43:15 +00:00
Michael Kerrisk a43eed0cdc Hyphenation fixes 2007-12-26 11:17:23 +00:00
Michael Kerrisk 0b4deed8dc Small rewording 2007-12-26 11:15:02 +00:00
Michael Kerrisk 2706f299e5 Hyphenation fixes 2007-12-26 08:00:10 +00:00
Michael Kerrisk c382a36592 hyphenation fixes 2007-12-25 22:02:19 +00:00
Michael Kerrisk e415892486 ffix 2007-12-25 21:41:35 +00:00
Michael Kerrisk 222ad5f146 ffix 2007-12-25 21:39:59 +00:00
Michael Kerrisk d19a206dbb grfix 2007-12-25 21:30:22 +00:00
Michael Kerrisk 8382f16db1 grfix 2007-12-25 21:28:09 +00:00
Michael Kerrisk e2badfdf26 Hyphenation fixes 2007-12-25 20:50:22 +00:00
Michael Kerrisk 5b55dde281 grfix 2007-12-25 20:39:36 +00:00
Michael Kerrisk 498c6aa666 Clarify interpretation of 'addr'; plus a few other minor edits and updates. 2007-12-25 17:06:46 +00:00
Michael Kerrisk 781b97e6a4 grfix 2007-12-25 16:36:15 +00:00
Michael Kerrisk a325cc6045 ffix 2007-12-25 16:16:06 +00:00
Michael Kerrisk 863b571e68 ffix 2007-12-25 16:11:05 +00:00
Michael Kerrisk 438825e097 ffix 2007-12-24 22:25:11 +00:00
Michael Kerrisk 47752f332c s/fildes/fd/ 2007-12-24 22:04:47 +00:00
Michael Kerrisk a17e03f5cb Rename 'filedes' argument 'pipefd'. 2007-12-24 22:02:58 +00:00
Michael Kerrisk 34cd540ed6 Add comma to clarify meaning of a sentence. 2007-12-24 17:34:54 +00:00
Michael Kerrisk 34ccb744ec s/x86/i386/ 2007-12-24 17:31:35 +00:00
Michael Kerrisk d1b4e37d41 ffix 2007-12-23 22:24:54 +00:00
Michael Kerrisk ca62583fcf tfix 2007-12-23 22:20:35 +00:00
Michael Kerrisk 7670ac9d8e ffix 2007-12-23 22:20:16 +00:00
Michael Kerrisk 218dfacd71 ffix 2007-12-23 22:13:45 +00:00
Michael Kerrisk 187339e696 ffix 2007-12-23 22:04:06 +00:00
Michael Kerrisk 54f73b77a1 ffix 2007-12-23 22:02:16 +00:00
Michael Kerrisk d3b03141a9 s/filedes/fd/ 2007-12-23 21:56:27 +00:00
Michael Kerrisk de5c8e39f9 Nowadays there are seven macros. 2007-12-23 21:51:26 +00:00
Michael Kerrisk d4b19a0066 Modify explanation of EINVAL 'maxnode' error. 2007-12-23 21:40:51 +00:00
Michael Kerrisk 9a7f80e209 Minor formatting/wording changes. 2007-12-23 21:26:33 +00:00
Michael Kerrisk c825020667 Fixed unbalanced .nf/fi pairs. 2007-12-23 21:05:57 +00:00
Michael Kerrisk 8568021d3b white space clean-ups. 2007-12-23 17:46:23 +00:00
Michael Kerrisk 49b50a1812 wfix 2007-12-23 17:30:21 +00:00
Michael Kerrisk aeb4b1fc8b s/u_long/unsigned long/ 
s/ulong/unsigned long/
s/u_char/unsigned char/
s/u_short/unsigned short/
s/ushort/unsigned short/
s/u_int8_t/uint8_t
s/u_int16_t/uint16_t
s/u_int32_t/uint16_t
s/u_int/unsigned int/
 2007-12-23 17:26:26 +00:00
Michael Kerrisk d6d508165e ffix 2007-12-23 16:55:14 +00:00
Michael Kerrisk 3f89ebc011 Indent structure definitions by +4n. 2007-12-23 14:14:04 +00:00
Michael Kerrisk 3ad4ddcd0b Indent structure defintions by +4n, 2007-12-23 14:03:07 +00:00
Michael Kerrisk 5895e7eb8d wspace in SYNOPSIS 2007-12-23 13:45:24 +00:00
Michael Kerrisk 62218dc0fd Format SYNOPSIS consistently. 2007-12-23 08:20:39 +00:00
Michael Kerrisk 9ec0ea9000 ffix 2007-12-22 23:05:03 +00:00
Michael Kerrisk cf29f7772a ffix 2007-12-22 22:56:42 +00:00
Michael Kerrisk 0967c11fb9 s/etc/etc./ 2007-12-22 22:43:42 +00:00
Michael Kerrisk d061dbacc3 spfix 2007-12-22 20:50:00 +00:00
Michael Kerrisk 728dbc291c Remove duplicate "#include <fcntl.h>" from SYNOPSIS. 2007-12-22 20:48:31 +00:00
Michael Kerrisk 495846d9eb Format SYNOPSIS in manner consistent with other pages. 2007-12-22 17:10:05 +00:00
Michael Kerrisk 4a8d10ef27 Minor rewordings 2007-12-22 17:00:19 +00:00
Michael Kerrisk 4d2be0ee63 ffix 2007-12-22 16:56:03 +00:00
Michael Kerrisk 4922b5d50b ffix 2007-12-22 16:46:37 +00:00
Michael Kerrisk 94e9d9febd Replace "-" by "\-" where a real dash is required. 2007-12-22 16:40:46 +00:00
Michael Kerrisk 009df872f7 Format casts so that there is a non-breaking space after the 
type, and remove unnecessary parentheses around the casted value.
Thus, for example, the following:

     .IR "(size_t) (\-1)" .

becomes:
    .IR "(size_t)\ \-1" .
 2007-12-22 16:26:51 +00:00
Michael Kerrisk 5f414585bc ffix 2007-12-20 12:44:59 +00:00
Michael Kerrisk 30f6523ba5 We can use context FDs for the dirfd argument to the *at() syscalls. 2007-12-20 11:49:17 +00:00
Michael Kerrisk cf94921b75 ffix 2007-12-20 11:25:58 +00:00
Michael Kerrisk 26cf2565db Updated date in .TH line 2007-12-19 07:24:03 +00:00
Michael Kerrisk a6e2f12821 Make the standard indent for code samples, shell session 
logs, etc. to be ".in +4n".
 2007-12-19 07:19:23 +00:00
Michael Kerrisk 088a639be3 Make the standard indent for code samples, shell session 
logs, etc. to be ".in +4n".
 2007-12-19 06:57:44 +00:00
Michael Kerrisk cfadad462c remove superflous white space in text 2007-12-19 06:29:23 +00:00
Michael Kerrisk bd19142309 enclose code smaples/structure defns/etc in ".in +4n / .in" 2007-12-19 06:16:04 +00:00
Michael Kerrisk a08ea57c20 Make the standard indent for code samples, shell session 
logs, etc. to be ".in +4n".
 2007-12-19 05:53:30 +00:00
Michael Kerrisk c1bdeb84c5 Fix typos in argument names; ffixes 2007-12-18 15:59:38 +00:00
Michael Kerrisk 40271293b2 Update date in .TH line 2007-12-18 15:46:06 +00:00
Michael Kerrisk be9634cfdd s/epoch/Epoch/ 2007-12-18 15:37:46 +00:00
Michael Kerrisk 5e27f149be http://marc.info/?l=linux-kernel&m=119447727031225&w=2 
Rework the text describing the return value to be closer
to the requirements of POSIX.1; move Linux details
to NOTES and add a warning not to rely on those details.
Add a warning about the -1 to -4095 bug which results
in a 41 second window where the glibc wrapper will wrongly
return -1 indicating an error.

Remove cruft HZ text.

Clarify text describing return value of clock(3).
 2007-12-18 15:36:00 +00:00
Michael Kerrisk 2d986c928c Replace `...' with alternate formatting (e.g., ".." or .I) 2007-12-18 07:47:22 +00:00
Michael Kerrisk 92a5f98331 ffix 2007-12-17 17:06:05 +00:00
Michael Kerrisk d2296c225b wfix/ffix 2007-12-17 17:05:09 +00:00