Heinrich Schuchardt | 26 Nov 23:56 2014
Picon
Picon

[PATCH 1/1] random.4: describe handling of O_NONBLOCK

/dev/random and /dev/urandom treat O_NONBLOCK differently.
This should be described in the manpage.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@...>
---
 man4/random.4 | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/man4/random.4 b/man4/random.4
index a193ddf..44d9e34 100644
--- a/man4/random.4
+++ b/man4/random.4
 <at>  <at>  -44,6 +44,22  <at>  <at>  pool.
 high quality randomness such as one-time pad or key generation.
 When the entropy pool is empty, reads from \fI/dev/random\fP will block
 until additional environmental noise is gathered.
+If
+.BR open (2)
+is called for
+.I /dev/random
+with flag
+.BR O_NONBLOCK ,
+a subsequent
+.BR read (2)
+will not block if the requested number of bytes is not available.
+Instead the available bytes are returned.
+If no byte is available
+.BR read (2)
+will return -1 and
+.I errno
(Continue reading)

Heinrich Schuchardt | 26 Nov 23:58 2014
Picon
Picon

[PATCH 1/1] random.4: mention PRNG used by urandom

/dev/urandom uses a pseudo random number generator to replace
missing entropy.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@...>
---
 man4/random.4 | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/man4/random.4 b/man4/random.4
index 44d9e34..1be19b8 100644
--- a/man4/random.4
+++ b/man4/random.4
 <at>  <at>  -63,8 +63,9  <at>  <at>  will be set to
 .LP
 A read from the \fI/dev/urandom\fP device will not block
 waiting for more entropy.
-As a result, if there is not sufficient entropy in the
-entropy pool, the returned values are theoretically vulnerable to a
+If there is not sufficient entropy, a pseudorandom number generator is used
+to create the requested bytes.
+As a result, in this case the returned values are theoretically vulnerable to a
 cryptographic attack on the algorithms used by the driver.
 Knowledge of how to do this is not available in the current unclassified
 literature, but it is theoretically possible that such an attack may
--

-- 
2.1.3

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@...
(Continue reading)

Ma Shimiao | 26 Nov 07:09 2014

[PATCH] acosh.3:ATTRIBUTES: Note functions that are thread-safe

The function acosh(), acoshf() and acoshl() are thread safe.

Signed-off-by: Ma Shimiao <mashimiao.fnst@...>
---
 man3/acosh.3 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/man3/acosh.3 b/man3/acosh.3
index 48138a3..2234ea3 100644
--- a/man3/acosh.3
+++ b/man3/acosh.3
 <at>  <at>  -117,6 +117,20  <at>  <at>  is set to
 An invalid floating-point exception
 .RB ( FE_INVALID )
 is raised.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw28 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR acosh (),
+.BR acoshf (),
+.BR acoshl ()
+T}	Thread safety	MT-Safe
+.TE
 .SH CONFORMING TO
(Continue reading)

Ma Shimiao | 26 Nov 06:35 2014

[PATCH] acos.3:ATTRIBUTES: Note functions that are thread-safe

The function acos(), acosf() and acosl() are thread safe.

Signed-off-by: Ma Shimiao <mashimiao.fnst@...>
---
 man3/acos.3 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/man3/acos.3 b/man3/acos.3
index f42effa..4ba8f39 100644
--- a/man3/acos.3
+++ b/man3/acos.3
 <at>  <at>  -110,6 +110,20  <at>  <at>  is set to
 An invalid floating-point exception
 .RB ( FE_INVALID )
 is raised.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw24 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR acos (),
+.BR acosf (),
+.BR acosl ()
+T}	Thread safety	MT-Safe
+.TE
 .SH CONFORMING TO
(Continue reading)

Ma Shimiao | 26 Nov 04:38 2014

[PATCH] clog.3:ATTRIBUTES: Note functions that are thread-safe

The function clog(), clogf() and clogl() are thread safe.

Signed-off-by: Ma Shimiao <mashimiao.fnst@...>
---
 man3/clog.3 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/man3/clog.3 b/man3/clog.3
index 0ef7148..e74a0e0 100644
--- a/man3/clog.3
+++ b/man3/clog.3
 <at>  <at>  -38,6 +38,20  <at>  <at>  Note that
 close to zero will cause an overflow.
 .SH VERSIONS
 These functions first appeared in glibc in version 2.1.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw24 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR clog (),
+.BR clogf (),
+.BR clogl ()
+T}	Thread safety	MT-Safe
+.TE
 .SH CONFORMING TO
(Continue reading)

Ma Shimiao | 26 Nov 04:36 2014

[PATCH] cacos.3:ATTRIBUTES: Note functions that are thread-safe

The function cacos(), cacosf() and cacosl() are thread safe.

Signed-off-by: Ma Shimiao <mashimiao.fnst@...>
---
 man3/cacos.3 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/man3/cacos.3 b/man3/cacos.3
index 36c7bc1..3550a1c 100644
--- a/man3/cacos.3
+++ b/man3/cacos.3
 <at>  <at>  -35,6 +35,20  <at>  <at>  One has:
 .fi
 .SH VERSIONS
 These functions first appeared in glibc in version 2.1.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw28 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR cacos (),
+.BR cacosf (),
+.BR cacosl ()
+T}	Thread safety	MT-Safe
+.TE
 .SH CONFORMING TO
(Continue reading)

Tobias Werth | 25 Nov 12:59 2014
Picon

[PATCH] ascii.7: tfix

The ' in the compact tables were not escaped correctly resulting in
UTF-8 in the ASCII table.
---
 man7/ascii.7 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/man7/ascii.7 b/man7/ascii.7
index 93a404a..d0fbe6b 100644
--- a/man7/ascii.7
+++ b/man7/ascii.7
 <at>  <at>  -138,9 +138,9  <at>  <at>  For convenience, below are more compact tables in hex and decimal.
 4: $ 4 D T d t     4: "  ,  6   <at>   J  T  ^  h   r   |
 5: % 5 E U e u     5: #  \-  7  A  K  U  _  i   s   }
 6: & 6 F V f v     6: $  .  8  B  L  V  \`  j   t   ~
-7: \' 7 G W g w     7: %  /  9  C  M  W  a  k   u  DEL
+7: \(aq 7 G W g w     7: %  /  9  C  M  W  a  k   u  DEL
 8: ( 8 H X h x     8: &  0  :  D  N  X  b  l   v
-9: ) 9 I Y i y     9: \'  1  ;  E  O  Y  c  m   w
+9: ) 9 I Y i y     9: \(aq  1  ;  E  O  Y  c  m   w
 A: * : J Z j z
 B: + ; K [ k {
 C: , < L \e l |
--

-- 
2.1.3

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@...
More majordomo info at  http://vger.kernel.org/majordomo-info.html

(Continue reading)

Ma Shimiao | 25 Nov 11:04 2014

[PATCH] mmap.2:ATTRIBUTES: Note functions that are thread-safe

The function mmap() and munmap() are thread safe.

Signed-off-by: Ma Shimiao <mashimiao.fnst@...>
---
 man2/mmap.2 | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/man2/mmap.2 b/man2/mmap.2
index 295df3d..f948866 100644
--- a/man2/mmap.2
+++ b/man2/mmap.2
 <at>  <at>  -492,6 +492,19  <at>  <at>  Attempted write into a region mapped as read-only.
 Attempted access to a portion of the buffer that does not correspond
 to the file (for example, beyond the end of the file, including the
 case where another process has truncated the file).
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw18 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR mmap (),
+.BR munmap ()
+T}	Thread safety	MT-Safe
+.TE
 .SH CONFORMING TO
 SVr4, 4.4BSD, POSIX.1-2001.
(Continue reading)

Piotr Dobrogost | 24 Nov 15:20 2014
Picon

Lack of sshfs(1) man page

Hi!

I was looking for sshfs man page at
http://man7.org/linux/man-pages/dir_section_1.html but it's not there.
At the same time there is such a page at
http://linux.die.net/man/1/sshfs
Am I missing something?
Also should I prefer man7.org/linux/man-pages/ man pages to
http://linux.die.net/man/ ones?

Regards,
Piotr Dobrogost
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@...
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Troy Davis | 23 Nov 17:28 2014

[patch] tcp.7: Clarify tcp_tw_recycle on Internet-facing hosts

Clarify that tcp_tw_recycle will break communication with many
general-purpose remote Internet hosts (namely, remote NAT devices)
even when the Linux device itself is not behind NAT.

Sources:
  - BCP to make NAT implementors aware of this problem (2013):
https://tools.ietf.org/html/draft-penno-behave-rfc4787-5382-5508-bis-04#section-3.1.2
  - RFC 1323 (PAWS)
  - RFC 6191: Reducing the TIME-WAIT State Using TCP Timestamps
  - The many users who unknowingly enabled this option on devices
communicating with the general-purpose Internet:
https://www.google.com/search?q=tcp_tw_recycle%20ip%20nat%20timestamp

Patched against git HEAD as of this email
(ac5ba355d52a5a29f2d26badc96e6da9e48c0097).

diff --git a/man7/tcp.7 b/man7/tcp.7
index e6f5aee..06cc127 100644
--- a/man7/tcp.7
+++ b/man7/tcp.7
 <at>  <at>  -780,10 +780,11  <at>  <at>  building larger TSO frames.
 .TP
 .IR tcp_tw_recycle " (Boolean; default: disabled; since Linux 2.4)"
 .\" Since 2.3.15
-Enable fast recycling of TIME_WAIT sockets.
-Enabling this option is not
-recommended since this causes problems when working
-with NAT (Network Address Translation).
+Enable fast recycling of TIME_WAIT sockets. Enabling this option is
+not recommended for devices communicating with the general Internet
(Continue reading)

Carlos O'Donell | 19 Nov 20:45 2014
Picon

[PATCH] wordexp.3: Make it clear that WRDE_NOCMD prevents command substitution.

The use of WRDE_NOCMD prevents command substitution. If the flag
WRDE_NOCMD is set then no command substitution shall occur and
the error WRDE_CMDSUB will be returned if such substitution is
requested when processing the words.

The manual page as-is makes it seem like the command substitution
occurs, and an error is returned *after* the substitution.

This patch clarifies that.

Patch against trunk.

Signed-off-by: Carlos O'Donell <carlos@...>

diff --git a/man3/wordexp.3 b/man3/wordexp.3
index c695c08..e457943 100644
--- a/man3/wordexp.3
+++ b/man3/wordexp.3
 <at>  <at>  -169,7 +169,7  <at>  <at>  flag
 told us to consider this an error.
 .TP
 .B WRDE_CMDSUB
-Command substitution occurred, and the
+Command substitution requested, but the
 .B WRDE_NOCMD
 flag told us to consider this an error.
 .TP
---

Cheers,
(Continue reading)


Gmane