Commit Graph

4104 Commits

Author SHA1 Message Date
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 cd1aabe6b1 Remove statement that inet_pton() extends inet_ntoa();
that's not really true, since inet_pton() doesn't support
all of the string forms that are supported by inet_ntoa();
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482987.
Describe IPv6 address formats.
Describe dotted decimal format in more detail.
Add an example program.
Remove unneeded header files from SYNOPSIS.
Make NAME line more precise.
Make description of return value more precise.
SEE ALSO: Add inet(3), Add getaddrinfo(3).
2008-06-13 10:37:04 +00:00
Michael Kerrisk 3b26a174e5 Remove unneeded header files from SYNOPSIS.
SEE ALSO: Add inet(3) and getnameinfo(3).
Make NAME line more precise.
Move errors to an ERRORS section.
Add EXAMPLE section pointing to inet_pton(3).
2008-06-13 10:23:57 +00:00
Michael Kerrisk 054f5228c6 inet_aton() is *not* in POSIX.1.
Rewrite discussion of why inet_addr() is disfavored.
SEE ALSO: Add getaddrinfo(3).
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482979.
Describe the various address forms supported by inet_aton().
Rewrite description of inet_network().
Clarify discussion of inet_lnaof(), inet_netof(), and inet_makeaddr().
Add discussion of Classful Addressing, noting that it is obsolete.
Added an EXAMPLE program.
Relocate discussion of i386 byte order to NOTES.
Note that inet_aton() returns an address in network byte order.
SEE ALSO: Add byteorder(3) and getnameinfo(3).
2008-06-13 10:22:21 +00:00
Michael Kerrisk 444aa1ce8c DESCRIPTION: Add reference to inet_addr(3) for dotted notation.
SEE ALSO: add inet(3).
Added BUGS section noting that gethostbyname() does not
recognize hexadecimal components in dotted address strings;
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482973
2008-06-13 10:14:55 +00:00
Michael Kerrisk a3edd71dc4 Improve description or 'hints' and 'res' arguments.
Add details on numeric strings that can be specified for 'node'.
Other fairly major restructrings and rewrites to improve
logical structure and clarity of the page.
2008-06-13 10:00:32 +00:00
Michael Kerrisk 481c58cae6 Remove mention of sa_len field from example code.
That field is a BSDism not present on Linux.
2008-06-13 09:54:52 +00:00
Michael Kerrisk cd117d4875 s/strcat/strncat/ (a typo that changed the semantics in DESCRIPTION). 2008-06-13 09:40:16 +00:00
Michael Kerrisk bf92b60051 sync 2008-06-13 09:17:39 +00:00
Michael Kerrisk 2d50dd9efa Modify SYNOPSIS to show protoypes of both versions of strerror_r(),
and make other small clarifications of the description regarding
the two versions.
2008-06-13 09:10:47 +00:00
Michael Kerrisk 0f7035a8cb sync 2008-06-12 13:42:30 +00:00
Michael Kerrisk b1ea88bd69 sync 2008-06-12 11:56:59 +00:00
Michael Kerrisk a1d5601bee Removed trailing white space at end of lines 2008-06-12 11:52:08 +00:00
Michael Kerrisk 7041cdc1b1 Removed tabs 2008-06-12 11:51:54 +00:00
Michael Kerrisk 905c9e1c05 tstamp 2008-06-12 11:47:27 +00:00
Michael Kerrisk d9acd25454 sync 2008-06-12 11:46:56 +00:00
Michael Kerrisk 6b84b38312 tstamp 2008-06-12 11:46:50 +00:00
Michael Kerrisk 5fda4d2588 Link to getcwd.3 2008-06-12 10:24:34 +00:00
Michael Kerrisk caf6e711a3 sync 2008-06-12 10:11:40 +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 5c1decfcc2 Remove outdated FIXME. 2008-06-12 06:20:47 +00:00
Michael Kerrisk 8d2394ac80 Link to mkstemp.3 2008-06-12 06:20:27 +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 b4e9ee8f48 Document /proc/PID/oom_score, which was new in kernel 2.6.11.
This file displays the "badness" score of the process, which
provides the basis for OOM-killer decisions.

Document /proc/PID/oom_adj, which was new in kernel 2.6.11.
This file influences the oom_score of a process.

Document /proc/PID/limits, which was new in 2.6.24.
This file displays a process's resource limits.

Document /proc/PID/fdinfo/*, which was new in 2.6.22.
These files display info about each descriptor opened by the
process: the current file offset, and the file access mode +
file status flags as set in open() or fcntl(F_SETFL).

Document /proc/PID/mountinfo, which was new in 2.6.26.
This file displays information about mount points.
Closely based on text from Documentation/filesystems/proc.txt.

Document /proc/PID/mountstats, which was new in 2.6.17.
This file displays statistics about mount points.
2008-06-12 05:49:06 +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 6cefc99668 Add description of mkostemp(), new in glibc 2.7.
Fix discussion of O_EXCL flag.
These functions may also fail for any of the errors described in open(2).
Various other rewordings.
2008-06-12 05:18:05 +00:00
Michael Kerrisk c81e8a4261 Various minor changes. 2008-06-12 05:16:43 +00:00
Michael Kerrisk b78e3a8023 Document core_pattern pipe syntax, which appeared in kernel 2.6.19.
Add an example program demonstrating use of core_pattern pipe syntax.
Document /proc/PID/coredump_filter, new in kernel 2.6.23.
Documentation was based on the text in Documentation/filesystems/proc.txt,
plus testing, and reading the kernel source.
2008-06-12 04:59:28 +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 28959f370d sync 2008-06-11 22:42:54 +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 aaed8ba0f9 A complete rewrite of this page, now with much more detail. 2008-06-11 22:37:54 +00:00
Michael Kerrisk 305865606d Note that Linux supports ACLs on POSIX named semaphores since 2.6.19. 2008-06-11 22:32:40 +00:00
Michael Kerrisk 8f36e23f07 Linux does not currently support ACLs for POSIX message queues. 2008-06-11 22:31:48 +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 94b40171e1 Provide a clear description of the three types of address that can
appear in the sockaddr_un structure: pathname, unnamed, and abstract.
2008-06-11 22:11:06 +00:00
Michael Kerrisk 063212eb63 Changes for 3.01 2008-06-11 22:10:31 +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 2b061b28a6 Minor tweaks 2008-06-11 21:50:28 +00:00
Michael Kerrisk 60435a752c SEE ALSO: Add hostname (7) 2008-06-11 21:31:42 +00:00
Michael Kerrisk eae3689b44 A description of symbolic links, taken from FreeBSD 6.2 and heavily edited. 2008-06-11 21:25:12 +00:00
Michael Kerrisk 06b00cff20 A description of hostnames, taken from FreeBSD. 2008-06-11 21:24:46 +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