xref: /freebsd/usr.sbin/vidcontrol/vidcontrol.1 (revision 02f2e93b60c2b91feac8f45c4c889a5a8e40d8a2)
1.\"
2.\" vidcontrol - a utility for manipulating the syscons video driver
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\"
13.\"     @(#)vidcontrol.1
14.\"	$Id$
15.\"
16.Dd May 22, 1994
17.Dt VIDCONTROL 1
18.Os
19.Sh NAME
20.Nm vidcontrol
21.Nd a utility for manipulating the syscons video driver.
22.Sh SYNOPSIS
23.Nm
24.Ar options ...
25.Sh DESCRIPTION
26The
27.Nm vidcontrol
28command is used to set various options for the syscons video driver,
29such as video mode, colors, cursors, scrnmaps, font and screensaver timeout.
30.Pp
31A new video mode is selected by specifying its name as an argument to
32.Nm vidcontrol .
33For example:
34.Bd -literal
35vidcontrol VGA_80x25
36.Ed
37.Pp
38The modes currently supported:
39.Ar VGA_40x25 ,
40.Ar VGA_80x25 ,
41.Ar VGA_80x50 ,
42.Ar EGA_80x25 ,
43.Ar EGA_80x43 .
44On some laptops the modes
45.Ar VGA_80x30
46and
47.Ar VGA_80x60
48can be used.
49The graphic mode
50.Ar VGA_320x200
51can also be chosen.
52.Pp
53The colors used when displaying text can be changed by specifying the
54foreground color (e.g. "vidcontrol white"), or both a foreground & background
55color (e.g. "vidcontrol yellow blue").
56.Pp
57To see the supported colors on a given platform use "vidcontrol show".
58.Pp
59The following command line options are supported:
60.Bl -tag -width Fl
61.It Fl r Ar foreground Ar background
62Change reverse mode colors to
63.Ar foreground
64and
65.Ar background
66.It Fl b Ar color
67Set border color to
68.Ar color
69(only supported on VGA hardware).
70.It Fl c Ar normal|blink|destructive
71Change the cursor appearance. The cursor is either an inverting block
72(normal) that eventually can "blink". Or it can be like the old hardware cursor
73(destructive). The latter is actually a simulation.
74.It Fl d
75Print out current screen output map.
76.It Fl l Ar scrmap
77Install screen output map file from
78.Ar scrmap
79.It Fl L
80Install default screen output map.
81.It Fl m Ar on|off
82Switches the mousepointer on or off. Used together with the moused
83daemon for textmode cut & paste functionality.
84.It Fl f Ar size Ar file
85Load font
86.Ar file
87for
88.Ar size
89(currently, only 8x8, 8x14 or 8x16).
90The fontfile can be either uuencoded or in raw binary format.
91.It Fl s Ar Number
92Sets the current vty to
93.Ar Number .
94.It Fl t Ar N|off
95Sets the screensaver timeout to
96.Ar N
97seconds, or turns it
98.Ar off .
99.It Fl x
100Use hexadecimal digits for output.
101.El
102.Sh FILES
103.Bl -tag -width /usr/share/syscons/scrnmaps -compact
104.It Pa /usr/share/syscons/fonts
105.It Pa /usr/share/syscons/scrnmaps
106.El
107.Sh SEE ALSO
108.Xr kbdcontrol 1 ,
109.Xr keyboard 4 ,
110.Xr screen 4 ,
111.Xr moused 8
112.Sh AUTHORS
113S�ren Schmidt (sos@FreeBSD.org)
114