'\" t
.\"     Title: zapping_setup_fb
.\"    Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 01/26/2017
.\"    Manual: [FIXME: manual]
.\"    Source: [FIXME: source]
.\"  Language: English
.\"
.TH "ZAPPING_SETUP_FB" "1" "01/26/2017" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
zapping_setup_fb \- prepares V4L/V4L2 driver for overlay
.SH "SYNOPSIS"
.HP \w'\fBzapping_setup_fb\fR\ 'u
\fBzapping_setup_fb\fR [\-?,\ \-h,\ \-\-help,\ \-\-usage] [\-b,\ \-\-bpp\ \fINUMBER\fR] [\-c,\ \-\-child] [\-d,\ \-\-device\ \fIFILENAME\fR] [\-D,\ \-\-display\ \fINAME\fR] [\-f,\ \-\-fd] [\-q,\ \-\-quiet] [\-S,\ \-\-screen\ \fISCREEN\ NUMBER\fR] [\-v,\ \-\-verbose] [\-V,\ \-\-version]
.SH "DESCRIPTION"
.PP
\fBzapping_setup_fb\fR
is a small program to prepare Video For Linux (V4L) or Video For Linux Two (V4L2) video capture drivers for video overlay\&. It must be executed by
\fBpam\fR(8)
with root privileges, or owned by root with the set\-user\-ID bit set (see
\fBchmod\fR(1))\&. This manual page refers to
\fBzapping_setup_fb\fR
version 0\&.13\&.
.SH "BACKGROUND"
.PP
To enable video overlay V4L and V4L2 drivers need to know the screen memory address\&. For security reasons only the system administrator can program this address\&.
\fBzapping\fR(1)
delegates the task to this helper application\&.
.SH "OPTIONS"
.PP
\fB\-?, \-h, \-\-help, \-\-usage\fR
.RS 4
Prints usage information on stdout, then terminates the program\&.
.RE
.PP
\fB\-b, \-\-bpp \fR\fB\fINUMBER\fR\fR
.RS 4
Color depth hint, the number of bits per pixel on the display in question, either 24 or 32\&. Usually
\fBzapping_setup_fb\fR
can determine this number automatically\&.
.RE
.PP
\fB\-c, \-\-child\fR
.RS 4
Zapping
sets this flag when executing
\fBzapping_setup_fb\fR
as child process to enable the output of localized error messages in UTF\-8 encoding on stderr\&.
.RE
.PP
\fB\-d, \-\-device \fR\fB\fIFILENAME\fR\fR
.RS 4
The video capture device to open, by default
/dev/video0\&.
.RE
.PP
\fB\-D, \-\-display \fR\fB\fINAME\fR\fR
.RS 4
The X display to use\&. Defaults to the name defined by the
\fBDISPLAY\fR
environment variable\&.
.RE
.PP
\fB\-f, \-\-fd \fR\fB\fINUMBER\fR\fR
.RS 4
Zapping
uses this option when executing
\fBzapping_setup_fb\fR
as child process to access the video capture driver by this shared file descriptor instead of opening the device file by name\&.
.RE
.PP
\fB\-q, \-\-quiet\fR
.RS 4
Decrements the verbosity level\&.
.RE
.PP
\fB\-S, \-\-screen \fR\fB\fINUMBER\fR\fR
.RS 4
The X screen to use (Xinerama), defaults to 0\&.
.RE
.PP
\fB\-v, \-\-verbose\fR
.RS 4
Increments the verbosity level\&.
.RE
.PP
\fB\-V, \-\-version\fR
.RS 4
Prints the version of
\fBzapping_setup_fb\fR
on stdout, then terminates the program\&.
.RE
.SH "BUGS"
.PP
None known\&.
.SH "SEE ALSO"
.PP
\fBzapping\fR(1),
\fBzapping_remote\fR(1),
\fBpam\fR(8)
.SH "AUTHORS"
.PP
Zapping
and
\fBzapping_setup_fb\fR
were written by Iñaki García Etxebarria, Michael H\&. Schimek (mschimek@users\&.sourceforge\&.net) and many contributors\&.
.PP
This manual page was written by Michael H\&. Schimek based on work by Christian Marillat\&.