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 “Characters with Special Values” 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
`\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-20 “Boolean Capabilities”, Table 3-21 “Numeric Capabilities”, and Table 3-22 “String Capabilities” as a reference for programmers. Table 3-20 “Boolean Capabilities” lists the capabilities by the Boolean variable name; Table 3-21 “Numeric Capabilities” lists the capabilities by the numeric variable name, and Table 3-22 “String Capabilities” lists the capabilities by the string variable name.

Boolean Capabilities

Table 3-7 “Boolean Capabilities” 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_saturation`	Terminal uses only 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)
`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 “Numeric Capabilities” 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
`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`

String Capabilities

Table 3-9 “String Capabilities” lists the string capabilities.

Table 3-9 String Capabilities

TInfo	TCap	Variable	Description
`acsc`	`ac`	`acs_chars`	Graphics character set pairs aAbBcC-defn=vt100
`bel`	`bl`	`bell`	Produce audible signal (bell or beep)
`blink`	`mb`	`enter_blink_mode`	Turn on blinking
`bold`	`md`	`enter_bold_mode`	Turn on bold (extra bright) mode
`cbt`	`bt`	`back_tab`	Back tab
`chr`	`ZC`	`change_res_horz`	Change horizontal resolution
`civis`	`vi`	`cursor_invisible`	Make cursor invisible
`clear`	<`cl`	`clear_screen`	Clear screen
`cmdch`	`CC`	`command_character`	Terminal settable command character in prototype
`cnorm`	`ve`	`cursor_normal`	Make cursor appear normal (undo `cvvis/civis`)
`cpi`	`ZA`	`change_char_pitch`	Change number of characters per inch
`cr`	`cr`	`carriage_return`	Move cursor to left edge of screen
`csnm`	`Zy`	`char_set_names`	List of character set names
`csr`	`cs`	`change_scroll_region`	Change to lines #1 through #2 (vt100)
`cub`	`LE`	`parm_left_cursor`	Move cursor left #1 spaces
`cub1`	`le`	`cursor_left`	Move cursor left one space
`cud`	`DO`	`parm_down_cursor`	Move cursor down #1 lines
`cud1`	`do`	`cursor_down`	Move cursor down one line
`cuf`	`RI`	`parm_right_cursor`	Move cursor right #1 spaces
`cuf1`	`nd`	`cursor_right`	Non-destructive space (cursor right)
`cup`	`cm`	`cursor_address`	Cursor motion to row #1 col #2
`cuu`	`UP`	`parm_up_cursor`	Move cursor up #1 lines
`cuu1`	`up`	`cursor_up`	Move cursor up
`cvr`	`ZD`	`change_res_vert`	Change vertical resolution
`cvvis`	`vs`	`cursor_visible`	Make cursor very visible
`dch`	`DC`	`parm_dch`	Delete #1 characters
`dch1`	`dc`	`delete_character`	Delete character
`defc`	`ZE`	`define_char`	Define a character in a character set
`dim`	`mh`	`enter_dim_mode`	Turn on half-bright mode
`dl`	`DL`	`parm_delete_line`	Delete #1 lines
`dl1`	`dl`	`delete_line`	Delete line
`docr`	`Zw`	`these_cause_cr`	Printing any of these chars causes cr
`dsl`	`ds`	`dis_status_line`	Disable status line
`ech`	`ec`	`erase_chars`	Erase #1 characters
`ed`	`cd`	`clr_eos`	Clear to end of display
`el`	`ce`	`clr_eol`	Clear to end of line
`el1`	`cb`	`clr_bol`	Clear to beginning of line, inclusive
`enacs`	`eA`	`ena_acs`	Enable alternate character set
`ff`	`ff`	`form_feed`	Hardcopy terminal page eject
`flash`	`vb`	`flash_screen`	Visible bell (may not move cursor)
`fsl`	`fs`	`from_status_line`	Return from status line
`hd`	`hd`	`down_half_line`	Half-line down (forward 1/2 linefeed)
`home`	`ho`	`cursor_home`	Home cursor (if no `cup`)
`hpa`	`ch`	`column_address`	Set cursor column
`ht`	`ta`	`tab`	Tab to next 8 space hardware tab stop
`hts`	`st`	`set_tab`	Set a tab in all rows, current column
`hu`	`hu`	`up_half_line`	Half-line up (reverse 1/2 linefeed)
`ich`	`IC`	`parm_ich`	Insert #1 blank characters
`ich1`	`ic`	`insert_character`	Insert character
`if`	`if`	`init_file`	Name of file containing is
`il`	`AL`	`parm_insert_line`	Add #1 new blank lines
`il1`	`al`	`insert_line`	Add new blank line
`ind`	`sf`	`scroll_forward`	Scroll text up
`indn`	`SF`	`parm_index`	Scroll forward #1 lines
`initc`	`Ic`	`initialize_color`	Initialize the definition of color
`initp`	`Ip`	`initialize_pair`	Initialize color pair
`invis`	`mk`	`enter_secure_mode`	Turn on blank mode (characters invisible)
`ip`	`ip`	`insert_padding`	Insert pad after character inserted
`iprog`	`iP`	`init_prog`	Pathname of program for initialization
`is1=`	`i1`	`init_1string`	Terminal initialization string
`is2=`	`is`	`init_2string`	Terminal initialization string
`is3=`	`i3`	`init_3string`	Terminal initialization string
`kBEG`	`&9`	`key_sbeg`	Sent by shift-beginning key
`kCAN`	`&0`	`key_scancel`	Sent by shift-cancel key
`kCMD`	`*1`	`key_scommand`	Sent by shift-command key
`kCPY`	`*2`	`key_scopy`	Sent by shift-copy key
`kCRT`	`*3`	`key_screate`	Sent by shift-create key
`kDC`	`*4`	`key_sdc`	Sent by shift-delete-char key
`kDL`	`*5`	`key_sdl`	Sent by shift-delete-line key
`kEND`	`*7`	`key_send`	Sent by shift-end key
`kEOL`	`*8`	`key_seol`	Sent by shift-eol key
`kEXT`	`*9`	`key_sexit`	Sent by shift-exit key
`kFND`	`*0`	`key_sfind`	Sent by shift-find key
`kHLP`	`#1`	`key_shelp`	Sent by shift-help key
`kHOM`	`#2`	`key_shome`	Sent by shift-home key
`kIC`	`#3`	`key_sic`	Sent by shift-insert-char key
`kLFT`	`#4`	`key_sleft`	Sent by shift-left key
`kMOV`	`%b`	`key_smove`	Sent by shift-move key
`kMSG`	`%a`	`key_smessage`	Sent by shift-message key
`kNXT`	`%c`	`key_snext`	Sent by shift-next key
`kOPT`	`%d`	`key_soptions`	Sent by shift-options key
`kPRT`	`%f`	`key_sprint`	Sent by shift-print key
`kPRV`	`%e`	`key_sprevious`	Sent by shift-prev key
`kRDO`	`g`	`key_sredo`	Sent by shift-redo key
`kRES`	`%j`	`key_srsume`	Sent by shift-resume key
`kRIT`	`%i`	`key_sright`	Sent by shift-right key
`kRPL`	`%h`	`key_sreplace`	Sent by shift-replace key
`kSAV`	`!1`	`key_ssave`	Sent by shift-save key
`kSPD`	`!2`	`key_ssuspend`	Sent by shift-suspend key
`kUND`	`!3`	`key_sundo`	Sent by shift-undo key
`ka1`	`K1`	`key_a1`	Upper left of keypad
`ka3`	`K3`	`key_a3`	Upper right of keypad
`kb2`	`K2`	`key_b2`	Center of keypad
`kbeg`	`@1`	`key_beg`	Sent by beginning key
`kbs`	`kb`	`key_backspace`	Sent by backspace key
`kc1`	`K4`	`key_c1`	Lower left of keypad
`kc3`	`K5`	`key_c3`	Lower right of keypad
`kcan`	`@2`	`key_cancel`	Sent by cancel key
`kcbt`	`kB`	`key_btab`	Sent by BackTab key
`kclo`	`@3`	`key_close`	Sent by close key
`kclr`	`kC`	`key_clear`	Sent by clear screen or erase key
`kcmd`	`@4`	`key_command`	Sent by command key
`kcpy`	`@5`	`key_copy`	Sent by copy key
`kcreate`	`@6`	`key_create`	Sent by create key
`kctab`	`kt`	`key_ctab`	Sent by clear-tab key
`kcub1`	`kl`	`key_left`	Sent by terminal left arrow key
`kcud1`	`kd`	`key_down`	Sent by terminal down arrow key
`kcuf1`	`kr`	`key_right`	Sent by terminal right arrow key
`kcuu1`	`ku`	`key_up`	Sent by terminal up arrow key
`kdch1`	`kD`	`key_dc`	Sent by delete character key
`kdl1`	`kL`	`key_dl`	Sent by delete line key
`ked`	`kS`	`key_eos`	Sent by clear-to-end-of-screen key
`kel`	`kE`	`key_eol`	Sent by clear-to-end-of-line key
`kend`	`@7`	`key_end`	Sent by end key
`kent`	`@8`	`key_enter`	Sent by enter/send key
`kext`	`@9`	`key_exit`	Sent by exit key
`kf0`	`k0`	`key_f0`	Sent by function key f0
`kf1`	`k1`	`key_f1`	Sent by function key f1
`kf2`	`k2`	`key_f2`	Sent by function key f2
`kf3`	`k3`	`key_f3`	Sent by function key f3
`kf4`	`k4`	`key_f4`	Sent by function key f4
`kf5`	`k5`	`key_f5`	Sent by function key f5
`kf6`	`k6`	`key_f6`	Sent by function key f6
`kf7`	`k7`	`key_f7`	Sent by function key f7
`kf8`	`k8`	`key_f8`	Sent by function key f8
`kf9`	`k9`	`key_f9`	Sent by function key f9
`kf10`	`k;`	`key_f10`	Sent by function key f10
`kf11`	`F1`	`key_f11`	Sent by function key 11
`kf12`	`F2`	`key_f12`	Sent by function key 12
`kf13`	`F3`	`key_f13`	Sent by function key 13
`kf14`	`F4`	`key_f14`	Sent by function key 14
`kf15`	`F5`	`key_f15`	Sent by function key 15
`kf16`	`F6`	`key_f16`	Sent by function key 16
`kf17`	`F7`	`key_f17`	Sent by function key 17
`kf18`	`F8`	`key_f18`	Sent by function key 18
`kf19`	`F9`	`key_f19`	Sent by function key 19
`kf20`	`FA`	`key_f20`	Sent by function key 20
`kf21`	`FB`	`key_f21`	Sent by function key 21
`kf22`	`FC`	`key_f22`	Sent by function key 22
`kf23`	`FD`	`key_f23`	Sent by function key 23
`kf24`	`FE`	`key_f24`	Sent by function key 24
`kf25`	`FF`	`key_f25`	Sent by function key 25
`kf26`	`FG`	`key_f26`	Sent by function key 26
`kf27`	`FH`	`key_f27`	Sent by function key 27
`kf28`	`FI`	`key_f28`	Sent by function key 28
`kf29`	`FJ`	`key_f29`	Sent by function key 29
`kf30`	`FK`	`key_f30`	Sent by function key 30
`kf31`	`FL`	`key_f31`	Sent by function key 31
`kf32`	`FM`	`key_f32`	Sent by function key 32
`kf33`	`FN`	`key_f33`	Sent by function key 33
`kf34`	`FO`	`key_f34`	Sent by function key 34
`kf35`	`FP`	`key_f35`	Sent by function key 35
`kf36`	`FQ`	`key_f36`	Sent by function key 36
`kf37`	`FR`	`key_f37`	Sent by function key 37
`kf38`	`FS`	`key_f38`	Sent by function key 38
`kf39`	`FT`	`key_f39`	Sent by function key 39
`kf40`	`FU`	`key_f40`	Sent by function key 40
`kf41`	`FV`	`key_f41`	Sent by function key 41
`kf42`	`FW`	`key_f42`	Sent by function key 42
`kf43`	`FX`	`key_f43`	Sent by function key 43
`kf44`	`FY`	`key_f44`	Sent by function key 44
`kf45`	`FZ`	`key_f45`	Sent by function key 45
`kf46`	`Fa`	`key_f46`	Sent by function key 46
`kf47`	`Fb`	`key_f47`	Sent by function key 47
`kf48`	`Fc`	`key_f48`	Sent by function key 48
`kf49`	`Fd`	`key_f49`	Sent by function key 49
`kf50`	`Fe`	`key_f50`	Sent by function key 50
`kf51`	`Ff`	`key_f51`	Sent by function key 51
`kf52`	`Fg`	`key_f52`	Sent by function key 52
`kf53`	`Fh`	`key_f53`	Sent by function key 53
`kf54`	`Fi`	`key_f54`	Sent by function key 54
`kf55`	`Fj`	`key_f55`	Sent by function key 55
`kf56`	`Fk`	`key_f56`	Sent by function key 56
`kf57`	`Fl`	`key_f57`	Sent by function key 57
`kf58`	`Fm`	`key_f58`	Sent by function key 58
`kf59`	`Fn`	`key_f59`	Sent by function key 59
`kf60`	`Fo`	`key_f60`	Sent by function key 60
`kf61`	`Fp`	`key_f61`	Sent by function key 61
`kf62`	`Fq`	`key_f62`	Sent by function key 62
`kf63`	`Fr`	`key_f63`	Sent by function key 63
`kfnd`	`@0`	`key_find`	Sent by find key
`khlp`	`%1`	`key_help`	Sent by help key
`khome`	`kh`	`key_home`	Sent by home key
`khts`	`kT`	`key_stab`	Sent by set-tab key
`kich1`	`kI`	`key_ic`	Sent by ins char/enter ins mode key
`kil1`	`kA`	`key_il`	Sent by insert line
`kind`	`kF`	`key_sf`	Sent by scroll-forward/down key
`kll`	`kH`	`key_ll`	Sent by home down key (lower left)
`kmov`	`%4`	`key_move`	Sent by move key
`kmrk`	`%2`	`key_mark`	Sent by mark key
`kmsg`	`%3`	`key_message`	Sent by message key
`knp`	`kN`	`key_npage`	Sent by next-page key
`knxt`	`%5`	`key_next`	Sent by next-object key
`kopn`	`%6`	`key_open`	Sent by open key
`kopt`	`%7`	`key_options`	Sent by options key
`kpp`	`kP`	`key_ppage`	Sent by previous-page key
`kprt`	`%9`	`key_print`	Sent by print or copy key
`kprv`	`%8`	`key_previous`	Sent by previous-object key
`krdo`	`%0`	`key_redo`	Sent by redo key
`kref`	`&1`	`key_reference`	Sent by reference key
`kres`	`&5`	`key_resume`	Sent by resume key
`krfr`	`&2`	`key_refresh`	Sent by refresh key
`kri`	`kR`	`key_sr`	Sent by scroll-backward/up key
`krmir`	`kM`	`key_eic`	Sent by `rmir` or `smir` in insert mode
`krpl`	`&3`	`key_replace`	Sent by replace key
`krst`	`&4`	`key_restart`	Sent by restart key
`ksav`	`&6`	`key_save`	Sent by save key
`kslt`	`*6`	`key_select`	Sent by select key
`kspd`	`&7`	`key_suspend`	Sent by suspend key
`ktbc`	`ka`	`key_catab`	Sent by clear-all-tabs key
`kund`	`&8`	`key_undo`	Sent by undo key
`lf0`	`l0`	`lab_f0`	Labels on function key f0 if not f0
`lf1`	`l1`	`lab_f1`	Labels on function key f1 if not f1
`lf2`	`l2`	`lab_f2`	Labels on function key f2 if not f2
`lf3`	`l3`	`lab_f3`	Labels on function key f3 if not f3
`lf4`	`l4`	`lab_f4`	Labels on function key f4 if not f4
`lf5`	`l5`	`lab_f5`	Labels on function key f5 if not f5
`lf6`	`l6`	`lab_f6`	Labels on function key f6 if not f6
`lf7`	`l7`	`lab_f7`	Labels on function key f7 if not f7
`lf8`	`l8`	`lab_f8`	Labels on function key f8 if not f8
`lf9`	`l9`	`lab_f9`	Labels on function key f9 if not f9
`lf10`	`la`	`lab_f10`	Labels on function key f10 if not f10
`ll`	`ll`	`cursor_to_ll`	Last line, first column (if no `cup`)
`lpi`	`ZB`	`change_line_pitch`	Change number of lines per inch
`mc0`	`ps`	`print_screen`	Print contents of the screen
`mc4`	`pf`	`prtr_off`	Turn off the printer
`mc5`	`po`	`prtr_on`	Turn on the printer
`mc5p`	`pO`	`prtr_non`	Turn on the printer for #1 bytes
`mcub`	`Zg`	`parm_left_micro`	Like parm_left_cursor
`mcub1`	`Za`	`micro_left`	Like cursor_left for micro adjustment
`mcud`	`Zf`	`parm_down_micro`	Like parm_down_cursor
`mcud1`	`ZZ`	`micro_down`	Like cursor_down for micro adjustment
`mcuf`	`Zh`	`parm_right_micro`	Like parm_right_cursor
`mcuf1`	`Zb`	`micro_right`	Like cursor_right for micro adjustment
`mcuu`	`Zi`	`parm_up_micro`	Like parm_up_cursor
`mcuu1`	`Zd`	`micro_up`	Like cursor_up for micro adjustment
`mgc`	`MC`	`clear_margins`	Clear all margins top, bottom,
`mhpa`	`ZY`	`micro_column_address`	Like column_address for micro adjustment
`mrcup`	`CM`	`cursor_mem_address`	Memory relative cursor addressing
`mvpa`	`Zc`	`micro_row_address`	Like row_address for micro adjustment
`nel`	`nw`	`newline`	Produces newline (behaves like cr followed by lf)
`oc`	`oc 0`	`orig_colors`	Set all color(pair)s to the original ones
`op`	`op`	`orig_pair`	Set default color pair to the original one
`pad`	`pc`	`pad_char`	Pad character (rather than null)
`pfkey`	`pk`	`pkey_key`	Prog funct key #1 to type string #2
`pfloc`	`pl`	`pkey_local`	Prog funct key #1 to execute string #2
`pfx`	`px`	`pkey_xmit`	Prog funct key #1 to xmit string #2
`pln`	`pn`	`plab_norm`	Prog label #1 to show string #2
`porder`	`Ze`	`order_of_pins`	Matches software bits to print-head pins
`prot`	`mp`	`enter_protected_mode`	Turn on protected mode
`rbim`	`Zs`	`stop_bit_image`	Stop printing bit image graphics
`rc`	`rc`	`restore_cursor`	Restore cursor to position of last sc
`rcsd`	`Zt`	`stop_char_set_def`	Stop definition of character set
`rep`	`rp`	`repeat_char`	Repeat char #1 #2 times
`rev`	`mr`	`enter_reverse_mode`	Turn on reverse video mode
`rf`	`rf`	`reset_file`	Name of file containing reset string
`rfi`	`RF`	`req_for_input`	Send next input character (for ptys)
`ri`	`ri`	`scroll_reverse`	Scroll text down
`rin`	`SR`	`parm_rindex`	Scroll backward #1 lines
`ritm`	`ZR`	`exit_italics_mode`	Disable italics
`rlm`	`ZS`	`exit_leftward_mode`	Enable rightward (normal) carriage motion
`rmacs`	`ae`	`exit_alt_charset_mode`	End alternate character set
`rmam`	`RA`	`exit_am_mode`	Turn off automatic margins
`rmcup`	`te`	`exit_ca_mode`	String to begin programs that use `cup`
`rmdc`	`ed`	`exit_delete_mode`	End delete mode
`rmicm`	`ZT`	`exit_micro_mode`	Disable micro motion capabilities
`rmir`	`ei`	`exit_insert_mode`	End insert mode
`rmkx`	`ke`	`keypad_local`	Out of keypad transmit mode
`rmln`	`LF`	`label_off`	Turn off soft labels
`rmm`	`mo`	`meta_off`	Turn off meta mode
`rmp`	`rP`	`char_padding`	Like `ip`, but when in replace mode
`rmso`	`se`	`exit_standout_mode`	End stand out mode
`rmul`	`ue`	`exit_underline_mode`	End underscore mode
`rmxon`	`RX`	`exit_xon_mode`	Turn off XON/XOFF handshaking
`rs1`	`r1`	`reset_1string`	Reset terminal completely to sane modes
`rs2`	`r2`	`reset_2string`	Reset terminal completely to sane modes
`rs3`	`r3`	`reset_3string`	Reset terminal completely to sane modes
`rshm`	`ZU`	`exit_shadow_mode`	Disable shadow printing
`wsubm`	`ZV`	`exit_subscript_mode`	Disable subscript printing
`rsupm`	`ZW`	`exit_supercript_mode`	Disable superscript printing
`rum`	`ZX`	`exit_upward_mode`	Enable downward (normal) carriage motion
`rwidm`	`ZQ`	`exit_doublewide_mode`	Disable double wide printing
`sbim`	`Zq`	`start_bit_image`	Start printing bit image graphics
`sc`	`sc`	`save_cursor`	Save cursor position
`scp`	`sp`	`set_color_pair`	Set current color pair
`scs`	`Zj`	`select_char_set`	Select character set
`scsd`	`Zr`	`start_char_set_def`	Start definition of character set
`sdrfq`	`ZG`	`enter_draft_quality`	Set draft quality print
`setb`	`Sb`	`set_background`	Set current background color
`setf`	`Sf`	`set_foreground`	Set current foreground color
`sgr`	`sa`	`set_attributes`	Define the video attributes
`sgr0`	`me`	`exit_attribute_mode`	Turn off all attributes
`sitm`	`ZH`	`enter_italics_mode`	Enable italics
`slm`	`ZI`	`enter_leftward_mode`	Enable leftward carriage motion
`smacs`	`as`	`enter_alt_charset_mode`	Start alternate character set
`smam`	`SA`	`enter_am_mode`	Turn on automatic margins
`smcup`	`ti`	`enter_ca_mode`	String to end programs that use `cup`
`smdc`	`dm`	`enter_delete_mode`	Delete mode (enter)
`smgb`	`Zk`	`set_bottom_margin`	Set bottom margin at current line
`smgbp`	`Zl`	`set_bottom_margin_parm`	Set bottom margin at line #1 or #2 from bottom
`smgl`	`ML`	`set_left_margin`	Set left margin at current column
`smglp`	`Zm`	`set_left_margin_parm`	Set left (right) margin at column #1 (#2)
`smgr`	`MR`	`set_right_margin`	Set right margin at current column
`smgrp`	`Zn`	`set_right_margin_parm`	Set right margin at column #1
`smgt`	`Zo`	`set_top_margin`	Set top margin at current line
`smgtp`	`Zp`	`set_top_margin_parm`	Set top (bottom) margin at line #1 (#2)
`smicm`	`ZJ`	`enter_micro_mode`	Enable micro motion capabilities
`smir`	`im`	`enter_insert_mode`	Insert mode (enter)
`smln`	`LO`	`label_on`	Turn on soft labels
`smm`	`mm`	`meta_on`	Turn on meta mode (8th bit)
`smso`	`so`	`enter_standout_mode`	Begin stand out mode
`smul`	`us`	`enter_underline_mode`	Start underscore mode
`smxon`	`SX`	`enter_xon_mode`	Turn on XON/XOFF handshaking
`snlq`	`ZK`	`enter_near_letter_quality`	Set near-letter quality
`snrmq`	`ZL`	`enter_normal_quality`	Set normal quality print
`sshm`	`ZM`	`enter_shadow_mode`	Enable shadow printing
`ssubm`	`ZN`	`enter_subscript_mode`	Enable subscript printing
`ssupm`	`ZO`	`enter_supercript_mode`	Enable superscript printing
`subcs`	`Zu`	`subscript_characters`	List of "subscript-able" characters
`sum`	`ZP`	`enter_upward_mode`	Enable upward carriage msupcs
`supcs`	`Zv`	`superscript_characters`	List of "superscript-able" characters
`swidm`	`ZF`	`enter_doublewide_mode`	Enable double wide printing
`tbc`	`ct`	`clear_all_tabs`	Clear all tab stops
`tsl`	`ts`	`to_status_line`	Go to status line
`uc`	`uc`	`underline_char`	Underscore one char and move past it
`use`	`tc`	`N/A`	Read capabilities from entry
`vpa`	`cv`	`row_address`	Like `hpa`, but sets row
`wind`	`wi`	`set_window`	Current window is lines #1 - #2 cols #3 - #4
`xoffc`	`XF`	`xoff_character`	XOFF character
`xonc`	`XN`	`xon_character`	XON character
`zerom`	`Zx`	`zero_motion`	No motion for the subsequent character

The following sections group these categories and look at each group in detail.

Configuration Capabilities

Table 3-10 “Configuration Capabilities” lists the capabilities used to configure terminals. Following the table are more detailed descriptions of some of these capabilities.

Table 3-10 Configuration Capabilities

Capability	Variable	Description
`acscU=`	`acs_chars`	Graphics character set pairs aAbBcC-defn=vt100
`am`	`auto_right_margin`	Wraps to next line at right margin
`bel=`	`bell`	Produce audible signal (bell or beep)
`bufsz#`	`buffer_capacity`	Number of bytes buffered before printing
`bw`	`auto_left_margin`	cub1 wraps from column 0 to last column
`ccc`	`can_change`	Terminal can redefine existing color
`chts`	`hard_cursor`	Cursor is hard to see
`cmdch=`	`command_character`	Terminal settable command character in prototype
`cols#`	`columns`	Number of columns on each line
`cr=`	`carriage_return`	Move cursor to left edge of screen
`da`	`memory_above`	Display may be retained above the screen
`db`	`memory_below`	Display may be retained below the screen
`eo`	`erase_overstrike`	Terminal can erase overstrikes with a blank
`eslok`	`status_line_esc_ok`	Escape can be used on the status line
`gn`	`generic_type`	Generic line type (for example, dialup, switch)
`hc`	`hard_copy`	Hardcopy terminal
`hs`	`has_status_line`	Terminal has extra status line
`hz`	`tilde_glitch`	Hazeltine: cannot print tilde (~)
`if=`	`init_file`	Name of file containing `is`
`iprog=`	`init_prog`	Path name of program for initialization
`is1=`	`init_1string`	Terminal initialization string
`is2=`	`init_2string`	Terminal initialization string
`is3=`	`init_3string`	Terminal initialization string
`lines#`	`lines`	Number of lines on the screen
`lm#`	`lines_of_memory`	Lines of memory if > 0; 0 means unfixed
`nxon`	`needs_xon_xoff`	Padding will not work, XON/XOFF required
`pad=`	`pad_char`	Pad character (rather than null)
`pb#`	`padding_baud_rate`	Lowest baud rate where cr/nl padding needed
`os`	`over_strike`	Overstrike leaves both characters on screen
`rf=`	`reset_file`	Name of file containing reset string
`rs1=`	`reset_1string`	Reset terminal completely to sane modes
`rs2=`	`reset_2string`	Reset terminal completely to sane modes
`rs3=`	`reset_3string`	Reset terminal completely to sane modes
`rmam=`	`exit_am_mode`	Turn off automatic margins
`rmxon=`	`exit_xon_mode`	Turn off XON/XOFF handshaking
`sam`	`semi_auto_right_margin`	Printing in last column causes cr
`smam=`	`enter_am_mode`	Turn on automatic margins
`smxon=`	`enter_xon_mode`	Turn on XON/XOFF handshaking
`ul`	`transparent_underline`	Underline character overstrikes
`vt#`	`virtual_terminal`	Virtual terminal # (CB/UNIX)
`xenl`	`eat_newline_glitch`	Newline ignored after 80 columns (Concept)
`xoffc=`	`xoff_character`	XOFF character
`xon`	`xon_xoff`	Terminal uses XON/XOFF handshaking
`xonc=`	x`on_character`	XON character
`xsb`	`no_esc_ctlc`	Beehive (f1=escape, f2=ctrl C)
`xt`	`dest_tabs_magic_smso`	Tabs destructive, magic smso character

Detailed Descriptions

More detailed descriptions are provided below for the following capabilities:

cmdch
da, db
gn
if, iprog, is1, is2, is3
lm
xenl
os, hc
ascs

cmdch

Some terminals, such as the Tektronix 4025, have a control character that can be set. The cmdch string describes a "dummy" control character to be used in all capabilities. Some UNIX systems support the convention of using the value of the environment variable CC in place of the dummy control character.

da

The da capability describes the case where deleting a line or scrolling a full screen may bring non-blank lines from below the screen; the db capability describes the case where scrolling back with ri may bring down non-blank lines from above.

gn

Terminal descriptions that are not specific types of terminals (such as switch, dialup, patch, and network) can be described at a basic level with gn. This allows the terminal to function at a low level but still complain when some operations are impossible. This capability is not used for virtual terminal descriptions supported by the UNIX system virtual terminal protocol. (Use vt.)

if, iprog, is1, is2, is3

The if, iprog, is1, is2, and is3 strings must be sent to the device every time that the user logs in. They must be output in a certain order: run the program specified by iprog; output is1; output is2; set the margins with mgc, smgl, and smgr; set the tabs with tbc and hts; print the file specified by if; and output is3 (using the init option of the tput command).

Normally initialization is done with is2 and in special cases, is1 and is3; however, sequences that reset from an unknown state can be given as rs1, rs2, rf, and rs3. (Reset strings are normally output with the reset option of the tput command.) Commands are normally placed in these strings when they have annoying results or are not needed when logging in.

lm

The lm capability is used if the terminal has more lines of memory than can be displayed on the screen simultaneously; a value of zero means that the number of lines is not fixed but that number is still more than can fit on the screen.

xenl

In addition to terminals that ignore a linefeed, xenl should be specified for terminals that do not immediately wrap when a character is read to the right-most column of the screen but wait until another character has been received (the VT100, for example).

os, hc

If the device is a printing terminal with no soft copy unit, both os and hc should be specified.

ascs

The definition of the ascs string is based on the DEC VT100 character set with the addition of some characters from the AT&T 4410v1 terminal. Table 3-11 “Glyph to Character Mapping” illustrates the glyph to character mapping.

Table 3-11 Glyph to Character Mapping

Glyph Name	Character
right arrow	`+`
left arrow	`'`
down arrow	`.`
up arrow	`-`
solid square block	`O`
lantern symbol	`I`
diamond	`
checker board (stipple)	`a`
degree symbol	`f`
plus/minus	`g`
board of squares	`h`
lower right corner	`j`
upper right corner	`k`
upper left corner	`l`
lower left corner	`m`
plus	`n`
scan line 1	`o`
horizontal line	`q`
scan line 9	`s`
left tee (`\|-`)	`t`
right tee (`-\|`)	`u`
bottom tee ()	`v`
top tee (T)	`w`
vertical line	`x`
bullet	`~`

The characters are described in pairs, with the defining character for the glyph followed by the corresponding character on the device. For example, a device with the left tee, right tee, bottom tee, and top tee defined by the f,g, h, and i characters would be described as follows:

acsc=tfugvhwi

Cursor Movement and Scrolling Capabilities

Table 3-12 “Cursor Movement Capabilities” lists the capabilities used to define cursor movements. Following the table are more detailed descriptions of some of these capabilities.

Table 3-12 Cursor Movement Capabilities

Capability	Variable	Description
`csr=`	`change_scroll_region`	Change to lines #1 through #2 (vt100)
`cub=`	`parm_left_cursor`	Move cursor left specified number of spaces
`cub1=`	`cursor_left`	Move cursor left one space
`cud=`	`parm_down_cursor`	Move down specified number of lines
`cud1=`	`cursor_down`	Move cursor down one line
`cuf=`	`parm_right_cursor`	Move cursor right specified number of spaces
`cuf1=`	`cursor_right`	Non-destructive space (cursor right)
`cup=`	`cursor_address`	Move cursor to row #1 col #2
`cuu=`	`parm_up_cursor`	Move up specified number of lines
`cuu1=`	`cursor_up`	Move cursor up one line
`home=`	`cursor_home`	Move cursor to upper left corner of screen (if no `cup`)
`hpa=`	`column_address`	Absolute horizontal position
`ind=`	`scroll_forward`	Scroll text up
`indn=`	`parm_index`	Scroll forward #1 lines
`ll=`	`cursor_to_ll`	Moves cursor to last line, first column (if no `cup`)
`mir`	`move_insert_mode`	Safe to move in insert mode
`mrcup=`	`cursor_mem_address`	Memory relative cursor addressing
`msgr`	`move_standout_mode`	Safe to move in standout mode
`nel=`	`newline`	Produces newline (behaves like cr followed by lf)
`nrrmc=`	`non_rev_rmcup`	smcup does not restore screen after `rmcup`
`rc=`	`restore_cursor`	Restores cursor to position of last `sc`
`ri=`	`scroll_reverse`	Scrolls text down
`rin=`	`parm_rindex`	Scrolls backward #1 lines
`rmcup=`	`exit_ca_mode`	String that ends programs that use `cup`
`sc=`	`save_cursor`	Save cursor position
`smcup=`	`enter_ca_mode`	String that begins programs that use `cup`
`vpa=`	`row_address`	Absolute vertical position
`xhpa`	`col_addr_glitch`	Only positive motion for hpa/mhpa capabilties
`xt`	`dest_tabs_magic_smso`	Tabs destructive, magic `smso` character (Teleray 1061)
`xvpa`	`row_addr_glitch`	Only positive motion for `vpa/mvpa` capabilities

Detailed Descriptions

More detailed descriptions are provided below for the following capabilities:

ind, ri
cufl
csr
cup, cuu
home
mir
smcup, rmcup
xt

ind, ri

Local cursor movements defined for TERMINFO are undefined at the top and left edges of the screen. Unless bw is specified, programs should not try to backspace at the left edge of the screen. To scroll text down, the program should move the cursor to the bottom left corner of the screen and send ind. To scroll up, the program should move the cursor to the top of the screen and send ri. Both of these capabilities are undefined when the cursor is anywhere else on the screen.

Although moving backwards from the left edge of the screen is not possible unless bw is specified, moving forward at the right edge of the screen does not necessarily depend on whether or not am is set. If the device has switch selectable automatic margins, am should be specified in the TERMINFO file, and initialization strings should turn on this option.

cufl

The local cursor movements should not change the text that they pass over; for example, you would not use cufl=\s because the space would erase the character that it passed over.

csr

The cursor position is undefined after using csr. Do not specify csr on terminals that do not have destructive scroll regions unless all of the following simulate destructive scrolling: ind, ri, indn, rin, dl, and dl1. To find out whether or not the terminal has a destructive scroll region, create a scroll region and place data on the bottom line, move the cursor to the top and do a reverse index (ri), followed by a delete line (dl1) or index (ind). The terminal has destructive scroll regions if the bottom line drops off the bottom of the scrolling region.

The csr string can create the effect of insert and delete line.

cup, cuu

If the device does not have cup, (Tektronix 4025, for example), cud, cub, cuf, and cuu are useful for moving relative to present position. Sometimes absolute-cursor addressing in one dimension (using vpa and hpa) is faster than the two-parameter specification of cup (as with the Hewlett-Packard 2645).

home

Since home refers to the top left corner of the screen (0,0) and not to memory, the sequence \EH on Hewlett-Packard terminals could not be used without losing other features of the terminal. A program should not get to the lower left hand corner by going up with cuu1 itself from the home position because the effects of home cannot be predicted.

ri, ind

The ri and ind strings can be used to insert lines at the top or bottom of the screen on terminals that have no true insert/delete line (and may even be faster).

mir

A terminal that allows movement within insert mode to delete characters on the same line can specify mir to speed up the insertion process. Some terminals, such as Datamedia's, should not specify mir because of the way that their insert mode works.

smcup, rmcup

Some devices may need to be in a special mode to use cursor movement. Some terminals turn off cursor movement when not in use; other terminals, such as the Concept terminal, have cursor addressing relative to memory instead of the screen; so a single screen-sized window must be fixed into the device for cursor addressing to work properly. Terminals, such as the Tektronix 4025, that have programmable command characters need to set the command character to the one used in TERMINFO. The smcup and rmcup strings start and end programs that use cursor movement.

xt

The xt capability is used for Teleray terminals that have destructive tabs (turn all characters tabbed over to blanks) and have an odd standout mode that requires using insert and delete to change text from standout back to normal instead of typing over the text.

Edit Capabilities

Table 3-13 “Editing Capabilities” lists the capabilities used for inserting and deleting text on terminals. Following the table are more detailed descriptions of the following capabilities:

ich1
in
ip

Table 3-13 Editing Capabilities

Capability	Variable	Description
`clear=`	`clear_screen`	Clear screen
`dch=`	`parm_dch`	Delete #1 chars
`dch1=`	`delete_character`	Delete character
`dl=`	`parm_delete_line`	Delete #1 lines (only from first column on line)
`dl1=`	`delete_line`	Delete current line (only from first position on line)
`ech=`	`erase_ch`	Clear from current position to end of screen
`el=`	`clr_eol`	Clear from current position to end of line, leaving the cursor in the original position
`el1=`	`clr_bol`	Clear from current position to beginning of line inclusive, leaving the cursor in the original position
`ich=`	`parm_ich`	Insert #1 blank characters
`ich1=`	`insert_character`	Insert character
`il=`	`parm_insert_line`	Add #1 new blank lines (only from first column line)
`il1=`	`insert_line`	Add new blank line above cursor (only from first column on line)
`in`	`insert_null_glitch`	Insert mode distinguishes nulls
`ip=`	`insert_padding`	Insert pad after character inserted
`rmdc=`	`exit_delete_mode`	End delete mode
`rmir=`	`exit_insert_mode`	End insert mode
`rmp=`	`char_padding`	Like `ip`, but when in replace mode
`smdc=`	`enter_delete_mode`	Delete mode (enter)
`smir=`	`enter_insert_mode`	Insert mode (enter)

Detailed Descriptions

More detailed descriptions are provided below for the following capabilities:

ich1
in
ip

ich1

Most characters with a true insert mode do not require ich1 to be specified; specify ich1 for any terminal that requires a sequence to be sent before a character can be inserted. (Do not specify both smir and ich1 unless the terminal must be placed in insert mode and must be sent a character before insertion).

in

If the terminal distinguishes between blank characters and untyped positions (for example, local cursor movements) in should be specified. To find out, clear the screen, type a few characters, press a cursor key, and type a few more characters. Put the cursor before the first set of characters and put the terminal in insert mode. If the first set of characters shifts to the second and then moves onto the next line as you insert more characters, the terminal should be described by in.

ip

In addition to post-insert padding, ip can be used for any sequence that has to be sent after a character is inserted.

Attribute Capabilities

Table 3-14 “Attribute Capabilities” lists the capabilities used to control attributes on the terminal. For example, attribute capabilities include those to manipulate bold, underline, and color.

Table 3-14 Attribute Capabilities

Capability	Variable	Description
`bce`	`back_color_erase`	Screen erased with background color
`blink=`	`enter_blink_mode`	Turn on blinking
`bold=`	`enter_bold_mode`	Turn on bold (extra bright) mode
`colors#`	`max_colors`	Maximum number of colors on the screen
`dim=`	`enter_dim_mode`	Turn on half-bright mode
`hls`	`hue_lightness_saturation`	Terminal uses only HLS color notation (Tektronix)
`initc=`	`initialize_color`	Initialize the definition of color
`initp=`	`initialize_pair`	Initialize color pair
`invis=`	`enter_secure_mode`	Turn on blank mode (characters invisible)
`ncv#`	`no_color_video`	Video attributes that cannot be used with colors
`oc=`	`orig_colors`	Set all color (pair)s to the original one
`op=`	`orig_pair`	Set default color pair to the original one
`pairs#`	`max_pairs`	Maximum number of color pairs on the screen
`prot=`	`enter_protected_mode`	Turn on protected mode
`rev=`	`enter_reverse_mode`	Turn on reverse video mode
`rmso=`	`exit_standout_mode`	End stand out mode
`rmul=`	`exit_underline_mode`	End underscore mode
`scp=`	`set_color_pair`	Set current color pair
`setb=`	`set_background`	Set current background color
`setf=`	`set_foreground`	Set current foreground color
`sgr=`	`set_attributes`	Define the video attributes
`sgr0=`	`exit_attribute_mode`	Turn off all attributes
`smso=`	`enter_standout_mode`	Begin stand out mode
`smul=`	`enter_underline_mode`	Start underscore mode
`xhp`	`ceol_standout_glitch`	Standout not erased by overwriting (hp)
`xmc#`	`magic_cookie_glitch`	# of blank chars left by `smso` or `rmso`

Handling Color

There are two ways terminals handle color. The Tektronix method provides a fixed set of colors that can be used for background or foreground. The Hewlett-Packard method provides color pairs that represent the foreground and background colors together; there is no way to define the foreground and background independent of each other.

The initc string is defined for terminals that use the Tektronix method of handling color. The initc string requires four arguments: one color number (0 to color -1), and three RGB (red, green, blue) values or three HLS colors (hue, lightness, saturation) in the same order specified in the parentheses.

The initp string is defined for terminals that use the Hewlett-Packard method of handling color. The initp string requires seven parameters: the number of the color pair (0 to pairs -1), three RGB values for foreground, and three RGB values for background (each group in the order of red, green, blue).

The hls Boolean variable is used to tell the CURSES init_color( ) routine to convert RGB (red, green, blue) arguments to HLS (hue, lighness, saturation) before sending them to the terminal (for those terminals that only use HLS notation).

Some color terminals replace video attributes with colors. Since these attributes should not be combined with colors, they need to be identified. Information about these attributes are packed into the ncv variable.

ncv Variable

The nine least significant bits of the ncv variable correspond to the video attributes as shown in Table 3-15 “ncv Variable”.

Table 3-15 ncv Variable

Attribute	Bit Position	Decimal Value
`A_STANDOUT`	0	1
`A_UNDERLINE`	1	2
`A_REVERSE`	2	4
`A_BLINK`	3	8
`A_DIM`	4	16
`A_BOLD`	5	32
`A_INVIS`	6	64
`A_PROTECT`	7	128
`A_ALTCHARSET`	8	256

The corresponding ncv bit of each attribute that should not be combined with color should be set to one; otherwise, it should be set to zero. The decimal values of the attributes that cannot be used with color are summed, and that sum is packed into the ncv variable. For example, if the terminal uses color for standout mode (decimal value 1) and for underlining (decimal value 2), ncv would be a value of 3.

Turning Off Attributes

Always use sgr0 to turn off video attributes since it is the only way to turn off some attributes like dim or blink.

Programs using standout mode should exit standout mode (rmso) before sending a newline or moving the cursor unless the msgr capability is present. (The msgr capability specifies that it's safe to move in standout mode.)

Setting Arbitrary Modes

The sgr string describes the sequence to set arbitrary combinations of modes. The sgr string takes nine parameters in the following order:

standout
underline
reverse
blink
dim
bold
blank
protect
alternate character set

Each parameter is either zero or non-zero, representing whether the attribute is on or off.

Table 3-16 “sgr Parameters” lists the sgr parameters.

Table 3-16 sgr Parameters

tparm	Attribute
	none
`p1`	standout
`p2`	underline
`p3`	reverse
`p4`	blink
`p5`	dim
`p6`	bold
`p7`	invis
`p8`	protect
`p9`	altcharset

Tabs and Margins

Table 3-17 “Margins and Tabs” lists the capabilities used to control margins and tabs on the terminal.

Table 3-17 Margins and Tabs

Capability	Variable	Description
`cbt=`	`back_tab`	Back tab
`ht=`	`tab`	Tab to next eight space hardware tab stop
`hts=`	`set_tab`	Set a tab in all rows, current column
`it#`	`init_tabs`	Number of spaces between initial tabs
`mgc=`	`clear_margins`	Clear all margins top, bottom,
`smgb=`	`set_bottom_margin`	Set bottom margin at current line
`smgbp=`	`set_bottom_margin_parm`	Set bottom margin at line #1 or #2 from bottom
`smgl=`	`set_left_margin`	Set left margin at current column
`smglp=`	`set_left_ma rgin_parm`	Set left (right) margin at column #1 (#2)
`smgr=`	`set_right_margin`	Set right margin at current column
`smgrp=`	`set_right_m argin_parm`	Set right margin at column #1
`smgt=`	`set_top_margin`	Set top margin at current line
`smgtp=`	`set_top_mar gin_parm`	Set top (bottom) margin at line #1 (#2)
`tbc=`	`clear_all_tabs`	Clear all tab stops

If tabs are expanded by the computer rather than sent to the device, by convention, ht and cbt are not used because the user may not have the tabs correctly set.

If the sequence to set tabs cannot be described adequately with tbc and hts, it can be described with is2 or if.

The it string is normally used by tputs init to determine whether to set the mode for hardware expansion and whether to set the tabs.

Terminal Key Capabilities

Table 3-18 “Terminal Key Capabilities” lists the capabilities used to describe keys on the terminal.

Table 3-18 Terminal Key Capabilities

Capability	Variable	Description
`k_keyname=`	See Table 3-9 “String Capabilities”	See Table 3-9 “String Capabilities”
`km`	`has_meta_key`	Terminal has meta key (shift, sets parity bit)
`lab_function_name=`	See Table 3-9 “String Capabilities”	See Table 3-9 “String Capabilities”
`lf0=`	`lab_f0`	Labels on function key f0 if not f0
`lf1=`	`lab_f1`	Labels on function key f1 if not f1
`lf2=`	`lab_f2`	Labels on function key f2 if not f2
`lf3=`	`lab_f3`	Labels on function key f3 if not f3
`lf4=`	`lab_f4`	Labels on function key f4 if not f4
`lf5=`	`lab_f5`	Labels on function key f5 if not f5
`lf6=`	`lab_f6`	Labels on function key f6 if not f6
`lf7=`	`lab_f7`	Labels on function key f7 if not f7
`lf8=`	`lab_f8`	Labels on function key f8 if not f8
`lf9=`	`lab_f9`	Labels on function key f9 if not f9
`lf10=`	`lab_f10`	Labels on function key f10 if not f10
`pfkey=`	`pkey_key`	Prog funct key #1 to type string #2
`pfloc=`	`pkey_local`	Prog funct key #1 to execute string #2
`pfx=`	`pkey_xmit`	Prog funct key #1 to xmit string #2
`rfi=`	`req_for_input`	Send next input character (for ptys)
`rmkx=`	`meta_off`	Turn off meta mode
`smkx=`	`keypad_xmit`	Put terminal in keypad transmit mode
`smm=`	`meta_on`	Turn on meta mode (8th bit)




	NOTE: Refer back to Table 3-9 “String Capabilities” for a complete list of all the key capabilities.

Key capabilities describe keypads that transmit sequences of characters when keys are pressed. Keypads that work only in local mode cannot be described. The keypad is assumed to always transmit; if the transmit of keys can be turned on or off, this should be specified with smkx and rmkx, respectively.

If the first 11 function keys have labels other than the default f0 through f10, they can be described using lf0 through lf10. If the keypad has a 3 by 3 array of keys that includes the four arrow keys, the other keys can be described as ka1, ka3, kb2, kc1, and kc3 as shown in the diagram below.

`ka1`	[utrif]	ka3
`[ltrif]`	kb2	[rtrif]
`kc1`	[dtrif]	kc3

Miscellaneous Capabilities

Table 3-19 “Miscellaneous Capabilities” lists the capabilities that do not fit into any of the previous categories.

Table 3-19 Miscellaneous Capabilities

Capability	Variable	Description
`civis=`	`cursor_invisible`	Make cursor invisible
`cnorm=`	`cursor_normal`	Make cursor appear normal (undo `cvvis/civis`)
`cvvis=`	`cursor_visible`	Make cursor very visible
`defc=`	`define_char`	Define a character in a character set
`dsl=`	`dis_status_line`	Disable status line
`enacs=`	`ena_acs`	Enable alternate character set
`flash=`	`flash_screen`	Visible bell (may not move cursor)
`ff=`	`form_feed`	Hardcopy terminal page eject
`fsl=`	`from_status_line`	Return from status line
`lh#`	`label_height`	# rows in each label
`lw#`	`label_width`	# columns in each label
`nlab#`	`num_labels`	# of labels on screen (start at 1)
`pln=`	`plab_norm`	Prog label #1 to show string #2
`rbim=`	`stop_bit_image`	Stop printing bit image graphics
`rcsd=`	`stop_char_set_def`	Stop definition of character set
`rep=`	`repeat_char`	Repeat character #1 #2 times
`rmacs=`	`exit_alt_charset_mode`	End alternate character set
`rmln=`	`label_off`	Turn off soft labels
`sbim=`	`start_bit_image`	Start printing bit image graphics
`scs=`	`select_char_set`	Select character set
`scsd=`	`start_char_set_def`	Start definition of character set
`smacs=`	`enter_alt_charset_mode`	Start alternate character set
`smln=`	`label_on`	Turn on soft labels
`tsl=`	`to_status_line`	Go to status line
`use=`	`N/A`	Read capabilities from entry
`wind=`	`set_window`	Current window is lines #1 - #2 cols #3 - #4
`wsl#`	`width_status_line`	# columns in status line (if different from `cols`)

The fsl string must leave the cursor in the same position as it was before tsl. If necessary, this can be done by including sc and rc in thefsl and tsl strings.

The wind string defines a window that all commands affect as part of memory. It takes four arguments: starting lines in memory, ending lines in memory, starting columns in memory, and ending columns in memory.

Capabilities Sorted by Variable Name

The following tables list all of the capabilities by variable name (instead of TERMINFO capability name as was done previously) for ease of reference.

Table 3-20 “Boolean Capabilities” lists the Boolean capabilities, Table 3-21 “Numeric Capabilities” lists the numeric capabilities, and Table 3-22 “String Capabilities” lists the string capabilities.

Boolean Capabilities

Table 3-20 “Boolean Capabilities” lists the Boolean capabilities.

Table 3-20 Boolean Capabilities

Variable	TInfo	TCap	Description
`auto_left_margin`	`bw`	`bw`	`cub1` wraps from column 0 to last column
`auto_right_margin`	`am`	`am`	Terminal has automatic margins
`back_color_erase`	`bce`	`be`	Screen erased with background color
`can_change`	`ccc`	`cc`	Terminal can redefine existing color
`ceol_standout_glitch`	`xhp`	`xs`	Standout not erased by overwriting (hp)
`col_addr_glitch`	`xhpa`	`YA`	Only positive motion for hpa/mhpa capabilities
`cpi_changes_res`	`cpix`	`YF`	Changing character pitch changes resolution
`cr_cancels_micro_mode`	`crxm`	`YB`	Using cr turns off micro mode
`dest_tabs_magic_smso`	`xt`	`xt`	Tabs destructive, magic smso character (Teleray 1061)
`eat_newline_glitch`	`xenl`	`xn`	Newline ignored after 80 columns (Concept)
`erase_overstrike`	`eo`	`eo`	Terminal can erase overstrikes with a blank
`generic_type`	`gn`	`gn`	Generic line type (for example, dialup, switch)
`hard_copy`	`hc`	`hc`	Hardcopy terminal
`hard_cursor`	`chts`	`HC`	Cursor is hard to see
`has_meta_key`	`km`	`km`	Terminal has meta key (shift, sets parity bit)
`has_print_wheel`	`daisy`	`YC`	Printer needs operator to change character set
`has_status_line`	`hs`	`hs`	Terminal has extra status line
`hue_lightness_saturation`	`hls`	`hl`	Terminal uses only HLS color notation (Tektronix)
`insert_null_glitch`	`in`	`in`	Insert mode distinguishes nulls
`lpi_changes_res`	`lpix`	`YG`	Changing line pitch changes resolution
`memory_above`	`da`	`da`	Display may be retained
`amemory_below`	`db`	`db`	Display may be retained below the screen
`move_insert_mode`	`mir`	`mi`	Safe to move in insert mode
`move_standout_mode`	`msgr`	`ms`	Safe to move in standout mode
`needs_xon_xoff`	`nxon`	`nx`	Padding will not work, XON/XOFF required
`no_esc_ctlc`	`xsb`	`xb`	Beehive (f1=escape, f2=ctrl C)
`no_pad_char`	`npc`	`NP`	Pad character does not exist
`non_rev_rmcup`	`nrrmc`	`NR`	`smcup` does not reverse `rmcup`
`over_strike`	`os`	`os`	Terminal overstrikes
`prtr_silent`	`mc5i`	`5i`	Printer will not echo on screen
`row_addr_glitch`	`xvpa`	`YD`	Only positive motion for vpa/mvpa capabilities
`semi_auto_right_margin`	`sam`	`YE`	Printing in last column causes cr
`status_line_esc_ok`	`eslok`	`es`	Escape can be used on the status line
`tilde_glitch`	`hz`	`hz`	Hazeltine: cannot print tilde (~)
`transparent_underline`	`ul`	`ul`	Underline character overstrikes
`xon_xoff`	`xon`	`xo`	Terminal uses XON/XOFF handshaking

Numeric Capabilities

Table 3-21 “Numeric Capabilities” lists the numeric capabilities.

Table 3-21 Numeric Capabilities

Variable	TInfo	TCap	Description
`buffer_capacity`	`bufsz`	`Ya`	Number of bytes buffered before printing
`columns`	`cols`	`co`	Number of columns in a line
`dot_horz_spacing`	`spinh`	`Yc`	Spacing of dots horizontally in dots per inch
`dot_vert_spacing`	`spinv`	`Yb`	Spacing of pins vertically in pins per inch
`init_tabs`	`it`	`it`	Number of spaces between initial tabs
`label_height`	`lh`	`lh`	Number of rows in each label
`label_width`	`lw`	`lw`	Number of columns in each label
`lines`	`lines`	`li`	Number of lines on screen or page
`lines_of_memory`	`lm`	`lm`	Lines of memory if > 0; 0 means unfixed
`magic_cookie_glitch`	`xmc`	`sg`	Number of blank chars left by smso or rmso
`max_colors`	`colors`	`Co`	Maximum number of colors on the screen
`max_micro_address`	`maddr`	`Yd`	Maximum value in micro_..._address
`max_micro_jump`	`mjump`	`Ye`	Maximum value in parm_..._micro
`max_pairs`	`pairs`	`pa`	Maximum number of color pairs on the screen
`micro_col_size`	`mcs`	`Yf`	Character step size when in micro mode
`micro_line_size`	`mls`	`Yg`	Line step size when in micro mode
`no_color_video`	`ncv`	`NC`	Video attributes that cannot be used with colors
`num_labels`	`nlab`	`Nl`	Number of labels on screen (start at 1)
`number_of_pins`	`npins`	`yH`	Number of pins in print-head
`output_res_char`	`orc`	`Yi`	Horz. res. in units per character
`output_res_horz_inch`	`orhi`	`Yk`	Horz. res. in units per inch
`output_res_line`	`orl`	`Yj`	Vert. res. in units per line
`output_res_vert_inch`	`orvi`	`Yl`	Vert. res. in units per inch
`padding_baud_rate`	`pb`	`pb`	Lowest baud rate where cr/nl padding needed
`virtual_terminal`	`vt`	`vt`	Virtual terminal number (CB/UNIX)
`wide_char_size`	`widcs`	`Yn`	Character step size when in double wide mode
`width_status_line`	`wsl`	`ws`	Number of columns in status line

String Capabilities

Table 3-22 “String Capabilities” lists the string capabilities.

Table 3-22 String Capabilities

Variable	TInfo	TCap	Description
`N/A`	`use`	`tc`	Read capabilities from entry
`acs_chars`	`acsc`	`ac`	Graphics character set pairs aAbBcC - defn=vt100
`back_tab`	`cbt`	`bt`	Back tab
`bell`	`bel`	`bl`	Produce audible signal (bell or beep)
`carriage_return`	`cr`	`cr`	Move cursor to left edge of screen
`change_char_pitch`	`cpi`	`ZA`	Change number of characters per inch
`change_line_pitch`	`lpi`	`ZB`	Change number of lines per inch
`change_res_horz`	`chr`	`ZC`	Change horizontal resolution
`change_res_vert`	`cvr`	`ZD`	Change vertical resolution
`change_scroll_region`	`csr`	`cs`	Change to lines #1 through #2 (vt100)
`char_padding`	`rmp`	`rP`	Like `ip`, but when in replace mode
`char_set_names`	`csnm`	`Zy`	List of character set names
`clear_all_tabs`	`tbc`	`ct`	Clear all tab stops
`clear_margins`	`mgc`	`MC`	Clear all margins top and bottom
`clear_screen`	`clear`	`cl`	Clear screen
`clr_bol`	`el1`	`cb`	Clear to beginning of line, inclusive
`clr_eol`	`el`	`ce`	Clear to end of line
`clr_eos`	`ed`	`cd`	Clear to end of display
`column_address`	`hpa`	`ch`	Set cursor column
`command_character`	`cmdch`	`CC`	Terminal settable command character in prototype
`cursor_address`	`cup`	`cm`	Cursor motion to row #1 col #2
`cursor_down`	`cud1`	`do`	Move cursor down one line
`cursor_home`	`home`	`ho`	Home cursor (if no `cup`)
`cursor_invisible`	`civis`	`vi`	Make cursor invisible
`cursor_left`	`cub1`	`le`	Move cursor left one space
`cursor_mem_address`	`mrcup`	`CM`	Memory relative cursor addressing
`cursor_normal`	`cnorm`	`ve`	Make cursor appear normal (undo `cvvis/civis`)
`cursor_right`	`cuf1`	`nd`	Non-destructive space (cursor right)
`cursor_to_ll`	`ll`	`ll`	Last line, first column (if no `cup`)
`cursor_up`	`cuu1`	`up`	Move cursor up
`cursor_visible`	`cvvis`	`vs`	Make cursor very visible
`define_char`	`defc`	`ZE`	Define a character in a character set
`delete_character`	`dch1`	`dc`	Delete character
`delete_line`	`dl1`	`dl`	Delete line
`dis_status_line`	`dsl`	`ds`	Disable status line
`down_half_line`	`hd`	`hd`	Half-line down (forward 1/2 linefeed)
`ena_acs`	`enacs`	`eA`	Enable alternate character set
`enter_alt_charset_mode`	`smacs`	`as`	Start alternate character set
`enter_am_mode`	`smam`	`SA`	Turn on automatic margins
`enter_blink_mode`	`blink`	`mb`	Turn on blinking
`enter_bold_mode`	`bold`	`md`	Turn on bold (extra bright) mode
`enter_ca_mode`	`smcup`	`ti`	String to end programs that use `cup`
`enter_delete_mode`	`smdc`	`dm`	Delete mode (enter)
`enter_dim_mode`	`dim`	`mh`	Turn on half-bright mode
`enter_doublewide_mode`	`swidm`	`ZF`	Enable double wide printing
`enter_draft_quality`	`sdrfq`	`ZG`	Set draft quality print
`enter_insert_mode`	`smir`	`im`	Insert mode (enter)
`enter_italics_mode`	`sitm`	`ZH`	Enable italics
`enter_leftward_mode`	`slm`	`ZI`	Enable leftward carriage motion
`enter_micro_mode`	`smicm`	`ZJ`	Enable micro motion capabilities
`enter_near_letter_quality`	`snlq`	`ZK`	Set near-letter quality
`enter_normal_quality`	`snrmq`	`ZL`	Set normal quality print
`enter_protected_mode`	`prot`	`mp`	Turn on protected mode
`enter_reverse_mode`	`rev`	`mr`	Turn on reverse video mode
`enter_secure_mode`	`invis`	`mk`	Turn on blank mode (characters invisible)
`enter_shadow_mode`	`sshm`	`ZM`	Enable shadow printing
`enter_standout_mode`	`smso`	`so`	Begin stand out mode
`enter_subscript_mode`	`ssubm`	`ZN`	Enable subscript printing
`enter_supercript_mode`	`ssupm`	`ZO`	Enable superscript printing
`enter_underline_mode`	`smul`	`us`	Start underscore mode
`enter_upward_mode`	`sum`	`ZP`	Enable upward carriage motion
`enter_xon_mode`	`smxon`	`SX`	Turn on XON/XOFF handshaking
`erase_chars`	`ech`	`ec`	Erase #1 characters
`exit_alt_charset_mode`	`rmacs`	`ae`	End alternate character set
`exit_am_mode`	`rmam`	`RA`	Turn off automatic margins
`exit_attribute_mode`	`sgr0`	`me`	Turn off all attributes
`exit_ca_mode`	`rmcup`	`te`	String to begin programs that use `cup`
`exit_delete_mode`	`rmdc`	`ed`	End delete mode
`exit_doublewide_mode`	`rwidm`	`ZQ`	Disable double wide printing
`exit_insert_mode`	`rmir`	`ei`	End insert mode
`exit_italics_mode`	`ritm`	`ZR`	Disable italics
`exit_leftward_mode`	`rlm`	`ZS`	Enable rightward (normal) carriage motion
`exit_micro_mode`	`rmicm`	`ZT`	Disable micro motion capabilities
`exit_shadow_mode`	`rshm`	`ZU`	Disable shadow printing
`exit_standout_mode`	`rmso`	`se`	End stand out mode
`exit_subscript_mode`	`wsubm`	`ZV`	Disable subscript printing
`exit_supercript_mode`	`rsupm`	`ZW`	Disable superscript printing
`exit_underline_mode`	`rmul`	`ue`	End underscore mode
`exit_xon_mode`	`rmxon`	`RX`	Turn off XON/XOFF handshaking
`flash_screen`	`flash`	`vb`	Visible bell (may not move cursor)
`form_feed`	`ff`	`ff`	Hardcopy terminal page eject
`from_status_line`	`fsl`	`fs`	Return from status line
`init_1string`	`is1=`	`i1`	Terminal initialization string
`init_2string`	`is2=`	`is`	Terminal initialization string
`init_3string`	`is3=`	`i3`	Terminal initialization string
`init_file`	`if`	`if`	Name of file containing `is`
`init_prog`	`iprog`	`iP`	Pathname of program for initialization
`initialize_color`	`initc`	`Ic`	Initialize the definition of color
`initialize_pair`	`initp`	`Ip`	Initialize color pair
`insert_character`	`ich1`	`ic`	Insert character
`insert_line`	`il1`	`al`	Add new blank line
`insert_padding`	`ip`	`ip`	Insert pad after character inserted
`key_a1`	`ka1`	`K1`	Upper left of keypad
`key_a3`	`ka3`	`K3`	Upper right of keypad
`key_b2`	`kb2`	`K2`	Center of keypad
`key_backspace`	`kbs`	`kb`	Sent by backspace key
`key_beg`	`kbeg`	`@1`	Sent by beginning key
`key_btab`	`kcbt`	`kB`	Sent by BackTab key
`key_c1`	`kc1`	`K4`	Lower left of keypad
`key_c3`	`kc3`	`K5`	Lower right of keypad
`key_cancel`	`kcan`	`@2`	Sent by cancel key
`key_catab`	`ktbc`	`ka`	Sent by clear-all-tabs key
`key_clear`	`kclr`	`kC`	Sent by clear screen or erase key
`key_close`	`kclo`	`@3`	Sent by close key
`key_command`	`kcmd`	`@4`	Sent by command key
`key_copy`	`kcpy`	`@5`	Sent by copy key
`key_create`	`kcreate`	`@6`	Sent by create key
`key_ctab`	`kctab`	`kt`	Sent by clear-tab key
`key_dc`	`kdch1`	`kD`	Sent by delete character key
`key_dl`	`kdl1`	`kL`	Sent by delete line key
`key_down`	`kcud1`	`kd`	Sent by terminal down arrow key
`key_eic`	`krmir`	`kM`	Sent by `rmir` or `smir` in insert mode
`key_end`	`kend`	`@7`	Sent by end key
`key_enter`	`kent`	`@8`	Sent by enter/send key
`key_eol`	`kel`	`kE`	Sent by clear-to-end-of-line key
`key_eos`	`ked`	`kS`	Sent by clear-to-end-of-screen key
`key_exit`	`kext`	`@9`	Sent by exit key
`key_f0`	`kf0`	`k0`	Sent by function key f0
`key_f1`	`kf1`	`k1`	Sent by function key f1
`key_f2`	`kf2`	`k2`	Sent by function key f2
`key_f3`	`kf3`	`k3`	Sent by function key f3
`key_f4`	`kf4`	`k4`	Sent by function key f4
`key_f5`	`kf5`	`k5`	Sent by function key f5
`key_f6`	`kf6`	`k6`	Sent by function key f6
`key_f7`	`kf7`	`k7`	Sent by function key f7
`key_f8`	`kf8`	`k8`	Sent by function key f8
`key_f9`	`kf9`	`k9`	Sent by function key f9
`key_f10`	`kf10`	`k;`	Sent by function key f10
`key_f11`	`kf11`	`F1`	Sent by function key 11
`key_f12`	`kf12`	`F2`	Sent by function key 12
`key_f13`	`kf13`	`F3`	Sent by function key 13
`key_f14`	`kf14`	`F4`	Sent by function key 14
`key_f15`	`kf15`	`F5`	Sent by function key 15
`key_f16`	`kf16`	`F6`	Sent by function key 16
`key_f17`	`kf17`	`F7`	Sent by function key 17
`key_f18`	`kf18`	`F8`	Sent by function key 18
`key_f19`	`kf19`	`F9`	Sent by function key 19
`key_f20`	`kf20`	`FA`	Sent by function key 20
`key_f21`	`kf21`	`FB`	Sent by function key 21
`key_f22`	`kf22`	`FC`	Sent by function key 22
`key_f23`	`kf23`	`FD`	Sent by function key 23
`key_f24`	`kf24`	`FE`	Sent by function key 24
`key_f25`	`kf25`	`FF`	Sent by function key 25
`key_f26`	`kf26`	`FG`	Sent by function key 26
`key_f27`	`kf27`	`FH`	Sent by function key 27
`key_f28`	`kf28`	`FI`	Sent by function key 28
`key_f29`	`kf29`	`FJ`	Sent by function key 29
`key_f30`	`kf30`	`FK`	Sent by function key 30
`key_f31`	`kf31`	`FL`	Sent by function key 31
`key_f32`	`kf32`	`FM`	Sent by function key 32
`key_f33`	`kf33`	`FN`	Sent by function key 33
`key_f34`	`kf34`	`FO`	Sent by function key 34
`key_f35`	`kf35`	`FP`	Sent by function key 35
`key_f36`	`kf36`	`FQ`	Sent by function key 36
`key_f37`	`kf37`	`FR`	Sent by function key 37
`key_f38`	`kf38`	`FS`	Sent by function key 38
`key_f39`	`kf39`	`FT`	Sent by function key 39
`key_f40`	`kf40`	`FU`	Sent by function key 40
`key_f41`	`kf41`	`FV`	Sent by function key 41
`key_f42`	`kf42`	`FW`	Sent by function key 42
`key_f43`	`kf43`	`FX`	Sent by function key 43
`key_f44`	`kf44`	`FY`	Sent by function key 44
`key_f45`	`kf45`	`FZ`	Sent by function key 45
`key_f46`	`kf46`	`Fa`	Sent by function key 46
`key_f47`	`kf47`	`Fb`	Sent by function key 47
`key_f48`	`kf48`	`Fc`	Sent by function key 48
`key_f49`	`kf49`	`Fd`	Sent by function key 49
`key_f50`	`kf50`	`Fe`	Sent by function key 50
`key_f51`	`kf51`	`Ff`	Sent by function key 51
`key_f52`	`kf52`	`Fg`	Sent by function key 52
`key_f53`	`kf53`	`Fh`	Sent by function key 53
`key_f54`	`kf54`	`Fi`	Sent by function key 54
`key_f55`	`kf55`	`Fj`	Sent by function key 55
`key_f56`	`kf56`	`Fk`	Sent by function key 56
`key_f57`	`kf57`	`Fl`	Sent by function key 57
`key_f58`	`kf58`	`Fm`	Sent by function key 58
`key_f59`	`kf59`	`Fn`	Sent by function key 59
`key_f60`	`kf60`	`Fo`	Sent by function key 60
`key_f61`	`kf61`	`Fp`	Sent by function key 61
`key_f62`	`kf62`	`Fq`	Sent by function key 62
`key_f63`	`kf63`	`Fr`	Sent by function key 63
`key_find`	`kfnd`	`@0`	Sent by find key
`key_help`	`khlp`	`%1`	Sent by help key
`key_home`	`khome`	`kh`	Sent by home key
`key_ic`	`kich1`	`kI`	Sent by ins char/enter ins mode key
`key_il`	`kil1`	`kA`	Sent by insert line
`key_left`	`kcub1`	`kl`	Sent by terminal left-arrow key
`key_ll`	`kll`	`kH`	Sent by home-down key (lower left)
`key_mark`	`kmrk`	`%2`	Sent by mark key
`key_message`	`kmsg`	`%3`	Sent by message key
`key_move`	`kmov`	`%4`	Sent by move key
`key_next`	`knxt`	`%5`	Sent by next-object key
`key_npage`	`knp`	`kN`	Sent by next-page key
`key_open`	`kopn`	`%6`	Sent by open key
`key_options`	`kopt`	`%7`	Sent by options key
`key_ppage`	`kpp`	`kP`	Sent by previous-page key
`key_previous`	`kprv`	`%8`	Sent by previous-object key
`key_print`	`kprt`	`%9`	Sent by print or copy key
`key_redo`	`krdo`	`%0`	Sent by redo key
`key_reference`	`kref`	`&1`	Sent by reference key
`key_refresh`	`krfr`	`&2`	Sent by refresh key
`key_replace`	`krpl`	`&3`	Sent by replace key
`key_restart`	`krst`	`&4`	Sent by restart key
`key_resume`	`kres`	`&5`	Sent by resume key
`key_right`	`kcuf1`	`kr`	Sent by terminal right arrow key
`key_save`	`ksav`	`&6`	Sent by save key
`key_sbeg`	`kBEG`	`&9`	Sent by shift-beginning key
`key_scancel`	`kCAN`	`&0`	Sent by shift-cancel key
`key_scommand`	`kCMD`	`*1`	Sent by shift-command key
`key_scopy`	`kCPY`	`*2`	Sent by shift-copy key
`key_screate`	`kCRT`	`*3`	Sent by shift-create key
`key_sdc`	`kDC`	`*4`	Sent by shift-delete-char key
`key_sdl`	`kDL`	`*5`	Sent by shift-delete-line key
`key_select`	`kslt`	`*6`	Sent by select key
`key_send`	`kEND`	`*7`	Sent by shift-end key
`key_seol`	`kEOL`	`*8`	Sent by shift-eol key
`key_sexit`	`kEXT`	`*9`	Sent by shift-exit key
`key_sf`	`kind`	`kF`	Sent by scroll-forward/down key
`key_sfind`	`kFND`	`*0`	Sent by shift-find key
`key_shelp`	`kHLP`	`#1`	Sent by shift-help key
`key_shome`	`kHOM`	`#2`	Sent by shift-home key
`key_sic`	`kIC`	`#3`	Sent by shift-insert-char key
`key_sleft`	`kLFT`	`#4`	Sent by shift-left key
`key_smessage`	`kMSG`	`%a`	Sent by shift-message key
`key_smove`	`kMOV`	`%b`	Sent by shift-move key
`key_snext`	`kNXT`	`%c`	Sent by shift-next key
`key_soptions`	`kOPT`	`%d`	Sent by shift-options key
`key_sprevious`	`kPRV`	`%e`	Sent by shift-prev key
`key_sprint`	`kPRT`	`%f`	Sent by shift-print key
`key_sr`	`kri`	`kR`	Sent by scroll-backward/up key
`key_sredo`	`kRDO`	`%g`	Sent by shift-redo key
`key_sreplace`	`kRPL`	`%h`	Sent by shift-replace key
`key_sright`	`kRIT`	`%i`	Sent by shift-right key
`key_srsume`	`kRES`	`%j`	Sent by shift-resume key
`key_ssave`	`kSAV`	`!1`	Sent by shift-save key
`key_ssuspend`	`kSPD`	`!2`	Sent by shift-suspend key
`key_stab`	`khts`	`kT`	Sent by set-tab key
`key_sundo`	`kUND`	`!3`	Sent by shift-undo key
`key_suspend`	`kspd`	`&7`	Sent by suspend key
`key_undo`	`kund`	`&8`	Sent by undo key
`key_up`	`kcuu1`	`ku`	Sent by terminal up-arrow key
`keypad_local`	`rmkx`	`ke`	Out of keypad transmit mode
`keypad_xmit`	`smkx`	`ks`	Put terminal in keypad transmit mode
`lab_f0`	`lf0`	`l0`	Labels on function key f0 if not f0
`lab_f1`	`lf1`	`l1`	Labels on function key f1 if not f1
`lab_f10`	`lf10`	`la`	Labels on function key f10 if not f10
`lab_f2`	`lf2`	`l2`	Labels on function key f2 if not f2
`lab_f3`	`lf3`	`l3`	Labels on function key f3 if not f3
`lab_f4`	`lf4`	`l4`	Labels on function key f4 if not f4
`lab_f5`	`lf5`	`l5`	Labels on function key f5 if not f5
`lab_f6`	`lf6`	`l6`	Labels on function key f6 if not f6
`lab_f7`	`lf7`	`l7`	Labels on function key f7 if not f7
`lab_f8`	`lf8`	`l8`	Labels on function key f8 if not f8
`lab_f9`	`lf9`	`l9`	Labels on function key f9 if not f9
`label_off`	`rmln`	`LF`	Turn off soft labels
`label_on`	`smln`	`LO`	Turn on soft labels
`meta_off`	`rmm`	`mo`	Turn off meta mode
`meta_on`	`smm`	`mm`	Turn on meta mode (8th bit)
`micro_column_address`	`mhpa`	`ZY`	Like `column_address` for micro adjustment
`micro_down`	`mcud1`	`ZZ`	Like `cursor_down` for micro adjustment
`micro_left`	`mcub1`	`Za`	Like `cursor_left` for micro adjustment
`micro_right`	`mcuf1`	`Zb`	Like `cursor_right` for micro adjustment
`micro_row_address`	`mvpa`	`Zc`	Like `row_address` for micro adjustment
`micro_up`	`mcuu1`	`Zd`	Like `cursor_up` for micro adjustment
`newline`	`nel`	`nw`	Produces newline (behaves like cr followed by lf)
`order_of_pins`	`porder`	`Ze`	Matches software bits to print-head pins
`orig_colors`	`oc`	`oc`	Set all color(pair)s to the original ones
`orig_pair`	`op`	`op`	Set default color pair to the original one
`pad_char`	`pad`	`pc`	Pad character (rather than null)
`parm_dch`	`dch`	`DC`	Delete #1 characters
`parm_delete_line`	`dl`	`DL`	Delete #1 lines
`parm_down_cursor`	`cud`	`DO`	Move cursor down #1 lines
`parm_down_micro`	`mcud`	`Zf`	Like `parm_down_cursor`
`parm_ich`	`ich`	`IC`	Insert #1 blank characters
`parm_index`	`indn`	`SF`	Scroll forward #1 lines
`parm_insert_line`	`il`	`AL`	Add #1 new blank lines
`parm_left_cursor`	`cub`	`LE`	Move cursor left #1 spaces
`parm_left_micro`	`mcub`	`Zg`	Like `parm_left_cursor`
`parm_right_cursor`	`cuf`	`RI`	Move cursor right #1 spaces
`parm_right_micro`	`mcuf`	`Zh`	Like `parm_right_cursor`
`parm_rindex`	`rin`	`SR`	Scroll backward #1 lines
`parm_up_cursor`	`cuu`	`UP`	Move cursor up #1 lines
`parm_up_micro`	`mcuu`	`Zi`	Like `parm_up_cursor`
`pkey_key`	`pfkey`	`pk`	Prog funct key #1 to type string #2
`pkey_local`	`pfloc`	`pl`	Prog funct key #1 to execute string #2
`pkey_xmit`	`pfx`	`px`	Prog funct key #1 to xmit string #2
`plab_norm`	`pln`	`pn`	Prog label #1 to show string #2
`print_screen`	`mc0`	`ps`	Print contents of the screen
`prtr_non`	`mc5p`	`pO`	Turn on the printer for #1 bytes
`prtr_off`	`mc4`	`pf`	Turn off the printer
`prtr_on`	`mc5`	`po`	Turn on the printer
`repeat_char`	`rep`	`rp`	Repeat char #1 #2 times
`req_for_input`	`rfi`	`RF`	Send next input character (for ptys)
`reset_1string`	`rs1`	`r1`	Reset terminal completely to sane modes
`reset_2string`	`rs2`	`r2`	Reset terminal completely to sane modes
`reset_3string`	`rs3`	`r3`	Reset terminal completely to sane modes
`reset_file`	`rf`	`rf`	Name of file containing reset string
`restore_cursor`	`rc`	`rc`	Restore cursor to position of last `sc`
`row_address`	`vpa`	`cv`	Like `hpa` but sets row
`save_cursor`	`sc`	`sc`	Save cursor position
`scroll_forward`	`ind`	`sf`	Scroll text up
`scroll_reverse`	`ri`	`ri`	Scroll text down
`select_char_set`	`scs`	`Zj`	Select character set
`set_attributes`	`sgr`	`sa`	Define the video attributes
`set_background`	`setb`	`Sb`	Set current background color
`set_bottom_margin`	`smgb`	`Zk`	Set bottom margin at current line
`set_bottom_margin_parm`	`smgbp`	`Zl`	Set bottom margin at line #1 or #2 from bottom
`set_color_pair`	`scp`	`sp`	Set current color pair
`set_foreground`	`setf`	`Sf`	Set current foreground color
`set_left_margin`	`smgl`	`ML`	Set left margin at current column
`set_left_margin_parm`	`smglp`	`Zm`	Set left (right) margin at column #1 (#2)
`set_right_margin`	`smgr`	`MR`	Set right margin at current column
`set_right_margin_parm`	`smgrp`	`Zn`	Set right margin at column #1
`set_tab`	`hts`	`st`	Set a tab in all rows, current column
`set_top_margin`	`smgt`	`Zo`	Set top margin at current line
`set_top_margin_parm`	`smgtp`	`Zp`	Set top (bottom) margin at line #1 (#2)
`set_window`	`wind`	`wi`	Current window is lines #1 - #2 cols #3 - #4
`start_bit_image`	`sbim`	`Zq`	Start printing bit image graphics
`start_char_set_def`	`scsd`	`Zr`	Start definition of character set
`stop_bit_image`	`rbim`	`Z`s	Stop printing bit image graphics
`stop_char_set_def`	`rcsd`	`Zt`	Stop definition of character set
`subscript_characters`	`subcs`	`Zu`	List of "subscriptable" characters
`superscript_characters`	`supcs`	`Zv`	List of "superscript-able" characters
`tab`	`ht`	`ta`	Tab to next 8-space hardware tab stop
`these_cause_cr`	`docr`	`Zw`	Printing any of these chars causes cr
`to_status_line`	`tsl`	`ts`	Go to status line
`underline_char`	`uc`	`uc`	Underscore one char and move past it
`up_half_line`	`hu`	`hu`	Half-line up(reverse 1/2 linefeed)
`xoff_character`	`xoffc`	`XF`	XOFF character
`xon_character`	`xonc`	`XN`	XON character
`zero_motion`	`zerom`	`Zx`	No motion for the subsequent character

Creating Device Descriptions

Technical documentation

» Table of Contents

» Index

Special Characters

Names of Capabilities

Boolean Capabilities

Numeric Capabilities

String Capabilities

Configuration Capabilities

Detailed Descriptions

cmdch

da

gn

if, iprog, is1, is2, is3

lm

xenl

os, hc

ascs

Cursor Movement and Scrolling Capabilities

Detailed Descriptions

ind, ri

cufl

csr

cup, cuu

home

ri, ind

mir

smcup, rmcup

xt

Edit Capabilities

Detailed Descriptions

ich1

in

ip

Attribute Capabilities

Handling Color

ncv Variable

Turning Off Attributes

Setting Arbitrary Modes

Tabs and Margins

Terminal Key Capabilities

Miscellaneous Capabilities

Capabilities Sorted by Variable Name

Boolean Capabilities

Numeric Capabilities

String Capabilities