tty(1)

tty1

Return user's terminal name

Usage

tty [-s]

Overview

The tty utility writes the name of the terminal attached to standard input to standard output. The name that is written is the string returned by ttyname(3). If the standard input is not a terminal, the message “not a tty” is written. The options are as follows:

-s

Do not write the terminal name; only the exit status is affected when this option is specified. The -s option is deprecated in favor of the “test -t 0” command.

Exit status

The tty utility exits 0 if the standard input is a terminal, 1 if the standard input is not a terminal, and >1 if an error occurs.

Releases

163 releases since Mac OS X 10.0; the text changed 2 times.

  1. 10.0–10.5.8
  2. 10.6–12.2
  3. 12.3–26.5

Standards

The tty utility is expected to be IEEE Std 1003.2 (“POSIX.2”) compatible.

History

A tty command appeared in Version 1 AT&T UNIX.

From adv_cmds 237 in macOS 26.5. Parsed by carta from the page's mdoc source.