|
1
|
1 .TH fbset 8 "July 1998" local "Linux frame buffer utils"
|
|
|
2 .SH NAME
|
|
|
3 fbset \- show and modify frame buffer device settings
|
|
|
4 .SH SYNOPSIS
|
|
|
5 .B fbset
|
|
|
6 .RI [ options ]
|
|
|
7 .RI [ mode ]
|
|
|
8 .SH DESCRIPTION
|
|
|
9 .B This documentation is out of date!!
|
|
|
10 .PP
|
|
|
11 .B fbset
|
|
|
12 is a system utility to show or change the settings of the frame buffer
|
|
|
13 device. The frame buffer device provides a simple and unique interface to
|
|
|
14 access different kinds of graphic displays.
|
|
|
15 .PP
|
|
|
16 Frame buffer devices are accessed via special device nodes located in the
|
|
|
17 /dev directory. The naming scheme for these nodes is always
|
|
|
18 .IR \fBfb < n >,
|
|
|
19 where
|
|
|
20 .I n
|
|
|
21 is the number of the used frame buffer device.
|
|
|
22 .PP
|
|
|
23 .B fbset
|
|
|
24 uses an own video mode database located in /etc/fb.modes. An unlimited
|
|
|
25 number of video modes can be defined in this database. For further
|
|
|
26 information see
|
|
|
27 .BR fb.modes (5).
|
|
|
28 .SH OPTIONS
|
|
|
29 If no option is given,
|
|
|
30 .B fbset
|
|
|
31 will display the current frame buffer settings.
|
|
|
32 .sp
|
|
|
33 General options:
|
|
|
34 .RS
|
|
|
35 .TP
|
|
|
36 .BR \-\-help ",\ " \-h
|
|
|
37 display an usage information
|
|
|
38 .TP
|
|
|
39 .BR \-\-now ",\ " \-n
|
|
|
40 change the video mode immediately. If no frame buffer device is given via
|
|
|
41 .B \-fb
|
|
|
42 , then this option is activated by default
|
|
|
43 .TP
|
|
|
44 .BR \-\-show ",\ " \-s
|
|
|
45 display the video mode settings. This is default if no further option or
|
|
|
46 only a frame buffer device via
|
|
|
47 .B \-fb
|
|
|
48 is given
|
|
|
49 .TP
|
|
|
50 .BR \-\-info ",\ " \-i
|
|
|
51 display all available frame buffer information
|
|
|
52 .TP
|
|
|
53 .BR \-\-verbose ",\ " \-v
|
|
|
54 display information what
|
|
|
55 .B fbset
|
|
|
56 is currently doing
|
|
|
57 .TP
|
|
|
58 .BR \-\-version ",\ " \-V
|
|
|
59 display the version information about
|
|
|
60 .B fbset
|
|
|
61 .TP
|
|
|
62 .BR \-\-xfree86 ",\ " \-x
|
|
|
63 display the timing information as it's needed by XFree86
|
|
|
64 .RE
|
|
|
65 .PP
|
|
|
66 Frame buffer device nodes:
|
|
|
67 .RS
|
|
|
68 .TP
|
|
|
69 .BR \-fb "\ <" \fIdevice >
|
|
|
70 .I device
|
|
|
71 gives the frame buffer device node. If no device via
|
|
|
72 .B \-fb
|
|
|
73 is given,
|
|
|
74 .I /dev/fb0
|
|
|
75 is used
|
|
|
76 .TP
|
|
|
77 .RE
|
|
|
78 .PP
|
|
|
79 Video mode database:
|
|
|
80 .RS
|
|
|
81 .TP
|
|
|
82 .BR \-db "\ <" \fIfile >
|
|
|
83 set an alternative video mode database file (default is
|
|
|
84 .IR /etc/fb.modes ),
|
|
|
85 see also
|
|
|
86 .BR fb.modes (5)
|
|
|
87 .RE
|
|
|
88 .PP
|
|
|
89 Display geometry:
|
|
|
90 .RS
|
|
|
91 .TP
|
|
|
92 .BR \-xres "\ <" \fIvalue >
|
|
|
93 set visible horizontal resolution (in pixels)
|
|
|
94 .TP
|
|
|
95 .BR \-yres "\ <" \fIvalue >
|
|
|
96 set visible vertical resolution (in pixels)
|
|
|
97 .TP
|
|
|
98 .BR \-vxres "\ <" \fIvalue >
|
|
|
99 set virtual horizontal resolution (in pixels)
|
|
|
100 .TP
|
|
|
101 .BR \-vyres "\ <" \fIvalue >
|
|
|
102 set virtual vertical resolution (in pixels)
|
|
|
103 .TP
|
|
|
104 .BR \-depth "\ <" \fIvalue >
|
|
|
105 set display depth (in bits per pixel)
|
|
|
106 .TP
|
|
|
107 .BR \-\-geometry ",\ " \-g "\ ..."
|
|
|
108 set all geometry parameters at once in the order
|
|
|
109 .RI < xres >
|
|
|
110 .RI < yres >
|
|
|
111 .RI < vxres >
|
|
|
112 .RI < vyres >
|
|
|
113 .RI < depth >,
|
|
|
114 e.g.
|
|
|
115 .B \-g
|
|
|
116 .I 640 400 640 400 4
|
|
|
117 .TP
|
|
|
118 .BR \-match "\ \ \ \ \ \ "
|
|
|
119 make the physical resolution match the virtual resolution
|
|
|
120 .RE
|
|
|
121 .PP
|
|
|
122 Display timings:
|
|
|
123 .RS
|
|
|
124 .TP
|
|
|
125 .BR \-pixclock "\ <" \fIvalue >
|
|
|
126 set the length of one pixel (in picoseconds). Note that the frame buffer
|
|
|
127 device may only support some pixel lengths
|
|
|
128 .TP
|
|
|
129 .BR \-left "\ <" \fIvalue >
|
|
|
130 set left margin (in pixels)
|
|
|
131 .TP
|
|
|
132 .BR \-right "\ <" \fIvalue >
|
|
|
133 set right margin (in pixels)
|
|
|
134 .TP
|
|
|
135 .BR \-upper "\ <" \fIvalue >
|
|
|
136 set upper margin (in pixel lines)
|
|
|
137 .TP
|
|
|
138 .BR \-lower "\ <" \fIvalue >
|
|
|
139 set lower margin (in pixel lines)
|
|
|
140 .TP
|
|
|
141 .BR \-hslen "\ <" \fIvalue >
|
|
|
142 set horizontal sync length (in pixels)
|
|
|
143 .TP
|
|
|
144 .BR \-vslen "\ <" \fIvalue >
|
|
|
145 set vertical sync length (in pixel lines)
|
|
|
146 .TP
|
|
|
147 .BR \-\-timings ",\ " \-t "\ ..."
|
|
|
148 set all timing parameters at once in the order
|
|
|
149 .RI < pixclock >
|
|
|
150 .RI < left >
|
|
|
151 .RI < right >
|
|
|
152 .RI < upper >
|
|
|
153 .RI < lower >
|
|
|
154 .RI < hslen >
|
|
|
155 .RI < vslen >,
|
|
|
156 e.g.
|
|
|
157 .B \-g
|
|
|
158 .I 35242 64 96 35 12 112 2
|
|
|
159 .RE
|
|
|
160 .PP
|
|
|
161 Display flags:
|
|
|
162 .RS
|
|
|
163 .TP
|
|
|
164 .IR \fB\-hsync "\ {" low | high }
|
|
|
165 set the horizontal sync polarity
|
|
|
166 .TP
|
|
|
167 .IR \fB\-vsync "\ {" low | high }
|
|
|
168 set the vertical sync polarity
|
|
|
169 .TP
|
|
|
170 .IR \fB\-csync "\ {" low | high }
|
|
|
171 set the composite sync polarity
|
|
|
172 .TP
|
|
|
173 .IR \fB\-extsync "\ {" false | true }
|
|
|
174 enable or disable external resync. If enabled the sync timings are not
|
|
|
175 generated by the frame buffer device and must be provided externally
|
|
|
176 instead. Note that this option may not be supported by every frame buffer
|
|
|
177 device
|
|
|
178 .TP
|
|
|
179 .IR \fB\-bcast "\ {" false | true }
|
|
|
180 enable or disable broadcast modes. If enabled the frame buffer generates the
|
|
|
181 exact timings for several broadcast modes (e.g. PAL or NTSC). Note that
|
|
|
182 this option may not be supported by every frame buffer device
|
|
|
183 .TP
|
|
|
184 .IR \fB\-laced "\ {" false | true }
|
|
|
185 enable or disable interlace. If enabled the display will be split in two
|
|
|
186 frames, each frame contains only even and odd lines respectively. These two
|
|
|
187 frames will be displayed alternating, this way twice the lines can be
|
|
|
188 displayed and the vertical frequency for the monitor stays the same, but the
|
|
|
189 visible vertical frequency gets halved
|
|
|
190 .TP
|
|
|
191 .IR \fB\-double "\ {" false | true }
|
|
|
192 enable or disable doublescan. If enabled every line will be displayed twice
|
|
|
193 and this way the horizontal frequency can easily be doubled, so that the
|
|
|
194 same resolution can be displayed on different monitors, even if the
|
|
|
195 horizontal frequency specification differs. Note that this option may not be
|
|
|
196 supported by every frame buffer device
|
|
|
197 .RE
|
|
|
198 .PP
|
|
|
199 Display positioning:
|
|
|
200 .RS
|
|
|
201 .TP
|
|
|
202 .IR \fB\-move "\ {" left | right | up | down }
|
|
|
203 move the visible part of the display in the specified direction
|
|
|
204 .TP
|
|
|
205 .BR \-step "\ <" \fIvalue >
|
|
|
206 set step size for display positioning (in pixels or pixel lines), if
|
|
|
207 .B \-step
|
|
|
208 is not given display will be moved 8 pixels horizontally or 2 pixel lines
|
|
|
209 vertically
|
|
|
210 .RE
|
|
|
211 .SH EXAMPLE
|
|
|
212 To set the used video mode for
|
|
|
213 .B X
|
|
|
214 insert the following in rc.local:
|
|
|
215 .RS
|
|
|
216 .sp
|
|
|
217 .B fbset
|
|
|
218 -fb
|
|
|
219 .I /dev/fb0
|
|
|
220 vga
|
|
|
221 .sp
|
|
|
222 .RE
|
|
|
223 and make the used frame buffer device known to
|
|
|
224 .BR X :
|
|
|
225 .RS
|
|
|
226 .sp
|
|
|
227 .B export
|
|
|
228 .RI FRAMEBUFFER= /dev/fb0
|
|
|
229 .RE
|
|
|
230 .SH FILES
|
|
|
231 .I /dev/fb*
|
|
|
232 .br
|
|
|
233 .I /etc/fb.modes
|
|
|
234 .SH SEE ALSO
|
|
|
235 .BR fb.modes "(5), " fbdev (4)
|
|
|
236 .SH AUTHORS
|
|
|
237 .TP
|
|
|
238 Geert Uytterhoeven <Geert.Uytterhoeven@cs.kuleuven.ac.be>
|
|
|
239 .TP
|
|
|
240 Roman Zippel <zippel@fh-brandenburg.de>
|
|
|
241 .br
|
|
|
242 man files
|
