* 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
