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
|
.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "ZAPPING_SETUP_FB" 1 "" "" ""
.SH NAME
zapping_setup_fb \- prepares V4L/V4L2 driver for overlay
.SH "SYNOPSIS"
.nf
\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]
.fi
.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"
.TP
\fB-?, -h, --help, --usage\fR
Prints usage information on stdout, then terminates the program\&.
.TP
\fB-b, --bpp \fINUMBER\fR\fR
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\&.
.TP
\fB-c, --child\fR
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\&.
.TP
\fB-d, --device \fIFILENAME\fR\fR
The video capture device to open, by default \fI/dev/video0\fR\&.
.TP
\fB-D, --display \fINAME\fR\fR
The X display to use\&. Defaults to the name defined by the \fBDISPLAY\fR environment variable\&.
.TP
\fB-f, --fd \fINUMBER\fR\fR
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\&.
.TP
\fB-q, --quiet\fR
Decrements the verbosity level\&.
.TP
\fB-S, --screen \fINUMBER\fR\fR
The X screen to use (Xinerama), defaults to 0\&.
.TP
\fB-v, --verbose\fR
Increments the verbosity level\&.
.TP
\fB-V, --version\fR
Prints the version of \fBzapping_setup_fb\fR on stdout, then terminates the program\&.
.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 Iaki Garca 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\&.
|
