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

  man pages->OpenBSD man pages -> ttyname (3)              



NAME    [Toc]    [Back]

     ttyname, ttyname_r, isatty, ttyslot - get name of associated
     (tty) from file descriptor

SYNOPSIS    [Toc]    [Back]

     #include <unistd.h>

     char *
     ttyname(int fd);

     ttyname_r(int fd, char *name, size_t namesize);

     isatty(int fd);


DESCRIPTION    [Toc]    [Back]

     These  functions  operate on the system file descriptors for
terminal type
     devices.  These descriptors are not related to the  standard
     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 fd
refers to a
     valid terminal type device.

     The ttyname() and ttyname_r() functions get the related  device name of a
     file descriptor for which isatty() is true.  The ttyname_r()
     stores the null-terminated pathname of the terminal  associated with the
     file  descriptor  fd  in  the  character array referenced by
name.  The array
     is namesize characters long and should have  space  for  the
name and the
     terminating NUL character.  The maximum length of the terminal name is

     The ttyslot() function fetches the current process's control
     number from the ttys(5) file entry.

RETURN VALUES    [Toc]    [Back]

     The ttyname() and ttyname_r() functions return the null-terminated name
     if the device is found and isatty()  is  true;  otherwise  a
null pointer is
     returned and errno is set to indicate the error.

     The  isatty()  function returns 1 if fd is associated with a
terminal device;
 otherwise it returns 0 and errno is  set  to  indicate
the error.

     The ttyslot() function returns the unit number of the device
file if
     found; otherwise the value zero is returned.

FILES    [Toc]    [Back]


ERRORS    [Toc]    [Back]

     The ttyname() and isatty() functions will fail if:

     [EBADF]       The fd argument is not a valid  file  descriptor.

     [ENOTTY]       The  fd argument does not refer to a terminal

     [ERANGE]      The value of  namesize  is  smaller  than  the
length of the
                   string  to be returned including the terminating NUL character.

SEE ALSO    [Toc]    [Back]

     ioctl(2), ttys(5), dev_mkdb(8)

HISTORY    [Toc]    [Back]

     The isatty(), ttyname(), and ttyslot() functions appeared in
Version 7
     AT&T  UNIX.   The ttyname_r() function appeared in the POSIX
Threads Extension

BUGS    [Toc]    [Back]

     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.

OpenBSD      3.6                           June      4,      1993
[ Back ]
 Similar pages
Name OS Title
pxfisatty IRIX Determines if file descriptor corresponds to a valid file descriptor
isatty Linux does this descriptor refer to a terminal
fattach Tru64 Attach a STREAMS-based file descriptor to a file in the file system name space
fdetach Tru64 Detach a STREAMS-based file descriptor from a file in the file system name space
AFopenfile IRIX allocate an AFfilehandle structure for an audio file identified by name / by a Unix file descriptor
AFidentifyfd IRIX retrieve the audio file format of a file descriptor / open AFfilehandle
isfdtype Tru64 Test a file descriptor for a specific file type
isastream Tru64 Determine if a file descriptor refers to a STREAMS file
acl_set_fd Tru64 Sets the ACL on the file or directory designated by the file descriptor
AFgetfd IRIX get the Unix file descriptor for the file associated with an AFfilehandle structure
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service