GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  ISATTY (3)

NAME

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

CONTENTS

Library
Synopsis
Description
Return Values
Errors
See Also
History

LIBRARY


.Lb libc

SYNOPSIS


.In unistd.h char * ttyname int fd int ttyname_r int fd char *buf size_t len int isatty int fd

DESCRIPTION

These functions operate on file descriptors for terminal type devices.

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 ttyname function returns the name stored in a static buffer which will be overwritten on subsequent calls. The ttyname_r function takes a buffer and length as arguments to avoid this problem.

RETURN VALUES

The isatty function returns 1 if fd refers to a terminal type device; otherwise, it returns 0 and may set errno to indicate the error. The ttyname function returns the null terminated name if the device is found and isatty is true; otherwise a NULL pointer is returned. The ttyname_r function returns 0 if successful. Otherwise an error number is returned.

ERRORS

These functions may fail if:
[EBADF]
  The fd argument is not a valid file descriptor.
[ENOTTY]
  The file associated with fd is not a terminal.

Additionally, ttyname_r may fail if:
[ERANGE]
  The bufsize argument is smaller than the length of the string to be returned.

SEE ALSO

fdevname(3), ptsname(3), tcgetattr(3), tty(4)

HISTORY

The isatty and ttyname functions appeared in AT&T v7 . The ttyname_r function appeared in
.Fx 6.0 .
Search for    or go to Top of page |  Section 3 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.