Michael Kerrisk
b59a4ee7bf
scanf.3: Document the quote (') modifier for decimal conversions
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 14:53:33 +13:00
Michael Kerrisk
2b609f22c4
printf.3: Add references to setlocale(3) in discussions of locales
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 14:53:33 +13:00
Michael Kerrisk
5d717bda58
printf.3: As a nonstandard extension, GNU treats 'll' and 'L' as synonyms
...
See https://bugzilla.kernel.org/show_bug.cgi?id=190341 .
Reported-by: Nadav Har'El <nyh@math.technion.ac.il>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 09:41:48 +13:00
Michael Kerrisk
1b8d305469
printf.3: Document nonstandard 'Z' modifier
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 09:20:50 +13:00
Michael Kerrisk
74b9e29f92
printf.3: Document 'q' length modifier
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 09:20:50 +13:00
Jakub Wilk
2e621720d0
iconv.1: ffix
...
Don't embolden commas between option names.
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 09:10:31 +13:00
Jakub Wilk
2081060818
iconv.1: tfix
...
Escape hyphens in option names and pathnames.
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 09:10:31 +13:00
Jakub Wilk
908a1b280a
proc.5: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 09:10:31 +13:00
Jakub Wilk
555b5c7b1b
vfork.2: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 09:10:31 +13:00
Jakub Wilk
ba71223dfb
ioctl_iflags.2: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 09:10:30 +13:00
Michael Kerrisk
e00916fdee
random_r.3: tfix
...
Reported-by: Jan Ziak <0xe2.0x9a.0x9b@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 09:10:30 +13:00
Michael Kerrisk
6e9219f775
capabilities.7: Further enhance the recommendation against new uses of CAP_SYS_ADMIN
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 09:10:30 +13:00
Michael Kerrisk
fa50d3d48b
capabilities.7: Explicitly point from CAP_SYS_ADMIN to "Notes for kernel developers"
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 09:10:24 +13:00
Michael Kerrisk
ddb624a9e5
capabilities.7: Improvements after feedback from Casey Schaufler
...
Reported-by: Casey Schaufler <casey@schaufler-ca.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 17:04:44 +13:00
Michael Kerrisk
8de5616fd7
capabilities.7: Add subsection with notes to kernel developers
...
Provide some notes to kernel developers considering how to choose
which capability should govern a new kernel feature.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 17:04:07 +13:00
Michael Kerrisk
5a5bde703f
proc.5: Add reference to slabinfo(5) in discussion of /proc/meminfo 'Slab' field
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 16:57:08 +13:00
Tadeusz Struk
58b9f0ebb9
readdir.3: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 13:09:18 +13:00
Michael Kerrisk
accc82d2d4
getopt.3: Correct details of use of <stdio.h> to get getopt() declaration
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 11:41:51 +13:00
Michael Kerrisk
a4746c3978
getopt.3: Reword discussion of error handling and reporting
...
The existing description was hard to understand. Break
it into a bullet list that separates out the details
in a manner that is easier to parse.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 10:29:14 +13:00
Michael Kerrisk
797438e749
getopt.3: Remove redundant text
...
The same information is described in two consecutive paragraphs.
Remove the shorter paragraph, leaving the longer one that
contains more information.
Reported-by: John Wiersba <jrw32982@yahoo.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 10:04:27 +13:00
Michael Kerrisk
606b226bd2
random_r.3: Add BUGS section pointing out the weirdness of the initstate_r() API
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 09:54:36 +13:00
Michael Kerrisk
516a39595e
random_r.3: Note that 'buf' records a pointer to 'statebuf'
...
See https://sourceware.org/bugzilla/show_bug.cgi?id=3662 .
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 09:49:08 +13:00
Michael Kerrisk
a689fdb223
random.3: Minor improvement to wording in NOTES
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 09:38:21 +13:00
Michael Kerrisk
f9a54fa1cd
random.3: Relocate information of "optimal" value of initstate() 'n' argument
...
The information was a bit hidden in NOTES.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 09:32:21 +13:00
Michael Kerrisk
4efbcb17e9
random_r.3: Add some usage notes for setstate_r()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 09:00:12 +13:00
Michael Kerrisk
91e37268d6
random_r.3: 'buf.state' must be initialized to NULL before calling initstate_r()
...
See https://bugzilla.kernel.org/show_bug.cgi?id=192801 .
See also the glibc source file string/strfry.c, which shows
an example of this initialization:
if (!init)
{
static char state[32];
rdata.state = NULL;
__initstate_r (time ((time_t *) NULL) ^ getpid (),
state, sizeof (state), &rdata);
init = 1;
}
Reported-by: Jan Ziak <0xe2.0x9a.0x9b@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 08:43:38 +13:00
Michael Kerrisk
48ac01a782
proc.5: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 07:54:19 +13:00
Michael Kerrisk
729b84f473
strverscmp.3: Fix comparison error in example program
...
Reported-by: Vivenzio Pagliari <vivenzio.pagliari@nokia.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 07:41:44 +13:00
Michael Kerrisk
6284854c9d
slabinfo.5: SEE ALSO: add slabtop(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk
c67f5ff2f9
sem_wait.3: Remove statement that SA_RESTART does not cause restarting
...
This has not been true since Linux 2.6.22. The description
of EINTR maintains a reference to signal(7), which explains
the historical details.
See https://bugzilla.kernel.org/show_bug.cgi?id=192071
Reported-by: Fabjan Sukalia <fsukalia@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk
700bfeba0a
read.2: Remove crufty text about EINTR and partial read
...
Remove bogus text saying that POSIX permits partial read
to return -1/EINTR on interrupt by a signal handler.
That statement already ceased to be true in SUSv1 (1995)!
See https://bugzilla.kernel.org/show_bug.cgi?id=193111
Reported-by: Steven Luo <steven@steven676.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk
1b1069ee02
getline.3: Handle null bytes in input
...
As reported by Kent:
The example input/output handler in this EXAMPLE is subject
to introducing subtle bugs if the input stream contains
literal null bytes.
Subsequently, there should be some warning that this occurs,
or an alternative using fwrite(3) might be better.
Change the example program to use fwrite(3).
See https://bugzilla.kernel.org/show_bug.cgi?id=192701
Reported-by: Kent Fredic <kentfredric@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk
0885f9504f
getline.3: EXAMPLE: better error handling
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk
cbc616e345
getline.3: EXAMPLE: specify file to be opened as command-line argument
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk
71fd04a347
getline.3: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk
809b6c47cc
getline.3: Use better variable name in example program
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk
4c3cfc369c
mbind.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk
f13970357e
random.7: Mention getentropy(3)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk
d9e71757d0
getrandom.2: glibc support was added in version 2.25
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk
933ab9c7f6
random.7: SEE ALSO: add getentropy(3)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk
15df4f6b42
getrandom.2: Remove getentropy(3) details and defer to new getentropy(3) page
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk
b026572816
getentropy.3: New page documenting getentropy(3)
...
getentropy(3) is added to glibc in version 2.25.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:03:15 +13:00
Michael Kerrisk
5b0fbedb2b
perf_event_open.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:02:47 +13:00
Michael Kerrisk
26d5cd2ff2
perf_event_open.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:02:47 +13:00
Michael Kerrisk
da8bd8a4a0
perf_event_open.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:02:47 +13:00
Michael Kerrisk
880403e90e
perf_event_open.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:02:47 +13:00
Hugo Guiroux
b4870e704b
perf_event_open.2: wsfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:02:47 +13:00
Namhyung Kim
aa3453a0db
statfs.2: Add more filesystem types
...
Add missing magic numbers from /usr/include/linux/magic.h
Signed-off-by: Namhyung Kim <namhyung@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:02:47 +13:00
Michael Kerrisk
4a96f7b56f
signalfd.2: Add a "Limitations" subsection heading in NOTES
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:02:47 +13:00
Michael Kerrisk
76e55b8a4c
signalfd.2: signalfd() doesn't play well with helper programs spawned by libraries
...
See https://lwn.net/Articles/415684/ .
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:02:47 +13:00