|
|
HP-UX Reference Volume 4 of 5 > tttyname(3C) |
|
NAMEttyname(), ttyname_r(), isatty() — find name of a terminal SYNOPSIS#include <unistd.h> char *ttyname(int fildes); int ttyname_r(int fildes, char *buffer, size_t buflen); int isatty(int fildes); DESCRIPTIONttyname() returns a pointer to a string containing the null-terminated path name of the terminal device associated with file descriptor fildes. isatty() returns 1 if fildes is associated with a terminal device, 0 otherwise. RETURN VALUEttyname() returns a NULL pointer if fildes does not describe a terminal device in directory /dev. ttyname_r() returns a zero upon success and an error number upon failure. ERRORSisatty() and ttyname() fail if any of the following conditions are encountered:
APPLICATION USAGEThe return value for ttyname() points to static data whose content is overwritten by each call. ttyname() is not thread-safe. ttyname_r() is thread-safe. ttyname() and ttyname_r() are not async-cancel-safe. A cancellation point may occur when a thread is executing ttyname() or ttyname_r(). WARNINGSFor streams ptys, ttyname() and isatty() do not consider master ptys to be tty devices. It should also be noted that ttyname() returns a pointer to the master pty name for all master pty devices. This is a result of device files being linked together. Users of ttyname_r() should also note that the prototype of this function has changed in this release for conformance with the POSIX.1c Threads standard. The old prototype of ttyname_r() is supported for compatibility with existing DCE applications only. |
|