2 .\" $FreeBSD: src/share/man/man4/screen.4,v 1.14.2.9 2001/08/17 13:08:39 ru Exp $
3 .\" $DragonFly: src/share/man/man4/screen.4,v 1.2 2003/06/17 04:36:59 dillon Exp $
10 .Nd pc display interface
14 are obtained through the device files
18 Each of these files correspond to a separate
20 All virtual console devices can be open at once, but only one is
22 The active virtual console "owns" the keyboard and
25 Output to a virtual console that not currently is on the display is
26 saved in a buffer that holds a "screenfull" (normally 25) lines.
29 (the original console device) is echoed to
32 To switch between the virtual consoles one uses the sequence
34 which means hold down ALT and press one of the function keys.
36 virtual console with the same number as the function key is then
37 selected as the current virtual console, and given exclusive use of
38 the keyboard and display.
39 This switch sequence can be changed via
40 the keyboard mapping ioctl call (see
43 The console allows entering values that are not physically
44 present on the keyboard via a special keysequence.
45 To use this facility press and hold down ALT,
46 then enter a decimal number from 0-255 via the numerical keypad, then
48 The entered value is then used as the ASCII value for one
50 This way it is possible to enter any ASCII value.
51 The console driver also includes a history function.
53 pressing the scroll-lock key.
54 This holds the display, and enables the cursor
55 arrows for scrolling up and down through the last scrolled out lines.
57 The console understands a subset of the ANSI x3.64 character
59 For compatibility with the old pccons, the PC3 character
60 sequences is also supported.
63 ANSI Seq Function Termcap entry
64 ======= ======= ===================================== ==============
66 -- E7 Save cursor position sc
68 -- E8 Restore saved cursor position rc
72 -- EM move cursor up 1 line, --
75 CUU E[nA move cursor up n lines up/UP (ku)
77 CUD E[nB move cursor down n lines do/DO (kd)
79 CUF E[nC move cursor right n characters nd/RI (kr)
81 CUB E[nD move cursor left n characters --/LE (kl)
83 HPA E[n` move cursor to character position n ch
85 HPR E[na move cursor right n characters --
87 VPA E[nd move cursor to line n cv
89 VPR E[ne move cursor down n lines --
91 CPL E[nF move cursor to start of line, -- (@7)
94 CNL E[nE move cursor to start of line, nw
97 CUP E[y;xH Move cursor to x, y cm
99 HVP E[y;xf Move cursor to x, y --
101 CBT E[nZ Move cursor back n tab stops bt (kB)
103 IL E[nL Insert n blank lines al/AL
105 ICH E[n@ Insert n blank characters ic/IC
107 DL E[nM Delete n lines dl/DL
109 DCH E[nP Delete n characters dc/DC
111 ED E[nJ Erase part or all of display: cd
112 n=0 from cursor to end of display,
113 n=1 from begin of display to cursor,
116 EL E[nK Erase part or all of line: ce
117 n=0 from cursor to end of line,
118 n=1 from begin of line to cursor,
121 ECH E[nX Erase n characters ec
123 SU E[nS Scroll display n lines up (forward) sf/SF
125 SD E[nT Scroll display n lines down (reverse) sr/SR
128 SGR E[nm Set character attributes: --
129 n= 0 normal attribute (all off)
130 n= 1 bold (highlight)
131 n= 4 underscore (if supported by HW)
132 n= 5 blink (if supported by HW)
135 n= 24 remove underscore
138 n= 3X set ANSI foreground color
140 n= 4X set ANSI background color
146 X=6 cyan X=7 light grey
147 X=9 reset to the normal color
149 -- E[s Save cursor position sc
151 -- E[u Restore saved cursor position rc
153 -- E[x Reset normal colors and attributes --
154 to their default values
156 -- E[nz Switch to virtual console n --
158 -- E[1;nx Set normal ANSI background color --
161 -- E[2;nx Set normal ANSI foreground color --
164 -- E[3;nx Set normal video attribute directly --
165 to n (n from 0 to 255)
167 -- E[5;nx Set normal ANSI reverse background --
168 color to n (see table)
170 -- E[6;nx Set normal ANSI reverse foreground --
171 color to n (see table)
173 n= 0 black n= 8 dark grey
174 n= 1 red n= 9 light red
175 n= 2 green n=10 light green
176 n= 3 brown n=11 yellow
177 n= 4 blue n=12 light blue
178 n= 5 magenta n=13 light magenta
179 n= 6 cyan n=14 light cyan
180 n= 7 light grey n=15 white
182 -- E[7;nx Set normal reverse video attribute --
183 directly to n (n from 0 to 255)
185 -- E[=p;dB Set bell pitch (p) and duration (d), --
186 pitch is in units of 840 nS,
187 duration is units of 0,1 S.
189 -- E[=tC Set cursor type (see table) --
191 t=0 normal non-blinking
193 t=2 custom non-blinking
196 -- E[=s;eC Set custom cursor shape, where --
197 s is the starting and e is the ending
198 scanlines of the cursor.
200 -- E[=nA Set the border color to n --
201 (see table) (if supported by HW)
203 -- E[=nF Set normal foreground color to n --
206 -- E[=nG Set normal background color to n --
209 -- E[=nH Set normal reverse foreground color --
212 -- E[=nI Set normal reverse background color --
215 n= 0 black n= 8 dark grey
216 n= 1 blue n= 9 light blue
217 n= 2 green n=10 light green
218 n= 3 cyan n=11 light cyan
219 n= 4 red n=12 light red
220 n= 5 magenta n=13 light magenta
221 n= 6 brown n=14 yellow
222 n= 7 light grey n=15 white
224 note: the first E in the sequences stands for ESC (0x1b)
227 .An S\(/oren Schmidt Aq sos@FreeBSD.org