Commit Graph

5636 Commits

Author SHA1 Message Date
Michael Kerrisk 4f9d01a93e backtrace.3: SEE ALSO: add addr2line(1) and gdb(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-07 09:26:56 +01:00
Michael Kerrisk cf3ecd874c posix_spawn.3: tfix
Reported-by: Paul Fee <paul.f.fee@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-03 15:43:05 +01:00
Michael Kerrisk 88f78c4aa7 ftw.3: Correctly handle use of stat info for FTW_NS in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-24 05:17:40 +01:00
Michael Kerrisk d252ac9d8b ftw.3: Clarify that stat buffer is undefined for FTW_NS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-24 05:15:07 +01:00
Michael Kerrisk e186d0ca34 mq_receive.3, mq_send.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:40:52 +01:00
Michael Kerrisk 1ce0421b98 mq_open.3: Include definition of the 'mq_attr' structure in this man page
Make the reader's life a little easier by saving them from
having to refer to mq_getattr(3).

Reported-by: Adam Martindale <adam.john.martindale@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:40:52 +01:00
Michael Kerrisk c1b9bce2ed mq_send.3: Refer to mq_overview(7) for details on range of message priority
Reported-by: Adam Martindale <adam.john.martindale@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:40:52 +01:00
Michael Kerrisk c76ea16ab4 fts.3: Clarify meaning of zero as 'instr' value for fts_set()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:18 +01:00
Michael Kerrisk 71ddeb19dc fts.3: Improve explanation of 'fts_errno'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 90882d77f2 fts.3: Give a hint that there are further fields in the FTSENT structure
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 6110d89af1 fts.3: Fix minor error in FTSENT structure definition
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 17b0c3ad68 fts.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 822ffd7cb6 fts.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 1fcf641193 fts.3: Use better argument name for fts_children() and fts_set()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:07 +01:00
Michael Kerrisk 8b65f73d05 fts.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 20:03:47 +01:00
Michael Kerrisk 5c71ea83df fts.3: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 12:10:58 +01:00
Michael Kerrisk c9e5b0e128 fts.3: Minor fix: make the meaning of "stream" a little more obvious
"Stream" was used lower in the page, without first
being defined.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 12:10:58 +01:00
Michael Kerrisk f6c7968375 fts.3: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 12:10:58 +01:00
Michael Kerrisk 58c744401a fts.3: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 12:10:58 +01:00
Michael Kerrisk 211c7df8cf hsearch.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 08:50:24 +01:00
Michael Kerrisk 1ed246aedd printf.3: Fix a small bug in example code
Move the second call to va_end(ap) to above the if-block that
precedes it, so that the va_list 'ap' will be cleaned up in
all cases.

Reported-by: Erik Roland van der Meer <ervdmeer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 09:33:04 +13:00
Michael Kerrisk 5d048f53d3 strerror.3: Minor tweak's to Heinrich Schuchardt's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 09:13:02 +13:00
Michael Kerrisk 154e01afc1 strerror.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 09:11:37 +13:00
Heinrich Schuchardt e9cf84ab1d strerror.3: Indicate reasonable buffer size for strerror_r() and strerror_l()
Add a hint which buffer size is needed for
strerror_r() and strerror_l().

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 09:09:51 +13:00
Michael Kerrisk 9f2791e93e explicit_bzero.3: New link to bzero.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 08:25:18 +13:00
Michael Kerrisk 55e04d2370 bzero.3: Document explicit_bzero() (new in glibc 2.25)
Also, reword the description of bzero somewhat.

By now, over time, I've completely rewritten the page,
so change the copyright as well.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 08:25:18 +13:00
Michael Kerrisk 879091c911 bcmp.3, bcopy.3, bzero.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, memset.3: SEE ALSO: add bstring(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 08:25:18 +13:00
Erik Kline 768b58c715 getenv.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-27 08:45:31 +13:00
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
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
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 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 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 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