Commit Graph

17497 Commits

Author SHA1 Message Date
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
Michael Kerrisk c471c3636d clone.2: clone() does not execute fork handlers
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:02:47 +13:00
Michael Kerrisk 26cfa7d300 system.3: In the glibc implementation, fork handlers are not executed by system()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:02:47 +13:00
Michael Kerrisk 472bbe3bdb mount.2: Refer to mount_namespaces(7) for details of default propagation type
Reported-by: Rob Landley <rob@landley.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:23 +13:00
Michael Kerrisk 3dcc463a03 mount_namespaces.7: Rework the discussion of defaults for mount propagation types
Add rather more detail. In particular, note the cases where the
default propagation type is MS_PRIVATE vs MS_SHARED.

Reported-by: Rob Landley <rob@landley.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:23 +13:00
Michael Kerrisk 50dedc44d0 proc.5: Document /proc/sys/fs/mount-max
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:23 +13:00
Michael Kerrisk 1dc9bca64f capabilities.7: Adjust references to chattr(1) to point to ioctl_iflags(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:23 +13:00
Michael Kerrisk 85342fa7a9 chmod.2: ERRORS: add EPERM error for immutable/append-only file
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:23 +13:00
Michael Kerrisk 6f9433349c chown.2: ERRORS: add EPERM error for immutable/append-only file
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:23 +13:00
Michael Kerrisk 663c13027a unlink.2: ERRORS: add EPERM error for immutable/read-only files
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:23 +13:00
Michael Kerrisk 5fae754f7f link.2: ERRORS: add EPERM for immutable/append-only files
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:23 +13:00
Michael Kerrisk 937a7c8747 setxattr.2: ERRORS: add EPERM for immutable/append-only files
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:23 +13:00
Michael Kerrisk 459091008d ioctl.2: SEE ALSO: add ioctl_iflags(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:23 +13:00
Michael Kerrisk c7fc938f2c ioctl_iflags.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:23 +13:00
Michael Kerrisk cfb3e18732 ioctl_iflags.2: New page describing inode flags and ioctl() operations
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:23 +13:00
Michael Kerrisk 156d8c8480 capabilities.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:23 +13:00
Michael Kerrisk e39561aac8 netlink.7: Add NETLINK_RDMA to list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:22 +13:00
Michael Kerrisk 4338604d01 netlink.7: Add NETLINK_SCSITRANSPORT to list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:22 +13:00
Michael Kerrisk 1fcf200311 netlink.7: NETLINK_IP6_FW went away in Linux 3.5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:22 +13:00
Michael Kerrisk d7fd538cd0 netlink.7: NETLINK_NFLOG was removed in Linux 3.17
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:22 +13:00
Michael Kerrisk 326ccb6cf6 netlink.7: NETLINK_W1 went away in Linux 2.6.18
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:01:22 +13:00