2008-06-11 22:42:54 +00:00
|
|
|
==================== Changes in man-pages-3.01 ====================
|
2007-09-19 21:40:03 +00:00
|
|
|
|
2008-06-11 04:20:37 +00:00
|
|
|
Released: 2008-06-12, Konolfingen
|
2007-09-19 21:40:03 +00:00
|
|
|
|
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
Contributors
|
|
|
|
------------
|
2007-10-23 11:33:49 +00:00
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
The following people contributed notes, ideas, or patches that have
|
|
|
|
been incorporated in changes in this release:
|
2007-09-20 18:15:23 +00:00
|
|
|
|
2008-06-11 22:42:54 +00:00
|
|
|
Alain Portal <aportal@univ-montp2.fr>
|
2008-06-12 11:46:56 +00:00
|
|
|
Andrew Clayton <andrew@digital-domain.net>
|
2008-06-11 22:42:54 +00:00
|
|
|
Christoph Hellwig <hch@infradead.org>
|
2008-06-12 10:11:40 +00:00
|
|
|
Neil Horman <nhorman@tuxdriver.com>
|
2008-06-11 22:42:54 +00:00
|
|
|
Peter Zijlstra <a.p.zijlstra@chello.nl>
|
2008-06-12 10:11:40 +00:00
|
|
|
Petr Gajdos <pgajdos@suse.cz>
|
2008-06-11 22:42:54 +00:00
|
|
|
Sam Varshavchik <mrsam@courier-mta.com>
|
|
|
|
Samuel Thibault <samuel.thibault@ens-lyon.org>
|
|
|
|
Stuart Cunningham <stuartc@rd.bbc.co.uk>
|
2008-06-12 10:11:40 +00:00
|
|
|
Yao Zhao <dragonlinux@gmail.com>
|
2007-11-24 10:49:28 +00:00
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
Apologies if I missed anyone!
|
2007-11-24 10:49:28 +00:00
|
|
|
|
|
|
|
|
2008-06-11 22:42:54 +00:00
|
|
|
New and rewritten pages
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
acct.5
|
|
|
|
mtk
|
|
|
|
A complete rewrite of this page, now with much more detail.
|
|
|
|
|
|
|
|
hostname.7
|
|
|
|
mtk
|
2008-06-12 11:51:54 +00:00
|
|
|
A description og hostnames.
|
2008-06-11 22:42:54 +00:00
|
|
|
Taken from FreeBSD 6.2, and lightly edited for man-pages style.
|
|
|
|
|
|
|
|
symlink.7
|
|
|
|
mtk
|
|
|
|
Taken from FreeBSD 6.2, but heavily edited for Linux details,
|
2008-06-12 11:51:54 +00:00
|
|
|
improved readability, and man-pages style.
|
2008-06-11 22:42:54 +00:00
|
|
|
|
|
|
|
|
2008-06-12 10:11:40 +00:00
|
|
|
Newly documented interfaces in existing pages
|
|
|
|
---------------------------------------------
|
|
|
|
|
|
|
|
getrlimit.2
|
|
|
|
mtk / Peter Zijlstra
|
|
|
|
Add description of RLIMIT_RTTIME limit, new in 2.6.25.
|
|
|
|
|
|
|
|
mkstemp.3
|
|
|
|
mtk
|
|
|
|
Add description of mkostemp(), new in glibc 2.7.
|
|
|
|
|
|
|
|
core.5
|
|
|
|
mtk, after a note by Petr Gajdos; review by Neil Horman
|
|
|
|
Document core_pattern pipe syntax, which appeared in
|
2008-06-12 11:51:54 +00:00
|
|
|
kernel 2.6.19.
|
|
|
|
Add an example program demonstrating use of core_pattern
|
|
|
|
pipe syntax.
|
2008-06-12 10:11:40 +00:00
|
|
|
mtk
|
|
|
|
Document /proc/PID/coredump_filter, new in kernel 2.6.23.
|
2008-06-12 11:51:54 +00:00
|
|
|
Documentation was based on the text in
|
|
|
|
Documentation/filesystems/proc.txt, plus testing, and
|
|
|
|
reading the kernel source.
|
2008-06-12 10:11:40 +00:00
|
|
|
|
|
|
|
proc.5
|
|
|
|
mtk
|
|
|
|
Document /proc/PID/oom_score, which was new in kernel 2.6.11.
|
2008-06-12 11:51:54 +00:00
|
|
|
This file displays the "badness" score of the process, which
|
|
|
|
provides the basis for OOM-killer decisions.
|
2008-06-12 10:11:40 +00:00
|
|
|
mtk
|
|
|
|
Document /proc/PID/oom_adj, which was new in kernel 2.6.11.
|
2008-06-12 11:51:54 +00:00
|
|
|
This file influences the oom_score of a process.
|
2008-06-12 10:11:40 +00:00
|
|
|
mtk
|
|
|
|
Document /proc/PID/limits, which was new in 2.6.24.
|
2008-06-12 11:51:54 +00:00
|
|
|
This file displays a process's resource limits.
|
2008-06-12 10:11:40 +00:00
|
|
|
mtk
|
|
|
|
Document /proc/PID/fdinfo/*, which was new in 2.6.22.
|
|
|
|
These files display info about each descriptor opened by the
|
2008-06-12 11:51:54 +00:00
|
|
|
process: the current file offset, and the file access mode +
|
|
|
|
file status flags as set in open() or fcntl(F_SETFL).
|
2008-06-12 10:11:40 +00:00
|
|
|
mtk
|
|
|
|
Document /proc/PID/mountinfo, which was new in 2.6.26.
|
2008-06-12 11:51:54 +00:00
|
|
|
This file displays information about mount points.
|
|
|
|
Closely based on text from Documentation/filesystems/proc.txt.
|
2008-06-12 10:11:40 +00:00
|
|
|
mtk
|
|
|
|
Document /proc/PID/mountstats, which was new in 2.6.17.
|
2008-06-12 11:51:54 +00:00
|
|
|
This file displays statistics about mount points.
|
2008-06-12 10:11:40 +00:00
|
|
|
|
|
|
|
|
|
|
|
New links
|
|
|
|
---------
|
|
|
|
|
|
|
|
mkostemp.3
|
|
|
|
mtk
|
|
|
|
Link to mkstemp.3.
|
|
|
|
|
2008-06-12 11:46:56 +00:00
|
|
|
getcwd.2
|
|
|
|
mtk
|
|
|
|
Link to getcwd.3, which describes several interfaces, among
|
2008-06-12 11:51:54 +00:00
|
|
|
them getcwd(), which is in fact a system call.
|
2008-06-12 10:11:40 +00:00
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
Global changes
|
|
|
|
--------------
|
2007-11-24 10:49:28 +00:00
|
|
|
|
2008-06-11 22:42:54 +00:00
|
|
|
chown.2
|
|
|
|
faccessat.2
|
|
|
|
fchmodat.2
|
|
|
|
fchownat.2
|
|
|
|
fstatat.2
|
|
|
|
getxattr.2
|
|
|
|
link.2
|
|
|
|
linkat.2
|
|
|
|
listxattr.2
|
|
|
|
open.2
|
|
|
|
readlink.2
|
|
|
|
removexattr.2
|
|
|
|
rename.2
|
|
|
|
setxattr.2
|
|
|
|
stat.2
|
|
|
|
symlink.2
|
|
|
|
symlinkat.2
|
|
|
|
unlink.2
|
|
|
|
futimes.3
|
|
|
|
remove.3
|
|
|
|
path_resolution.7
|
2008-06-10 08:47:02 +00:00
|
|
|
mtk
|
2008-06-11 22:42:54 +00:00
|
|
|
SEE ALSO: Add symlink(7).
|
|
|
|
|
2008-06-12 10:11:40 +00:00
|
|
|
intro.1
|
|
|
|
time.1
|
|
|
|
fcntl.2
|
|
|
|
gethostbyname.3
|
|
|
|
ioctl_list.2
|
|
|
|
mtk
|
|
|
|
Wrap source lines so that new sentence starts on new line.
|
|
|
|
|
2008-06-11 22:42:54 +00:00
|
|
|
addseverity.3
|
|
|
|
backtrace.3
|
|
|
|
dlopen.3
|
|
|
|
fmtmsg.3
|
|
|
|
getnameinfo.3
|
|
|
|
getpt.3
|
|
|
|
grantpt.3
|
|
|
|
makecontext.3
|
|
|
|
ptsname.3
|
|
|
|
tcgetsid.3
|
|
|
|
unlockpt.3
|
|
|
|
wordexp.3
|
2008-06-09 21:12:35 +00:00
|
|
|
mtk
|
2008-06-11 22:42:54 +00:00
|
|
|
Added VERSIONS section.
|
|
|
|
|
|
|
|
io_cancel.2
|
|
|
|
io_destroy.2
|
|
|
|
io_getevents.2
|
|
|
|
io_setup.2
|
|
|
|
io_submit.2
|
|
|
|
Alain Portal / mtk
|
|
|
|
Re-order ERRORS and SEE ALSO entries to be alphabetical.
|
2008-03-05 15:23:19 +00:00
|
|
|
|
2008-03-19 07:09:48 +00:00
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
Changes to individual pages
|
|
|
|
---------------------------
|
2008-06-05 20:14:50 +00:00
|
|
|
|
2008-06-11 22:42:54 +00:00
|
|
|
acct.2
|
|
|
|
mtk
|
|
|
|
Add a few more words to DESCRIPTION.
|
2008-06-12 11:51:54 +00:00
|
|
|
NOTES: Add pointer to acct(5).
|
2008-06-11 22:42:54 +00:00
|
|
|
|
|
|
|
alarm.2
|
|
|
|
Alain Portal
|
|
|
|
s/process/calling process/ so as to that the alarm signal is
|
2008-06-12 11:51:54 +00:00
|
|
|
delivered to the calling process.
|
2008-06-11 22:42:54 +00:00
|
|
|
|
2008-06-12 10:11:40 +00:00
|
|
|
brk.2
|
|
|
|
Yao Zhao / mtk
|
|
|
|
Clarify discussion of return value of sbrk().
|
|
|
|
mtk
|
|
|
|
DESCRIPTION: Add some sentences giving an overview of these
|
2008-06-12 11:51:54 +00:00
|
|
|
interfaces.
|
2008-06-12 10:11:40 +00:00
|
|
|
Add note recommending use of malloc(3).
|
2008-06-12 11:51:54 +00:00
|
|
|
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 10:11:40 +00:00
|
|
|
|
2008-06-11 22:42:54 +00:00
|
|
|
chmod.2
|
|
|
|
mtk
|
|
|
|
Clarify description of chmod() and fchmod().
|
2008-06-12 11:51:54 +00:00
|
|
|
Add further detail on S_ISUID, S_ISGID, and S_ISVTX permissions.
|
|
|
|
Reformat list of permissions bits.
|
2008-06-11 22:42:54 +00:00
|
|
|
|
|
|
|
chown.2
|
|
|
|
mtk
|
|
|
|
Describe rules governing ownership of new files (bsdgroups
|
2008-06-12 11:51:54 +00:00
|
|
|
versus sysvgroups, and the effect of the parent directory's
|
|
|
|
set-group-ID permission bit).
|
2008-06-11 22:42:54 +00:00
|
|
|
|
|
|
|
chroot.2
|
|
|
|
Alain Portal
|
|
|
|
Clarify description a little.
|
2008-06-12 11:51:54 +00:00
|
|
|
s/changes the root directory/
|
|
|
|
changes the root directory of the calling process/
|
2008-06-11 22:42:54 +00:00
|
|
|
|
2008-06-12 10:11:40 +00:00
|
|
|
execve.2
|
|
|
|
mtk
|
|
|
|
Fix text that warns against use of NULL argv and envp.
|
2008-06-12 11:51:54 +00:00
|
|
|
Using a NULL envp does in fact seem to be portable (works
|
2008-06-12 10:11:40 +00:00
|
|
|
on Solaris and FreeBSD), but the Linux semantics for a NULL
|
2008-06-12 11:51:54 +00:00
|
|
|
argv certainly aren't consistent with other implementations.
|
|
|
|
See http://bugzilla.kernel.org/show_bug.cgi?id=8408.
|
2008-06-12 10:11:40 +00:00
|
|
|
|
|
|
|
mknod.2
|
|
|
|
mtk
|
|
|
|
Note that EEXIST applies, even if the pathname is a
|
2008-06-12 11:51:54 +00:00
|
|
|
(possibly dangling) symbolic link.
|
2008-06-11 22:42:54 +00:00
|
|
|
|
|
|
|
open.2
|
2008-06-12 10:11:40 +00:00
|
|
|
mtk, after a note from Christoph Hellwig
|
2008-06-11 22:42:54 +00:00
|
|
|
NOTES: Note that access mode flags are not single bits,
|
2008-06-12 11:51:54 +00:00
|
|
|
and document the Linuxism "access mode 3".
|
2008-06-11 22:42:54 +00:00
|
|
|
See also http://thread.gmane.org/gmane.linux.kernel/653123.
|
|
|
|
|
2008-06-12 10:11:40 +00:00
|
|
|
sched_setscheduler.2
|
2008-06-11 22:42:54 +00:00
|
|
|
mtk
|
2008-06-12 10:11:40 +00:00
|
|
|
Add pointer to discussion of RLIMIT_RTTIME in getrlimit.2.
|
|
|
|
mtk, after a note by Andrew Clayton
|
|
|
|
Rewrote and restructured various parts of the page for greater
|
2008-06-12 11:51:54 +00:00
|
|
|
clarity.
|
2008-06-11 22:42:54 +00:00
|
|
|
|
|
|
|
dprintf.3
|
2008-06-10 08:47:02 +00:00
|
|
|
mtk
|
2008-06-11 22:42:54 +00:00
|
|
|
Note that these functions are included in the next POSIX revision.
|
2008-06-12 11:51:54 +00:00
|
|
|
Remove editorial discussion about what the functions should have
|
|
|
|
been named.
|
2008-06-10 08:47:02 +00:00
|
|
|
|
2008-06-11 22:42:54 +00:00
|
|
|
getaddrinfo.3
|
|
|
|
mtk
|
|
|
|
SEE ALSO: Add hostname(7).
|
|
|
|
|
|
|
|
getmntent.3
|
|
|
|
mtk, after Stuart Cunningham pointed out the typo
|
|
|
|
Remove statement that LSB deprecates the functions
|
2008-06-12 11:51:54 +00:00
|
|
|
"endmntent(), setmntent() [sic] and setmntent()".
|
|
|
|
This doesn't seem to be true (I can't find mention of
|
|
|
|
deprecation in any of the LSB specs). Rather, LSB simply
|
|
|
|
doesn't specify these functions. (LSB 1.3 had a spec of
|
|
|
|
setmntent(), but not getmntent() or endmntent(), and noted
|
|
|
|
that having a spec of setmntent() was of little use without
|
|
|
|
also having a spec of getmntent().)
|
|
|
|
See also https://lists.linux-foundation.org/pipermail/\
|
|
|
|
lsb-discuss/2006-October/003078.html
|
2008-06-11 22:42:54 +00:00
|
|
|
|
2008-06-12 10:11:40 +00:00
|
|
|
getnameinfo.3
|
|
|
|
mtk
|
|
|
|
Various minor changes.
|
|
|
|
|
2008-06-11 22:42:54 +00:00
|
|
|
mkfifo.3
|
|
|
|
mtk
|
|
|
|
Note that EEXIST applies, even if the pathname is a
|
2008-06-12 11:51:54 +00:00
|
|
|
(possibly dangling) symbolic link.
|
2008-06-11 22:42:54 +00:00
|
|
|
|
2008-06-12 10:11:40 +00:00
|
|
|
mkstemp.3
|
|
|
|
mtk
|
2008-06-12 11:51:54 +00:00
|
|
|
Fix discussion of O_EXCL flag.
|
2008-06-12 10:11:40 +00:00
|
|
|
These functions may also fail for any of the errors described
|
2008-06-12 11:51:54 +00:00
|
|
|
in open(2).
|
|
|
|
Various other rewordings.
|
2008-06-12 10:11:40 +00:00
|
|
|
|
2008-06-11 22:42:54 +00:00
|
|
|
remainder.3
|
|
|
|
mtk
|
|
|
|
Recommend against drem(), in favor of remainder().
|
|
|
|
|
|
|
|
man-pages.7
|
|
|
|
mtk
|
|
|
|
Enhanced description of VERSIONS section.
|
2008-06-12 11:51:54 +00:00
|
|
|
|
2008-06-11 22:42:54 +00:00
|
|
|
mq_overview.7
|
|
|
|
mtk
|
|
|
|
Note that Linux does not currently support ACLs for POSIX
|
2008-06-12 11:51:54 +00:00
|
|
|
message queues.
|
2008-06-11 22:42:54 +00:00
|
|
|
|
|
|
|
sem_overview.7
|
2008-06-05 20:14:50 +00:00
|
|
|
mtk
|
2008-06-11 22:42:54 +00:00
|
|
|
Note that Linux supports ACLs on POSIX named semaphores
|
2008-06-12 11:51:54 +00:00
|
|
|
since 2.6.19.
|
2008-06-11 22:42:54 +00:00
|
|
|
|
|
|
|
unix.7
|
|
|
|
mtk, after a note by Samuel Thibault
|
|
|
|
Provide a clear description of the three types of address that
|
2008-06-12 11:51:54 +00:00
|
|
|
can appear in the sockaddr_un structure: pathname, unnamed,
|
|
|
|
and abstract.
|