Jan Chaloupka | 23 Jul 12:54 2014
Picon

[PATCH]: unix.7: mentioning SOCK_STREAM socket for ioctl_type of ioctl function

 From https://bugzilla.redhat.com/show_bug.cgi?id=1110401.

unix.7 is not clear about socket type of ioctl_type argument of ioctl 
function. The description of SIOCINQ is applicable only for SOCK_STREAM 
socket. For SOCK_DGRAM, udp(7) man page gives correct description of 
SIOCINQ.

---
  man7/unix.7 | 11 +++++++++--
  1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/man7/unix.7 b/man7/unix.7
index b0ade5b..6bcc8ba 100644
--- a/man7/unix.7
+++ b/man7/unix.7
 <at>  <at>  -299,7 +299,9  <at>  <at>  The correct syntax is:
  can be:
  .TP
  .B SIOCINQ
-Returns the amount of queued unread data in the receive buffer.
+For
+.B SOCK_STREAM
+socket the function returns the amount of queued unread data in the 
receive buffer.
  The socket must not be in LISTEN state, otherwise an error
  .RB ( EINVAL )
  is returned.
 <at>  <at>  -319,6 +321,10  <at>  <at>  defined in
  .\" That number is normally larger than the number of bytes of pending
  .\" output. Since this info is, from userland's point of view, imprecise,
(Continue reading)

Jan Chaloupka | 22 Jul 10:17 2014
Picon

Re: For review: mtrace(1) man page

Hi Tushar,

On 07/22/2014 09:45 AM, Tushar Shinde wrote:
> Hi Jan,
>
> Is  this MTRACEDATA is same as environment  variable  MALLOC_TRACE 
> of MTRACE(3) ?
> If yes we should keep MALLOC_TRACE instead of MTRACEDATA to avoid 
> confusion.
>
> Tushar

thank you for noticing. Those are script arguments, not environment 
variables. Changed bold into underline.

.\" Copyright (c) 2013, Peter Schiffer (pschiffe@...)
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
(Continue reading)

Peng Haitao | 22 Jul 05:52 2014

[PATCH] getgrouplist.3: ATTRIBUTES: Note function that is thread safe with exceptions

The function getgrouplist() is thread safe with exceptions.

Signed-off-by: Peng Haitao <penght@...>
---
 man3/getgrouplist.3 | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/man3/getgrouplist.3 b/man3/getgrouplist.3
index 3d28eed..b24532a 100644
--- a/man3/getgrouplist.3
+++ b/man3/getgrouplist.3
 <at>  <at>  -95,6 +95,18  <at>  <at>  can be used to resize the buffer passed to a further call
 .BR getgrouplist ().
 .SH VERSIONS
 This function is present since glibc 2.2.4.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR getgrouplist ()
+T}	Thread safety	MT-Safe locale
+.TE
 .SH CONFORMING TO
 This function is nonstandard; it appears on most BSDs.
 .SH BUGS
(Continue reading)

Peng Haitao | 22 Jul 05:19 2014

[PATCH] strtoul.3: Reformat thread-safety information

Signed-off-by: Peng Haitao <penght@...>
---
 man3/strtoul.3 | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/man3/strtoul.3 b/man3/strtoul.3
index 60649cc..b4266d3 100644
--- a/man3/strtoul.3
+++ b/man3/strtoul.3
 <at>  <at>  -163,17 +163,19  <at>  <at>  to
 in case
 no conversion was performed (no digits seen, and 0 returned).
 .SH ATTRIBUTES
-.SS Multithreading (see pthreads(7))
-The
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw32 lb lb
+l l l.
+Interface	Attribute	Value
+T{
 .BR strtoul (),
 .BR strtoull (),
-and
 .BR strtouq ()
-functions are thread-safe with exceptions.
-These functions can be safely used in multithreaded applications,
-as long as
(Continue reading)

Peng Haitao | 22 Jul 05:14 2014

[PATCH] swab.3: Reformat thread-safety information

Signed-off-by: Peng Haitao <penght@...>
---
 man3/swab.3 | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/man3/swab.3 b/man3/swab.3
index 007f685..8b5b217 100644
--- a/man3/swab.3
+++ b/man3/swab.3
 <at>  <at>  -70,10 +70,17  <at>  <at>  The
 .BR swab ()
 function returns no value.
 .SH ATTRIBUTES
-.SS Multithreading (see pthreads(7))
-The
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
 .BR swab ()
-function is thread-safe.
+T}	Thread safety	MT-Safe
+.TE
 .SH CONFORMING TO
 SVr4, 4.3BSD, POSIX.1-2001.
 .SH SEE ALSO
(Continue reading)

Peng Haitao | 22 Jul 05:10 2014

[PATCH] system.3: Reformat thread-safety information

Signed-off-by: Peng Haitao <penght@...>
---
 man3/system.3 | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/man3/system.3 b/man3/system.3
index 22a6b3b..d80416f 100644
--- a/man3/system.3
+++ b/man3/system.3
 <at>  <at>  -108,10 +108,17  <at>  <at>  and so on).
 .BR system ()
 does not affect the wait status of any other children.
 .SH ATTRIBUTES
-.SS Multithreading (see pthreads(7))
-The
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
 .BR system ()
-function is thread-safe.
+T}	Thread safety	MT-Safe
+.TE
 .SH CONFORMING TO
 C89, C99, POSIX.1-2001.
 .SH NOTES
(Continue reading)

Peng Haitao | 22 Jul 05:00 2014

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

The functions getw() and putw() are thread safe.

Signed-off-by: Peng Haitao <penght@...>
---
 man3/getw.3 | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/man3/getw.3 b/man3/getw.3
index 7850de0..430343b 100644
--- a/man3/getw.3
+++ b/man3/getw.3
 <at>  <at>  -77,6 +77,19  <at>  <at>  returns the word read, and
 .BR putw ()
 returns 0.
 On error, they return \fBEOF\fP.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw14 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR getw (),
+.BR putw ()
+T}	Thread safety	MT-Safe
+.TE
 .SH CONFORMING TO
 SVr4, SUSv2.
(Continue reading)

Peng Haitao | 21 Jul 11:32 2014

[PATCH] sysv_signal.3: Reformat thread-safety information

Signed-off-by: Peng Haitao <penght@...>
---
 man3/sysv_signal.3 | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/man3/sysv_signal.3 b/man3/sysv_signal.3
index 3dd1e93..9f2a1d5 100644
--- a/man3/sysv_signal.3
+++ b/man3/sysv_signal.3
 <at>  <at>  -58,10 +58,17  <at>  <at>  on error.
 As for
 .BR signal (2).
 .SH ATTRIBUTES
-.SS Multithreading (see pthreads(7))
-The
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
 .BR sysv_signal ()
-function is thread-safe.
+T}	Thread safety	MT-Safe
+.TE
 .SH CONFORMING TO
 This function is nonstandard.
 .SH NOTES
(Continue reading)

Peng Haitao | 21 Jul 11:27 2014

[PATCH] tan.3: Reformat thread-safety information

Signed-off-by: Peng Haitao <penght@...>
---
 man3/tan.3 | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/man3/tan.3 b/man3/tan.3
index f89bed1..a56107f 100644
--- a/man3/tan.3
+++ b/man3/tan.3
 <at>  <at>  -131,13 +131,19  <at>  <at>  An overflow floating-point exception
 .RB ( FE_OVERFLOW )
 is raised.
 .SH ATTRIBUTES
-.SS Multithreading (see pthreads(7))
-The
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw21 lb lb
+l l l.
+Interface	Attribute	Value
+T{
 .BR tan (),
 .BR tanf (),
-and
 .BR tanl ()
-functions are thread-safe.
+T}	Thread safety	MT-Safe
+.TE
(Continue reading)

Peng Haitao | 21 Jul 11:21 2014

[PATCH] tanh.3: Reformat thread-safety information

Signed-off-by: Peng Haitao <penght@...>
---
 man3/tanh.3 | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/man3/tanh.3 b/man3/tanh.3
index 79edab1..fa76347 100644
--- a/man3/tanh.3
+++ b/man3/tanh.3
 <at>  <at>  -98,13 +98,19  <at>  <at>  is positive infinity (negative infinity),
 .SH ERRORS
 No errors occur.
 .SH ATTRIBUTES
-.SS Multithreading (see pthreads(7))
-The
+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 tanh (),
 .BR tanhf (),
-and
 .BR tanhl ()
-functions are thread-safe.
+T}	Thread safety	MT-Safe
+.TE
(Continue reading)

Peng Haitao | 21 Jul 10:57 2014

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

The functions getcwd(), getwd() and get_current_dir_name() are
thread safe.

Signed-off-by: Peng Haitao <penght@...>
---
 man3/getcwd.3 | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/man3/getcwd.3 b/man3/getcwd.3
index d351938..f4762f2 100644
--- a/man3/getcwd.3
+++ b/man3/getcwd.3
 <at>  <at>  -205,6 +205,22  <at>  <at>  The
 argument is less than the length of the absolute pathname of the
 working directory, including the terminating null byte.
 You need to allocate a bigger array and try again.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw22 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR getcwd (),
+.BR getwd ()
+T}	Thread safety	MT-Safe
+T{
+.BR get_current_dir_name ()
(Continue reading)


Gmane