v4l-conf(1x)

v4l-conf1x

Configure a video4linux driver

Usage

v4l-conf [options]

Overview

v4l-conf is a small helper tool. It figures out the video mode and framebuffer base address of the graphics board and configures a video4linux driver like bttv. This is needed for drivers which can DMA the video over PCI directly to the into the video memory.

Usually it is not required to use v4l-conf manually, xawtv(1) and fbtv(1) run it automatically at startup. It might be useful for trouble-shooting. v4l-conf must be installed suid-root.

v4l-conf knows tree ways to get the informations:

*

Query the X-Server using the XF86 DGA extention. This is the default if the DISPLAY environment variable is set.

*

Query the framebuffer driver. This is the default if DISPLAY is not set.

*

Query the console driver. This is used on mklinux only.

Options

-h

Print a short description of all command line options.

-q

Be quiet.

-d dpy

Use the X11 display dpy to get the parameters.

-f

Use the framebuffer driver to get the parameters.

-c device

Set the video4linux device.

-b n

enforce n bpp color depth. Works for switching between 15/16 and 24/32 bpp.

-s n

Shift the video display by n bytes.

-a adr

Set framebuffer address to adr. The value should be specified in hex. This option is allowd for root only. You can't overwrite the autodetected value, this switch is only useful if autodetect does'nt work because the X-Server lacks DGA support. You can put this into /etc/conf.modules, as "post-install bttv ..." for example.

Bugs

Hope I hav'nt any security flaws in there. If you find one, drop me a note. Mails with patches are prefeared :-)

Author

Gerd Knorr <[email protected]>

From xawtv 3.06-3 in Debian 2.2 (Potato). Parsed by carta from the page's man source.