manpagez: man pages & more
man ttyname(3)
Home | html | info | man
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 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

Mac OS X 10.8 - Generated Fri Aug 31 16:25:54 CDT 2012
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.