1 files changed, 58 insertions, 0 deletions
diff --git a/man3/ctermid.3 b/man3/ctermid.3
new file mode 100644
index 000000000..1cec6bf39
--- /dev/null
+++ b/man3/ctermid.3
@@ -0,0 +1,58 @@
+.\" (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
+.\"
+.\" 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.
+.\"
+.\" Permission is granted to copy and distribute modified versions of this
+.\" manual under the conditions for verbatim copying, provided that the
+.\" entire resulting derived work is distributed under the terms of a
+.\" permission notice identical to this one.
+.\" 
+.\" Since the Linux kernel and libraries are constantly changing, this
+.\" manual page may be incorrect or out-of-date.  The author(s) assume no
+.\" responsibility for errors or omissions, or for damages resulting from
+.\" the use of the information contained herein.  The author(s) may not
+.\" have taken the same level of care in the production of this manual,
+.\" which is licensed free of charge, as they might when working
+.\" professionally.
+.\" 
+.\" Formatted or processed versions of this manual, if unaccompanied by
+.\" the source, must acknowledge the copyright and authors of this work.
+.\" License.
+.\" Modified Sat Jul 24 19:51:06 1993 by Rik Faith (faith@cs.unc.edu)
+.TH CTERMID 3  1993-04-06 "GNU" "Linux Programmer's Manual"
+.SH NAME
+ctermid \- get controlling terminal name
+.SH SYNOPSIS
+.nf
+.B #include <stdio.h>
+.sp
+.BI "char *ctermid(char *" "s" );
+.fi
+.SH DESCRIPTION
+.B ctermid()
+returns a string which is the pathname for the current controlling terminal for this
+process. 
+If
+.I s
+is
+.BR NULL ,
+a static buffer is used, otherwise
+.I s
+points to a buffer used to hold the terminal pathname.
+The symbolic constant
+.B L_ctermid
+is the maximum number of characters in the returned pathname.
+.SH "RETURN VALUE"
+The pointer to the pathname.
+.SH "CONFORMING TO"
+SVID, Issue 1; POSIX.1
+.SH BUGS
+The path returned may not uniquely identify the controlling
+terminal; it may, for example, be
+.BR /dev/tty .
+.PP
+It is not assured that the program can open the terminal.
+.SH "SEE ALSO"
+.BR ttyname (3)