ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man Pages
|
This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles. For more information about the manual page format, see the manual page for manpages(5). |
TTYNAME(3) BSD Library Functions Manual TTYNAME(3) NAME isatty, ttyname, ttyslot -- get name of associated terminal (tty) from file descriptor LIBRARY Standard C Library (libc, -lc) SYNOPSIS #include <unistd.h> int isatty(int fildes); char * ttyname(int fildes); int ttyslot(void); DESCRIPTION These functions operate on the system file descriptors for terminal type devices. These descriptors are not related to the standard I/O FILE typedef, but refer to the special device files found in /dev and named /dev/ttyxx and for which an entry exists in the initialization file /etc/ttys. (See ttys(5).) The isatty() function determines if the file descriptor fildes refers to a valid terminal type device. The ttyname() function gets the related device name of a file descriptor for which isatty() is true. The ttyslot() function fetches the current process' control terminal num-ber number ber from the ttys(5) file entry. RETURN VALUES The ttyname() function returns the null terminated name if the device is found and isatty() is true; otherwise, a NULL pointer is returned. The ttyslot() function returns the unit number of the device file if found; otherwise, the value zero is returned. FILES /dev/* /etc/ttys SEE ALSO ioctl(2), ttys(5) HISTORY A isatty(), ttyname(), and ttyslot() function appeared in Version 7 AT&T UNIX. BUGS The ttyname() function leaves its result in an internal static object and returns a pointer to that object. Subsequent calls to ttyname() will modify the same object. BSD June 4, 1993 BSD |