QTERM
Section: User Commands (1)
Updated: 6 November 1990
Index
Return to Main Contents
NAME
qterm - Query Terminal
SYNOPSIS
qterm
[
+|-alt
] [
+|-always
] [
+|-longname
] [
+|-quiet
] [
+|-sent
] [
+|-timeout
] [
+|-usrtab
] [
+|-watch
] [
+|-systab
] [
-wait
interval
] [
-file
tabfile
]
DESCRIPTION
Qterm
is used to query a terminal to determine its name.
This is done by sending a special sequence to the terminal,
reading in a response, and comparing it against a table of possible
responses.
The ``name'' printed to standard output should be one found in
the
termcap(5)
(or
terminfo(5)
for System V systems)
database.
For
csh(1)
users,
putting a line in your
.login
file such as:
setenv TERM `qterm`
should automagically set your terminal type.
For
sh(1)
users, putting these lines in your
.profile
file should set your terminal type:
TERM=`qterm`
export TERM
By default,
qterm
uses the system tab file
/usr/usc/lib/qtermtab
to obtain information for querying terminals.
OPTIONS
- +alt
-
Use the alternate string ``<ESCAPE>[c'' when asking the terminal to
identify itself. This string is recognized by most ANSI compatible
terminals.
- -alt
-
Don't use the alternate string, but the string found in the
tabfile
being used.
This is the default.
- +always
-
Always send the terminal query string.
Normally the query string is only sent if it differs from
the last string sent.
- -always
-
Only send the terminal query string if it differs from the last
string sent.
This is the default.
- -file tabfile
-
Use
<tabfile>
to find information for querying the terminal.
- +longname
-
Print only the long (verbose) terminal name.
- -longname
-
Don't print the long (verbose) terminal name.
This is the default.
- +quiet
-
Be quiet and only print the terminal name to standard output.
- -quiet
-
Don't be quiet and only print the terminal name to standard output.
This is the default.
- +watch
-
Watch the characters sent and recieved to the terminal.
- -watch
-
Don't watch the characters sent and recieved to the terminal.
This is the default.
- +timeout
-
Wait for timeout when listening for response string.
This is useful if the first entry in a qtermtab doesn't have
a response string with an ending character that is common
with the rest of the qtermtab entries.
- -timeout
-
Disable waiting for timeout when listening for response string.
This is the default.
- +usrtab
-
Use
$HOME/.qtermtab
to find information for querying the terminal.
- -usrtab
-
Don't use
$HOME/.qtermtab
to find information for querying the terminal.
This is the default.
- +sent
-
Display the final response sent from
the terminal in a ``nice'' fashion.
- -sent
-
Don't display the final response sent from the terminal.
This is the default.
- +systab
-
Use
/usr/usc/lib/qtermtab
to find information for querying the terminal.
This is the default
- -systab
-
Don't use
system tab file
to find information for querying the terminal.
- -wait interval
-
Set the wait (timeout) period to
interval
(in seconds).
QTERMTAB
The format of the file
$HOME/.qtermtab
and
qterm's
system tab file
/usr/usc/lib/qtermtab,
consists of four fields each seperated by white space (tabs and/or spaces).
The first field is the string that should be used to query the terminal.
The second field is the string to expect in response to the query.
The third field is the terminal name (compatible with
termcap(5))
to print to standard output.
The fourth field is optional and may contain a description of the exact
manufacturer and model name of the terminal to be used in a message
printed to standard error.
Blank lines or lines starting with the character ``#''
are ignored and may be used as comment lines.
A character preceeded by a ``^'' is taken to mean the
control
character. (i.e. ``^['' is interpretted as an <ESCAPE>).
Both the send and receive (first and second) fields may contain
octal values preceeded by a `\'.
(i.e. <ESCAPE> can be represented by `\033'.)
The ``expect'' (second) field
can be a regular expression denoted by a leading backslash (`\').
i.e. "^[[123" matches the string "^[[123", whereas "^[\[123]" matches
"^[1" or "^[2" or "^[3".
See
ed(1)
for regular expression information.
Below is a sample file:
#
# QTerm File
#
^[Z ^[[?1;1c vt100 A vt100 with STP
^[Z ^[[?1;2c vt100 ANSI/VT100 Clone
^[Z ^[[?1;3c vt100 A vt100 with AVO and STP
^[Z ^[[?1;4c vt100 A vt100 with GPO
^[Z ^[iBO z29 Zenith in Zenith Mode
AUTHOR
Michael A. Cooper,
University Computing Services,
University of Southern California.
FILES
/usr/usc/lib/qtermtab - System table
$HOME/.qtermtab - User's table
/etc/termcap - termcap(5) database
SEE ALSO
csh(1), ed(1), sh(1), termcap(5)
DIAGNOSTICS
- Terminal not recognized - defaults to dumb.
-
QTerm
did not receive a response from the terminal, or the response
did not match any that
qterm
has stored internally. Use the +watch option to check to see which
is the case.
BUGS
Many terminals do not send a response at all.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- QTERMTAB
-
- AUTHOR
-
- FILES
-
- SEE ALSO
-
- DIAGNOSTICS
-
- BUGS
-
This document was created by
man2html,
using the manual pages.
Time: 06:11:33 GMT, December 12, 2024