File: fbset.8

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