.\" SUCH DAMAGE.
.\"
.\" @(#)ctermid.3 8.1 (Berkeley) 6/4/93
-.\" $FreeBSD: src/lib/libc/gen/ctermid.3,v 1.8 2001/10/01 16:08:50 ru Exp $
+.\" $FreeBSD: src/lib/libc/gen/ctermid.3,v 1.11 2003/09/08 19:57:14 ru Exp $
.\"
.Dd June 4, 1993
.Dt CTERMID 3
.Os
.Sh NAME
-.Nm ctermid
+.Nm ctermid ,
+.Nm ctermid_r
.Nd generate terminal pathname
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
.In stdio.h
.Ft char *
-.Fn ctermid "char *buf"
+.Fn ctermid "char *s"
.Ft char *
-.Fn ctermid_r "char *buf"
+.Fn ctermid_r "char *s"
.Sh DESCRIPTION
The
.Fn ctermid
-function generates a string, that, when used as a pathname, refers to
+function generates a string that, when used as a pathname, refers to
the current controlling terminal of the calling process.
.Pp
If
-.Ar buf
+.Fa s
is the
.Dv NULL
pointer, a pointer to a static area is returned.
Otherwise, the pathname is copied into the memory referenced by
-.Ar buf .
+.Fa s .
The argument
-.Ar buf
+.Fa s
is assumed to be at least
.Dv L_ctermid
(as defined in the include
file
-.Aq Pa stdio.h )
+.In stdio.h )
bytes long.
.Pp
+The
.Fn ctermid_r
+function
provides the same functionality as
-.Fn ctermid
+.Fn ctermid ,
except that if
-.Ar buf
+.Fa s
is a
.Dv NULL
pointer,