* Various pages that formerly lacked the information now have
a note under RETURN VALUE that errno is set on error.
* Peng Haitao has submitted patches to around 50 pages that note
functions that are thread-safe or thread-unsafe. For this
purpose, the man-pages add a new section, ATTRIBUTES, as
described in the man-pages(7) manual page. Peng Haitao's
substantial work is ongoing, and more pages will add this
information in the future.
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=76
* Newly documented interfaces in existing pages
sched_rr_get_interval.2
Document /proc/sys/kernel/sched_rr_timeslice_ms
proc.5
Document /proc/[pid]/map_files directory
This directory was added in Linux v3.3 and provides info about
files being mmap-ed in a way very similar to how /proc/[pid]/fd
works.
v2: Added examples of how links look like and noted dependency
on kernel config option CONFIG_CHECKPOINT_RESTORE.
Document /proc/sys/kernel/shm_rmid_forced
capabilities.7
Document /proc/sys/kernel/cap_last_cap
* Global changes
* Various pages
Global fix: fix placement of word "only"
* Various pages
License headers: consistent format
* Various pages
Global fix: s/since kernel/since Linux/
* Various System V IPC pages in Section 2
Add "System V" to .TH line and text
Make it clear that these pages relate to System V IPC,
not POSIX IPC.
* Changes to individual pages
access.2
Clarify RETURN VALUE for F_OK
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=705293
alarm.2
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=74
* New and rewritten pages
canonicalize_file_name.3
Rewrite page, adding much more detail
* Global changes
* Various pages
Global fix: s/END_LICENSE/LICENSE_END/
* Various pages
Global fix: s/bitmask/bit mask/
* Changes to individual pages
getent.1
netgroup description incorrectly refers to initgroups
capget.2
Update URL for libcap
fork.2
Port access permission bits (ioperm()) are turned off in the child
futex.2
'timeout' is a minimum duration that the call will wait, not a maximum
ioperm.2
Note that iopl() level of 3 is needed to access ports
'num' is *bits* not bytes!
Linux 2.6.8 lifted the port limit to 65,536
See http://article.gmane.org/gmane.linux.kernel/202624/
From: Stas Sergeev <stsp <at> aknet.ru>
Subject: [patch][rfc] Larger IO bitmap
Date: 2004-05-07 19:55:03 GMT
ioperm() operates on the calling *thread* (not process)
Clarify meaning of 'turn_on' argument
Plus form formatting fixes.
Clarify that default state of permission bits in child is off
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=72
* New and rewritten pages
getunwind.2
New page documenting getunwind(2)
Taken from Red Hat downstream man pages set
Much rewriting
Some text taken from arch/ia64/kernel/unwind.c.
perfmonctl.2
New page documenting IA-64-specific perfmonctl(2)
Taken from Red Hat downstream man pages
Rework discussion of PFM_CREATE_CONTEXT
Add VERSIONS and CONFORMING TO
Note that there is no glibc wrapper
Remove PFM_CREATE_EVTSETS, PFM_DELETE_EVTSETS, PFM_GETINFO_EVTSETS
These don't exist, and it appears they never have.
Fix argument types for PFM_WRITE_PMCS, PFM_WRITE_PMDS, PFM_READ_PMDS
The types that were being used don't exist!
Briefly document PFM_GET_FEATURES, PFM_DEBUG, PFM_GET_PMC_RESET_VAL
gai.conf.5
New page documenting gai.conf
Taken from Red Hat downstream pages
nss.conf.5
New page describing nss.conf
* Newly documented interfaces in existing pages
clock_getres.2
Document CLOCK_REALTIME_COARSE and CLOCK_MONOTONIC_COARSE
Document CLOCK_BOOTTIME
Some improvements to CLOCK_BOOTTIME description
ptrace.2
Document PTRACE_GETREGSET, PTRACE_SETREGSET, PTRACE_SEIZE, and friends
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=70
* New and rewritten pages
perf_event_open.2
New page documenting perf_event_open(2)
pthread_setname_np.3
New page for pthread_setname_np(3) and pthread_getname_np(3)
* Newly documented interfaces in existing pages
prctl.2
Document PR_SET_CHILD_SUBREAPER and PR_GET_CHILD_SUBREAPER
ip.7
Add source-specific multicast sockopts
This patch adds documentation of several source-specific multicast
socket options that were added to kernel with implementation
of IGMPv3 in 2.5.68.
The following socket options were added:
IP_ADD_SOURCE_MEMBERSHIP
IP_DROP_SOURCE_MEMBERSHIP
IP_BLOCK_SOURCE
IP_UNBLOCK_SOURCE
IP_MSFILTER
* Pages moved across sections
getcontext.3
This page really belongs in Section 3 (moved from Section 2)
getdtablesize.3
Move from Section 2
sln.8
New page documenting the 'sln' command provided by glibc
Inspired by a Red Hat downstream page, but with rather
more detail.
* New and changed links
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=68
* New and rewritten pages
kcmp.2
New page for kcmp(2)
* Newly documented interfaces in existing pages
init_module.2
Document finit_module(2)
Document finit_module() 'flags' argument
Document MODULE_INIT_IGNORE_MODVERSIONS and
MODULE_INIT_IGNORE_VERMAGIC. (Some edits by mtk.)
* New and changed links
finit_module.2
New link to init_module.2
__after_morecore_hook.3
__free_hook.3
__malloc_initialize_hook.3
__memalign_hook.3
__realloc_hook.3
New link to malloc_hook.3
* Global changes
* Various pages
Global fix: s/tty/terminal/
* Changes to individual pages
clone.2
Add kernel versions for various CLONE_* constants
CLONE_NEWIPC governs mechanisms that don't have filesystem pathnames
CLONE_NEWIPC doesn't mount the POSIX MQ file system
Add an example program (CLONE_NEWUTS)
Some reworking of CLONE_NEWIPC text
No substantial content changes.
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=66
* New and rewritten pages
s390_runtime_instr.2
New page for s390-specific s390_runtime_instr(2)
if_nameindex.3
Document if_nameindex(3) and if_freenameindex(3)
Edits, improvements and corrections to Hideaki's page
Add an example program
if_nametoindex.3
New page documenting if_nametoindex(3) and if_indextoname(3)
* Newly documented interfaces in existing pages
* New and changed links
if_freenameindex.3
New link to if_nameindex.3
if_indextoname.3
New link to if_nametoindex.3
* Global changes
sysconf.3
cciss.4
Global fix: s/runtime/run time/
* Changes to individual pages
clone.2
Since 2.6.30, CLONE_NEWIPC also supports POSIX message queues
delete_module.2
Small rewording of description of effect of O_TRUNC
getrlimit.2
Document Linux's nonstandard treatment or RLIMIT_CPU soft limit
Upon encountering the RLIMIT_CPU soft limit when a SIGXCPU handler
has been installed, Linux invokes the signal handler *and* raises
the soft limit by one second. This behavior repeats until the
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=64
* New and rewritten pages
delete_module.2
Rewrite to Linux 2.6+ reality
Change license and copyright
There is now nothing left of the original FSF-copyrighted
page. So, change the copyright and license.
Substantial reorganization after comments from Rusty Russell
Rusty notes that O_NONBLOCK is almost always used in
practice. Therefore, it would be better to reorganize
the page to consider that "the default".
init_module.2
Rewrite to Linux 2.6+ reality
Change copyright and license
Little of the original page now remains. Change
copyright and license
Changes after review comments from Rusty Russell
Add various pieces describing Linux 2.6+ behavior
Pieces take from, or inspired by, a patch sent by Kees.
getauxval.3
Document getauxval() function added in glibc 2.16
* Global changes
* Various pages
Global fix: Use consistent capitalization in NAME section
The line(s) in the NAME section should only use capitals
where English usage dictates that. Otherwise, use
lowercase throughout.
* Various pages
Global fix: "userspace" ==> "user space" or "user-space"
Existing pages variously use "userspace or "user space".
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=62
* Newly documented interfaces in existing pages
getenv.3
Document secure_getenv(3)
* New and changed links
phys.2
New link to unimplemented.2
secure_getenv.3
New link to getenv.3
* Global changes
* Various pages
Global fix: s/-/\\-/ when real hyphen is required (e.g., in code)
* Various pages
Global fix: Various consistency fixes for SEE ALSO
* Various pages
Global fix: use "Linux kernel source" consistently
Rather than "kernel source".
* Various pages
Global fix: disable justification and hyphenation in SEE ALSO
For a better visual result, disable justification and hyphenation
in SEE ALSO where page names are long.
* Changes to individual pages
epoll_wait.2
Describe timeout limitation in kernels < 2.6.37
As reported by Fredrik (and as far as I can tell the problem
went back to 2.6.0):
The timeout argument has an upper limit. Any values above that
limit are treated the same as -1, i.e. to wait indefinitely.
The limit is given by:
#define EP_MAX_MSTIMEO min(1000ULL * MAX_SCHEDULE_TIMEOUT / HZ, \
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=60
* Global changes
* Various pages
Global fix: use UR macro where applicable
The syntax .UR http://example.com paired with .UE will create
links which one can interact, if the pager allows that. One
way to see the effect is ask the man(1) command to use browser
display, e.g.:
man -H man7/uri.7
("\:" is optional groff syntax to permit hyphenless line breaks.)
* Changes to individual pages
ldd.1
Add security note on untrusted executables
See also http://www.catonmat.net/blog/ldd-arbitrary-code-execution/
and
http://tldp.org/HOWTO/Program-Library-HOWTO/shared-libraries.html
clone.2
Rewrite discussion of sys_clone
futex.2
Марк Коренберг
Consolidate error descriptions to ERRORS
Various wording fix-ups
Fix description of EINVAL error
The current text seems incorrect. Replace with a more general
description.
getdents.2
select_tut.2
atof.3
atoi.3
pthread_create.3
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=57
* New and rewritten pages
get_robust_list.2
New page documenting get_robust_list(2) and set_robust_list(2)
mallinfo.3
New page for mallinfo(3)
malloc_info.3
New page for malloc_info(3)
malloc_stats.3
New man page for malloc_stats(3)
* Newly documented interfaces in existing pages
madvise.2
Document MADV_DONTDUMP and MADV_DODUMP
* New and changed links
set_robust_list.2
New link to new get_robust_list.2 page
LIST_ENTRY.3
LIST_HEAD.3
LIST_INIT.3
LIST_INSERT_AFTER.3
LIST_INSERT_HEAD.3
LIST_REMOVE.3
TAILQ_ENTRY.3
TAILQ_HEAD.3
TAILQ_INIT.3
TAILQ_INSERT_AFTER.3
TAILQ_INSERT_HEAD.3
TAILQ_INSERT_TAIL.3
TAILQ_REMOVE.3
CIRCLEQ_ENTRY.3
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=55
* New and rewritten pages
process_vm_readv.2
New page for process_vm_readv(2) and process_vm_writev(2)
mcheck.3
New man page for mcheck(3) and related functions
Also describes mcheck_check_all(3), mcheck_pedantic(3),
and mprobe(3)
* Newly documented interfaces in existing pages
rcmd.3
Document "_af" variants of these functions
Document rcmd_af(), rresvport_af(), iruserok_af(), ruserok_af().
Also some restructuring and other clarifications.
rexec.3
Document rexec_af()
* New and changed links
iruserok_af.3
rcmd_af.3
rresvport_af.3
ruserok_af.3
New links to rcmd.3
rexec_af.3
New link to rexec.3
* Changes to individual pages
clock_getres.2
Clarify difference between CLOCK_MONOTONIC and CLOCK_MONOTONIC_RAW
Note interactions of these two clocks with discontinuous
adjustments to the system time and NTP/adjtime(2).
fallocate.2
Fix description of ENOSYS and EOPNOTSUP errors
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=53
* New and rewritten pages
malloc_trim.3
New man page for malloc_trim(3)
malloc_usable_size.3
New man page for malloc_usable_size(3)
* Newly documented interfaces in existing pages
prctl.2
Document PR_SET_MM (new in Linux 3.3)
Various edits and improvements to Cyrill's patch
* Changes to individual pages
epoll_create.2
Rework discussion of 'size' argument
Add .SS for description of epoll_create1()
epoll_wait.2
Another thread can add to epoll instance while epoll_wait is blocked
See https://bugzilla.kernel.org/show_bug.cgi?id=43072
Clarify that epoll_pwait() blocks calling *thread*
A few wording improvements
fchmodat.2
Note difference between glibc wrapper and underlying system call
The wrapper function has a 'flags' argument (which currently
serves no purpose), while the underlying system call does not.
fcntl.2
Explain behaviour of F_GETLEASE during lease break
Change type of arg from "long" to "int"
Various fcntl(2) commands require an integral 'arg'.
The man page said it must be "long" in all such cases.
However, for the cases covered by POSIX, there is an
explicit requirement that these arguments be "int".
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=51
* New and rewritten pages
get_nprocs_conf.3
New page documenting get_nprocs_conf(3) and get_nprocs(3)
Some additions and improvements
malloc_get_state.3
New page documenting malloc_get_state(3) and malloc_set_state(3)
mallopt.3
New man page for mallopt(3)
mtrace.3
Complete rewrite of page, adding much more detail
scandirat.3
New page for scandirat(3) (new in glibc 2.15)
* Newly documented interfaces in existing pages
posix_memalign.3
Document aligned_alloc(3)
aligned_alloc() is new in C11.
Document pvalloc(3)
qsort.3
Add documentation of qsort_r(3)
Improvements to Mark R Bannister's qsort_r() patch
Add VERSIONS section for qsort_r()
* New and changed links
aligned_alloc.3
New link to posix_memalign.3
get_nprocs.3
Link to new get_nprocs_conf.3 page
malloc_set_state.3
Link to new malloc_get_state.3 page
pvalloc.3
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=49
* New and rewritten pages
getent.1
New page to document 'getent' binary provided by glibc
* Changes to individual pages
bdflush.2
Note that bdflush() is deprecated, and does nothing
nfsservctl.2
Note that this system call was removed in Linux 3.1
ptrace.2
add extended description of various ptrace quirks
Changes include:
s/parent/tracer/g, s/child/tracee/g - ptrace interface now
is sufficiently cleaned up to not treat tracing process
as parent.
Deleted several outright false statements:
- pid 1 can be traced
- tracer is not shown as parent in ps output
- PTRACE_ATTACH is not "the same behavior as if tracee had done
a PTRACE_TRACEME": PTRACE_ATTACH delivers a SIGSTOP.
- SIGSTOP _can_ be injected.
- Removed mentions of SunOS and Solaris as irrelevant.
- Added a few more known bugs.
Added a large block of text in DESCRIPTION which doesn't focus
on mechanical description of each flag and operation, but rather
tries to describe a bigger picture. The targeted audience is
a person which is reasonably knowledgeable in Unix but did not
spend years working with ptrace, and thus may be unaware of its
quirks. This text went through several iterations of review by
Oleg Nesterov and Tejun Heo.
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=44
* New and rewritten pages
sendmmsg.2
New page for sendmmsg(2)
Some pieces inspired by an initial attempt by Stephan Mueller.
* Newly documented interfaces in existing pages
fallocate.2
Document FALLOC_FL_PUNCH_HOLE
FALLOC_FL_PUNCH_HOLE was added in Linux 2.6.38,
for punching holes in the allocated space in a file.
* Changes to individual pages
dup.2
SYNOPSIS: Add "#include <fntl.h>" for O_* constants
fallocate.2
Substantial restructuring of DESCRIPTION
The addition of a second class of operation ("hole punching")
to the man page made it clear that some significant restructuring
is required. So I substantially reworked the page, including the
preexisting material on the default "file allocation" operation.
Add further details for FALLOC_FL_PUNCH_HOLE
ERRORS: Add EPERM error case for FALLOC_FL_PUNCH_HOLE
fork.2
NOTES: Describe clone() call equivalent to fork()
fsync.2
Various improvements
- explain the situation with disk caches better
- remove the duplicate fdatasync() explanation in the NOTES
section
- remove an incorrect note about fsync() generally requiring two
writes
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=43
* New and rewritten pages
recvmmsg.2
New man page for recvmmsg(2)
setns.2
New manual page for setns(2)
Various improvements
* Global changes
* Various pages
Global fix: remove spaces around em-dash
Normal English typographical convention is not to have
spaces around em dashes.
* Various pages
Global fix: s/null pointer/NULL pointer/
* Various pages
Global fix: use ORing
Use "ORing", not "OR'ing", nor an italic ".IR OR ing".
* Various pages
Global fix: consistent use of "null wide character"
Bring more consistency to the discussion of
"[terminating] null wide character"
by writing (at least in the initial use in a page)
"[terminating] null wide character (L'\0')".
* Various pages
Global fix: consistent use of "null byte"
Bring more consistency to the discussion of
"[terminating] null byte"
by writing (at least in the initial use in a page)
"[terminating] null byte ('\0')".
mount.2, prctl.2
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=39
* New and rewritten pages
rt_sigqueueinfo.2
New page for rt_sigqueueinfo(2) and rt_tgsigqueueinfo(2)
This replaces the previous '.so' man page link file for
rt_sigqueueinfo.2, which linked to this sigqueue() man page.
cciss.4
New man page for cciss driver
I obtained the information in this man page as a consequence
of having worked on the cciss driver for the past several years,
and having written considerable portions of it.
Copyedit by mtk
hpsa.4
New man page for the hpsa driver
I obtained the information in this man page as a consequence
of being the main author of the hpsa driver
Copyedits my mtk
* Newly documented interfaces in existing pages
fstatat.2
Document AT_NO_AUTOMOUNT
lseek.2
Document SEEK_HOLE and SEEK_DATA
These flags, designed for discovering holes in a file,
were added in Linux 3.1. Included comments from Eric
Blake and Sunil Mushran.
madvise.2
Add MADV_HUGEPAGE and MADV_NOHUGEPAGE
Document the MADV_HUGEPAGE and MADV_NOHUGEPAGE flags added to
madvise() in Linux 2.6.38.
* New and changed links
OBS-URL: https://build.opensuse.org/package/show/Documentation/man-pages?expand=0&rev=34