Commit Graph

14247 Commits

Author SHA1 Message Date
Michael Kerrisk 1148d9343f bpf.2: ffix (multiple)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk 9a5215bfad bpf.2: srcfix: wrap source lines at sentence breaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Alexei Starovoitov cc7ac21d25 bpf.2: New page documenting bpf(2)
Signed-off-by: Alexei Starovoitov <ast@plumgrid.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk b1e6b7c776 socket.7: SEE ALSO: add bpf(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk f735e9ee34 socket.7: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk 0563f2047b capabilities.7: CAP_SYS_ADMIN allows calling bpf(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk 9dbfb3b839 sched_setaffinity.2: Improvements after comments by Florian Weimer
Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 14:36:54 +02:00
Michael Kerrisk dde6d764a3 sched_setaffinity.2: Rework text about dealing with systems with more than 1024 CPUs
After comments from Florian Weimer, who pointed out various
confusions in the earlier text.

Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 14:36:54 +02:00
Michael Kerrisk abbbace718 sched_setaffinity.2: Explain how to deal with 1024-CPU limitation of glibc's cpu_set_t type
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 14:36:53 +02:00
Julian Orth c3529e3b3a sched_setattr.2: Remove a const attribute
The attr argument of sched_setattr was documented as const but the
kernel will modify the size field of this struct if it contains an
invalid value. See the documentation of the size field for details.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 09:38:36 +02:00
Vince Weaver e38fb93eea perf_event_open.2: Exclude_host/exclude_guest clarification
This patch relates to the exclude_host and exclude_guest bits added
by the following commit:

   exclude_host, exclude_guest; Linux 3.2
        commit a240f76165e6255384d4bdb8139895fac7988799
        Author: Joerg Roedel <joerg.roedel@amd.com>
        Date:   Wed Oct 5 14:01:16 2011 +0200

            perf, core: Introduce attrs to count in either host or guest mode

The updated manpage text clarifies that the "exclude_host" and
"exclude_guest" perf_event_open() attr bits only apply in the
context of a KVM environment and are currently x86 only.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Acked-by: Joerg Roedel <jroedel@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-22 20:51:26 +02:00
Vince Weaver f5281dfdd8 perf_event_open.2: Document PERF_SAMPLE_REGS_INTR
This patch relates to the addition of PERF_SAMPLE_REGS_INTR
support added in the following commit:

    perf_sample_regs_intr; Linux 3.19
	commit 60e2364e60e86e81bc6377f49779779e6120977f
	Author: Stephane Eranian <eranian@google.com>

            perf: Add ability to sample machine state on interrupt

The primary difference between PERF_SAMPLE_REGS_INTR and the
existing PERF_SAMPLE_REGS_USER is that the new support will
return kernel register values.  Also if precise_ip is
set higher than 0 then the PEBS register state will be returned
rather than the saved interrupt state.

This patch incorporates feedback from Stephane Eranian and
Andi Kleen.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-22 20:45:19 +02:00
Michael Kerrisk 4607213d6b mprotect.2: Note ENOMEM error that can occur when we reach limit on maximum VMAs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-22 09:18:26 +02:00
Michael Kerrisk c0b897882c mmap.2: ERRORS: point out that ENOMEM can occur even for munmap()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-22 09:13:00 +02:00
Michael Kerrisk 74309bedf2 mmap.2: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-22 09:09:12 +02:00
Michael Kerrisk 911f1c7ace mmap.2: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-22 09:08:19 +02:00
Michael Kerrisk 88b001ffe8 mmap.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-22 09:04:55 +02:00
Michael Kerrisk 9882fc693b epoll.7: wfix
Reported-by: Dilyan Palauzov <dilyan.palauzov@aegee.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-21 21:14:31 +02:00
Michael Kerrisk 555c445244 mlock.2: Document another ENOME error case
ENOMEM can occur if locking/unlocking in the middle of a region
would increase the number of VMAs beyond the system limit (64k).

Reported-by: Mehdi Aqadjani Memar <m.aqadjanimemar@student.vu.nl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-21 20:47:17 +02:00
Michael Kerrisk 8e085a68d0 console_codes.4: Add kernel version for "Set the cursor blink interval" sequence
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-21 18:54:14 +02:00
Scot Doyle 7be0bf81de console_codes.4: Add CSI sequence for cursor blink interval
Add a Console Private CSI sequence to specify the current
console's cursor blink interval. The interval is specified
as a number of milliseconds until the next cursor display
state toggle, from 50 to 65535.

Acked-by: Pavel Machek <pavel@ucw.cz>
Signed-off-by: Scot Doyle <lkml14@scotdoyle.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-21 18:49:22 +02:00
Michael Kerrisk eb5367ada7 hosts.equiv.5: Minor improvement to text
As discussed with Carlos O'Donell.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-21 16:02:53 +02:00
Michael Kerrisk bb2f758044 fallocate.2: Since Linux 4.2, ext4 supports FALLOC_FL_INSERT_RANGE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-21 08:38:07 +02:00
Michael Kerrisk da31981e88 error.3: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-19 14:32:48 +02:00
Zeng Linggang b08ffceb33 error.3: ATTRIBUTES: Note functions that are/aren't thread-safe
The markings match glibc markings.
markings of functions in glibc are:
- error:         MT-Safe locale
- error_at_line: MT-Unsafe race:error_at_line/error_one_per_line locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-19 14:28:52 +02:00
Michael Kerrisk 087dd22bfd locale.5: Remove BUGS section saying man page is not complete
To some degree, this is true of many pages. And anyway, this
page is much better after recent work by Marko.

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Ville Skyttä 1927bf89ec ldconfig.8: wsfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Ville Skyttä f5ddfb6af4 man-pages-4.01.Announce: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Michael Kerrisk 903770d316 LIST_EMPTY.3, LIST_FIRST.3, LIST_FOREACH.3, LIST_HEAD_INITIALIZER.3, LIST_INSERT_BEFORE.3, LIST_NEXT.3, SLIST_EMPTY.3, SLIST_ENTRY.3, SLIST_FIRST.3, SLIST_FOREACH.3, SLIST_HEAD.3, SLIST_HEAD_INITIALIZER.3, SLIST_INIT.3, SLIST_INSERT_AFTER.3, SLIST_INSERT_HEAD.3, SLIST_NEXT.3, SLIST_REMOVE.3, SLIST_REMOVE_HEAD.3, STAILQ_CONCAT.3, STAILQ_EMPTY.3, STAILQ_ENTRY.3, STAILQ_FIRST.3, STAILQ_FOREACH.3, STAILQ_HEAD.3, STAILQ_HEAD_INITIALIZER.3, STAILQ_INIT.3, STAILQ_INSERT_AFTER.3, STAILQ_INSERT_HEAD.3, STAILQ_INSERT_TAIL.3, STAILQ_NEXT.3, STAILQ_REMOVE.3, STAILQ_REMOVE_HEAD.3, TAILQ_CONCAT.3, TAILQ_EMPTY.3, TAILQ_FIRST.3, TAILQ_FOREACH.3, TAILQ_FOREACH_REVERSE.3, TAILQ_HEAD_INITIALIZER.3, TAILQ_INSERT_BEFORE.3, TAILQ_LAST.3, TAILQ_NEXT.3, TAILQ_PREV.3, TAILQ_SWAP.3: New link to queue.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Michael Kerrisk ed69ec5292 queue.3: srcfix: Add license marker tags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Michael Kerrisk 43e48f9eab queue.3: Use real hyphens in code samples
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Michael Kerrisk 929ec2c61d queue.3: Update timestamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Michael Kerrisk 9a8f31143b queue.3: Replace HISTORY with CONFORMING TO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Michael Kerrisk 3693b3d79a queue.3: Remove SEE ALSO reference to nonexistent tree(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Michael Kerrisk d20b994c37 queue.3: Use subsections in DESCRIPTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Michael Kerrisk 6559169cac queue.3: Comment out text for functions not in glibc
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Michael Kerrisk c0f21a05f0 queue.3: Reimport from latest FreeBSD page
Long ago, Doug Klima noted that many macros were not
documented in the queue(3) page. Fix by reimporting from
latest [1] FreeBSD man page.

[1] Revision 263142, Modified Fri Mar 14 03:07:51 2014 UTC

This also fixes https://sourceware.org/bugzilla/show_bug.cgi?id=1506

This time, I'll learn from past mistakes and not convert
from 'mdoc' to 'man' macros.

Reported-by: David Leppik <dleppik@vocalabs.com>
Reported-by: Doug Klima <cardoe@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Marko Myllynen 5ca8b4fa32 locale.5: document era keywords
This patch completes the LC_TIME section - since these era
keywords are so tightly coupled, I'm providing them as a
single patch.

Based on
http://pubs.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap07.html
http://www.open-std.org/jtc1/SC22/WG20/docs/n972-14652ft.pdf

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Zeng Linggang 365dc8d352 xdr.3: ATTRIBUTES: Note functions that are thread-safe
After research, We think
xdr_array(), xdr_bool(),
xdr_bytes(), xdr_char(),
xdr_destroy(), xdr_double(),
xdr_enum(), xdr_float(),
xdr_free(), xdr_getpos(),
xdr_inline(), xdr_int(),
xdr_long(), xdrmem_create(),
xdr_opaque(), xdr_pointer(),
xdrrec_create(), xdrrec_eof(),
xdrrec_endofrecord(),
xdrrec_skiprecord(),
xdr_reference(), xdr_setpos(),
xdr_short(), xdrstdio_create(),
xdr_string(), xdr_u_char(),
xdr_u_int(), xdr_u_long(),
xdr_u_short(), xdr_union(),
xdr_vector(), xdr_void(),
xdr_wrapstring(),
are thread-safe. But, there are not
markings of them in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Zeng Linggang 7d30e395a0 rpc.3: ATTRIBUTES: Note functions that are thread-safe
After research, We think
auth_destroy(), authnone_create(),
authunix_create(), authunix_create_default(),
callrpc(), clnt_broadcast(),
clnt_call(), clnt_destroy(),
clnt_create(), clnt_control(),
clnt_freeres(), clnt_geterr(),
clnt_pcreateerror(), clnt_perrno(),
clnt_perror(), clnt_spcreateerror(),
clnt_sperrno(), clnt_sperror(),
clntraw_create(), clnttcp_create(),
clntudp_create(), clntudp_bufcreate(),
get_myaddress(), pmap_getmaps(),
pmap_getport(), pmap_rmtcall(),
pmap_set(), pmap_unset(),
registerrpc(), svc_destroy(),
svc_freeargs(), svc_getargs(),
svc_getcaller(), svc_getreqset(),
svc_getreq(), svc_register(),
svc_run(), svc_sendreply(),
svc_unregister(), svcerr_auth(),
svcerr_decode(), svcerr_noproc(),
svcerr_noprog(), svcerr_progvers(),
svcerr_systemerr(), svcerr_weakauth(),
svcfd_create(), svcraw_create(),
svctcp_create(), svcudp_bufcreate(),
svcudp_create(), xdr_accepted_reply(),
xdr_authunix_parms(), xdr_callhdr(),
xdr_callmsg(), xdr_opaque_auth(),
xdr_pmap(), xdr_pmaplist(),
xdr_rejected_reply(), xdr_replymsg(),
xprt_register(), xprt_unregister(),
are thread-safe. But, there are not
markings of them in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Michael Kerrisk 17e38dad94 getauxval.3: File capabilities also trigger AT_SECURE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-15 16:36:02 +02:00
Michael Kerrisk fe56ce1c5f seccomp.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-13 14:06:24 +02:00
Michael Kerrisk 81f3ee482d uselib.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-10 20:00:22 +02:00
Michael Kerrisk 2e380e890b getauxval.3: (Briefly) document AT_HWCAP2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-08 11:04:49 +02:00
Michael Kerrisk 023ad3b197 memcpy.3: NOTES: describe the glibc 2.13 changes that revealed buggy applications
Adding a note on this point seems worthwhile as a way of
emphasizing the point that the buffers must not overlap.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-03 14:00:30 +02:00
Michael Kerrisk ccc357f7c6 fcntl.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-03 12:40:48 +02:00
Michael Kerrisk 3c5ab7703e seccomp.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-03 12:40:48 +02:00
Michael Kerrisk 85fbef7408 prctl.2, seccomp.2: Clarify that SECCOMP_SET_MODE_STRICT disallows exit_group(2)
These days, glibc implements _exit() as a wrapper around
exit_group(2). (When seccomp was originally introduced, this was
not the case.) Give the reader a clue that, despite what glibc is
doing, what SECCOMP_SET_MODE_STRICT permits is the true _exit(2)
system call, and not exit_group(2).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-03 12:40:16 +02:00
Michael Kerrisk 7a79bb301a seccomp.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-30 13:29:23 +02:00
Michael Kerrisk e9855ef2f7 seccomp.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-30 13:29:00 +02:00