LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity
14,019 Commits 1 Branch 197 Tags 93 MiB
Commit Graph

14019 Commits

Author SHA1 Message Date
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
Michael Kerrisk 65cfc71220 seccomp.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-30 13:28:10 +02:00
Michael Kerrisk 29218e62cc truncate.2: ERRORS: ftruncate() can fail if the file descriptor is not writable 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-30 11:57:40 +02:00
Michael Kerrisk a68beb356c sched.7: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-27 11:09:23 +02:00
Michael Kerrisk 84dd132503 sched.7: Remove ancient, wildly optimistic prediction about future of RT patches 
It seems the patches were not merged by 2.6.30...

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-27 11:09:15 +02:00
Michael Kerrisk 8e8cd193a6 sched.7: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-26 11:07:43 +02:00
Michael Kerrisk 7b28cf6636 core.5: Mention 'coredump_filter' boot option 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-26 11:07:43 +02:00
Michael Kerrisk d726280aaf sched_setaffinity.2: Mention the use of the 'isolcpus' kernel boot option 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-26 11:07:43 +02:00
Michael Kerrisk b0ce4533dc getpriority.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-26 11:07:43 +02:00
Michael Kerrisk 7065339f71 hosts.equiv.5: Improve explanation in EXAMPLE 
Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-18 21:19:38 +02:00
Zeng Linggang af64225343 gsignal.3: ATTRIBUTES: Note functions that are thread-safe 
The markings match glibc markings.
markings of functions in glibc are:
- gsignal: MT-Safe
- ssignal: MT-Safe sigintr

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-18 09:04:30 +02:00
Zeng Linggang 98a731cd5f getpwent_r.3: ATTRIBUTES: Note functions that are/aren't thread-safe 
The markings match glibc markings.
markings of functions in glibc are:
- getpwent_r:  MT-Unsafe race:pwent locale
- fgetpwent_r: MT-Safe

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-18 09:04:25 +02:00
Zeng Linggang f8c46262e6 getgrent_r.3: ATTRIBUTES: Note functions that are/aren't thread-safe 
The markings match glibc markings.
markings of functions in glibc are:
- getgrent_r:  MT-Unsafe race:grent locale
- fgetgrent_r: MT-Safe

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-18 09:04:21 +02:00
Zeng Linggang cc0d547f4d clearenv.3: ATTRIBUTES: Note function that is not thread-safe 
The marking matches glibc marking.
The marking of functions in glibc is:
- clearenv: MT-Unsafe const:env

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-18 09:04:14 +02:00
Tobias Stoeckmann 4621e4e772 setsid.2: tfix 
it -> its

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-18 08:43:56 +02:00
Michael Kerrisk c139511aad packet.7: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-18 08:41:21 +02:00
Michael Kerrisk 62184395b3 proc.5: Document /proc/sys/kernel/sysctl_writes_strict 
Based on text in Documentation/sysctl/kernel.txt.

Cowritten-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-18 08:34:16 +02:00
Michael Kerrisk ba5ed753c5 hosts.equiv.5: Improve explanation in EXAMPLE 
Reported-by: Arjun Shankar <arjun@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-18 08:34:15 +02:00
Michael Kerrisk e7fd5cc233 hosts.equiv.5: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-18 08:34:15 +02:00
Michael Kerrisk 9e7cff750b hosts.equiv.5: Tweak's to Carlos's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-17 10:46:06 +02:00
Carlos O'Donell 427cee53f0 hosts.equiv.5: Fix format, clarify IdM needs, and provide examples. 
In some recent work with a Red Hat customer I had the opportunity
to discuss the fine nuances of the ruserok() function and related
API which are used to implement rlogin and rsh.

It came to my attention after working with QE on some automated
internal testing that there were no good examples in the hosts.equiv
manual page showing how the format was supposed to work for this
file and for ~/.rhosts, worse the "format" line showed that there
should be spaces between arguments when that would clearly lead
to incorrect behaviour. In addition some things that the format
allows you to write are just wrong like "-host -user" which makes
no sense since the host is already rejected, and should be written
as "host -user" instead. I added notes in the example to make it
clear that "-host -user" is invalid.

I fixed three things:

(a) The format line.
- Either +, or [-]hostname, or +@netgrp or -@netgrp.
- Either +, or [-]username, or +@netgrp or -@netgrp.
- You must specify something in the hostname portion so remove
  optional brackets.

(b) Clarify language around credentials
- If the host is not trusted you must provide credentials to
  the login system and that could be anything really and it
  depends on your configuration e.g. PAM or whatever IdM you have.

(c) Provide real-world examples
- Provide several real world examples and some corner case
  examples for how you would write something. Hopefully others
  can add examples as they see fit.

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-17 08:34:18 +02:00
Michael Kerrisk 6e9c8c174f host.conf.5: Wording fix: s/resolv+/the resolver library/ 
The term "resolv+" seems to be historical cruft.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-16 13:20:54 +02:00
Michael Kerrisk ba9aa794c8 chroot.2: Minor fixes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-16 13:20:47 +02:00
Stephan Mueller 3c4dfb62a5 socket.2: Update documentation reference for AF_ALG 
Signed-off-by: Stephan Mueller <stephan.mueller@atsec.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-16 10:07:00 +02:00
Jann Horn 614e269a80 chroot.2: chroot() is not intended for security; document attack 
It is unfortunate that this discourages this use of chroot(2)
without pointing out alternative solutions - for example,
OpenSSH and vsftpd both still rely on chroot(2) for security.

Bind mounts should theoretically be usable as a replacement, but
currently, they have a similar problem (CVE-2015-2925) that hasn't
been fixed in ~6 months, so I'd rather not add it to the manpage
as a solution before a fix lands.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-16 10:00:14 +02:00
Zeng Linggang 0326cdf21e fexecve.3: ATTRIBUTES: Note function that is thread-safe 
After research, We think fexecve() is thread-safe. But, there
is not marking of fexecve() in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-16 08:48:41 +02:00
Michael Kerrisk 8f7977002a resolver.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-12 21:46:36 +02:00
Michael Kerrisk 78b0e70aa8 rcmd.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-12 21:45:08 +02:00
Michael Kerrisk ea48f0aaa0 getrpcent.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-06-12 21:44:09 +02:00