Michael Kerrisk [Mon, 18 Mar 2013 04:53:49 +0000 (05:53 +0100)]
mq_getattr.3: Add an example program
The example program can be used to discover the default
'mq_maxmsg' and 'mq_msgsize' values used to create a queue with
a mq_open(3) call in which 'attr' is NULL.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Marko Myllynen [Tue, 30 Sep 2014 10:30:55 +0000 (13:30 +0300)]
iso_8859-16.7: Charset pages unification, minor cleanups
- adjust references
- remove stray comments, streamline description
(charsets(7) and Wikipedia provide more detailed
and up-to-date description)
- cosmetics
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Marko Myllynen [Wed, 1 Oct 2014 09:21:25 +0000 (11:21 +0200)]
iso_8859-15.7: Charset pages unification, minor cleanups
- adjust references
- remove stray comments, streamline description
(charsets(7) and Wikipedia provide more detailed
and up-to-date description)
- cosmetics
Marko Myllynen [Tue, 30 Sep 2014 10:29:44 +0000 (13:29 +0300)]
iso_8859-2.7: Charset pages unification, minor cleanups
- adjust references
- remove stray comments, streamline description
(charsets(7) and Wikipedia provide more detailed
and up-to-date description)
- cosmetics
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Marko Myllynen [Wed, 1 Oct 2014 09:03:14 +0000 (11:03 +0200)]
iso_8859-1.7: Charset pages unification, minor cleanups
- adjust references
- remove stray comments, streamline description
(charsets(7) and Wikipedia provide more detailed
and up-to-date description)
- cosmetics
Marko Myllynen [Tue, 30 Sep 2014 10:29:33 +0000 (13:29 +0300)]
koi8-u.7: Charset pages unification, minor cleanups
- adjust references
- remove stray comments, streamline description
(charsets(7) and Wikipedia provide more detailed
and up-to-date description)
- list differences between koi8-r.7 vs koi8-u.7
- cosmetics
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Marko Myllynen [Tue, 30 Sep 2014 10:29:29 +0000 (13:29 +0300)]
koi8-r.7: Charset pages unification, minor cleanups
- adjust references
- remove stray comments, streamline description
(charsets(7) and Wikipedia provide more detailed
and up-to-date description)
- list differences between koi8-r.7 vs koi8-u.7
- cosmetics
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Marko Myllynen [Tue, 30 Sep 2014 10:29:11 +0000 (13:29 +0300)]
ascii.7: Charset pages unification, minor cleanups
This and the follow-up patches will provide unification of
charset pages, minor cleanups, and some unifying cosmetic
changes. References are adjusted so that all pages include
a reference to charsets(7), which contains a description of
these sets, stray comments are removed, some obsolete
statements (like ISO 8859-1 being the de-facto ASCII
replacement) are removed, and some minor reformatting
to minimize diff's between the pages are done.
The actual substance, the character tables, remain unchanged.
This series changes the following pages (under man7): ascii,
armscii, cp1251, koi8-r, koi8-u, and all of iso_8859-*.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This patch adds a short description about the contents of
/proc/buddyinfo and how this file can be used to assist
in checking for memory fragmentation issues.
Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 23 Sep 2014 04:09:41 +0000 (06:09 +0200)]
execve.2: Remove unneeded ".sh" extension in interpreter script example
See https://bugzilla.kernel.org/show_bug.cgi?id=84701
As noted by C. Alex North-Keys:
1) Command name extensions considered harmful: Adding ".sh", or
any other unneeded extension, unnecessarily duplicates meta
information already present in the interpreter directive,
exposing an implementation detail that then ends up explicitly
part of other programs running this one. Later, when such a
script is replaced with a new version in Python, C, etc., the
useless ".sh" has to be retained to avoid breaking those other
programs' calls to this one, and now has a stark antifunction
of lying about the script's content and occasionally causing
admins to run undefined experiments as root (like
"bash -x ./reallyperlscript.sh"). Such extensions, while fine
in DOS which ignores extensions explicitly, is a serious flaw
in Unix-targeted script writing. Canonical documentation
from the Linux manual should not support such a flawed idiom -
recommending against it would be preferred.
A more extensive rant against them can be found at:
http://www.talisman.org/~erlkonig/documents/commandname-extensions-considered-harmful
2) The space after "#!" in the interpreter directive is minor -
and the kernel's fs/binfmt_script.c specifically allows for it -
but versions of unix have length limits from ~30 characters to
Linux's 127 or so (if that number's correct) so the space does
have a cost. Most scripts I've seen lack that space, and
there's no real reason to encourage it.
Reported-by: C. Alex North-Keys <erlkonig@talisman.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
CLONE_NEWIPC is the correct constant, as can be seen in the detailed
list of namespaces & their corresponding constants, as well as the
clone(2) man page and include/uapi/linux/sched.h in the Linux source tree.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Carlos O'Donell [Wed, 10 Sep 2014 16:45:25 +0000 (12:45 -0400)]
getgrent.3: Add ENOENT and EAGAIN to error list
It's possible to get ENOENT returned from getgrent()
if the backend, for example say SSSD, isn't configured
or the daemon isn't running. The same can be said of any
of the NSS backend.
As POSIX does not list ENOENT, we can list it ourselves
and define it how we like.
I don't know how you handle errno values that are glibc
specific, but here is the patch that enhances getgrent(3)
to make users aware of what ENOENT is intended to mean
from glibc.
While I'm fixing one I might as well [add EAGAIN].
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
projects / thirdparty / man-pages.git / log
