This commit was generated by cvs2svn to track changes on a CVS vendor
[unix-history] / usr.sbin / vidcontrol / vidcontrol.1
CommitLineData
7d9ffb37
SS
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.TH vidcontrol 1 "May 22, 1994" "" "FreeBSD"
16
17.SH NAME
18vidcontrol - a utility for manipulating the syscons video driver.
19.SH SYNOPSIS
20.na
21.B vidcontrol
22.RB [options]
23.SH DESCRIPTION
24The
25.B vidcontrol
26command is used to set various options for the syscons video driver,
27such as video mode, colors, cursor, scrnmaps, font,
28screensaver type and timeout.
29
30A new video mode is selected by specifying its name as an argument to
31.B vidcontrol
32eg. "
33.B vidcontrol 80x25
34".
35
36The modes currently supported: 80x25 and 80x50 text.
37
38The colors used when displaying text can be changed by specifying the
39foreground color (eg. "
40.B vidcontrol white
41"), or both a foreground & background
42color (eg. "
43.B vidcontrol yellow blue
44").
45
46To see the supported colors on a given platform use "
47.B vidcontrol show
48".
49
50.SH OPTIONS
51.TP
52The following command line options are supported.
53.TP
54.BI "\-r\ " foreground\ background
55Change reverse mode colors to
56.B foreground
57and
58.B background
59.
60.TP
61.BI "\-b\ " color
62Set border color to
63.B color
64(only supported on VGA hardware):
65.TP
66.BI "\-c\ " start.end
67Change the cursor apperance. The cursor is changed to a shape that starts
68on scanline
69.B start
70and ends on scanline
71.B end
72.
73.TP
74.BI "\-l\ " scrmap
75Install screen output map file from
76.I scrmap
77.TP
97fb0b80
SS
78.BI "\-L\ "
79Install default screen output map.
80.TP
7d9ffb37
SS
81.BI "\-f\ " size\ file
82Load font
83.I file
84for
85.I size
86(currently, only 8x8, 8x14 or 8x16).
97fb0b80 87The fontfile can be either uuencoded or in raw binary format.
7d9ffb37
SS
88.TP
89.BI "\-t\ " N|off
90Sets the screensaver timeout to
91.I N
92seconds, or turns it
93.I off
94.TP
95.BI "\-s\ " NAME|help
96Sets the screensaver appearance to
97.I NAME .
98Use \-s help to print a list of the available screen savers.
99.PP
100.SH FILES
101/usr/share/syscons/fonts
102/usr/share/syscons/scrnmaps
103.SH BUGS
104Report when found.
105.SH "SEE ALSO"
e083f390 106.BR kbdcontrol(1) ,
7d9ffb37
SS
107.BR keyboard (4) ,
108.BR screen (4) ,
109.BR /sys/i386/conf/SYSCONS
110.SH AUTHORS
111