1.Dd January 8, 1995 2.Dt SCREEN 4 3.Os FreeBSD 4.Sh NAME 5.Nm screen 6.Nd pc display interface 7.Sh DESCRIPTION 8 9Access to the 10.Ar virtual consoles 11are obtained through the device files 12ttyv0 - ttyvb in /dev. 13Each of these files correspond to a seperate 14virtual console. 15All virtual console devices can be open at once, but only one is 16active at a time. The active virtual console "owns" the keyboard and 17display screen. 18.Pp 19Output to a virtual console that not currently is on the display is 20saved in a buffer that holds a "screenfull" (normally 25) lines. 21Any output written to 22.Ar /dev/console 23(the original console device) is echoed to /dev/ttyv0. 24.Pp 25To switch between the virtual consoles one uses the sequence 26.Ar ALT+Fn 27, which means hold down ALT and press one of the function keys. The 28virtual console with the same number as the function key is then 29selected as the current virtual console, and given exclusive use of 30the keyboard and display. This switch sequence can be changed via 31the keyboard mapping ioctl call (see keyboard.4) 32.Pp 33 34The console allows entering values that are not physically 35present on the keyboard via a special keysequence. 36To use this facility press and hold down ALT, 37then enter a decimal number from 0-255 via the numerical keypad, then 38release ALT. The entered value is then used as the ASCII value for one 39character. This way it is possible to enter any ASCII value. 40The console driver also includes a history function. It is activatet by 41pressing the scroll-lock key. This holds the display, and enables the cursor 42arrows for scrolling up and down through the last scrolled out lines. 43 44The console understands a subset of the ANSI x3.64 character 45sequences. For compatibility with the old pccons, the PC3 character 46sequences is also supported. 47.Pp 48.Bd -literal 49ANSI Seq Function Termcap entry 50======= ======= ===================================== ============== 51 52CUU E[nA move cursor up n lines up/UP (ku) 53 54CUD E[nB move cursor down n lines do/DO (kd) 55 56CUF E[nC move cursor right n characters nd/RI (kr) 57 58CUB E[nD move cursor left n characters --/LE (kl) 59 60HPA E[n` move cursor to character position n ch 61 62HPR E[na move cursor right n characters -- 63 64VPA E[nd move cursor to line n cv 65 66VPR E[ne move cursor down n lines -- 67 68CPL E[nF move cursor to start of line, -- (@7) 69 n lines up 70 71CNL E[nE move cursor to start of line, nw 72 n lines down 73 74CUP E[y;xH Move cursor to x, y cm 75 76HVP E[y;xf Move cursor to x, y -- 77 78CBT E[nZ Move cursor back n tab stops bt (kB) 79 80IL E[nL Insert n blank lines al/AL 81 82ICH E[n@ Insert n blank characters ic/IC 83 84DL E[nM Delete n lines dl/DL 85 86DCH E[nP Delete n characters dc/DC 87 88ED E[nJ Erase part or all of display: cd 89 n=0 from cursor to end of display, 90 n=1 from begin of display to cursor, 91 n=2 entire display. 92 93EL E[nK Erase part or all of line: ce 94 n=0 from cursor to end of line, 95 n=1 from begin of line to cursor, 96 n=2 entire line. 97 98ECH E[nX Erase n characters ec 99 100SU E[nS Scroll display n lines up (forward) sf/SF 101 102SD E[nT Scroll display n lines down (reverse) sr/SR 103 104 105SGR E[nm Set character attributes: -- 106 n= 0 normal attribute (all off) 107 n= 1 bold (highlight) 108 n= 4 underscore (if supported by HW) 109 n= 5 blink (if supported by HW) 110 n= 7 reverse 111 n=3X set foreground color (see table) 112 n=4X set background color (see table) 113 114 X=0 black X=1 red 115 X=2 green X=3 brown 116 X=4 blue X=5 magenta 117 X=6 cyan X=7 white 118 119 120-- E[=p;dB Set bell pitch (p) and duration (d), -- 121 picth is in units of 840 nS, 122 duration is units of 0,1 S. 123 124-- E[=tC Set cursor type, 1 selects a blinking -- 125 cursor, 0 a steady cursor. 126 127-- E[=nA Set the border color to color n 128 (see table) (if supported by HW) 129 130-- E[=cF set normal foreground color to n -- 131 (see table) 132 133-- E[=cG set normal background color to n -- 134 (see table) 135 136-- E[=cH set reverse foreground color to n -- 137 (see table) 138 139-- E[=cI set reverse background color to n -- 140 (see table) 141 142 n= 0 black n= 8 grey 143 n= 1 blue n= 9 light blue 144 n= 2 green n=10 light green 145 n= 3 cyan n=11 light cyan 146 n= 4 red n=12 light red 147 n= 5 magenta n=13 light magenta 148 n= 6 brown n=14 yellow 149 n= 7 white n=15 light white 150 151note: the first E in the sequences stands for ESC (0x1b) 152 153.Ed 154.Pp 155.Sh AUTHOR 156 S�ren Schmidt (sos@FreeBSD.org) 157