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