*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->FreeBSD man pages -> ctermid_r (3)              



NAME    [Toc]    [Back]

     ctermid -- generate terminal pathname

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <stdio.h>

     char *
     ctermid(char *buf);

     char *
     ctermid_r(char *buf);

DESCRIPTION    [Toc]    [Back]

     The ctermid() function generates a string, that, when used as a pathname,
     refers to the current controlling terminal of the calling process.

     If buf is the NULL pointer, a pointer to a static area is returned.  Otherwise,
 the pathname is copied into the memory referenced by buf.	The
     argument buf is assumed to be at least L_ctermid (as defined in the
     include file <stdio.h>) bytes long.

     The ctermid_r() function provides the same functionality as ctermid()
     except that if buf is a NULL pointer, NULL is returned.

     The current implementation simply returns `/dev/tty'.

RETURN VALUES    [Toc]    [Back]

     Upon successful completion, a non-NULL pointer is returned.  Otherwise, a
     NULL pointer is returned and the global variable errno is set to indicate
     the error.

ERRORS    [Toc]    [Back]

     The current implementation detects no error conditions.

SEE ALSO    [Toc]    [Back]


STANDARDS    [Toc]    [Back]

     The ctermid() function conforms to IEEE Std 1003.1-1988 (``POSIX.1'').

BUGS    [Toc]    [Back]

     By default the ctermid() function writes all information to an internal
     static object.  Subsequent calls to ctermid() will modify the same

FreeBSD 5.2.1			 June 4, 1993			 FreeBSD 5.2.1
[ Back ]
 Similar pages
Name OS Title
ctermid Tru64 Generate the pathname for the controlling terminal
pxfctermid IRIX Generates terminal pathname
tty Tru64 Returns pathname of terminal device
namei Linux follow a pathname until a terminal point is found
ctermid IRIX generate file name for terminal
termios Linux get and set terminal attributes, line control, get and set baud rate, get and set terminal foregroun...
ct HP-UX spawn getty to a remote terminal (call terminal)
acl_get_file IRIX get or set the ACL for a pathname
relookup OpenBSD pathname lookup
namei OpenBSD pathname lookup
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service