Appendix B

Description of Terminal Capabilities

terminfo.ini is the ASCII file that describes the emulation capabilities of terminals. The description is very similar to the TERMINFO source code of UNIX system.

The file consists of terminal sections. Each section begins with a header string - a logical terminal name enclosed in brackets. The name is used to select the terminal type in the Telnet_SSH Options/Settings/Type tab.

The section header is followed by a set of entry records that describes the emulation capabilities of the terminal. Each record consists of a capability keyword, a '=' separator, and one or more capability values separated by a ',' delimiter. White spaces are ignored after the ',' separator as well as after the last value.

Any line may contain a comment. A comment begins with a ';' character on a line and lasts to the end of the current line.

Normally there may be several groups of records in each terminal section:

• A group of terminal capability definitions (e.g., Lines, Columns, Colors, UseCRT, MG0, MG1, RGB, UseCSI, Use2W, Use2HW, Tab8, TabSet).
  
  
• A group of X-keys definitions (for non-standard keys of keyboards, e.g., auxiliary keypads or function keys). An X-keysym name followed by a '=' separator begins the record. X-keys definitions may have a single value for the PC-layout mode, or a single value for the VT-layout mode, or both. A '/' sign must precede the VT-layout mode value. In case of both modes, the first value is for the PC-layout mode. A value is a code sequence of one or more key codes (separated by a ',' delimiter) to be transmitted when you use the X-key defined. A code is a decimal number (to represent valid escape or control sequences for the terminal).
  

  Examples for VT240:

  XK_Home=155,72 / 155,50,126 ; CSI H / CSI 2 ~

  XK_KP_Home=155,72/143,119 ; CSI H / SS3 w

  XK_KP_Space=/143,117 ; / SS3 u

• A group of user defined keys (UDK) definitions. You can reprogram them in the Telnet_SSH Options/Settings/User Defined tab. A UDK's name followed by a '=' separator begins the record. A value may be a sequence of one or more characters and/or hex codes (without any separator) to be transmitted when you use the UDK defined.
  

  Examples:

  Alt-F10=PRINT ; five characters

  Shift-F1=0x1bOp ; one hex code 0x1b with two characters O and p

Terminal Parameter Settings

You can set up terminal capabilities by records with the following keywords and values:

Lines=number

The record specifies a number of lines on a screen of a terminal.

(Example: Lines=24)

Columns=number

The record specifies a number of characters in a line.

(Example: Columns=80)

Colors=number

The record specifies the maximum number of colors on the screen.

(Example: Colors=16)

RGB=R.G.B, ...

The record specifies the palette description for colors to be used for color terminals instead of default colors of MS Windows. Each color number (beginning at 0 to Colors-1) is represented by R, G and B - the relative intensities for red, green, and blue primaries (each in the range of 0...255 decimal) to be used for a certain color. The RGB values indicate normal locations in color space. The primaries in a triple are '.' separated while triples are separated by a ',' delimiter.

UseCSI=1

The terminal can (UseCSI=1) or cannot (UseCSI=0) use 8-bit control sequences.

UseCRT=1

The record defines to use the terminal or application mode for arrows keys instead of ANSI mode (as default).

Use2W=1

The terminal can (Use2W=1) or cannot (Use2W=0) use characters with double width. (See the control sequence Esc#6 for DEC terminals.)

Use2HW=1

The terminal can (Use2HW=1) or cannot (Use2HW=0) use characters with double height and width. (See control sequences Esc#3 and Esc#4 for DEC terminals.)

Tab8=1

The terminal can use the 8-space default tab stops (in case the TabSet record below does not exist).

TabSet=n1,n2,...

The record defines the horizontal tabulation stop set that will be used as the default tabulation set for the terminal. Decimal numbers separated by a ',' delimiter (n1,n2,...) are column numbers for horizontal tab stops. No values means the tabulation set is empty.

MG0i=inp.out,...
MG1i=inp.out,...

The records define re-mapping tables for the main character set (MG0) and for the alternate character set (MG1). Each table consists of code pairs separated by a ',' delimiter. A code pair has an input code (to be remapped), a '.' sign, and an output code from the character set used to display characters. The codes must be a hex number. Tables may continue onto multiple lines. The 'i' suffix in the keywords (MG0i or MG1i) shows the value for 'line number - 1'.

• Example for AT386 (9 pairs for MG0 on 2 lines):
  

  MG00=0x90.0xC9,0x91.0xBB,0x92.0xBC,0x93.0xC8,0x94.0xCD;

  MG01=0x95.0xBA,0x97.0xB9,0x98.0xCA,0x99.0xCC;

• Example for DEC terminals and XTERM (15 pairs for MG1 on 3 lines):
  

  MG10=0x6A.0xD9,0x6B.0xBF,0x6C.0xDA,0x6D.0xC0,0x6E.0xC5;

  MG11=0x6F.0xC4,0x70.0xC4,0x71.0xC4,0x72.0xC4,0x73.0xC4;

  MG12=0x74.0xC3,0x75.0xB4,0x76.0xC1,0x77.0xC2,0x78.0xB3;