projects / unix-history / blame
| Commit | Line | Data |
|---|---|---|
| 5b79f985 C |
1 | .TH TTYNAME 3 "19 January 1983" |
| 2 | .SH NAME | |
| 3 | ttyname, isatty, ttyslot \- find name of a terminal | |
| 4 | .SH SYNOPSIS | |
| 5 | .B char *ttyname(filedes) | |
| 6 | .PP | |
| 7 | .B isatty(filedes) | |
| 8 | .PP | |
| 9 | .B ttyslot() | |
| 10 | .SH DESCRIPTION | |
| 11 | .I Ttyname | |
| 12 | returns a pointer to the null-terminated path name | |
| 13 | of the terminal device associated with file descriptor | |
| 14 | .I filedes | |
| 15 | (this is a system file descriptor and has nothing to do with the | |
| 16 | standard I/O FILE typedef). | |
| 17 | .PP | |
| 18 | .I Isatty | |
| 19 | returns 1 if | |
| 20 | .I filedes | |
| 21 | is associated with a terminal device, 0 otherwise. | |
| 22 | .PP | |
| 23 | .I Ttyslot | |
| 24 | returns the number of the entry in the | |
| 25 | .IR ttys (5) | |
| 26 | file for the control terminal of the current process. | |
| 27 | .SH FILES | |
| 28 | /dev/\(** | |
| 29 | .br | |
| 30 | /etc/ttys | |
| 31 | .SH SEE ALSO | |
| 32 | ioctl(2), ttys(5) | |
| 33 | .SH DIAGNOSTICS | |
| 34 | .I Ttyname | |
| 35 | returns a null pointer (0) if | |
| 36 | .I filedes | |
| 37 | does not describe a terminal device in directory `/dev'. | |
| 38 | .PP | |
| 39 | .I Ttyslot | |
| 40 | returns 0 if `/etc/ttys' is inaccessible or if | |
| 41 | it cannot determine the control terminal. | |
| 42 | .SH BUGS | |
| 43 | The return value points to static data | |
| 44 | whose content is overwritten by each call. |