Wednesday, May 22, 2013

More man pages now rendered at man7.org

As detailed in this blog post, I've expanded the set of man pages rendered in HTML at http://man7.org/linux/man-pages/ to include pages in addition to those provided by the man-pages project. This change has several purposes. One main purpose is to provide a up-to-date and regularly updated HTML renderings of these man pages. (Most online man page renderings are out-of-date to some extent--in some cases, extremely out of date.) The other main purpose is to provide information on where to report bugs in each man page. To this end, each HTML rendering includes a COLOPHON that describes the origin of the page, notes the date when it was extracted, and provides information on where to report bugs in the page. (The man-pages project has already done this since December 2007, with the result that many more man page bugs are nowadays reported.)

Currently, man pages from nearly 40 projects are rendered, raising the number of pages rendered at man7.org from around 950 to around 1750. The projects that I have so far included have a bias that matches my interests: man-pages, projects related to low-level C and system programming (e.g., the ACL and extended attribute libraries), toolchain projects (e.g., gcc, gdb, Git, coreutils, binutils, util-linux), and other relevant tools (kmod, strace, ltrace, procps, expect) and tools relevant to manual pages (e.g., groff, man-db). The full list of projects and the corresponding man pages that are rendered can be found in the man pages by project index. I'm open to adding further projects to the rendered set, if they seem relevant. If you think there is a project that should be added, take a look at this blog post.

Tuesday, April 30, 2013

man-pages-3.51 is released

I've released man-pages-3.51. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org.

This is a relatively small release that has various fixes across a number of pages. Among the more notable changes in man-pages-3.51 are the following:

  • Documentation of various /proc interfaces was added in a number of pages.
  • Various architecture-specific details were added to the syscall(1) and clone(2) pages.

Saturday, March 16, 2013

man-pages-3.50 is released

I've released man-pages-3.50. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org.

This is a relatively small release; the notable changes in man-pages-3.50 are as follows:

  • I've rewritten the canonicalize_file_name(3) manual page, adding quite a bit more detail.
  • I've updated and added several details to what was a rather outdated ioperm(2) manual page.
  • The syscalls(2) page now includes the kernel version in which all system calls were added.
  • Elie de Brauwer added descriptions for various ioctl() interfaces for /dev/random in the random(4) page.

Friday, March 15, 2013

man-pages-3.49 is released

I've released man-pages-3.49. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org.

There are no content changes in this release: it consists purely of changes to comments inside the source of every manual page, in order to arrange the copyright and license sections into a standard order. The intent is to make it easier for scripts to parse the manual page sources to obtain the copyright and license of a page. For more details, see the changelog.

Tuesday, March 12, 2013

man-pages-3.48 is released

I've released man-pages-3.48. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org.

As well as many small fixes to various pages, the major changes in man-pages-3.48 are as follows:

  • A new getunwind(2) manual page, written by Marcela Maslanova, documents the IA-64-specific system call of the same name. This page, as well as all of the other new pages in this release, come from the Red Hat downstream man pages project.
  • A new perfmonctl(2) page, written by Ivana Varekova, documents the IA-64-specific system call of the same name.
  • Two new pages by Ulrich Drepper, gai.conf(5) and nss(5), document configuration files of the same name.
  • The clock_getres(2) page adds descriptions of the new clocks CLOCK_REALTIME_COARSE and CLOCK_MONOTONIC_COARSE, and CLOCK_BOOT_TIME. Thanks to Cyril Hrubis.
  • The ptrace(2) page adds descriptions pf the new commands PTRACE_GETREGSET, PTRACE_SETREGSET, and PTRACE_SEIZE. Thanks to Denys Vlasenko.

Thursday, March 7, 2013

HTML man-pages on kernel.org now redirect to man7.org

While things were repaired following the 2011 kernel.org break in, it ceased to be possible to update the HTML man pages renderings that I have for a few years maintained there. So I started placing updated renderings on my own domain, man7.org. Even after the kernel.org infrastructure was fully restored, it was still somewhat cumbersome to update 2000+ HTML pages at that location, so I subsequently continued to update the renderings at only man7.org.

Notwithstanding the fact that they are now significantly out of date, the kernel.org renderings have continued to see a lot of traffic. For that reason, I've asked the kernel.org admins to set redirects from the URLs on kernel.org to equivalent URLs on man7.org. All old links should just work; please let me know if there are any breakages.

Thursday, February 14, 2013

man-pages-3.47 is released

I've released man-pages-3.47. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org.

As well as many small fixes to various pages, the major changes in man-pages-3.47 are as follows:

  • A new perf_event_open(2) by Vincent Weaver documents the system call of the same name.
  • A new pthread_setname_np(3) page documents the pthread_setname_np() and pthread_getname_np() library functions.
  • A new sln(8) page document the sln command provided by glibc.
  • Several Red Hat downstream patches were merged.
  • Various section 2 pages add SEE ALSO entries that refer to related commands in the util-linux package.


185 Empty Chairs, Christchurch

Sunday, February 3, 2013

man-pages-3.46 is released

I've released man-pages-3.46. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org.

Aside from many small fixes to a wide range of pages, the main changes in man-pages-3.46 are as follows:

  • A new kcmp(2) by Cyrill Gorcunov documents the system call of the same name.
  • The init_module(2) page adds documentation of the finit_module() system call that was added in Linux 3.8.
  • The prctl(2) pages adds documentation for the PR_SET_PTRACER and PR_GET_TID_ADDRESS commands.
Canberra sunset

Saturday, December 22, 2012

man-pages-3.45 is released

I've released man-pages-3.45. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org.

Aside from various small fixes to a range of pages, the main changes in man-pages-3.45 are as follows:

  • A new s390_runtime_instr(2) by Jan Glauber documents the s390-specific system call of the same name that was added in Linux 3.7.
  • I've substantially rewritten the syslog(2) page to improve clarity, and added various details to the page.
  • A new if_nametoindex(3) page by YOSHIFUJI Hideaki documents the if_nametoindex() and if_indextoname() functions.
  • A new if_nameindex(3) page by YOSHIFUJI Hideaki, with some additions by me, documents the if_nameindex() and if_freenameindex() functions.

Thursday, November 15, 2012

man-pages-3.44 is released

I've released man-pages-3.44. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org.

Aside from various small fixes to a range of pages, the main changes in man-pages-3.44 are as follows:

  • The delete_module(2) and init_module(2) pages have been completely rewritten and updated to reflect Linux 2.6+ behavior.
  • A new getauxval(3) page documents the getauxval() function that was added to glibc in version 2.16.
  • The prctl(2) adds documentation of various commands.
  • The proc(5) page adds documentation of /proc/meminfo.

Sunday, October 21, 2012

man-pages-3.43 is released

I've released man-pages-3.43. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org.

The changes in man-pages-3.43 are mostly small fixes to a wide range of existing pages, including significant technical details in a number of pages. Other than that, the getenv(2) page adds documentation of the secure_getenv(3) function that is part of the upcoming glibc 2.17 release.

Friday, August 24, 2012

man-pages-3.42 is released

I've released man-pages-3.42. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org. The changes in man-pages-3.42 are mainly minor changes to a wide range of pages.

Thursday, May 17, 2012

man-pages-3.41 is released

I've released man-pages-3.41. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org.

The most notable changes in man-pages-3.41 are as follows:

  • A new get_robust_list(2) page, written by Ivana Varekova, documents the get_robust_list() and set_robust_list() system calls.
  • Three new pages written by me—mallinfo(3), malloc_info(3), and malloc_stats(3)—document various interfaces used to monitor the state of the malloc implementation.
  • The madvise(2) page adds documentation of the MADV_DONTDUMP and MADV_DODUMP operations.

Wednesday, May 2, 2012

man-pages-3.40 is released

I've released man-pages-3.40. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org.

The most notable changes in man-pages-3.40 are as follows:

  • A new process_vm_readv(2) page (created by Mike Frysinger based on material from Christopher Yeoh, with additions by me) documents the process_vm_readv() and process_vm_writev() system calls.
  • The prctl(2) page adds documentation of the PR_TASK_PERF_EVENTS_DISABLE and PR_TASK_PERF_EVENTS_ENABLE operations.
  • A new mcheck(3) page (by me) documents the mcheck(), mcheck_check_all(), mcheck_pedantic(), and mprobe() functions.
  • The rcmd(3) page adds documentation of the rcmd_af(), rresvport_af(), iruserok_af(), and ruserok_af() functions.
  • The rexec(3) page adds documentation of the rexec_af() function.

Monday, April 23, 2012

man-pages-3.39 is released

I've released man-pages-3.39. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org.

The most notable changes in man-pages-3.39 are as follows:

  • A new malloc_trim(3) page (by me) documents the malloc_trim() function.
  • A new malloc_usable_size(3) page (by me) documents the malloc_usable_size() function.
  • The prctl(2) page adds documentation of the PR_SET_MM operation, thanks to Cyrill Gorcunov
  • Rewrites of a large part of nsswitch.conf(5) to clarify the text and bring it up to date, thanks to Mark Bannister