2.11BSD#431 - /usr/local/man/cat1/qterm.0

QTERM(1)	    UNIX Programmer's Manual		 QTERM(1)


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/local/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


USC-UCS                  6 November 1990			1


QTERM(1)	    UNIX Programmer's Manual		 QTERM(1)


	  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 termi-
	  nal.	This is the default.

     +systab
	  Use /usr/local/lib/qtermtab to find information for


USC-UCS                  6 November 1990			2


QTERM(1)	    UNIX Programmer's Manual		 QTERM(1)


	  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/local/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 pre-
     ceeded 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 informa-
     tion.

     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.


USC-UCS                  6 November 1990			3


QTERM(1)	    UNIX Programmer's Manual		 QTERM(1)


FILES
     /usr/local/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.


USC-UCS                  6 November 1990			4