TTY(1) User Commands TTY(1)
NAME
tty - return user's terminal name
SYNOPSIS
/usr/bin/tty [
-l] [
-s]
ksh93 tty [
options ]
DESCRIPTION
/usr/bin/tty 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.
ksh93 The
ksh93 tty built-in writes the name of the terminal that is connected
to standard input onto standard output. If the standard input is not a
terminal, "not a tty" will be written to standard output.
OPTIONS
The following options are supported:
/usr/bin/tty -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.
ksh93 -l --line-number Write the synchronous line number of the terminal on a
separate line following the terminal name line. If the
standard input is not a synchronous terminal then "not
on an active synchronous line" is written.
-s --silent|
quiet Disable the terminal name line. Portable applications
should use [[ -t 0 ]] instead.
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 |
+--------------------+-----------------+
|CSI | Enabled |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+
|Standard |
standards(7). |
+--------------------+-----------------+
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.
August 11, 2009
TTY(1)