fallocate.2, futex.2, getrandom.2, mprotect.2, posix_spawn.3, address_families.7...

[thirdparty/man-pages.git] / man3 / isatty.3

diff --git a/man3/isatty.3 b/man3/isatty.3
index 3f7f95b5446a5bb6df0e8f66998d98b742e74c15..b7487692f3b54c75dfdb188f4adf5a45a3fad7a6 100644 (file)
--- a/man3/isatty.3
+++ b/man3/isatty.3
@@ -1,6 +1,7 @@
 .\" Copyright 2008, Linux Foundation, written by Michael Kerrisk
 .\"     <mtk.manpages@gmail.com>
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -20,14 +21,15 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
-.TH ISATTY 3 2008-12-03 "Linux" "Linux Programmer's Manual"
+.TH ISATTY 3 2015-08-08 "Linux" "Linux Programmer's Manual"
 .SH NAME
 isatty \- test whether a file descriptor refers to a terminal
 .SH SYNOPSIS
 .nf
 .B #include <unistd.h>
-.sp
+.PP
 .BI "int isatty(int " fd );
 .fi
 .SH DESCRIPTION
@@ -50,15 +52,29 @@ is set to indicate the error.
 .I fd
 is not a valid file descriptor.
 .TP
-.B EINVAL
+.B ENOTTY
 .I fd
 refers to a file other than a terminal.
-POSIX.1-2001 specifies the error
-.BR ENOTTY
-.\" FIXME File a bug for this?
-for this case.
+On some older kernels, some types of files
+.\" e.g., FIFOs and pipes on 2.6.32
+resulted in the error
+.B EINVAL
+in this case (which is a violation of POSIX, which specifies the error
+.BR ENOTTY ).
+.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 isatty ()
+T}     Thread safety   MT-Safe
+.TE
 .SH CONFORMING TO
-SVr4, 4.3BSD, POSIX.1-2001.
+POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.
 .SH SEE ALSO
 .BR fstat (2),
 .BR ttyname (3)