tty(1)




NAME

     tty - return user's terminal name


SYNOPSIS

     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 synchro-
           nous line.

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


ENVIRONMENT VARIABLES

     See environ(5) 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(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|
    | CSI                         | enabled                     |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|


SEE ALSO

     isatty(3C), ttyname(3C),  attributes(5),  environ(5),  stan-
     dards(5)


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.


Man(1) output converted with man2html