Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

tty(1)

Name

tty - return user's terminal name

Synopsis

/usr/bin/tty [-l] [-s]

Description

The tty utility writes to the standard output the name of the terminal that is open as standard input. The name that is used is equivalent to the string that would be returned by the ttyname(3C) function.

Options

The following options are supported:

–l

Prints the synchronous line number to which the user's terminal is connected, if it is on an active synchronous line.

–s

Inhibits printing of the terminal path name, allowing one to test just the exit status.

Environment Variables

See environ(7) for descriptions of the following environment variables that affect the execution of tty: LANG, LC_ALL , LC_CTYPE, LC_MESSAGES, and NLSPATH.

Exit Status

The following exit values are returned:

0

Standard input is a terminal.

1

Standard input is not a terminal.

>1

An error occurred.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/core-os
CSI
Enabled
Interface Stability
Committed
Standard

See Also

isatty(3C), ttyname(3C), attributes(7), environ(7), standards(7)

Diagnostics

not on an active synchronous line

The standard input is not a synchronous terminal and –l is specified.

not a tty

The standard input is not a terminal and –s is not specified.

Notes

The –s option is useful only if the exit status is wanted. It does not rely on the ability to form a valid path name. Portable applications should use test –t.