source: multimedia/libdriv/v4l-utils.xml@ c3d8e34

12.1 ken/TL2024 lazarus plabs/newcss python3.11 rahul/power-profiles-daemon trunk xry111/llvm18
Last change on this file since c3d8e34 was c39ddc6, checked in by Xi Ruoyao <xry111@…>, 7 months ago

llvm: Remove BPF from targets

To use clang with BPF for v4l-utils, libbpf must be installed but it's
not a BLFS package. And I doubt if any BLFS user really uses an IR
remote control on the BLFS system. So let's not make all BLFS users
build something useless.

Note that if both clang and libbpf both exist, v4l-utils will attempt to
use "clang -target bpf" anyway even if -Dbpf=disabled is explicitly
specified (we've got enough surprise from v4l-utils building system
these days!!), so add a note to v4l-utils for people installing non-BLFS
libbpf.
  • Property mode set to 100644
File size: 12.4 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY v4l-download-http "https://www.linuxtv.org/downloads/v4l-utils/v4l-utils-&v4l-utils-version;.tar.xz">
8 <!ENTITY v4l-download-ftp " ">
9 <!ENTITY v4l-md5sum "0ccb2a18e1d3a3b2986591753a2b3a7f">
10 <!ENTITY v4l-size "1.2 MB">
11 <!ENTITY v4l-buildsize "32 MB">
12 <!ENTITY v4l-time "1.1 SBU (using parallelism=4)">
13]>
14
15<sect1 id="v4l-utils" xreflabel="v4l-utils-&v4l-utils-version;">
16 <?dbhtml filename="v4l-utils.html" ?>
17
18
19 <title>v4l-utils-&v4l-utils-version;</title>
20
21 <indexterm zone="v4l-utils">
22 <primary sortas="a-v4l-utils">v4l-utils</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to v4l-utils</title>
27
28 <para>
29 <application>v4l-utils</application> provides a series of utilities for
30 media devices, allowing to handle the proprietary formats available at
31 most webcams (libv4l), and providing tools to test V4L devices.
32 </para>
33
34 &lfs120_checked;
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>
40 Download (HTTP): <ulink url="&v4l-download-http;"/>
41 </para>
42 </listitem>
43 <listitem>
44 <para>
45 Download (FTP): <ulink url="&v4l-download-ftp;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download MD5 sum: &v4l-md5sum;
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download size: &v4l-size;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Estimated disk space required: &v4l-buildsize;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated build time: &v4l-time;
66 </para>
67 </listitem>
68 </itemizedlist>
69<!--
70 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
71 <itemizedlist>
72 <listitem>
73 <para>
74 Required patch:
75 <ulink url="&patch-root;/v4l-utils-&v4l-utils-version;-upstream_fixes-1.patch"/>
76 </para>
77 </listitem>
78 </itemizedlist>
79-->
80 <bridgehead renderas="sect3">v4l-utils Dependencies</bridgehead>
81
82 <bridgehead renderas="sect4">Recommended</bridgehead>
83 <para role="recommended">
84 <xref linkend="alsa-lib"/>,
85 <xref linkend="glu"/>,
86 <xref linkend="libjpeg"/>, and
87 &qt5-deps;
88 </para>
89
90 <bridgehead renderas="sect4">Optional</bridgehead>
91 <para role="optional">
92 <xref linkend="doxygen"/>,
93 <xref linkend="sdl2"/>, and
94 both <xref linkend="llvm"/> (with Clang and target BPF)
95 and <ulink url='https://github.com/libbpf/libbpf'>libbpf</ulink>
96 (for infrared remote control decoders based on BPF)
97 </para>
98
99 </sect2>
100
101 <sect2 role="installation">
102 <title>Installation of v4l-utils</title>
103
104 <note>
105 <para>
106 If you've installed both LLVM and libbpf (not in BLFS), either
107 enable the BPF target (via
108 <option>-DLLVM_TARGETS_TO_BUILD=</option>) building LLVM, or disable
109 the infrared remote control decoders based on BPF:
110 </para>
111
112 <!-- not "nodump" because it's harmless for BLFS anyway -->
113 <screen><userinput>sed '/^ir_bpf_enabled/s/=.*/= false/' \
114 -i utils/keytable/meson.build</userinput></screen>
115 </note>
116
117 <para>
118 Install <application>v4l-utils</application> by running
119 the following commands:
120 </para>
121
122<screen><userinput>mkdir build &amp;&amp;
123cd build &amp;&amp;
124meson setup --prefix=/usr -Ddoxygen-doc=disabled \
125 -Dgconv=disabled --buildtype=release ..
126
127ninja</userinput></screen>
128
129
130 <para>
131 This package does not come with a test suite.
132 </para>
133
134 <para>
135 Now, as the <systemitem class="username">root</systemitem> user:
136 </para>
137
138<screen role="root"><userinput>ninja install</userinput></screen>
139
140 <para>
141 If you also wish to install the contrib programs, add:
142 </para>
143
144<screen role="root"><userinput>for prog in sdlcam v4l2gl v4l2grab
145do
146 cp -v contrib/test/$prog $DESTDIR/usr/bin/.
147done</userinput></screen>
148
149
150 </sect2>
151
152 <sect2 role="commands">
153 <title>Command Explanations</title>
154
155 <para>
156 <parameter>-Dgconv=disabled</parameter>: This switch disables
157 the erroneous installation of gconv-modules that would break glibc.
158 </para>
159
160 </sect2>
161
162
163 <sect2 role="content">
164 <title>Contents</title>
165
166 <segmentedlist>
167 <segtitle>Installed Programs</segtitle>
168 <segtitle>Installed Library</segtitle>
169 <segtitle>Installed Directories</segtitle>
170
171 <seglistitem>
172 <seg>
173 cec-compliance,
174 cec-ctl,
175 cec-follower,
176 cx18-ctl,
177 decode_tm6000,
178 dvb-fe-tool,
179 dvb-format-convert,
180 dvbv5-daemon,
181 dvbv5-scan,
182 dvbv5-zap,
183 ir-ctl,
184 ir-keytable,
185 ivtv-ctl,
186 media-ctl,
187 qv4l2,
188 qvidcap,
189 rds-ctl,
190 v4l2-compliance,
191 v4l2-ctl,
192 v4l2-dbg, and
193 v4l2-sysfs-path
194 </seg>
195 <seg>
196 libdvbv5.so,
197 libv4l1.so,
198 libv4l2.so,
199 libv4l2rds.so,
200 libv4lconvert.so,
201 v4l1compat.so, and
202 v4l2convert.so
203 </seg>
204 <seg>
205 /etc/rc_keymaps,
206 /lib/udev/rc_keymaps,
207 /usr/include/libdvbv5, and
208 /usr/lib/libv4l
209 </seg>
210 </seglistitem>
211 </segmentedlist>
212
213 <variablelist>
214 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
215 <?dbfo list-presentation="list"?>
216 <?dbhtml list-presentation="table"?>
217
218 <varlistentry id="cx18-ctl">
219 <term><command>cx18-ctl</command></term>
220 <listitem>
221 <para>
222 is a tool to handle cx18 based devices
223 </para>
224 <indexterm zone="v4l-utils cx18-ctl">
225 <primary sortas="b-cx18-ctl">cx18-ctl</primary>
226 </indexterm>
227 </listitem>
228 </varlistentry>
229
230 <varlistentry id="decode_tm6000">
231 <term><command>decode_tm6000</command></term>
232 <listitem>
233 <para>
234 decodes multiplexed formats from TM5600/TM6000 USB devices
235 </para>
236 <indexterm zone="v4l-utils decode_tm6000">
237 <primary sortas="b-decode_tm6000">decode_tm6000</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="dvb-fe-tool">
243 <term><command>dvb-fe-tool</command></term>
244 <listitem>
245 <para>
246 is a command line tool for digital TV services
247 </para>
248 <indexterm zone="v4l-utils dvb-fe-tool">
249 <primary sortas="b-dvb-fe-tool">dvb-fe-tool</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="dvb-format-convert">
255 <term><command>dvb-format-convert</command></term>
256 <listitem>
257 <para>
258 is a tool meant to convert among different file formats. It is
259 compliant with version 5 of the DVB API
260 </para>
261 <indexterm zone="v4l-utils dvb-format-convert">
262 <primary sortas="b-dvb-format-convert">dvb-format-convert</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 <varlistentry id="dvbv5-scan">
268 <term><command>dvbv5-scan</command></term>
269 <listitem>
270 <para>
271 is a command line frequency scanning tool for digital TV
272 services that are compliant with version 5 of the DVB API
273 </para>
274 <indexterm zone="v4l-utils dvbv5-scan">
275 <primary sortas="b-dvbv5-scan">dvbv5-scan</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="dvbv5-zap">
281 <term><command>dvbv5-zap</command></term>
282 <listitem>
283 <para>
284 is a command line tuning tool for digital TV services
285 that is compliant with version 5 of the DVB API
286 </para>
287 <indexterm zone="v4l-utils dvbv5-zap">
288 <primary sortas="b-dvbv5-zap">dvbv5-zap</primary>
289 </indexterm>
290 </listitem>
291 </varlistentry>
292
293 <varlistentry id="ir-keytable">
294 <term><command>ir-keytable</command></term>
295 <listitem>
296 <para>
297 is a tool that lists the Remote Controller devices, allows one
298 to get/set IR keycode/scancode tables, test events generated by
299 IR, and to adjust other Remote Controller options
300 </para>
301 <indexterm zone="v4l-utils ir-keytable">
302 <primary sortas="b-ir-keytable">ir-keytable</primary>
303 </indexterm>
304 </listitem>
305 </varlistentry>
306
307 <varlistentry id="ivtv-ctl">
308 <term><command>ivtv-ctl</command></term>
309 <listitem>
310 <para>
311 is a utility that can control many card settings, like changing
312 the inputs from tuner to svideo or composite, setting video
313 resolution or changing video mode (PAL, SECAM, NTSC)
314 </para>
315 <indexterm zone="v4l-utils ivtv-ctl">
316 <primary sortas="b-ivtv-ctl">ivtv-ctl</primary>
317 </indexterm>
318 </listitem>
319 </varlistentry>
320
321 <varlistentry id="media-ctl">
322 <term><command>media-ctl</command></term>
323 <listitem>
324 <para>
325 is a utility used to configure V4L2 devices
326 </para>
327 <indexterm zone="v4l-utils media-ctl">
328 <primary sortas="b-media-ctl">media-ctl</primary>
329 </indexterm>
330 </listitem>
331 </varlistentry>
332
333 <varlistentry id="qv4l2">
334 <term><command>qv4l2</command></term>
335 <listitem>
336 <para>
337 is used to test video4linux capture devices
338 </para>
339 <indexterm zone="v4l-utils qv4l2">
340 <primary sortas="b-qv4l2">qv4l2</primary>
341 </indexterm>
342 </listitem>
343 </varlistentry>
344
345 <varlistentry id="qvidcap">
346 <term><command>qvidcap</command></term>
347 <listitem>
348 <para>
349 is used to capture video from a V4L2 device
350 </para>
351 <indexterm zone="v4l-utils qvidcap">
352 <primary sortas="b-qvidcap">qvidcap</primary>
353 </indexterm>
354 </listitem>
355 </varlistentry>
356
357 <varlistentry id="rds-ctl">
358 <term><command>rds-ctl</command></term>
359 <listitem>
360 <para>
361 is a utility for decoding raw RDS data from V4L2 Radio devices
362 and offers simple ways to access the received RDS information
363 </para>
364 <indexterm zone="v4l-utils rds-ctl">
365 <primary sortas="b-rds-ctl">rds-ctl</primary>
366 </indexterm>
367 </listitem>
368 </varlistentry>
369
370 <varlistentry id="v4l2-compliance">
371 <term><command>v4l2-compliance</command></term>
372 <listitem>
373 <para>
374 is a compliance test tool
375 </para>
376 <indexterm zone="v4l-utils v4l2-compliance">
377 <primary sortas="b-v4l2-compliance">v4l2-compliance</primary>
378 </indexterm>
379 </listitem>
380 </varlistentry>
381
382 <varlistentry id="v4l2-ctl">
383 <term><command>v4l2-ctl</command></term>
384 <listitem>
385 <para>
386 is a tool to control v4l2 controls from the cmdline
387 </para>
388 <indexterm zone="v4l-utils v4l2-ctl">
389 <primary sortas="b-v4l2-ctl">v4l2-ctl</primary>
390 </indexterm>
391 </listitem>
392 </varlistentry>
393
394 <varlistentry id="v4l2-dbg">
395 <term><command>v4l2-dbg</command></term>
396 <listitem>
397 <para>
398 is a tool to directly get and set registers of v4l2 devices
399 </para>
400 <indexterm zone="v4l-utils v4l2-dbg">
401 <primary sortas="b-v4l2-dbg">v4l2-dbg</primary>
402 </indexterm>
403 </listitem>
404 </varlistentry>
405
406 <varlistentry id="v4l2-sysfs-path">
407 <term><command>v4l2-sysfs-path</command></term>
408 <listitem>
409 <para>
410 checks the media devices installed on a machine and the
411 corresponding device nodes
412 </para>
413 <indexterm zone="v4l-utils v4l2-sysfs-path">
414 <primary sortas="b-v4l2-sysfs-path">v4l2-sysfs-path</primary>
415 </indexterm>
416 </listitem>
417 </varlistentry>
418
419 </variablelist>
420
421 </sect2>
422
423</sect1>
Note: See TracBrowser for help on using the repository browser.