Skip to contentSkip to conversation

ttyname.3: Add description of the function is not thread-safe

PATCH In review Peng Haitao 2 participants 2 messages Sep 6, 2011 – Mar 17, 2013 1 message not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 ttyname.3: Add description of the function is not thread-safe

The function ttyname() uses a static variable "ttyname_buf", so it is not thread-safe.

---
 man3/ttyname.3 |   11 ++++++++++-
 1 files changed, 10 insertions(+), 1 deletions(-)
man3/ttyname.3 +10 -1
index 08fb2b7..5047e94 100644
@@ -23,7 +23,7 @@
 .\" Modified 2001-12-13, Martin Schulze <[email protected]>
 .\" Added ttyname_r, aeb, 2002-07-20
 .\"
-.TH TTYNAME 3 2008-07-14 "Linux" "Linux Programmer's Manual"
+.TH TTYNAME 3 20011-09-06 "Linux" "Linux Programmer's Manual"
 .SH NAME
 ttyname, ttyname_r \- return name of a terminal
 .SH SYNOPSIS
@@ -70,6 +70,15 @@ File descriptor does not refer to a terminal device.
 .B ERANGE
 .I buflen
 was too small to allow storing the pathname.
+.SH ATTRIBUTES
+.SS Multithreading (see pthreads(7))
+The
+.BR ttyname ()
+function is not thread-safe.
+.LP
+The
+.BR ttyname_r ()
+function is thread-safe.
 .SH "CONFORMING TO"
 4.2BSD, POSIX.1-2001.
 .SH "SEE ALSO"
Signature · 10 lines
1.7.1

-- 
Best Regards,
Peng Haitao

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

A message that is not in the archive (sent off-list or not yet received): [email protected]

#2 lore raw
Quoted 2 lines · Peng Haitao

The function ttyname() uses a static variable "ttyname_buf", so it is not thread-safe.

I've applied this patch.

Thanks,

Michael

Quoted 41 lines
---
 man3/ttyname.3 |   11 ++++++++++-
 1 files changed, 10 insertions(+), 1 deletions(-)
man3/ttyname.3 +10 -2
index 08fb2b7..5047e94 100644
@@ -23,7 +23,7 @@
 .\" Modified 2001-12-13, Martin Schulze <[email protected]>
 .\" Added ttyname_r, aeb, 2002-07-20
 .\"
-.TH TTYNAME 3 2008-07-14 "Linux" "Linux Programmer's Manual"
+.TH TTYNAME 3 20011-09-06 "Linux" "Linux Programmer's Manual"
 .SH NAME
 ttyname, ttyname_r \- return name of a terminal
 .SH SYNOPSIS
@@ -70,6 +70,15 @@ File descriptor does not refer to a terminal device.
 .B ERANGE
 .I buflen
 was too small to allow storing the pathname.
+.SH ATTRIBUTES
+.SS Multithreading (see pthreads(7))
+The
+.BR ttyname ()
+function is not thread-safe.
+.LP
+The
+.BR ttyname_r ()
+function is thread-safe.
 .SH "CONFORMING TO"
 4.2BSD, POSIX.1-2001.
 .SH "SEE ALSO"
--

1.7.1

--
Best Regards,
Peng Haitao

Signature · 7 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html