Unix/Linux Go Back    


BSD 2.11 - man page for qterm (bsd section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


QTERM(1)										 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  spe-
       cial  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 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/local/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/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 com-
       ment 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 sec-
       ond) fields may contain octal values preceeded by a `\'.  (i.e.	<ESCAPE>  can  be  repre-
       sented 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/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.

					 6 November 1990				 QTERM(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 04:47 AM.