1.\" $NetBSD: terminfo.5.in,v 1.7 2010/02/06 07:12:25 wiz Exp $ 2.\" 3.\" Copyright (c) 2009 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to The NetBSD Foundation 7.\" by Roy Marples. 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice, this list of conditions and the following disclaimer. 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28.\" POSSIBILITY OF SUCH DAMAGE. 29.\" 30.Dd February 5, 2009 31.Dt TERMINFO 5 32.Os 33.Sh NAME 34.Nm terminfo 35.Nd terminal capability definition 36.Sh DESCRIPTION 37.Nm 38describes the capabilities of terminals, used by programs such as 39.Xr vi 1 , 40.Xr rogue 6 41and libraries such as 42.Xr curses 3 . 43The 44.Nm 45source described here needs to be compiled with 46.Xr tic 1 47to be of any use. 48.Pp 49Entries in 50.Nm 51consist of a number of comma separated fields. 52White space after each comma is ignored. 53Embedded commas must be escaped by using a backslash. 54Lines beginning with 55.Sq # 56in the first column are treated as comments. 57Blank lines are ignored. 58.Pp 59The header line must begin in column one and end with a comma. 60Inside the header line are terminal name and aliases, 61separated by vertical bars, the last one being the long 62description of the terminal. 63.Pp 64Capability lines then follow, starting on column two and ending with a comma. 65Each capability is listed by its name, followed by its value if applicable. 66Booleans have no values, numeric values are prefixed by 67.Sq # 68and strings are prefixed by 69.Sq = . 70Numbers can range from 0 to 32767 and string values can be up to 1000 71characters long. 72This implementation supports strings upto 32767 characters long, including the 73.Dv NUL 74terminator. 75.Pp 76Some escapes are available for strings - both 77.Sy \eE 78and 79.Sy \ee 80map to the 81.Dv ESC 82character, 83.Sy ^X 84maps to a control-X for any appropriate X, and the sequences 85.Sy \en , 86.Sy \er , 87.Sy \et , 88.Sy \eb 89and 90.Sy \ef 91map to linefeed, return, tab, backspace and formfeed respectively. 92Any character can be escaped in octal, such as 93.Sy \e072 . 94If you need to encode a 95.Dv NUL 96character, it should be escaped as 97.Sy \e200 . 98.Pp 99A delay in milliseconds may appear anywhere in a string capability, 100prefixed with a dollar sign and enclosed by angled brackets, such as 101.Sy $\*[Lt]5\*[Gt] . 102.Ss String Parameters 103String capabilities sometimes require parameters. 104Normally this just involves replacing the parameter with a supplied 105variable; however, there are cases where the variable needs to be manipulated 106or used in conditional expressions. 107A stack is also provided for simple pop and push operations. 108.Pp 109The below % encodings have the following meanings: 110.Bl -tag -width %P[a-z] 111.It Sy %% 112outputs % 113.It Sy %[[:]flags][width[.precision]][doxXs] 114flags are 115.Dq [-+#] . 116Prefix with 117.Sq \&: 118to avoid interpreting 119.Dq %- 120as an operator. 121.It Sy %c 122pop a parameter and print the character representation of it. 123.It Sy %s 124pop a parameter and print the string representation of it. 125.It Sy %p[1-9] 126push the parameter [1-9]. 127.It Sy %P[a-z] 128pop a parameter and push it to dynamic variable [a-z]. 129.It Sy %g[a-z] 130push the dynamic variable [a-z]. 131.It Sy %P[A-Z] 132pop a parameter and push it to static variable [a-z]. 133.It Sy %g[A-Z] 134push the dynamic variable [A-Z]. 135.Pp 136Static variables persist over 137.Fn tparm 138whereas dynamic variables do not. 139.It Sy %'c' 140char constant c. 141.It Sy %{nn} 142integer constant nn. 143.It Sy %l 144push the string length of the previously popped parameter. 145.It Sy %+ Sy %- Sy %* Sy %/ Sy %m 146arithmetic: pop two parameters and push the result. 147.It Sy %& Sy %| Sy %^ 148bit operations: pop two parameters and push the result. 149.It Sy %! Sy %~ 150unary operations: pop two parameters and push the result. 151.It Sy %i 152add 1 to parameters 1 and 2. 153.It Sy %? Va expr Sy %t Ic then Sy %e Ic else Sy %; 154If expr equates to zero then control passes to the optional else part. 155.El 156.Ss Boolean Capabilities 157.Bl -column "enter_near_quality_letter" "setcolor" "TC" 158.It Sy "Long name" Ta Sy "Code" Ta Sy "TC" 159@BOOLCAPS@ 160.El 161.Ss Numeric Capabilities 162.Bl -column "enter_near_quality_letter" "setcolor" "TC" 163.It Sy "Long name" Ta Sy "Code" Ta Sy "TC" 164@NUMCAPS@ 165.El 166.Ss String Capabilities 167.Bl -column "enter_near_quality_letter" "setcolor" "TC" 168.It Sy "Long name" Ta Sy "Code" Ta Sy "TC" 169@STRCAPS@ 170.El 171.Ss A Sample Entry 172.Bd -literal 173vt100\||dec vt100 (w/advanced video), 174am, xenl, msgr, mc5i, xon, 175cols#80, it#8, lines#24, vt#3, 176acsc=``aaffggjjkkllmmnnooppqqrrssttuuvvwwxxyyzz{{||}}~~, bel=^G, 177cr=^M, csr=\eE[%i%p1%d;%p2%dr, tbc=\eE[3g, clear=\eE[H\eE[J$\*[Lt]50\*[Gt], 178el1=\eE[1K$\*[Lt]3\*[Gt], el=\eE[K$\*[Lt]3\*[Gt], ed=\eE[J$\*[Lt]50\*[Gt], 179cup=\eE[%i%p1%d;%p2%dH$\*[Lt]5\*[Gt], cud1=^J, home=\eE[H, cub1=^H, 180cuf1=\eE[C$\*[Lt]2\*[Gt], cuu1=\eE[A$\*[Lt]2\*[Gt], enacs=\eE(B\eE)0, smacs=^N, 181smam=\eE[?7h, blink=\eE[5m$\*[Lt]2\*[Gt], bold=\eE[1m$\*[Lt]2\*[Gt], rev=\eE[7m$\*[Lt]2\*[Gt], 182smso=\eE[7m$\*[Lt]2\*[Gt], smul=\eE[4m$\*[Lt]2\*[Gt], rmacs=^O, rmam=\eE[?7l, 183sgr0=\eE[m017$\*[Lt]2\*[Gt], rmso=\eE[m$\*[Lt]2\*[Gt], rmul=\eE[m$\*[Lt]2\*[Gt], ka1=\eEOq, 184ka3=\eEOs, kb2=\eEOr, kbs=^H, kc1=\eEOp, kc3=\eEOn, kcud1=\eEOB, 185kent=\eEOM, kf0=\eEOy, kf1=\eEOP, kf2=\eEOQ, kf3=\eEOR, kf4=\eEOS, 186kf5=\eEOt, kf6=\eEOu, kf7=\eEOv, kf8=\eEOl, kf9=\eEOw, kf10=\eEOx, 187kcub1=\eEOD, kcuf1=\eEOC, kcuu1=\eEOA, rmkx=\eE[?1l\eE\*[Gt], 188smkx=\eE[?1h\eE=, lf1=pf1, lf2=pf2, lf3=pf3, lf4=pf4, 189cud=\eE[%p1%dB, cub=\eE[%p1%dD, cuf=\eE[%p1%dC, cuu=\eE[%p1%dA, 190mc0=\eE[0i, mc4=\eE[4i, mc5=\eE[5i, 191rs2=\eE\*[Gt]\eE[?3l\eE[?4l\eE[?5l\eE[?7h\eE[?8h, rc=\eE8, sc=\eE7, 192ind=^J, ri=\eEM$\*[Lt]5\*[Gt], 193sgr=\eE[0%?%p1%p6%|%t;1%;%?%p2%t;4%;%?%p1%p3%|%t;7%;%?%p4%t;5%;m%?%p9%t016%e017%;$\*[Lt]2\*[Gt], 194hts=\eEH, ht=^I, 195.Ed 196.Ss Fetching Compiled Descriptions 197If the environment variable 198.Ev TERMINFO 199is available, 200.Pa .db 201is appended to it and only this database is used. 202Otherwise 203.Nm 204will first look for 205.Pa $HOME/.terminfo.db , 206followed by 207.Pa /usr/share/misc/terminfo.db , 208and 209.Pa /rescue/terminfo.db . 210.Sh FILES 211.Bl -tag -width /usr/share/misc/terminfo.db -compact 212.It Pa $HOME/.terminfo.db 213Database of terminal descriptions for personal use. 214.It Pa /rescue/terminfo.db 215Small database of terminal descriptions for use when rescuing the system. 216.It Pa /usr/share/misc/terminfo 217File containing terminal descriptions. 218.It Pa /usr/share/misc/terminfo.db 219Database of terminal descriptions. 220.El 221.Sh SEE ALSO 222.Xr infocmp 1 , 223.Xr tic 1 , 224.Xr tput 1 , 225.Xr curses 3 226.Sh STANDARDS 227.Nm 228complies with the 229.St -xcurses4.2 230standard. 231.Pp 232Extensions to the standard are noted in 233.Xr tic 1 . 234.Sh AUTHORS 235.An Roy Marples Aq roy@NetBSD.org 236