2008年06月26日 星期四 00:20
----- Forwarded message from Michael Kerrisk <> ----- From: Michael Kerrisk <> Date: Wed, 25 Jun 2008 18:14:27 +0200 Subject: man-pages-3.01 is released Gidday I've released man-pages-3.01. This release is now available for download at: http://www.kernel.org/pub/linux/docs/man-pages or ftp://ftp.kernel.org/pub/linux/docs/man-pages This release is now available for download at: http://www.kernel.org/pub/linux/docs/man-pages or ftp://ftp.kernel.org/pub/linux/docs/man-pages The online changelog is available at http://www.kernel.org/doc/man-pages/changelog.html (blogged at http://linux-man-pages.blogspot.com/2008/06/man-pages-301-is-released.html) and the current version of the pages is browsable at http://www.kernel.org/doc/man-pages/ An abridged version of the changes in this release that may be of interest to readers of this list is provided below. Cheers, Michael ==================== Changes in man-pages-3.01 ==================== New and rewritten pages ----------------------- acct.5 mtk A complete rewrite of this page, now with much more detail. hostname.7 mtk A description of hostname resolution. Taken from FreeBSD 6.2, and lightly edited for man-pages style. symlink.7 mtk A description of symbolic links. Taken from FreeBSD 6.2, but heavily edited for Linux details, improved readability, and man-pages style. 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 kernel 2.6.19. Add an example program demonstrating use of core_pattern pipe syntax. mtk 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 checking the kernel source. proc.5 mtk 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. mtk Document /proc/PID/oom_adj, which was new in kernel 2.6.11. This file influences the oom_score of a process. mtk Document /proc/PID/limits, which was new in 2.6.24. This file displays a process's resource limits. mtk 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). mtk 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. mtk Document /proc/PID/mountstats, which was new in 2.6.17. This file displays statistics about mount points. mtk Document /proc/PID/status. Samuel Thibault / mtk, review by Laurent Vivier, Christian Borntraeger, and Andrew P Document guest (virtual CPU) time field in /proc/stat. Document guest (virtual CPU) time fields in /proc/PID/stat. Changes to individual pages --------------------------- chmod.2 mtk Clarify description of chmod() and fchmod(). Add further detail on S_ISUID, S_ISGID, and S_ISVTX permissions. chown.2 mtk Describe rules governing ownership of new files (bsdgroups versus sysvgroups, and the effect of the parent directory's set-group-ID permission bit). getdents.2 mtk, after a note from George Spelvin Document d_type field, present since kernel 2.6.4. getitimer.2 mtk Linux 2.6.16 removed the MAX_SEC_IN_JIFFIES ceiling on timer values. nanosleep.2 mtk, after a report from Stephane Chazelas Remove crufty discussion of HZ, and replace with a pointer to time(7). See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=485636 mtk, after some discussions with Bart Van Assche and Roman Zippel 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?" mtk Replace mentions of "process' by "thread". NOTES: describe case where clock_nanosleep() can be preferable. Some minor rewrites. open.2 mtk, after a note from Christoph Hellwig 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. sched_setscheduler.2 mtk, after a note by Andrew Clayton Rewrote and restructured various parts of the page for greater clarity. mtk Add more detail to the rules that are applied when an unprivileged process with a non-zero RLIMIT_RTPRIO limit changes policy and priority. syscalls.2 mtk Added system call history back to version 1.2. adjtime.3 mtk The longstanding bug that if delta was NULL, olddelta didn't return the outstanding clock adjustment, is now fixed (since glibc 2.8 + kernel 2.6.26). http://sourceware.org/bugzilla/show_bug?id=2449 http://bugzilla.kernel.org/show_bug.cgi?id=6761 getaddrinfo.3 mtk Improve description or 'hints' and 'res' arguments. Add details on numeric strings that can be specified for 'node'. Other fairly major restructurings and rewrites to improve logical structure and clarity of the page. SEE ALSO: Add hostname(7). inet.3 mtk / Stephane Chazelas inet_aton() is *not* in POSIX.1. Rewrote discussion of why inet_addr() is disfavored. SEE ALSO: Add getaddrinfo(3). as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482979. mtk, after a note by Stephane Chazelas Describe the various address forms supported by inet_aton(). mtk 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. mtk 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). inet_pton.3 mtk / Stephane Chazelas 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(). SEE ALSO: Add getaddrinfo(3). as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482987. mtk Describe IPv6 address formats. Describe dotted decimal format in more detail. Add an example program. mtk Remove unneeded header files from SYNOPSIS. Make NAME line more precise. Make description of return value more precise. SEE ALSO: Add inet(3). readdir.3 mtk Document DT_LNK (symbolic link) for d_type field. Reorder DT_ entries alphabetically. scanf.3 mtk, after a note from Stephane Chazelas Add an ERRORS section documenting at least some of the errors that may occur for scanf(). See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=487254. mtk, after a note from Stephane Chazelas; review by Stephane Chazelas Document the GNU 'a' modifier for dynamically allocating strings. See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=487254. Document the GNU 'm' modifier for dynamically allocating strings. random.4 George Spelvin (taking time out from his busy Broadway schedule), with some tweaks by Matt Mackall and mtk Add a Usage subsection that recommends most users to use /dev/urandom, and emphasizes parsimonious usage of /dev/random. locale.5 Petr Baudis <pasky at suse.cz> LC_TIME: Describe first_weekday and first_workday. proc.5 mtk The vaious CPU time fields in /proc/stat and /proc/PID/stat return time in clock ticks (USER_HZ, cputime_to_clock_t(), sysconf(_SC_CLK_TCK)). Updated, clarified and expanded the description several fields in /proc/[number]/stat. mtk Clarified and expanded the description of /proc/[number]/fd. mtk Updated and clarified the description of /proc/[number]/statm. mtk Updated and clarified the description of /proc/sys/fs/dentry-state. time.7 mtk, with some suggestions from Bart Van Assche and Thomas Gleixner Added some details about where jiffies come into play. Added section on high-resolution timers. Mentioned a few other time-related interfaces at various points in the page. See http://thread.gmane.org/gmane.linux.kernel/697378. unix.7 mtk, after a note by Samuel Thibault Provide a clear description of the three types of address that can appear in the sockaddr_un structure: pathname, unnamed, and abstract. -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo at vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/ ----- End forwarded message ----- -- Hi, I'm a .signature virus, please copy/paste me to help me spread all over the world.
2008年06月26日 星期四 01:21
On Wed, Jun 25, 2008 at 05:20:39PM +0100, WANG Cong wrote: >----- Forwarded message from Michael Kerrisk <> ----- > >From: Michael Kerrisk <> >Date: Wed, 25 Jun 2008 18:14:27 +0200 >Subject: man-pages-3.01 is released > >Gidday > >I've released man-pages-3.01. > >This release is now available for download at: > > http://www.kernel.org/pub/linux/docs/man-pages 解压,make ,make install安装后, kongove在ubuntu:~$ man --version man, version 2.4.4, 2007-02-12 版本信息为变化,但man手册内容已经更新。 系统原来只有27M,现在增大到34M了。看来更新挺大的~ > or ftp://ftp.kernel.org/pub/linux/docs/man-pages > >This release is now available for download at: > > http://www.kernel.org/pub/linux/docs/man-pages > or ftp://ftp.kernel.org/pub/linux/docs/man-pages <.......>
Zeuux © 2024
京ICP备05028076号