HP 3000 Manuals

Creating Device Descriptions [ MPE/iX Developer's Kit Reference Manual Volume II ] MPE/iX 5.0 Documentation


MPE/iX Developer's Kit Reference Manual Volume II

Creating Device Descriptions 

The easiest way to create a new entry for a device is to find one that is
similar, modify it, and compile it using the tic utility.  The tic
utility installs the new definition in the TERMINFO directory hierarchy.
You can change the location of the directory hierarchy by redefining the
TERMINFO environment variable.

You can test your description in small segments using VI. Keep in mind
that a unusual device may not be adequately described by TERMINFO or
adequately tested by VI.

A terminal can be defined as having certain capabilties that are
equivalent to those of another terminal.  These capabilities are then
read from one terminal description into the other.  The use capability
names the terminal from which to read the capabilities.  Any capabilities
listed before the use string override those put in place by use.  A
capability that should not be used in the terminal desciption can be
cancelled by typing an at sign (@) after the name of the capability.  The
following example bases the definition of a VT-100 terminal without
automatic margins on a standard VT-100 terminal definition.

     vt100-nam|VT100 without automatic margins,
     am@, use=vt100,

A crude test for getting the right amount of padding for insert-line (if
not documented) is to comment out xon, edit a large file at 9600 baud
with VI, delete 16 or so lines from the middle of the screen, and press
the u key several times quickly.  If the display becomes corrupted,
insert-line requires more padding.

Special Characters 

Table 3-6  summarizes all the special characters sequences discussed
to this point.

          Table 3-6.  Characters with Special Values 

---------------------------------------------------------------------------------------------
|                                             |                                             |
|                  Character                  |                   Meaning                   |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                      ,                      | Separates capabilities                      |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                      #                      | Precedes integer value in numeric           |
|                                             | capabilities                                |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                      =                      | Separates string capability name from       |
|                                             | string sequence                             |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                      @                      | Cancels capability                          |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                      #                      | At the beginning of line, comments out the  |
|                                             | line                                        |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                      .                      | When directly preceding a capability,       |
|                                             | period comments it out                      |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     ^x                      | Control x sequence                          |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \E                      | Escape character                            |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \e                      | Escape character                            |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \n                      | Newline character                           |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \r                      | Return character                            |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \t                      | Tab character                               |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \v                      | Vertical tab character                      |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \b                      | Backspace character                         |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \f                      | Formfeed character                          |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \s                      | Space character                             |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \l                      | Linefeed character                          |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \a                      | Alert character                             |
|                                             |                                             |
---------------------------------------------------------------------------------------------

          Table 3-6.  Characters with Special Values (cont.) 

---------------------------------------------------------------------------------------------
|                                             |                                             |
|                  Character                  |                   Meaning                   |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                    \xxx                     | Octal characters (must be three characters) |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \,                      | Escapes a comma                             |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \\                      | Escapes a backslash                         |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \^                      | Escapes a caret                             |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \:                      | Escapes a colon                             |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     \0                      | Escapes a null character                    |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                     %x                      | String using format operator                |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                    $<n>                     | Indicates a delay in n milliseconds         |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                    $<n/>                    | Indicates the delay is mandatory            |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                    $<n*>                    | Indicates the padding required per affected |
|                                             | line                                        |
|                                             |                                             |
---------------------------------------------------------------------------------------------
|                                             |                                             |
|                   $<n/*>                    | Indicates mandatory padding required per    |
|                                             | affected line                               |
|                                             |                                             |
---------------------------------------------------------------------------------------------

Names of Capabilities 

Capability names are normally kept to two to five characters and normally
comply with ANSI X3.64-1979.  Each capability has a corresponding
variable name used in the program to access it; for example, the variable
defined for am is auto_left_margin.

The Boolean, number, and string capabilities are listed in the tables on
the following pages.  Within these tables, each TERMINFO capability name
is listed, along with the equivalent termcap name, the variable name, and
a brief description.  The #i symbol that sometimes appears in the
description section of the table refers to the ith parameter.

Additional tables sorted by variable name may be found in Table 3-21 ,
Table 3-22 , and Table 3-23  as a reference for programmers.  Table
3-21  lists the capabilities by the Boolean variable name; Table 3-22
 lists the capabilities by the numeric variable name, and Table 3-23
 lists the capabilities by the string variable name.

Boolean Capabilities.   

Table 3-7  lists the Boolean capabilities.

          Table 3-7.  Boolean Capabilities 
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
|         TInfo         |         TCap          |       Variable        |      Description      |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| am                    | am                    | auto_right_margin     | Terminal has          |
|                       |                       |                       | automatic margins     |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| bw                    | bw                    | auto_left_margin      | cub1 wraps from       |
|                       |                       |                       | column 0 to last      |
|                       |                       |                       | column                |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| ccc                   | cc                    | can_change            | Terminal can redefine |
|                       |                       |                       | existing color        |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| chts                  | HC                    | hard_cursor           | Cursor is hard to see |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| cpix                  | YF                    | cpi_changes_res       | Changing character    |
|                       |                       |                       | pitch changes         |
|                       |                       |                       | resolution            |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| crxm                  | YB                    | cr_cancels_micro_mode | Using cr turns off    |
|                       |                       |                       | micro mode            |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| da                    | da                    | memory_above          | Display may be        |
|                       |                       |                       | retained above the    |
|                       |                       |                       | screen                |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| daisy                 | YC                    | has_print_wheel       | Printer needs         |
|                       |                       |                       | operator to change    |
|                       |                       |                       | character set         |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| db                    | db                    | memory_below          | Display may be        |
|                       |                       |                       | retained below the    |
|                       |                       |                       | screen                |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| eo                    | eo                    | erase_overstrike      | Terminal can erase    |
|                       |                       |                       | overstrikes with a    |
|                       |                       |                       | blank                 |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| eslok                 | es                    | status_line_esc_ok    | Escape can be used on |
|                       |                       |                       | the status line       |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| gn                    | gn                    | generic_type          | Generic line type     |
|                       |                       |                       | (e.g.  dialup,        |
|                       |                       |                       | switch)               |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| hc                    | hc                    | hard_copy             | Hardcopy terminal     |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| hls                   | hl                    | hue_lightness         | Terminal uses only    |
|                       |                       | _saturation           | HLS color notation    |
|                       |                       |                       | (Tektronix)           |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| hs                    | hs                    | has_status_line       | Terminal has extra    |
|                       |                       |                       | status line           |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| hz                    | hz                    | tilde_glitch          | Hazeltine:  cannot    |
|                       |                       |                       | print tilde (~)       |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| in                    | in                    | insert_null_glitch    | Insert mode           |
|                       |                       |                       | distinguishes nulls   |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| km                    | km                    | has_meta_key          | Terminal has meta key |
|                       |                       |                       | (shift, sets parity   |
|                       |                       |                       | bit)                  |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------

          Table 3-7.  Boolean Capabilities (cont.) 

-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
|         TInfo         |         TCap          |       Variable        |      Description      |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| lpix                  | YG                    | lpi_changes_res       | Changing line pitch   |
|                       |                       |                       | changes resolution    |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| mc5i                  | 5i                    | prtr_silent           | Printer will not echo |
|                       |                       |                       | on screen             |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| mir                   | mi                    | move_insert_mode      | Safe to move in       |
|                       |                       |                       | insert mode           |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| msgr                  | ms                    | move_standout_mode    | Safe to move in       |
|                       |                       |                       | standout mode         |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| npc                   | NP                    | no_pad_char           | Pad character does    |
|                       |                       |                       | not exist             |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| nrrmc                 | NR                    | non_rev_rmcup         | smcup does not        |
|                       |                       |                       | reverse rmcup         |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| nxon                  | nx                    | needs_xon_xoff        | Padding will not      |
|                       |                       |                       | work, XON/XOFF        |
|                       |                       |                       | required              |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| os                    | os                    | over_strike           | Terminal overstrikes  |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| sam                   | YE                    | semi_auto_right_margin| Printing in last      |
|                       |                       |                       | column causes cr      |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| ul                    | ul                    | transparent_underline | Underline character   |
|                       |                       |                       | overstrikes           |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| xenl                  | xn                    | eat_newline_glitch    | Newline ignored after |
|                       |                       |                       | 80 columns (Concept)  |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| xhp                   | xs                    | ceol_standout_glitch  | Standout not erased   |
|                       |                       |                       | by overwriting (hp)   |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| xhpa                  | YA                    | col_addr_glitch       | Only positive motion  |
|                       |                       |                       | for hpa/mhpa          |
|                       |                       |                       | capabilities          |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| xon                   | xo                    | xon_xoff              | Terminal uses         |
|                       |                       |                       | XON/XOFF handshaking  |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| xsb                   | xb                    | no_esc_ctlc           | Beehive (f 1=escape,  |
|                       |                       |                       | f2=ctrl C)            |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| xt                    | xt                    | dest_tabs_magic_smso  | Tabs destructive,     |
|                       |                       |                       | magic smso character  |
|                       |                       |                       | (Teleray 1061)        |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| xvpa                  | YD                    | row_addr_glitch       | Only positive motion  |
|                       |                       |                       | for vpa/mvpa          |
|                       |                       |                       | capabilities          |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------

Numeric Capabilities.   

Table 3-8  lists the numeric capabilities.

          Table 3-8.  Numeric Capabilities 

-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
|         TInfo         |         TCap          |       Variable        |      Description      |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| bufsz                 | Ya                    | buffer_capacity       | Number of bytes       |
|                       |                       |                       | buffered before       |
|                       |                       |                       | printing              |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| colors                | Co                    | max_colors            | Maximum number of     |
|                       |                       |                       | colors on the screen  |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| cols                  | co                    | columns               | Number of columns in  |
|                       |                       |                       | a line                |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| it                    | it                    | init_tabs             | Number of spaces      |
|                       |                       |                       | between initial tabs  |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| lh                    | lh                    | label_height          | Number of rows in     |
|                       |                       |                       | each label            |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| lines                 | li                    | lines                 | Number of lines on    |
|                       |                       |                       | screen or page        |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| lm                    | lm                    | lines_of_memory       | Lines of memory if >  |
|                       |                       |                       | 0; 0 means unfixed    |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| lw                    | lw                    | label_width           | Number of columns in  |
|                       |                       |                       | each label            |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| maddr                 | Yd                    | max_micro_address     | Maximum value in      |
|                       |                       |                       | micro_..._address     |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| mcs                   | Yf                    | micro_col_size        | Character step size   |
|                       |                       |                       | when in micro mode    |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| mjump                 | Ye                    | max_micro_jump        | Maximum value in      |
|                       |                       |                       | parm_..._micro        |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| mls                   | Yg                    | micro_line_size       | Line step size when   |
|                       |                       |                       | in micro mode         |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| ncv                   | NC                    | no_color_video        | Video attributes that |
|                       |                       |                       | cannot be used with   |
|                       |                       |                       | colors                |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| nlab                  | Nl                    | num_labels            | Number of labels on   |
|                       |                       |                       | screen (start at 1)   |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| npins                 | yH                    | number_of_pins        | Number of pins in     |
|                       |                       |                       | print-head            |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| orc                   | Yi                    | output_res_char       | Horz.  res.  in units |
|                       |                       |                       | per character         |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| orhi                  | Yk                    | output_res_horz_inch  | Horz.  res.  in units |
|                       |                       |                       | per inch              |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| orl                   | Yj                    | output_res_line       | Vert.  res.  in units |
|                       |                       |                       | per line              |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| orvi                  | Yl                    | output_res_vert_inch  | Vert.  res.  in units |
|                       |                       |                       | per inch              |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| pairs                 | pa                    | max_pairs             | Maximum number of     |
|                       |                       |                       | color pairs on the    |
|                       |                       |                       | screen                |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------

          Table 3-8.  Numeric Capabilities (cont.) 

-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
|         TInfo         |         TCap          |       Variable        |      Description      |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| pb                    | pb                    | padding_baud_rate     | Lowest baud rate      |
|                       |                       |                       | where cr/nl padding   |
|                       |                       |                       | needed                |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| spinh                 | Yc                    | dot_horz_spacing      | Spacing of dots       |
|                       |                       |                       | horizontally in dots  |
|                       |                       |                       | per inch              |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| spinv                 | Yb                    | dot_vert_spacing      | Spacing of pins       |
|                       |                       |                       | vertically in pins    |
|                       |                       |                       | per inch              |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| vt                    | vt                    | virtual_termina       | Virtual terminal      |
|                       |                       |                       | number (CB/UNIX)      |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| widcs                 | Yn                    | wide_char_size        | Character step size   |
|                       |                       |                       | when in double wide   |
|                       |                       |                       | mode                  |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| wsl                   | ws                    | width_status_line     | Number of columns in  |
|                       |                       |                       | status line           |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------
|                       |                       |                       |                       |
| xmc                   | sg                    | magic_cookie_glitch   | Number of blank chars |
|                       |                       |                       | left by smso or rmso  |
|                       |                       |                       |                       |
-------------------------------------------------------------------------------------------------



MPE/iX 5.0 Documentation