View | Details | Raw Unified | Return to bug 38815
Collapse All | Expand All

(-)syscons.4.fixed (-41 / +40 lines)
Lines 87-99 Link Here
87
.Xr getty 8
87
.Xr getty 8
88
will recognize them to be active and run
88
will recognize them to be active and run
89
.Xr login 1
89
.Xr login 1
90
to let the user to login to the system.
90
to let the user log into the system.
91
By default, only the first eight virtual terminals are activated in
91
By default, only the first eight virtual terminals are activated in
92
.Pa /etc/ttys .
92
.Pa /etc/ttys .
93
.Pp
93
.Pp
94
You press the
94
You press the
95
.Dv Alt
95
.Dv Alt
96
key and a switch key to switch between
96
key and switch keys to switch between
97
virtual terminals.
97
virtual terminals.
98
The following table summarizes the correspondence between the switch
98
The following table summarizes the correspondence between the switch
99
key and the virtual terminal.
99
key and the virtual terminal.
Lines 111-117 Link Here
111
key on the AT Enhanced keyboard) to cycle available virtual terminals.
111
key on the AT Enhanced keyboard) to cycle available virtual terminals.
112
.Pp
112
.Pp
113
The default number of available virtual terminals is 16.
113
The default number of available virtual terminals is 16.
114
This can be changed by the kernel configuration option
114
This can be changed with the kernel configuration option
115
.Dv MAXCONS
115
.Dv MAXCONS
116
(see below).
116
(see below).
117
.Pp
117
.Pp
Lines 151-160 Link Here
151
.Pa /usr/share/syscons/fonts .
151
.Pa /usr/share/syscons/fonts .
152
.Pp
152
.Pp
153
The font comes in various sizes: 8x8, 8x14 and 8x16.
153
The font comes in various sizes: 8x8, 8x14 and 8x16.
154
The 8x16 font is typically used for the VGA card in the 80-column-
154
The 8x16 font is typically used for the VGA card in the 80-column-by-25-line mode.
155
by-25-line mode.
155
Other video modes may require different font sizes.
156
Other video modes may require different size of font.
156
It is better to always load all three sizes of the same font.
157
It is better to always load these three sizes of the same font.
158
.Pp
157
.Pp
159
You may set
158
You may set
160
.Ar font8x8 ,
159
.Ar font8x8 ,
Lines 162-204 Link Here
162
and
161
and
163
.Ar font8x16
162
.Ar font8x16
164
variables in
163
variables in
165
.Pa /etc/rc.conf.local
164
.Pa /etc/rc.conf
166
to the desired font files so that they will be automatically loaded
165
to the desired font files so that they will be automatically loaded
167
when the system starts up.
166
when the system starts up.
168
.Pp
167
.Pp
169
Optionally you can make a particular font file as the default font.
168
Optionally you can specify a particular font file as the default.
170
See the
169
See the
171
.Dv SC_DFLT_FONT
170
.Dv SC_DFLT_FONT
172
option below.
171
option below.
173
.Ss Screen Map
172
.Ss Screen Map
174
If your video card does not support software font, you may still be able
173
If your video card does not support software fonts, you may still be able
175
to have similar effect by re-mapping font hard-wired in the video card.
174
to achieve a similar effect by re-mapping the font built into your video card.
176
Use
175
Use
177
.Xr vidcontrol 1
176
.Xr vidcontrol 1
178
to load a screen map file which defines mapping between character codes.
177
to load a screen map file which defines the mapping between character codes.
179
.Ss Mouse Support and Copy-and-Paste
178
.Ss Mouse Support and Copy-and-Paste
180
You can use your mouse to copy text on the screen and paste it as if
179
You can use your mouse to copy text on the screen and paste it as if
181
it is typed by hand.
180
it was typed by hand.
182
You must be running the mouse daemon
181
You must be running the mouse daemon
183
.Xr moused 8
182
.Xr moused 8
184
and enable the mouse cursor in the virtual terminal via
183
and enable the mouse cursor in the virtual terminal via
185
.Xr vidcontrol 1 .
184
.Xr vidcontrol 1 .
186
.Pp
185
.Pp
187
Pressing the mouse button 1 (usually the left button) will start selection.
186
Pressing mouse button 1 (usually the left button) will start selection.
188
Releasing the button 1 will end the selection process.
187
Releasing button 1 will end the selection process.
189
The selected text will be marked by inverting foreground and
188
The selected text will be marked by inverting foreground and
190
background colors.
189
background colors.
191
You can press the button 3 (usually the right button) to extend
190
You can press button 3 (usually the right button) to extend
192
the selected region.
191
the selected region.
193
The selected text is placed in the copy buffer and can be pasted
192
The selected text is placed in the copy buffer and can be pasted
194
at the cursor position by your pressing the button 2 (usually the
193
at the cursor position by pressing button 2 (usually the
195
middle button) as many times as you like.
194
middle button) as many times as you like.
196
.Pp
195
.Pp
197
If your mouse has only two buttons, you may want to use the
196
If your mouse has only two buttons, you may want to use the
198
.Dv SC_TWOBUTTON_MOUSE
197
.Dv SC_TWOBUTTON_MOUSE
199
option below to make the right button to paste the text.
198
option below to make the right button to paste the text.
200
Alternatively you can make the mouse daemon
199
Alternatively you can make the mouse daemon
201
to emulate the middle button.
200
emulate the middle button.
202
See the man page for
201
See the man page for
203
.Xr moused 8
202
.Xr moused 8
204
for more details.
203
for more details.
Lines 206-238 Link Here
206
The
205
The
207
.Nm
206
.Nm
208
driver allows the user to browse the output which has ``scrolled off''
207
driver allows the user to browse the output which has ``scrolled off''
209
from the top of the screen.
208
the top of the screen.
210
.Pp
209
.Pp
211
Press the ``slock'' key (usually
210
Press the ``slock'' key (called
212
.Dv ScrllLock
211
.Dv ScrllLock
213
and/or
212
.Dv scroll lock
213
or
214
.Dv Pause
214
.Dv Pause
215
keys on many AT Enhanced keyboards) and the terminal is
215
on many keyboards) and the terminal goes
216
in the ``back scrolling'' mode.
216
into ``scrollback'' mode.
217
It is indicated by the
217
It is indicated by the
218
.Dv Scroll Lock
218
.Dv Scroll Lock
219
LED.
219
LED.
220
Use arrow keys,
220
Use the arrow keys, the
221
.Dv Page Up/Down
221
.Dv Page Up/Down
222
keys and
222
keys and the
223
.Dv Home/End
223
.Dv Home/End
224
keys to scroll buffered terminal output.
224
keys to scroll through this buffer.
225
Press the ``slock'' key again to get back to the normal terminal mode.
225
Press the ``slock'' key again to get back to the normal terminal mode.
226
.Pp
226
.Pp
227
The size of the back-scroll buffer can be set by the
227
The size of the scrollback buffer can be set by the
228
.Dv SC_HISTORY_SIZE
228
.Dv SC_HISTORY_SIZE
229
option below.
229
option described below.
230
.Ss Screen Saver
230
.Ss Screen Saver
231
The
231
The
232
.Nm
232
.Nm
233
driver can be made to put up the screen saver if the current
233
driver can be made to put up the screen saver if the current
234
virtual terminal is idle, that is, the user is not typing
234
virtual terminal is idle, that is, the user is not typing
235
on the keyboard nor moving mouse.
235
on the keyboard nor moving the mouse.
236
See
236
See
237
.Xr splash 4
237
.Xr splash 4
238
and
238
and
Lines 251-258 Link Here
251
.It Dv SC_ALT_MOUSE_IMAGE
251
.It Dv SC_ALT_MOUSE_IMAGE
252
This option selects the alternative way of displaying the mouse cursor
252
This option selects the alternative way of displaying the mouse cursor
253
in the virtual terminal.
253
in the virtual terminal.
254
It may be vastly costly for some video cards to draw the arrow-shaped
254
It may be expensive for some video cards to draw the arrow-shaped
255
cursor and you may want to try this option.
255
cursor, and you may want to try this option.
256
However, the appearance of the alternative mouse cursor may not be
256
However, the appearance of the alternative mouse cursor may not be
257
very appealing.
257
very appealing.
258
Note that if you use the
258
Note that if you use the
Lines 260-271 Link Here
260
option then you must also use this option if you wish to be able to use
260
option then you must also use this option if you wish to be able to use
261
the mouse.
261
the mouse.
262
.It Dv SC_DISABLE_DDBKEY
262
.It Dv SC_DISABLE_DDBKEY
263
This option disables the ``debug'' key (by default, it is
263
This option disables the ``debug'' key combination (by default, it is
264
.Dv Alt-Esc ,
264
.Dv Alt-Esc ,
265
or
265
or
266
.Dv Ctl-PrintScreen ) .
266
.Dv Ctl-PrintScreen ) .
267
It will prevent the user from
267
It will prevent users from
268
entering the kernel debugger DDB by pressing the key combination.
268
entering the kernel debugger (DDB) by pressing the key combination.
269
DDB will still be invoked when the kernel panics or hits a break point
269
DDB will still be invoked when the kernel panics or hits a break point
270
if it is included in the kernel.
270
if it is included in the kernel.
271
.It Dv SC_DISABLE_REBOOT
271
.It Dv SC_DISABLE_REBOOT
Lines 281-287 Link Here
281
Unless the
281
Unless the
282
.Dv SC_ALT_MOUSE_IMAGE
282
.Dv SC_ALT_MOUSE_IMAGE
283
option above is specified, the
283
option above is specified, the
284
The
285
.Nm
284
.Nm
286
driver reserves four consecutive character codes in order to display the
285
driver reserves four consecutive character codes in order to display the
287
mouse cursor in the virtual terminals in some systems.
286
mouse cursor in the virtual terminals in some systems.
Lines 321-328 Link Here
321
16-line, 14-line and 8-line font data will be compiled in.
320
16-line, 14-line and 8-line font data will be compiled in.
322
Without this option, the
321
Without this option, the
323
.Nm
322
.Nm
324
driver will use whatever font already loaded in the video card,
323
driver will use whatever font is already loaded in the video card,
325
unless you explicitly load software font at startup.
324
unless you explicitly load a software font at startup.
326
See
325
See
327
.Sx EXAMPLES
326
.Sx EXAMPLES
328
below.
327
below.
Lines 338-344 Link Here
338
.It Dv SC_NO_FONT_LOADING
337
.It Dv SC_NO_FONT_LOADING
339
The
338
The
340
.Nm
339
.Nm
341
driver can load software font on some video cards.
340
driver can load software fontf on some video cards.
342
This option removes this feature.
341
This option removes this feature.
343
Note that if you still wish to use
342
Note that if you still wish to use
344
the mouse with this option then you must also use the
343
the mouse with this option then you must also use the
Lines 390-396 Link Here
390
.\"This option suppresses the bell, whether audible or visual,
389
.\"This option suppresses the bell, whether audible or visual,
391
.\"if it is rung in a background virtual terminal.
390
.\"if it is rung in a background virtual terminal.
392
.It 0x0080 (VESA800X600)
391
.It 0x0080 (VESA800X600)
393
This option puts the video card in the VESA 800x600 dots, 16 color
392
This option puts the video card in the VESA 800x600 pixel, 16 color
394
mode.
393
mode.
395
It may be useful for laptop computers for which the 800x600 mode
394
It may be useful for laptop computers for which the 800x600 mode
396
is otherwise unsupported by the X server.
395
is otherwise unsupported by the X server.
Lines 473-480 Link Here
473
.Pp
472
.Pp
474
.\".Sh DIAGNOSTICS
473
.\".Sh DIAGNOSTICS
475
.Sh CAVEATS
474
.Sh CAVEATS
476
Amount of data that is possible to insert from the cut buffer is limited
475
The amount of data that is possible to insert from the cut buffer is limited
477
by the
476
by
478
.Brq Dv MAX_INPUT ,
477
.Brq Dv MAX_INPUT ,
479
a system limit on the number of bytes that may be stored in the terminal
478
a system limit on the number of bytes that may be stored in the terminal
480
input queue - usually 1024 bytes
479
input queue - usually 1024 bytes

Return to bug 38815