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

  man pages->NetBSD man pages -> ttyslot (3)              



NAME    [Toc]    [Back]

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

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <unistd.h>

     char *
     ttyname(int fd);

     isatty(int fd);

     #include <stdlib.h>


DESCRIPTION    [Toc]    [Back]

     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 fd 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 number
 from the ttys(5) file entry.

RETURN VALUES    [Toc]    [Back]

     The ttyname() function returns 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 device.

SEE ALSO    [Toc]    [Back]

     ioctl(2), ttys(5)

STANDARDS    [Toc]    [Back]

     The ttyname() and isatty() functions conform to ISO/IEC 9945-1:1990

HISTORY    [Toc]    [Back]

     A isatty(), ttyname(), and ttyslot() function appeared in Version 7 AT&T

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.

BSD                              June 4, 1993                              BSD
[ 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