lael-labs/linux

Documentation/admin-guide/pm/cpufreq.rst+5−6

 .. SPDX-License-Identifier: GPL-2.0
 .. include:: <isonum.txt>
-.. |struct cpufreq_policy| replace:: :c:type:`struct cpufreq_policy <cpufreq_policy>`
 .. |intel_pstate| replace:: :doc:`intel_pstate <intel_pstate>`
 =======================
 all of those CPUs simultaneously.
 Sets of CPUs sharing hardware P-state control interfaces are represented by
-``CPUFreq`` as |struct cpufreq_policy| objects.  For consistency,
+``CPUFreq`` as struct cpufreq_policy objects.  For consistency,
-|struct cpufreq_policy| is also used when there is only one CPU in the given
+struct cpufreq_policy is also used when there is only one CPU in the given
 set.
-The ``CPUFreq`` core maintains a pointer to a |struct cpufreq_policy| object for
+The ``CPUFreq`` core maintains a pointer to a struct cpufreq_policy object for
 every CPU in the system, including CPUs that are currently offline.  If multiple
 CPUs share the same hardware P-state control interface, all of the pointers
-corresponding to them point to the same |struct cpufreq_policy| object.
+corresponding to them point to the same struct cpufreq_policy object.
-``CPUFreq`` uses |struct cpufreq_policy| as its basic data type and the design
+``CPUFreq`` uses struct cpufreq_policy as its basic data type and the design
 of its user space interface is based on the policy concept.

Documentation/admin-guide/pstore-blk.rst+2−8

 Only a block device driver cares about these configurations. A block device
 driver uses ``register_pstore_blk`` to register to pstore/blk.
-.. kernel-doc:: fs/pstore/blk.c
-   :identifiers: register_pstore_blk
 A non-block device driver uses ``register_pstore_device`` with
 ``struct pstore_device_info`` to register to pstore/blk.
 .. kernel-doc:: fs/pstore/blk.c
-   :identifiers: register_pstore_device
+   :export:
-.. kernel-doc:: include/linux/pstore_blk.h
-   :identifiers: pstore_device_info
 Compression and header
 ----------------------
    :internal:
 .. kernel-doc:: fs/pstore/blk.c
-   :export:
+   :internal:
 .. kernel-doc:: include/linux/pstore_blk.h
    :internal:

Documentation/block/blk-mq.rst+6−6

Documentation/block/inline-encryption.rst+4−4

Documentation/conf.py+62−3

@@ -47,9 +47,68 @@ extensions = ['kerneldoc', 'rstFlatTable', 'kernel_include', · 46 unmodified lines
47	#	47	#
48	if major >= 3:	48	if major >= 3:
49	sys.stderr.write('''WARNING: The kernel documentation build process	49	sys.stderr.write('''WARNING: The kernel documentation build process
50	does not work correctly with Sphinx v3.0 and above. Expect errors	50	support for Sphinx v3.0 and above is brand new. Be prepared for
51	in the generated output.	51	possible issues in the generated output.
52	''')	52	''')
		53	if minor > 0 or patch >= 2:
		54	# Sphinx c function parser is more pedantic with regards to type
		55	# checking. Due to that, having macros at c:function cause problems.
		56	# Those needed to be scaped by using c_id_attributes[] array
		57	c_id_attributes = [
		58	# GCC Compiler types not parsed by Sphinx:
		59	"__restrict__",
		60
		61	# include/linux/compiler_types.h:
		62	"__iomem",
		63	"__kernel",
		64	"noinstr",
		65	"notrace",
		66	"__percpu",
		67	"__rcu",
		68	"__user",
		69
		70	# include/linux/compiler_attributes.h:
		71	"__alias",
		72	"__aligned",
		73	"__aligned_largest",
		74	"__always_inline",
		75	"__assume_aligned",
		76	"__cold",
		77	"__attribute_const__",
		78	"__copy",
		79	"__pure",
		80	"__designated_init",
		81	"__visible",
		82	"__printf",
		83	"__scanf",
		84	"__gnu_inline",
		85	"__malloc",
		86	"__mode",
		87	"__no_caller_saved_registers",
		88	"__noclone",
		89	"__nonstring",
		90	"__noreturn",
		91	"__packed",
		92	"__pure",
		93	"__section",
		94	"__always_unused",
		95	"__maybe_unused",
		96	"__used",
		97	"__weak",
		98	"noinline",
		99
		100	# include/linux/memblock.h:
		101	"__init_memblock",
		102	"__meminit",
		103
		104	# include/linux/init.h:
		105	"__init",
		106	"__ref",
		107
		108	# include/linux/linkage.h:
		109	"asmlinkage",
		110	]
		111
53	else:	112	else:
54	extensions.append('cdomain')	113	extensions.append('cdomain')
55		114

Documentation/core-api/genericirq.rst+2−0

 .. kernel-doc:: kernel/irq/manage.c
 .. kernel-doc:: kernel/irq/chip.c
+   :export:
 Internal Functions Provided
 ===========================
 .. kernel-doc:: kernel/irq/handle.c
 .. kernel-doc:: kernel/irq/chip.c
+   :internal:
 Credits
 =======

Documentation/core-api/kernel-api.rst+0−6

@@ -231,12 +231,6 @@ Refer to the file kernel/module.c for more information. · 230 unmodified lines
231	Hardware Interfaces	231	Hardware Interfaces
232	===================	232	===================
233		233
234	Interrupt Handling
235	------------------
236
237	.. kernel-doc:: kernel/irq/manage.c
238	:export:
239
240	DMA Channels	234	DMA Channels
241	------------	235	------------
242		236

Documentation/core-api/workqueue.rst+2−0

@@ -396,3 +396,5 @@ Kernel Inline Documentations Reference · 395 unmodified lines
396	======================================	396	======================================
397		397
398	.. kernel-doc:: include/linux/workqueue.h	398	.. kernel-doc:: include/linux/workqueue.h
		399
		400	.. kernel-doc:: kernel/workqueue.c

Documentation/dev-tools/kgdb.rst+3−3

Documentation/devicetree/bindings/display/tilcdc/tilcdc.txt+1−1

@@ -37,7 +37,7 @@ Optional nodes: · 36 unmodified lines
37	supports a single port with a single endpoint.	37	supports a single port with a single endpoint.
38		38
39	- See also Documentation/devicetree/bindings/display/tilcdc/panel.txt and	39	- See also Documentation/devicetree/bindings/display/tilcdc/panel.txt and
40	Documentation/devicetree/bindings/display/bridge/ti,tfp410.txt for connecting	40	Documentation/devicetree/bindings/display/bridge/ti,tfp410.yaml for connecting
41	tfp410 DVI encoder or lcd panel to lcdc	41	tfp410 DVI encoder or lcd panel to lcdc
42		42
43	[1] There is an errata about AM335x color wiring. For 16-bit color mode	43	[1] There is an errata about AM335x color wiring. For 16-bit color mode

Documentation/devicetree/bindings/mailbox/omap-mailbox.txt+1−1

@@ -69,7 +69,7 @@ The following are mandatory properties for the K3 AM65x and J721E SoCs only: · 68 unmodified lines
69	the interrupt routes between the IP and the main GIC	69	the interrupt routes between the IP and the main GIC
70	controllers. See the following binding for additional	70	controllers. See the following binding for additional
71	details,	71	details,
72	Documentation/devicetree/bindings/interrupt-controller/ti,sci-intr.txt	72	Documentation/devicetree/bindings/interrupt-controller/ti,sci-intr.yaml
73		73
74	Child Nodes:	74	Child Nodes:
75	============	75	============

Documentation/devicetree/bindings/media/i2c/tvp5150.txt+1−1

@@ -56,7 +56,7 @@ Optional Connector Properties: · 55 unmodified lines
56	instead of using the autodetection mechnism. Please look at	56	instead of using the autodetection mechnism. Please look at
57	[1] for more information.	57	[1] for more information.
58		58
59	[1] Documentation/devicetree/bindings/display/connector/analog-tv-connector.txt.	59	[1] Documentation/devicetree/bindings/display/connector/analog-tv-connector.yaml.
60		60
61	Example - three input sources:	61	Example - three input sources:
62	#include <dt-bindings/display/sdtv-standards.h>	62	#include <dt-bindings/display/sdtv-standards.h>

Documentation/devicetree/bindings/pwm/google,cros-ec-pwm.yaml+1−1

@@ -14,7 +14,7 @@ description: \| · 13 unmodified lines
14	Google's ChromeOS EC PWM is a simple PWM attached to the Embedded Controller	14	Google's ChromeOS EC PWM is a simple PWM attached to the Embedded Controller
15	(EC) and controlled via a host-command interface.	15	(EC) and controlled via a host-command interface.
16	An EC PWM node should be only found as a sub-node of the EC node (see	16	An EC PWM node should be only found as a sub-node of the EC node (see
17	Documentation/devicetree/bindings/mfd/cros-ec.txt).	17	Documentation/devicetree/bindings/mfd/google,cros-ec.yaml).
18		18
19	properties:	19	properties:
20	compatible:	20	compatible:

Documentation/devicetree/bindings/soc/qcom/qcom,smd-rpm.yaml+1−1

@@ -20,7 +20,7 @@ description: \| · 19 unmodified lines
20	present and this subnode may contain children that designate regulator	20	present and this subnode may contain children that designate regulator
21	resources.	21	resources.
22		22
23	Refer to Documentation/devicetree/bindings/regulator/qcom,smd-rpm-regulator.txt	23	Refer to Documentation/devicetree/bindings/regulator/qcom,smd-rpm-regulator.yaml
24	for information on the regulator subnodes that can exist under the	24	for information on the regulator subnodes that can exist under the
25	rpm_requests.	25	rpm_requests.
26		26

Documentation/devicetree/bindings/sound/google,cros-ec-codec.yaml+1−1

@@ -13,7 +13,7 @@ description: \| · 12 unmodified lines
13	Google's ChromeOS EC codec is a digital mic codec provided by the	13	Google's ChromeOS EC codec is a digital mic codec provided by the
14	Embedded Controller (EC) and is controlled via a host-command interface.	14	Embedded Controller (EC) and is controlled via a host-command interface.
15	An EC codec node should only be found as a sub-node of the EC node (see	15	An EC codec node should only be found as a sub-node of the EC node (see
16	Documentation/devicetree/bindings/mfd/cros-ec.txt).	16	Documentation/devicetree/bindings/mfd/google,cros-ec.yaml).
17		17
18	properties:	18	properties:
19	compatible:	19	compatible:

Documentation/doc-guide/kernel-doc.rst+8−0

@@ -490,6 +490,14 @@ identifiers: [ function/type ...] · 489 unmodified lines
490	.. kernel-doc:: lib/idr.c	490	.. kernel-doc:: lib/idr.c
491	:identifiers:	491	:identifiers:
492		492
		493	no-identifiers: [ function/type ...]
		494	Exclude documentation for each function and type in source.
		495
		496	Example::
		497
		498	.. kernel-doc:: lib/bitmap.c
		499	:no-identifiers: bitmap_parselist
		500
493	functions: [ function/type ...]	501	functions: [ function/type ...]
494	This is an alias of the 'identifiers' directive and deprecated.	502	This is an alias of the 'identifiers' directive and deprecated.
495		503

Documentation/driver-api/basics.rst+4−15

 .. kernel-doc:: include/linux/mod_devicetable.h
    :internal:
+   :no-identifiers: pci_device_id
 Delaying, scheduling, and timer routines
 ----------------------------------------
 .. kernel-doc:: kernel/time/hrtimer.c
    :export:
-Workqueues and Kevents
-----------------------
-.. kernel-doc:: include/linux/workqueue.h
-   :internal:
-.. kernel-doc:: kernel/workqueue.c
-   :export:
 Internal Functions
 ------------------
 .. kernel-doc:: include/linux/kernel.h
    :internal:
+   :no-identifiers: kstrtol kstrtoul
 .. kernel-doc:: kernel/printk/printk.c
    :export:
+   :no-identifiers: printk
 .. kernel-doc:: kernel/panic.c
    :export:
-.. kernel-doc:: kernel/rcu/tree.c
-   :export:
-.. kernel-doc:: kernel/rcu/update.c
-   :export:
 .. kernel-doc:: include/linux/overflow.h
    :internal:

Documentation/driver-api/device_link.rst+4−9

-.. |struct dev_pm_domain| replace:: :c:type:`struct dev_pm_domain <dev_pm_domain>`
-.. |struct generic_pm_domain| replace:: :c:type:`struct generic_pm_domain <generic_pm_domain>`
 .. _device_link:
 ============
   is the same as if the MMU was the parent of the master device.
   The fact that both devices share the same power domain would normally
-  suggest usage of a |struct dev_pm_domain| or |struct generic_pm_domain|,
+  suggest usage of a struct dev_pm_domain or struct generic_pm_domain,
   however these are not independent devices that happen to share a power
   switch, but rather the MMU device serves the busmaster device and is
   useless without it.  A device link creates a synthetic hierarchical
 Alternatives
 ============
-* A |struct dev_pm_domain| can be used to override the bus,
+* A struct dev_pm_domain can be used to override the bus,
   class or device type callbacks.  It is intended for devices sharing
   a single on/off switch, however it does not guarantee a specific
   suspend/resume ordering, this needs to be implemented separately.
   suspended.  Furthermore it cannot be used to enforce a specific shutdown
   ordering or a driver presence dependency.
-* A |struct generic_pm_domain| is a lot more heavyweight than a
+* A struct generic_pm_domain is a lot more heavyweight than a
   device link and does not allow for shutdown ordering or driver presence
   dependencies.  It also cannot be used on ACPI systems.
 API
 ===
-.. kernel-doc:: drivers/base/core.c
+See device_link_add(), device_link_del() and device_link_remove().
-   :functions: device_link_add device_link_del device_link_remove

Documentation/driver-api/fpga/fpga-bridge.rst+2−2

@@ -4,8 +4,8 @@ FPGA Bridge · 3 unmodified lines
4	API to implement a new FPGA bridge	4	API to implement a new FPGA bridge
5	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~	5	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
6		6
7	* struct :c:type:`fpga_bridge` — The FPGA Bridge structure	7	* struct fpga_bridge — The FPGA Bridge structure
8	* struct :c:type:`fpga_bridge_ops` — Low level Bridge driver ops	8	* struct fpga_bridge_ops — Low level Bridge driver ops
9	* devm_fpga_bridge_create() — Allocate and init a bridge struct	9	* devm_fpga_bridge_create() — Allocate and init a bridge struct
10	* fpga_bridge_register() — Register a bridge	10	* fpga_bridge_register() — Register a bridge
11	* fpga_bridge_unregister() — Unregister a bridge	11	* fpga_bridge_unregister() — Unregister a bridge

Documentation/driver-api/fpga/fpga-mgr.rst+3−3

@@ -101,9 +101,9 @@ in state. · 100 unmodified lines
101	API for implementing a new FPGA Manager driver	101	API for implementing a new FPGA Manager driver
102	----------------------------------------------	102	----------------------------------------------
103		103
104	* ``fpga_mgr_states`` — Values for :c:member:`fpga_manager->state`.	104	* ``fpga_mgr_states`` — Values for :c:expr:`fpga_manager->state`.
105	* struct :c:type:`fpga_manager` — the FPGA manager struct	105	* struct fpga_manager — the FPGA manager struct
106	* struct :c:type:`fpga_manager_ops` — Low level FPGA manager driver ops	106	* struct fpga_manager_ops — Low level FPGA manager driver ops
107	* devm_fpga_mgr_create() — Allocate and init a manager struct	107	* devm_fpga_mgr_create() — Allocate and init a manager struct
108	* fpga_mgr_register() — Register an FPGA manager	108	* fpga_mgr_register() — Register an FPGA manager
109	* fpga_mgr_unregister() — Unregister an FPGA manager	109	* fpga_mgr_unregister() — Unregister an FPGA manager

Documentation/driver-api/fpga/fpga-programming.rst+1−1

@@ -15,7 +15,7 @@ the FPGA manager and bridges. It will: · 14 unmodified lines
15	* lock the mutex of the region's FPGA manager	15	* lock the mutex of the region's FPGA manager
16	* build a list of FPGA bridges if a method has been specified to do so	16	* build a list of FPGA bridges if a method has been specified to do so
17	* disable the bridges	17	* disable the bridges
18	* program the FPGA using info passed in :c:member:`fpga_region->info`.	18	* program the FPGA using info passed in :c:expr:`fpga_region->info`.
19	* re-enable the bridges	19	* re-enable the bridges
20	* release the locks	20	* release the locks
21		21

Documentation/driver-api/fpga/fpga-region.rst+3−3

Documentation/driver-api/iio/buffers.rst+1−1

@@ -2,7 +2,7 @@ · 1 unmodified line
2	Buffers	2	Buffers
3	=======	3	=======
4		4
5	* struct :c:type:`iio_buffer` — general buffer structure	5	* struct iio_buffer — general buffer structure
6	* :c:func:`iio_validate_scan_mask_onehot` — Validates that exactly one channel	6	* :c:func:`iio_validate_scan_mask_onehot` — Validates that exactly one channel
7	is selected	7	is selected
8	* :c:func:`iio_buffer_get` — Grab a reference to the buffer	8	* :c:func:`iio_buffer_get` — Grab a reference to the buffer

Documentation/driver-api/iio/core.rst+3−3

@@ -10,7 +10,7 @@ applications manipulating sensors. The implementation can be found under · 9 unmodified lines
10	Industrial I/O Devices	10	Industrial I/O Devices
11	----------------------	11	----------------------
12		12
13	* struct :c:type:`iio_dev` - industrial I/O device	13	* struct iio_dev - industrial I/O device
14	* iio_device_alloc() - allocate an :c:type:`iio_dev` from a driver	14	* iio_device_alloc() - allocate an :c:type:`iio_dev` from a driver
15	* iio_device_free() - free an :c:type:`iio_dev` from a driver	15	* iio_device_free() - free an :c:type:`iio_dev` from a driver
16	* iio_device_register() - register a device with the IIO subsystem	16	* iio_device_register() - register a device with the IIO subsystem
@@ -66,7 +66,7 @@ Common attributes are: · 49 unmodified lines
66	IIO device channels	66	IIO device channels
67	===================	67	===================
68		68
69	struct :c:type:`iio_chan_spec` - specification of a single channel	69	struct iio_chan_spec - specification of a single channel
70		70
71	An IIO device channel is a representation of a data channel. An IIO device can	71	An IIO device channel is a representation of a data channel. An IIO device can
72	have one or multiple channels. For example:	72	have one or multiple channels. For example:
@@ -77,7 +77,7 @@ have one or multiple channels. For example: · 4 unmodified lines
77	* an accelerometer can have up to 3 channels representing acceleration on X, Y	77	* an accelerometer can have up to 3 channels representing acceleration on X, Y
78	and Z axes.	78	and Z axes.
79		79
80	An IIO channel is described by the struct :c:type:`iio_chan_spec`.	80	An IIO channel is described by the struct iio_chan_spec.
81	A thermometer driver for the temperature sensor in the example above would	81	A thermometer driver for the temperature sensor in the example above would
82	have to describe its channel as follows::	82	have to describe its channel as follows::
83		83

Documentation/driver-api/iio/hw-consumer.rst+1−1

@@ -8,7 +8,7 @@ software buffer for data. The implementation can be found under · 7 unmodified lines
8	:file:`drivers/iio/buffer/hw-consumer.c`	8	:file:`drivers/iio/buffer/hw-consumer.c`
9		9
10		10
11	* struct :c:type:`iio_hw_consumer` — Hardware consumer structure	11	* struct iio_hw_consumer — Hardware consumer structure
12	* :c:func:`iio_hw_consumer_alloc` — Allocate IIO hardware consumer	12	* :c:func:`iio_hw_consumer_alloc` — Allocate IIO hardware consumer
13	* :c:func:`iio_hw_consumer_free` — Free IIO hardware consumer	13	* :c:func:`iio_hw_consumer_free` — Free IIO hardware consumer
14	* :c:func:`iio_hw_consumer_enable` — Enable IIO hardware consumer	14	* :c:func:`iio_hw_consumer_enable` — Enable IIO hardware consumer

Documentation/driver-api/iio/triggered-buffers.rst+1−1

@@ -10,7 +10,7 @@ IIO triggered buffer setup · 9 unmodified lines
10	* :c:func:`iio_triggered_buffer_setup` — Setup triggered buffer and pollfunc	10	* :c:func:`iio_triggered_buffer_setup` — Setup triggered buffer and pollfunc
11	* :c:func:`iio_triggered_buffer_cleanup` — Free resources allocated by	11	* :c:func:`iio_triggered_buffer_cleanup` — Free resources allocated by
12	:c:func:`iio_triggered_buffer_setup`	12	:c:func:`iio_triggered_buffer_setup`
13	* struct :c:type:`iio_buffer_setup_ops` — buffer setup related callbacks	13	* struct iio_buffer_setup_ops — buffer setup related callbacks
14		14
15	A typical triggered buffer setup looks like this::	15	A typical triggered buffer setup looks like this::
16		16

Documentation/driver-api/iio/triggers.rst+2−2

@@ -2,7 +2,7 @@ · 1 unmodified line
2	Triggers	2	Triggers
3	========	3	========
4		4
5	* struct :c:type:`iio_trigger` — industrial I/O trigger device	5	* struct iio_trigger — industrial I/O trigger device
6	* :c:func:`devm_iio_trigger_alloc` — Resource-managed iio_trigger_alloc	6	* :c:func:`devm_iio_trigger_alloc` — Resource-managed iio_trigger_alloc
7	* :c:func:`devm_iio_trigger_register` — Resource-managed iio_trigger_register	7	* :c:func:`devm_iio_trigger_register` — Resource-managed iio_trigger_register
8	iio_trigger_unregister	8	iio_trigger_unregister
@@ -63,7 +63,7 @@ Let's see a simple example of how to setup a trigger to be used by a driver:: · 54 unmodified lines
63	IIO trigger ops	63	IIO trigger ops
64	===============	64	===============
65		65
66	* struct :c:type:`iio_trigger_ops` — operations structure for an iio_trigger.	66	* struct iio_trigger_ops — operations structure for an iio_trigger.
67		67
68	Notice that a trigger has a set of operations attached:	68	Notice that a trigger has a set of operations attached:
69		69

Documentation/driver-api/index.rst+0−1

@@ -27,7 +27,6 @@ available subsections can be seen below. · 26 unmodified lines
27	component	27	component
28	message-based	28	message-based
29	infiniband	29	infiniband
30	sound
31	frame-buffer	30	frame-buffer
32	regulator	31	regulator
33	iio/index	32	iio/index

Documentation/driver-api/infrastructure.rst+1−3

 .. kernel-doc:: include/linux/device.h
    :internal:
+   :no-identifiers: device_link_state
 Device Drivers Base
 -------------------
 .. kernel-doc:: drivers/base/node.c
    :internal:
-.. kernel-doc:: drivers/base/firmware_loader/main.c
-   :export:
 .. kernel-doc:: drivers/base/transport_class.c
    :export:

Documentation/driver-api/libata.rst+1−1

@@ -508,7 +508,7 @@ also complete commands. · 507 unmodified lines
508		508
509	2. ATA_QCFLAG_ACTIVE is cleared from qc->flags.	509	2. ATA_QCFLAG_ACTIVE is cleared from qc->flags.
510		510
511	3. :c:func:`qc->complete_fn` callback is invoked. If the return value of the	511	3. :c:expr:`qc->complete_fn` callback is invoked. If the return value of the
512	callback is not zero. Completion is short circuited and	512	callback is not zero. Completion is short circuited and
513	:c:func:`ata_qc_complete` returns.	513	:c:func:`ata_qc_complete` returns.
514		514

Documentation/driver-api/media/cec-core.rst+1−1

@@ -98,7 +98,7 @@ Implementing the Low-Level CEC Adapter · 97 unmodified lines
98	The following low-level adapter operations have to be implemented in	98	The following low-level adapter operations have to be implemented in
99	your driver:	99	your driver:
100		100
101	.. c:type:: struct cec_adap_ops	101	.. c:struct:: cec_adap_ops
102		102
103	.. code-block:: none	103	.. code-block:: none
104		104

Documentation/driver-api/media/dtv-frontend.rst+2−2

@@ -125,7 +125,7 @@ responsible for tuning the device. It supports multiple algorithms to · 124 unmodified lines
125	detect a channel, as defined at enum :c:func:`dvbfe_algo`.	125	detect a channel, as defined at enum :c:func:`dvbfe_algo`.
126		126
127	The algorithm to be used is obtained via ``.get_frontend_algo``. If the driver	127	The algorithm to be used is obtained via ``.get_frontend_algo``. If the driver
128	doesn't fill its field at struct :c:type:`dvb_frontend_ops`, it will default to	128	doesn't fill its field at struct dvb_frontend_ops, it will default to
129	``DVBFE_ALGO_SW``, meaning that the dvb-core will do a zigzag when tuning,	129	``DVBFE_ALGO_SW``, meaning that the dvb-core will do a zigzag when tuning,
130	e. g. it will try first to use the specified center frequency ``f``,	130	e. g. it will try first to use the specified center frequency ``f``,
131	then, it will do ``f`` + \|delta\|, ``f`` - \|delta\|, ``f`` + 2 x \|delta\|,	131	then, it will do ``f`` + \|delta\|, ``f`` - \|delta\|, ``f`` + 2 x \|delta\|,
@@ -140,7 +140,7 @@ define a ``.get_frontend_algo`` function that would return ``DVBFE_ALGO_HW``. · 8 unmodified lines
140	a third type (``DVBFE_ALGO_CUSTOM``), in order to allow the driver to	140	a third type (``DVBFE_ALGO_CUSTOM``), in order to allow the driver to
141	define its own hardware-assisted algorithm. Very few hardware need to	141	define its own hardware-assisted algorithm. Very few hardware need to
142	use it nowadays. Using ``DVBFE_ALGO_CUSTOM`` require to provide other	142	use it nowadays. Using ``DVBFE_ALGO_CUSTOM`` require to provide other
143	function callbacks at struct :c:type:`dvb_frontend_ops`.	143	function callbacks at struct dvb_frontend_ops.
144		144
145	Attaching frontend driver to the bridge driver	145	Attaching frontend driver to the bridge driver
146	^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^	146	^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Documentation/driver-api/media/mc-core.rst+12−12

@@ -36,7 +36,7 @@ pad to a sink pad. · 35 unmodified lines
36	Media device	36	Media device
37	^^^^^^^^^^^^	37	^^^^^^^^^^^^
38		38
39	A media device is represented by a struct :c:type:`media_device`	39	A media device is represented by a struct media_device
40	instance, defined in ``include/media/media-device.h``.	40	instance, defined in ``include/media/media-device.h``.
41	Allocation of the structure is handled by the media device driver, usually by	41	Allocation of the structure is handled by the media device driver, usually by
42	embedding the :c:type:`media_device` instance in a larger driver-specific	42	embedding the :c:type:`media_device` instance in a larger driver-specific
@@ -49,7 +49,7 @@ and unregistered by calling :c:func:`media_device_unregister()`. · 6 unmodified lines
49	Entities	49	Entities
50	^^^^^^^^	50	^^^^^^^^
51		51
52	Entities are represented by a struct :c:type:`media_entity`	52	Entities are represented by a struct media_entity
53	instance, defined in ``include/media/media-entity.h``. The structure is usually	53	instance, defined in ``include/media/media-entity.h``. The structure is usually
54	embedded into a higher-level structure, such as	54	embedded into a higher-level structure, such as
55	:c:type:`v4l2_subdev` or :c:type:`video_device`	55	:c:type:`v4l2_subdev` or :c:type:`video_device`
@@ -67,10 +67,10 @@ Interfaces · 11 unmodified lines
67	^^^^^^^^^^	67	^^^^^^^^^^
68		68
69	Interfaces are represented by a	69	Interfaces are represented by a
70	struct :c:type:`media_interface` instance, defined in	70	struct media_interface instance, defined in
71	``include/media/media-entity.h``. Currently, only one type of interface is	71	``include/media/media-entity.h``. Currently, only one type of interface is
72	defined: a device node. Such interfaces are represented by a	72	defined: a device node. Such interfaces are represented by a
73	struct :c:type:`media_intf_devnode`.	73	struct media_intf_devnode.
74		74
75	Drivers initialize and create device node interfaces by calling	75	Drivers initialize and create device node interfaces by calling
76	:c:func:`media_devnode_create()`	76	:c:func:`media_devnode_create()`
@@ -79,7 +79,7 @@ and remove them by calling: · 2 unmodified lines
79		79
80	Pads	80	Pads
81	^^^^	81	^^^^
82	Pads are represented by a struct :c:type:`media_pad` instance,	82	Pads are represented by a struct media_pad instance,
83	defined in ``include/media/media-entity.h``. Each entity stores its pads in	83	defined in ``include/media/media-entity.h``. Each entity stores its pads in
84	a pads array managed by the entity driver. Drivers usually embed the array in	84	a pads array managed by the entity driver. Drivers usually embed the array in
85	a driver-specific structure.	85	a driver-specific structure.
@@ -87,8 +87,8 @@ a driver-specific structure. · 1 unmodified line
87	Pads are identified by their entity and their 0-based index in the pads	87	Pads are identified by their entity and their 0-based index in the pads
88	array.	88	array.
89		89
90	Both information are stored in the struct :c:type:`media_pad`,	90	Both information are stored in the struct media_pad,
91	making the struct :c:type:`media_pad` pointer the canonical way	91	making the struct media_pad pointer the canonical way
92	to store and pass link references.	92	to store and pass link references.
93		93
94	Pads have flags that describe the pad capabilities and state.	94	Pads have flags that describe the pad capabilities and state.
@@ -104,7 +104,7 @@ Pads have flags that describe the pad capabilities and state. · 9 unmodified lines
104	Links	104	Links
105	^^^^^	105	^^^^^
106		106
107	Links are represented by a struct :c:type:`media_link` instance,	107	Links are represented by a struct media_link instance,
108	defined in ``include/media/media-entity.h``. There are two types of links:	108	defined in ``include/media/media-entity.h``. There are two types of links:
109		109
110	1. pad to pad links:	110	1. pad to pad links:
@@ -187,7 +187,7 @@ Use count and power handling · 76 unmodified lines
187		187
188	Due to the wide differences between drivers regarding power management	188	Due to the wide differences between drivers regarding power management
189	needs, the media controller does not implement power management. However,	189	needs, the media controller does not implement power management. However,
190	the struct :c:type:`media_entity` includes a ``use_count``	190	the struct media_entity includes a ``use_count``
191	field that media drivers	191	field that media drivers
192	can use to track the number of users of every entity for power management	192	can use to track the number of users of every entity for power management
193	needs.	193	needs.
@@ -213,11 +213,11 @@ prevent link states from being modified during streaming by calling · 19 unmodified lines
213	The function will mark all entities connected to the given entity through	213	The function will mark all entities connected to the given entity through
214	enabled links, either directly or indirectly, as streaming.	214	enabled links, either directly or indirectly, as streaming.
215		215
216	The struct :c:type:`media_pipeline` instance pointed to by	216	The struct media_pipeline instance pointed to by
217	the pipe argument will be stored in every entity in the pipeline.	217	the pipe argument will be stored in every entity in the pipeline.
218	Drivers should embed the struct :c:type:`media_pipeline`	218	Drivers should embed the struct media_pipeline
219	in higher-level pipeline structures and can then access the	219	in higher-level pipeline structures and can then access the
220	pipeline through the struct :c:type:`media_entity`	220	pipeline through the struct media_entity
221	pipe field.	221	pipe field.
222		222
223	Calls to :c:func:`media_pipeline_start()` can be nested.	223	Calls to :c:func:`media_pipeline_start()` can be nested.

Documentation/driver-api/media/v4l2-controls.rst+1−1

@@ -27,7 +27,7 @@ V4L2 specification with respect to controls in a central place. And to make · 26 unmodified lines
27	life as easy as possible for the driver developer.	27	life as easy as possible for the driver developer.
28		28
29	Note that the control framework relies on the presence of a struct	29	Note that the control framework relies on the presence of a struct
30	:c:type:`v4l2_device` for V4L2 drivers and struct :c:type:`v4l2_subdev` for	30	:c:type:`v4l2_device` for V4L2 drivers and struct v4l2_subdev for
31	sub-device drivers.	31	sub-device drivers.
32		32
33		33

Documentation/driver-api/media/v4l2-dev.rst+4−4

Documentation/driver-api/media/v4l2-device.rst+3−3

@@ -3,7 +3,7 @@ · 2 unmodified lines
3	V4L2 device instance	3	V4L2 device instance
4	--------------------	4	--------------------
5		5
6	Each device instance is represented by a struct :c:type:`v4l2_device`.	6	Each device instance is represented by a struct v4l2_device.
7	Very simple devices can just allocate this struct, but most of the time you	7	Very simple devices can just allocate this struct, but most of the time you
8	would embed this struct inside a larger struct.	8	would embed this struct inside a larger struct.
9		9
@@ -18,9 +18,9 @@ dev->driver_data field is ``NULL``, it will be linked to · 8 unmodified lines
18		18
19	Drivers that want integration with the media device framework need to set	19	Drivers that want integration with the media device framework need to set
20	dev->driver_data manually to point to the driver-specific device structure	20	dev->driver_data manually to point to the driver-specific device structure
21	that embed the struct :c:type:`v4l2_device` instance. This is achieved by a	21	that embed the struct v4l2_device instance. This is achieved by a
22	``dev_set_drvdata()`` call before registering the V4L2 device instance.	22	``dev_set_drvdata()`` call before registering the V4L2 device instance.
23	They must also set the struct :c:type:`v4l2_device` mdev field to point to a	23	They must also set the struct v4l2_device mdev field to point to a
24	properly initialized and registered :c:type:`media_device` instance.	24	properly initialized and registered :c:type:`media_device` instance.
25		25
26	If :c:type:`v4l2_dev <v4l2_device>`\ ->name is empty then it will be set to a	26	If :c:type:`v4l2_dev <v4l2_device>`\ ->name is empty then it will be set to a

Documentation/driver-api/media/v4l2-event.rst+5−5

@@ -44,18 +44,18 @@ such objects. · 43 unmodified lines
44		44
45	So to summarize:	45	So to summarize:
46		46
47	- struct :c:type:`v4l2_fh` has two lists: one of the ``subscribed`` events,	47	- struct v4l2_fh has two lists: one of the ``subscribed`` events,
48	and one of the ``available`` events.	48	and one of the ``available`` events.
49		49
50	- struct :c:type:`v4l2_subscribed_event` has a ringbuffer of raised	50	- struct v4l2_subscribed_event has a ringbuffer of raised
51	(pending) events of that particular type.	51	(pending) events of that particular type.
52		52
53	- If struct :c:type:`v4l2_subscribed_event` is associated with a specific	53	- If struct v4l2_subscribed_event is associated with a specific
54	object, then that object will have an internal list of	54	object, then that object will have an internal list of
55	struct :c:type:`v4l2_subscribed_event` so it knows who subscribed an	55	struct v4l2_subscribed_event so it knows who subscribed an
56	event to that object.	56	event to that object.
57		57
58	Furthermore, the internal struct :c:type:`v4l2_subscribed_event` has	58	Furthermore, the internal struct v4l2_subscribed_event has
59	``merge()`` and ``replace()`` callbacks which drivers can set. These	59	``merge()`` and ``replace()`` callbacks which drivers can set. These
60	callbacks are called when a new event is raised and there is no more room.	60	callbacks are called when a new event is raised and there is no more room.
61		61

Documentation/driver-api/media/v4l2-fh.rst+8−8

@@ -3,11 +3,11 @@ · 2 unmodified lines
3	V4L2 File handlers	3	V4L2 File handlers
4	------------------	4	------------------
5		5
6	struct :c:type:`v4l2_fh` provides a way to easily keep file handle specific	6	struct v4l2_fh provides a way to easily keep file handle specific
7	data that is used by the V4L2 framework.	7	data that is used by the V4L2 framework.
8		8
9	.. attention::	9	.. attention::
10	New drivers must use struct :c:type:`v4l2_fh`	10	New drivers must use struct v4l2_fh
11	since it is also used to implement priority handling	11	since it is also used to implement priority handling
12	(:ref:`VIDIOC_G_PRIORITY`).	12	(:ref:`VIDIOC_G_PRIORITY`).
13		13
@@ -16,11 +16,11 @@ whether a driver uses :c:type:`v4l2_fh` as its ``file->private_data`` pointer · 2 unmodified lines
16	by testing the ``V4L2_FL_USES_V4L2_FH`` bit in :c:type:`video_device`->flags.	16	by testing the ``V4L2_FL_USES_V4L2_FH`` bit in :c:type:`video_device`->flags.
17	This bit is set whenever :c:func:`v4l2_fh_init` is called.	17	This bit is set whenever :c:func:`v4l2_fh_init` is called.
18		18
19	struct :c:type:`v4l2_fh` is allocated as a part of the driver's own file handle	19	struct v4l2_fh is allocated as a part of the driver's own file handle
20	structure and ``file->private_data`` is set to it in the driver's ``open()``	20	structure and ``file->private_data`` is set to it in the driver's ``open()``
21	function by the driver.	21	function by the driver.
22		22
23	In many cases the struct :c:type:`v4l2_fh` will be embedded in a larger	23	In many cases the struct v4l2_fh will be embedded in a larger
24	structure. In that case you should call:	24	structure. In that case you should call:
25		25
26	#) :c:func:`v4l2_fh_init` and :c:func:`v4l2_fh_add` in ``open()``	26	#) :c:func:`v4l2_fh_init` and :c:func:`v4l2_fh_add` in ``open()``
@@ -102,18 +102,18 @@ Below is a short description of the :c:type:`v4l2_fh` functions used: · 75 unmodified lines
102	memory can be freed.	102	memory can be freed.
103		103
104		104
105	If struct :c:type:`v4l2_fh` is not embedded, then you can use these helper functions:	105	If struct v4l2_fh is not embedded, then you can use these helper functions:
106		106
107	:c:func:`v4l2_fh_open <v4l2_fh_open>`	107	:c:func:`v4l2_fh_open <v4l2_fh_open>`
108	(struct file \*filp)	108	(struct file \*filp)
109		109
110	- This allocates a struct :c:type:`v4l2_fh`, initializes it and adds it to	110	- This allocates a struct v4l2_fh, initializes it and adds it to
111	the struct :c:type:`video_device` associated with the file struct.	111	the struct video_device associated with the file struct.
112		112
113	:c:func:`v4l2_fh_release <v4l2_fh_release>`	113	:c:func:`v4l2_fh_release <v4l2_fh_release>`
114	(struct file \*filp)	114	(struct file \*filp)
115		115
116	- This deletes it from the struct :c:type:`video_device` associated with the	116	- This deletes it from the struct video_device associated with the
117	file struct, uninitialised the :c:type:`v4l2_fh` and frees it.	117	file struct, uninitialised the :c:type:`v4l2_fh` and frees it.
118		118
119	These two functions can be plugged into the v4l2_file_operation's ``open()``	119	These two functions can be plugged into the v4l2_file_operation's ``open()``

Documentation/driver-api/media/v4l2-subdev.rst+1−1

@@ -110,7 +110,7 @@ pads: · 109 unmodified lines
110	err = media_entity_pads_init(&sd->entity, npads, pads);	110	err = media_entity_pads_init(&sd->entity, npads, pads);
111		111
112	The pads array must have been previously initialized. There is no need to	112	The pads array must have been previously initialized. There is no need to
113	manually set the struct :c:type:`media_entity` function and name fields, but the	113	manually set the struct media_entity function and name fields, but the
114	revision field must be initialized if needed.	114	revision field must be initialized if needed.
115		115
116	A reference to the entity will be automatically acquired/released when the	116	A reference to the entity will be automatically acquired/released when the

Documentation/driver-api/mei/mei.rst+1−1

@@ -38,7 +38,7 @@ Because some of the Intel ME features can change the system · 37 unmodified lines
38	configuration, the driver by default allows only a privileged	38	configuration, the driver by default allows only a privileged
39	user to access it.	39	user to access it.
40		40
41	The session is terminated calling :c:func:`close(int fd)`.	41	The session is terminated calling :c:expr:`close(fd)`.
42		42
43	A code snippet for an application communicating with Intel AMTHI client:	43	A code snippet for an application communicating with Intel AMTHI client:
44		44

Documentation/driver-api/pm/cpuidle.rst+30−35

 .. SPDX-License-Identifier: GPL-2.0
 .. include:: <isonum.txt>
-.. |struct cpuidle_governor| replace:: :c:type:`struct cpuidle_governor <cpuidle_governor>`
-.. |struct cpuidle_device| replace:: :c:type:`struct cpuidle_device <cpuidle_device>`
-.. |struct cpuidle_driver| replace:: :c:type:`struct cpuidle_driver <cpuidle_driver>`
-.. |struct cpuidle_state| replace:: :c:type:`struct cpuidle_state <cpuidle_state>`
 ========================
 CPU Idle Time Management
 ========================
 operated on by them cannot depend on any hardware architecture or platform
 design details as well.
-The governor itself is represented by a |struct cpuidle_governor| object
+The governor itself is represented by a struct cpuidle_governor object
 containing four callback pointers, :c:member:`enable`, :c:member:`disable`,
 :c:member:`select`, :c:member:`reflect`, a :c:member:`rating` field described
 below, and a name (string) used for identifying it.
 	  int (*enable) (struct cpuidle_driver *drv, struct cpuidle_device *dev);
 	The role of this callback is to prepare the governor for handling the
-	(logical) CPU represented by the |struct cpuidle_device| object	pointed
+	(logical) CPU represented by the struct cpuidle_device object	pointed
-	to by the ``dev`` argument.  The |struct cpuidle_driver| object pointed
+	to by the ``dev`` argument.  The struct cpuidle_driver object pointed
 	to by the ``drv`` argument represents the ``CPUIdle`` driver to be used
 	with that CPU (among other things, it should contain the list of
-	|struct cpuidle_state| objects representing idle states that the
+	struct cpuidle_state objects representing idle states that the
 	processor holding the given CPU can be asked to enter).
 	It may fail, in which case it is expected to return a negative error
 	  void (*disable) (struct cpuidle_driver *drv, struct cpuidle_device *dev);
 	Called to make the governor stop handling the (logical) CPU represented
-	by the |struct cpuidle_device| object pointed to by the ``dev``
+	by the struct cpuidle_device object pointed to by the ``dev``
 	argument.
 	It is expected to reverse any changes made by the ``->enable()``
 	                 bool *stop_tick);
 	Called to select an idle state for the processor holding the (logical)
-	CPU represented by the |struct cpuidle_device| object pointed to by the
+	CPU represented by the struct cpuidle_device object pointed to by the
 	``dev`` argument.
 	The list of idle states to take into consideration is represented by the
-	:c:member:`states` array of |struct cpuidle_state| objects held by the
+	:c:member:`states` array of struct cpuidle_state objects held by the
-	|struct cpuidle_driver| object pointed to by the ``drv`` argument (which
+	struct cpuidle_driver object pointed to by the ``drv`` argument (which
 	represents the ``CPUIdle`` driver to be used with the CPU at hand).  The
 	value returned by this callback is interpreted as an index into that
 	array (unless it is a negative error code).
 	asking the processor to enter the idle state).
 	This callback is mandatory (i.e. the :c:member:`select` callback pointer
-	in |struct cpuidle_governor| must not be ``NULL`` for the registration
+	in struct cpuidle_governor must not be ``NULL`` for the registration
 	of the governor to succeed).
 :c:member:`reflect`
 other parts of ``CPUIdle`` and the hardware.
 First of all, a ``CPUIdle`` driver has to populate the :c:member:`states` array
-of |struct cpuidle_state| objects included in the |struct cpuidle_driver| object
+of struct cpuidle_state objects included in the struct cpuidle_driver object
 representing it.  Going forward this array will represent the list of available
 idle states that the processor hardware can be asked to enter shared by all of
 the logical CPUs handled by the given driver.
 The entries in the :c:member:`states` array are expected to be sorted by the
-value of the :c:member:`target_residency` field in |struct cpuidle_state| in
+value of the :c:member:`target_residency` field in struct cpuidle_state in
 the ascending order (that is, index 0 should correspond to the idle state with
 the minimum value of :c:member:`target_residency`).  [Since the
 :c:member:`target_residency` value is expected to reflect the "depth" of the
-idle state represented by the |struct cpuidle_state| object holding it, this
+idle state represented by the struct cpuidle_state object holding it, this
 sorting order should be the same as the ascending sorting order by the idle
 state "depth".]
-Three fields in |struct cpuidle_state| are used by the existing ``CPUIdle``
+Three fields in struct cpuidle_state are used by the existing ``CPUIdle``
 governors for computations related to idle state selection:
 :c:member:`target_residency`
 	any idle state at all.  [There are other flags used by the ``CPUIdle``
 	core in special situations.]
-The :c:member:`enter` callback pointer in |struct cpuidle_state|, which must not
+The :c:member:`enter` callback pointer in struct cpuidle_state, which must not
 be ``NULL``, points to the routine to execute in order to ask the processor to
 enter this particular idle state:
   void (*enter) (struct cpuidle_device *dev, struct cpuidle_driver *drv,
                  int index);
-The first two arguments of it point to the |struct cpuidle_device| object
+The first two arguments of it point to the struct cpuidle_device object
 representing the logical CPU running this callback and the
-|struct cpuidle_driver| object representing the driver itself, respectively,
+struct cpuidle_driver object representing the driver itself, respectively,
-and the last one is an index of the |struct cpuidle_state| entry in the driver's
+and the last one is an index of the struct cpuidle_state entry in the driver's
 :c:member:`states` array representing the idle state to ask the processor to
 enter.
-The analogous ``->enter_s2idle()`` callback in |struct cpuidle_state| is used
+The analogous ``->enter_s2idle()`` callback in struct cpuidle_state is used
 only for implementing the suspend-to-idle system-wide power management feature.
 The difference between in and ``->enter()`` is that it must not re-enable
 interrupts at any point (even temporarily) or attempt to change the states of
 Once the :c:member:`states` array has been populated, the number of valid
 entries in it has to be stored in the :c:member:`state_count` field of the
-|struct cpuidle_driver| object representing the driver.  Moreover, if any
+struct cpuidle_driver object representing the driver.  Moreover, if any
 entries in the :c:member:`states` array represent "coupled" idle states (that
 is, idle states that can only be asked for if multiple related logical CPUs are
-idle), the :c:member:`safe_state_index` field in |struct cpuidle_driver| needs
+idle), the :c:member:`safe_state_index` field in struct cpuidle_driver needs
 to be the index of an idle state that is not "coupled" (that is, one that can be
 asked for if only one logical CPU is idle).
 In addition to that, if the given ``CPUIdle`` driver is only going to handle a
 subset of logical CPUs in the system, the :c:member:`cpumask` field in its
-|struct cpuidle_driver| object must point to the set (mask) of CPUs that will be
+struct cpuidle_driver object must point to the set (mask) of CPUs that will be
 handled by it.
 A ``CPUIdle`` driver can only be used after it has been registered.  If there
 are no "coupled" idle state entries in the driver's :c:member:`states` array,
-that can be accomplished by passing the driver's |struct cpuidle_driver| object
+that can be accomplished by passing the driver's struct cpuidle_driver object
 to :c:func:`cpuidle_register_driver()`.  Otherwise, :c:func:`cpuidle_register()`
 should be used for this purpose.
-However, it also is necessary to register |struct cpuidle_device| objects for
+However, it also is necessary to register struct cpuidle_device objects for
 all of the logical CPUs to be handled by the given ``CPUIdle`` driver with the
 help of :c:func:`cpuidle_register_device()` after the driver has been registered
 and :c:func:`cpuidle_register_driver()`, unlike :c:func:`cpuidle_register()`,
 does not do that automatically.  For this reason, the drivers that use
 :c:func:`cpuidle_register_driver()` to register themselves must also take care
-of registering the |struct cpuidle_device| objects as needed, so it is generally
+of registering the struct cpuidle_device objects as needed, so it is generally
 recommended to use :c:func:`cpuidle_register()` for ``CPUIdle`` driver
 registration in all cases.
-The registration of a |struct cpuidle_device| object causes the ``CPUIdle``
+The registration of a struct cpuidle_device object causes the ``CPUIdle``
 ``sysfs`` interface to be created and the governor's ``->enable()`` callback to
 be invoked for the logical CPU represented by it, so it must take place after
 registering the driver that will handle the CPU in question.
-``CPUIdle`` drivers and |struct cpuidle_device| objects can be unregistered
+``CPUIdle`` drivers and struct cpuidle_device objects can be unregistered
 when they are not necessary any more which allows some resources associated with
 them to be released.  Due to dependencies between them, all of the
-|struct cpuidle_device| objects representing CPUs handled by the given
+struct cpuidle_device objects representing CPUs handled by the given
 ``CPUIdle`` driver must be unregistered, with the help of
 :c:func:`cpuidle_unregister_device()`, before calling
 :c:func:`cpuidle_unregister_driver()` to unregister the driver.  Alternatively,
 :c:func:`cpuidle_unregister()` can be called to unregister a ``CPUIdle`` driver
-along with all of the |struct cpuidle_device| objects representing CPUs handled
+along with all of the struct cpuidle_device objects representing CPUs handled
 by it.
 ``CPUIdle`` drivers can respond to runtime system configuration changes that
 battery or the other way around).  Upon a notification of such a change,
 a ``CPUIdle`` driver is expected to call :c:func:`cpuidle_pause_and_lock()` to
 turn ``CPUIdle`` off temporarily and then :c:func:`cpuidle_disable_device()` for
-all of the |struct cpuidle_device| objects representing CPUs affected by that
+all of the struct cpuidle_device objects representing CPUs affected by that
 change.  Next, it can update its :c:member:`states` array in accordance with
 the new configuration of the system, call :c:func:`cpuidle_enable_device()` for
-all of the relevant |struct cpuidle_device| objects and invoke
+all of the relevant struct cpuidle_device objects and invoke
 :c:func:`cpuidle_resume_and_unlock()` to allow ``CPUIdle`` to be used again.

Documentation/driver-api/pm/devices.rst+9−17

 .. SPDX-License-Identifier: GPL-2.0
 .. include:: <isonum.txt>
-.. |struct dev_pm_ops| replace:: :c:type:`struct dev_pm_ops <dev_pm_ops>`
-.. |struct dev_pm_domain| replace:: :c:type:`struct dev_pm_domain <dev_pm_domain>`
-.. |struct bus_type| replace:: :c:type:`struct bus_type <bus_type>`
-.. |struct device_type| replace:: :c:type:`struct device_type <device_type>`
-.. |struct class| replace:: :c:type:`struct class <class>`
-.. |struct wakeup_source| replace:: :c:type:`struct wakeup_source <wakeup_source>`
-.. |struct device| replace:: :c:type:`struct device <device>`
 .. _driverapi_pm_devices:
 ==============================
 Device power management operations, at the subsystem level as well as at the
 device driver level, are implemented by defining and populating objects of type
-|struct dev_pm_ops| defined in :file:`include/linux/pm.h`.  The roles of the
+struct dev_pm_ops defined in :file:`include/linux/pm.h`.  The roles of the
 methods included in it will be explained in what follows.  For now, it should be
 sufficient to remember that the last three methods are specific to runtime power
 management while the remaining ones are used during system-wide power
 There also is a deprecated "old" or "legacy" interface for power management
 operations available at least for some subsystems.  This approach does not use
-|struct dev_pm_ops| objects and it is suitable only for implementing system
+struct dev_pm_ops objects and it is suitable only for implementing system
 sleep power management methods in a limited way.  Therefore it is not described
 in this document, so please refer directly to the source code for more
 information about it.
 -----------------------
 The core methods to suspend and resume devices reside in
-|struct dev_pm_ops| pointed to by the :c:member:`ops` member of
+struct dev_pm_ops pointed to by the :c:member:`ops` member of
-|struct dev_pm_domain|, or by the :c:member:`pm` member of |struct bus_type|,
+struct dev_pm_domain, or by the :c:member:`pm` member of struct bus_type,
-|struct device_type| and |struct class|.  They are mostly of interest to the
+struct device_type and struct class.  They are mostly of interest to the
 people writing infrastructure for platforms and buses, like PCI or USB, or
 device type and device class drivers.  They also are relevant to the writers of
 device drivers whose subsystems (PM domains, device types, device classes and
 driver) can physically support wakeup events.  The
 :c:func:`device_set_wakeup_capable()` routine affects this flag.  The
 :c:member:`power.wakeup` field is a pointer to an object of type
-|struct wakeup_source| used for controlling whether or not the device should use
+struct wakeup_source used for controlling whether or not the device should use
 its system wakeup mechanism and for notifying the PM core of system wakeup
 events signaled by the device.  This object is only present for wakeup-capable
 devices (i.e. devices whose :c:member:`can_wakeup` flags are set) and is created
 will also switch off power supplies or reduce voltages.  [Drivers supporting
 runtime PM may already have performed some or all of these steps.]
-If :c:func:`device_may_wakeup(dev)` returns ``true``, the device should be
+If :c:func:`device_may_wakeup()` returns ``true``, the device should be
 prepared for generating hardware wakeup signals to trigger a system wakeup event
 when the system is in the sleep state.  For example, :c:func:`enable_irq_wake()`
 might identify GPIO signals hooked up to a switch or other external hardware,
 sub-domain of the parent domain.
 Support for power domains is provided through the :c:member:`pm_domain` field of
-|struct device|.  This field is a pointer to an object of type
+struct device.  This field is a pointer to an object of type
-|struct dev_pm_domain|, defined in :file:`include/linux/pm.h`, providing a set
+struct dev_pm_domain, defined in :file:`include/linux/pm.h`, providing a set
 of power management callbacks analogous to the subsystem-level and device driver
 callbacks that are executed for the given device during all power transitions,
 instead of the respective subsystem-level callbacks.  Specifically, if a

Documentation/driver-api/regulator.rst+2−2

@@ -116,7 +116,7 @@ core, providing operations structures to the core. A notifier interface · 115 unmodified lines
116	allows error conditions to be reported to the core.	116	allows error conditions to be reported to the core.
117		117
118	Registration should be triggered by explicit setup done by the platform,	118	Registration should be triggered by explicit setup done by the platform,
119	supplying a struct :c:type:`regulator_init_data` for the regulator	119	supplying a struct regulator_init_data for the regulator
120	containing constraint and supply information.	120	containing constraint and supply information.
121		121
122	Machine interface	122	Machine interface
@@ -144,7 +144,7 @@ a given system, for example supporting higher supply voltages than the · 21 unmodified lines
144	consumers are rated for.	144	consumers are rated for.
145		145
146	This is done at driver registration time` by providing a	146	This is done at driver registration time` by providing a
147	struct :c:type:`regulation_constraints`.	147	struct regulation_constraints.
148		148
149	The constraints may also specify an initial configuration for the	149	The constraints may also specify an initial configuration for the
150	regulator in the constraints, which is particularly useful for use with	150	regulator in the constraints, which is particularly useful for use with

Documentation/driver-api/sound.rst+0−54

@@ -1,54 +0,0 @@
1	Sound Devices
2	=============
3
4	.. kernel-doc:: include/sound/core.h
5	:internal:
6
7	.. kernel-doc:: sound/sound_core.c
8	:export:
9
10	.. kernel-doc:: include/sound/pcm.h
11	:internal:
12
13	.. kernel-doc:: sound/core/pcm.c
14	:export:
15
16	.. kernel-doc:: sound/core/device.c
17	:export:
18
19	.. kernel-doc:: sound/core/info.c
20	:export:
21
22	.. kernel-doc:: sound/core/rawmidi.c
23	:export:
24
25	.. kernel-doc:: sound/core/sound.c
26	:export:
27
28	.. kernel-doc:: sound/core/memory.c
29	:export:
30
31	.. kernel-doc:: sound/core/pcm_memory.c
32	:export:
33
34	.. kernel-doc:: sound/core/init.c
35	:export:
36
37	.. kernel-doc:: sound/core/isadma.c
38	:export:
39
40	.. kernel-doc:: sound/core/control.c
41	:export:
42
43	.. kernel-doc:: sound/core/pcm_lib.c
44	:export:
45
46	.. kernel-doc:: sound/core/hwdep.c
47	:export:
48
49	.. kernel-doc:: sound/core/pcm_native.c
50	:export:
51
52	.. kernel-doc:: sound/core/memalloc.c
53	:export:
54

Documentation/driver-api/target.rst+0−12

@@ -41,18 +41,6 @@ iSCSI boot information · 40 unmodified lines
41	.. kernel-doc:: drivers/scsi/iscsi_boot_sysfs.c	41	.. kernel-doc:: drivers/scsi/iscsi_boot_sysfs.c
42	:export:	42	:export:
43		43
44
45	iSCSI transport class
46	=====================
47
48	The file drivers/scsi/scsi_transport_iscsi.c defines transport
49	attributes for the iSCSI class, which sends SCSI packets over TCP/IP
50	connections.
51
52	.. kernel-doc:: drivers/scsi/scsi_transport_iscsi.c
53	:export:
54
55
56	iSCSI TCP interfaces	44	iSCSI TCP interfaces
57	====================	45	====================
58		46

Documentation/driver-api/usb/URB.rst+1−1

@@ -47,7 +47,7 @@ called USB Request Block, or URB for short. · 46 unmodified lines
47	The URB structure	47	The URB structure
48	=================	48	=================
49		49
50	Some of the fields in struct :c:type:`urb` are::	50	Some of the fields in struct urb are::
51		51
52	struct urb	52	struct urb
53	{	53	{

Documentation/driver-api/usb/gadget.rst+5−5

Documentation/driver-api/usb/hotplug.rst+1−1

@@ -122,7 +122,7 @@ and their quirks, might have a MODULE_DEVICE_TABLE like this:: · 121 unmodified lines
122	Most USB device drivers should pass these tables to the USB subsystem as	122	Most USB device drivers should pass these tables to the USB subsystem as
123	well as to the module management subsystem. Not all, though: some driver	123	well as to the module management subsystem. Not all, though: some driver
124	frameworks connect using interfaces layered over USB, and so they won't	124	frameworks connect using interfaces layered over USB, and so they won't
125	need such a struct :c:type:`usb_driver`.	125	need such a struct usb_driver.
126		126
127	Drivers that connect directly to the USB subsystem should be declared	127	Drivers that connect directly to the USB subsystem should be declared
128	something like this::	128	something like this::

Documentation/driver-api/usb/typec_bus.rst+7−1

@@ -91,10 +91,16 @@ their control. · 90 unmodified lines
91	Driver API	91	Driver API
92	----------	92	----------
93		93
		94	Alternate mode structs
		95	~~~~~~~~~~~~~~~~~~~~~~
		96
		97	.. kernel-doc:: include/linux/usb/typec_altmode.h
		98	:functions: typec_altmode_driver typec_altmode_ops
		99
94	Alternate mode driver registering/unregistering	100	Alternate mode driver registering/unregistering
95	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~	101	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
96		102
97	.. kernel-doc:: drivers/usb/typec/bus.c	103	.. kernel-doc:: include/linux/usb/typec_altmode.h
98	:functions: typec_altmode_register_driver typec_altmode_unregister_driver	104	:functions: typec_altmode_register_driver typec_altmode_unregister_driver
99		105
100	Alternate mode driver operations	106	Alternate mode driver operations

Documentation/filesystems/fscrypt.rst+36−38

 The FS_IOC_SET_ENCRYPTION_POLICY ioctl sets an encryption policy on an
 empty directory or verifies that a directory or regular file already
-has the specified encryption policy.  It takes in a pointer to a
+has the specified encryption policy.  It takes in a pointer to
-:c:type:`struct fscrypt_policy_v1` or a :c:type:`struct
+struct fscrypt_policy_v1 or struct fscrypt_policy_v2, defined as
-fscrypt_policy_v2`, defined as follows::
+follows::
     #define FSCRYPT_POLICY_V1               0
     #define FSCRYPT_KEY_DESCRIPTOR_SIZE     8
 This structure must be initialized as follows:
-- ``version`` must be FSCRYPT_POLICY_V1 (0) if the struct is
+- ``version`` must be FSCRYPT_POLICY_V1 (0) if
-  :c:type:`fscrypt_policy_v1` or FSCRYPT_POLICY_V2 (2) if the struct
+  struct fscrypt_policy_v1 is used or FSCRYPT_POLICY_V2 (2) if
-  is :c:type:`fscrypt_policy_v2`.  (Note: we refer to the original
+  struct fscrypt_policy_v2 is used. (Note: we refer to the original
-  policy version as "v1", though its version code is really 0.)  For
+  policy version as "v1", though its version code is really 0.)
-  new encrypted directories, use v2 policies.
+  For new encrypted directories, use v2 policies.
 - ``contents_encryption_mode`` and ``filenames_encryption_mode`` must
   be set to constants from ``<linux/fscrypt.h>`` which identify the
   replaced with ``master_key_identifier``, which is longer and cannot
   be arbitrarily chosen.  Instead, the key must first be added using
   `FS_IOC_ADD_ENCRYPTION_KEY`_.  Then, the ``key_spec.u.identifier``
-  the kernel returned in the :c:type:`struct fscrypt_add_key_arg` must
+  the kernel returned in the struct fscrypt_add_key_arg must
-  be used as the ``master_key_identifier`` in the :c:type:`struct
+  be used as the ``master_key_identifier`` in
-  fscrypt_policy_v2`.
+  struct fscrypt_policy_v2.
 If the file is not yet encrypted, then FS_IOC_SET_ENCRYPTION_POLICY
 verifies that the file is an empty directory.  If so, the specified
 The FS_IOC_GET_ENCRYPTION_POLICY_EX ioctl retrieves the encryption
 policy, if any, for a directory or regular file.  No additional
 permissions are required beyond the ability to open the file.  It
-takes in a pointer to a :c:type:`struct fscrypt_get_policy_ex_arg`,
+takes in a pointer to struct fscrypt_get_policy_ex_arg,
 defined as follows::
     struct fscrypt_get_policy_ex_arg {
 encryption policy, if any, for a directory or regular file.  However,
 unlike `FS_IOC_GET_ENCRYPTION_POLICY_EX`_,
 FS_IOC_GET_ENCRYPTION_POLICY only supports the original policy
-version.  It takes in a pointer directly to a :c:type:`struct
+version.  It takes in a pointer directly to struct fscrypt_policy_v1
-fscrypt_policy_v1` rather than a :c:type:`struct
+rather than struct fscrypt_get_policy_ex_arg.
-fscrypt_get_policy_ex_arg`.
 The error codes for FS_IOC_GET_ENCRYPTION_POLICY are the same as those
 for FS_IOC_GET_ENCRYPTION_POLICY_EX, except that
 encrypted using that key appear "unlocked", i.e. in plaintext form.
 It can be executed on any file or directory on the target filesystem,
 but using the filesystem's root directory is recommended.  It takes in
-a pointer to a :c:type:`struct fscrypt_add_key_arg`, defined as
+a pointer to struct fscrypt_add_key_arg, defined as follows::
-follows::
     struct fscrypt_add_key_arg {
             struct fscrypt_key_specifier key_spec;
             __u8 raw[];
     };
-:c:type:`struct fscrypt_add_key_arg` must be zeroed, then initialized
+struct fscrypt_add_key_arg must be zeroed, then initialized
 as follows:
 - If the key is being added for use by v1 encryption policies, then
   ``key_spec.type`` must contain FSCRYPT_KEY_SPEC_TYPE_DESCRIPTOR, and
   ``key_spec.u.descriptor`` must contain the descriptor of the key
   being added, corresponding to the value in the
-  ``master_key_descriptor`` field of :c:type:`struct
+  ``master_key_descriptor`` field of struct fscrypt_policy_v1.
-  fscrypt_policy_v1`.  To add this type of key, the calling process
+  To add this type of key, the calling process must have the
-  must have the CAP_SYS_ADMIN capability in the initial user
+  CAP_SYS_ADMIN capability in the initial user namespace.
-  namespace.
   Alternatively, if the key is being added for use by v2 encryption
   policies, then ``key_spec.type`` must contain
 - ``key_id`` is 0 if the raw key is given directly in the ``raw``
   field.  Otherwise ``key_id`` is the ID of a Linux keyring key of
-  type "fscrypt-provisioning" whose payload is a :c:type:`struct
+  type "fscrypt-provisioning" whose payload is
-  fscrypt_provisioning_key_payload` whose ``raw`` field contains the
+  struct fscrypt_provisioning_key_payload whose ``raw`` field contains
-  raw key and whose ``type`` field matches ``key_spec.type``.  Since
+  the raw key and whose ``type`` field matches ``key_spec.type``.
-  ``raw`` is variable-length, the total size of this key's payload
+  Since ``raw`` is variable-length, the total size of this key's
-  must be ``sizeof(struct fscrypt_provisioning_key_payload)`` plus the
+  payload must be ``sizeof(struct fscrypt_provisioning_key_payload)``
-  raw key size.  The process must have Search permission on this key.
+  plus the raw key size.  The process must have Search permission on
+  this key.
   Most users should leave this 0 and specify the raw key directly.
   The support for specifying a Linux keyring key is intended mainly to
 encryption key from the filesystem, and possibly removes the key
 itself.  It can be executed on any file or directory on the target
 filesystem, but using the filesystem's root directory is recommended.
-It takes in a pointer to a :c:type:`struct fscrypt_remove_key_arg`,
+It takes in a pointer to struct fscrypt_remove_key_arg, defined
-defined as follows::
+as follows::
     struct fscrypt_remove_key_arg {
             struct fscrypt_key_specifier key_spec;
 The FS_IOC_GET_ENCRYPTION_KEY_STATUS ioctl retrieves the status of a
 master encryption key.  It can be executed on any file or directory on
 the target filesystem, but using the filesystem's root directory is
-recommended.  It takes in a pointer to a :c:type:`struct
+recommended.  It takes in a pointer to
-fscrypt_get_key_status_arg`, defined as follows::
+struct fscrypt_get_key_status_arg, defined as follows::
     struct fscrypt_get_key_status_arg {
             /* input */
 Encryption context
 ------------------
-An encryption policy is represented on-disk by a :c:type:`struct
+An encryption policy is represented on-disk by
-fscrypt_context_v1` or a :c:type:`struct fscrypt_context_v2`.  It is
+struct fscrypt_context_v1 or struct fscrypt_context_v2.  It is up to
-up to individual filesystems to decide where to store it, but normally
+individual filesystems to decide where to store it, but normally it
-it would be stored in a hidden extended attribute.  It should *not* be
+would be stored in a hidden extended attribute.  It should *not* be
 exposed by the xattr-related system calls such as getxattr() and
 setxattr() because of the special semantics of the encryption xattr.
 (In particular, there would be much confusion if an encryption policy
 filesystem-specific hash(es) needed for directory lookups.  This
 allows the filesystem to still, with a high degree of confidence, map
 the filename given in ->lookup() back to a particular directory entry
-that was previously listed by readdir().  See :c:type:`struct
+that was previously listed by readdir().  See
-fscrypt_nokey_name` in the source for more details.
+struct fscrypt_nokey_name in the source for more details.
 Note that the precise way that filenames are presented to userspace
 without the key is subject to change in the future.  It is only meant

Documentation/filesystems/fsverity.rst+1−1

@@ -84,7 +84,7 @@ FS_IOC_ENABLE_VERITY · 83 unmodified lines
84	--------------------	84	--------------------
85		85
86	The FS_IOC_ENABLE_VERITY ioctl enables fs-verity on a file. It takes	86	The FS_IOC_ENABLE_VERITY ioctl enables fs-verity on a file. It takes
87	in a pointer to a :c:type:`struct fsverity_enable_arg`, defined as	87	in a pointer to a struct fsverity_enable_arg, defined as
88	follows::	88	follows::
89		89
90	struct fsverity_enable_arg {	90	struct fsverity_enable_arg {

Documentation/gpu/i915.rst+25−4

@@ -636,15 +636,36 @@ i915 Perf Observation Architecture Stream · 635 unmodified lines
636	.. kernel-doc:: drivers/gpu/drm/i915/i915_perf.c	636	.. kernel-doc:: drivers/gpu/drm/i915/i915_perf.c
637	:functions: i915_oa_poll_wait	637	:functions: i915_oa_poll_wait
638		638
639	All i915 Perf Internals	639	Other i915 Perf Internals
640	-----------------------	640	-------------------------
641		641
642	This section simply includes all currently documented i915 perf internals, in	642	This section simply includes all other currently documented i915 perf internals,
643	no particular order, but may include some more minor utilities or platform	643	in no particular order, but may include some more minor utilities or platform
644	specific details than found in the more high-level sections.	644	specific details than found in the more high-level sections.
645		645
646	.. kernel-doc:: drivers/gpu/drm/i915/i915_perf.c	646	.. kernel-doc:: drivers/gpu/drm/i915/i915_perf.c
647	:internal:	647	:internal:
		648	:no-identifiers:
		649	i915_perf_init
		650	i915_perf_fini
		651	i915_perf_register
		652	i915_perf_unregister
		653	i915_perf_open_ioctl
		654	i915_perf_release
		655	i915_perf_add_config_ioctl
		656	i915_perf_remove_config_ioctl
		657	read_properties_unlocked
		658	i915_perf_open_ioctl_locked
		659	i915_perf_destroy_locked
		660	i915_perf_read i915_perf_ioctl
		661	i915_perf_enable_locked
		662	i915_perf_disable_locked
		663	i915_perf_poll i915_perf_poll_locked
		664	i915_oa_stream_init i915_oa_read
		665	i915_oa_stream_enable
		666	i915_oa_stream_disable
		667	i915_oa_wait_unlocked
		668	i915_oa_poll_wait
648		669
649	Style	670	Style
650	=====	671	=====

Documentation/networking/ieee802154.rst+10−8

 Socket API
 ==========
-.. c:function:: int sd = socket(PF_IEEE802154, SOCK_DGRAM, 0);
+::
+    int sd = socket(PF_IEEE802154, SOCK_DGRAM, 0);
 The address family, socket addresses etc. are defined in the
 include/net/af_ieee802154.h header or in the special header
 Freeing registered PHY.
-.. c:function:: void ieee802154_rx_irqsafe(struct ieee802154_hw *hw, struct sk_buff *skb, u8 lqi):
+.. c:function:: void ieee802154_rx_irqsafe(struct ieee802154_hw *hw, struct sk_buff *skb, u8 lqi)
 Telling 802.15.4 module there is a new received frame in the skb with
 the RF Link Quality Indicator (LQI) from the hardware device.
-.. c:function:: void ieee802154_xmit_complete(struct ieee802154_hw *hw, struct sk_buff *skb, bool ifs_handling):
+.. c:function:: void ieee802154_xmit_complete(struct ieee802154_hw *hw, struct sk_buff *skb, bool ifs_handling)
 Telling 802.15.4 module the frame in the skb is or going to be
 transmitted through the hardware device
         ...
    };
-.. c:function:: int start(struct ieee802154_hw *hw):
+.. c:function:: int start(struct ieee802154_hw *hw)
 Handler that 802.15.4 module calls for the hardware device initialization.
-.. c:function:: void stop(struct ieee802154_hw *hw):
+.. c:function:: void stop(struct ieee802154_hw *hw)
 Handler that 802.15.4 module calls for the hardware device cleanup.
-.. c:function:: int xmit_async(struct ieee802154_hw *hw, struct sk_buff *skb):
+.. c:function:: int xmit_async(struct ieee802154_hw *hw, struct sk_buff *skb)
 Handler that 802.15.4 module calls for each frame in the skb going to be
 transmitted through the hardware device.
-.. c:function:: int ed(struct ieee802154_hw *hw, u8 *level):
+.. c:function:: int ed(struct ieee802154_hw *hw, u8 *level)
 Handler that 802.15.4 module calls for Energy Detection from the hardware
 device.
-.. c:function:: int set_channel(struct ieee802154_hw *hw, u8 page, u8 channel):
+.. c:function:: int set_channel(struct ieee802154_hw *hw, u8 page, u8 channel)
 Set radio for listening on specific channel of the hardware device.

Documentation/powerpc/syscall64-abi.rst+16−16

@@ -49,22 +49,22 @@ Register preservation rules · 48 unmodified lines
49	Register preservation rules match the ELF ABI calling sequence with the	49	Register preservation rules match the ELF ABI calling sequence with the
50	following differences:	50	following differences:
51		51
52	--- For the sc instruction, differences with the ELF ABI ---	52	+------------------------------------------------------------------------+
53	=========== ============= ========================================	53	\| For the sc instruction, differences with the ELF ABI \|
54	r0 Volatile (System call number.)	54	+--------------+--------------+------------------------------------------+
55	r3 Volatile (Parameter 1, and return value.)	55	\| r0 \| Volatile \| (System call number.) \|
56	r4-r8 Volatile (Parameters 2-6.)	56	\| rr3 \| Volatile \| (Parameter 1, and return value.) \|
57	cr0 Volatile (cr0.SO is the return error condition.)	57	\| rr4-r8 \| Volatile \| (Parameters 2-6.) \|
58	cr1, cr5-7 Nonvolatile	58	\| rcr0 \| Volatile \| (cr0.SO is the return error condition.) \|
59	lr Nonvolatile	59	\| rcr1, cr5-7 \| Nonvolatile \| \|
60	=========== ============= ========================================	60	\| rlr \| Nonvolatile \| \|
61		61	+--------------+--------------+------------------------------------------+
62	--- For the scv 0 instruction, differences with the ELF ABI ---	62	\| For the scv 0 instruction, differences with the ELF ABI \|
63	=========== ============= ========================================	63	+--------------+--------------+------------------------------------------+
64	r0 Volatile (System call number.)	64	\| r0 \| Volatile \| (System call number.) \|
65	r3 Volatile (Parameter 1, and return value.)	65	\| r3 \| Volatile \| (Parameter 1, and return value.) \|
66	r4-r8 Volatile (Parameters 2-6.)	66	\| r4-r8 \| Volatile \| (Parameters 2-6.) \|
67	=========== ============= ========================================	67	+--------------+--------------+------------------------------------------+
68		68
69	All floating point and vector data registers as well as control and status	69	All floating point and vector data registers as well as control and status
70	registers are nonvolatile.	70	registers are nonvolatile.

Documentation/sound/designs/tracepoints.rst+11−11

@@ -34,20 +34,20 @@ substream. In this procedure, PCM hardware parameters are decided by · 33 unmodified lines
34	interaction between applications and ALSA PCM core. Once decided, runtime of	34	interaction between applications and ALSA PCM core. Once decided, runtime of
35	the PCM substream keeps the parameters.	35	the PCM substream keeps the parameters.
36		36
37	The parameters are described in :c:type:`struct snd_pcm_hw_params`. This	37	The parameters are described in struct snd_pcm_hw_params. This
38	structure includes several types of parameters. Applications set preferable	38	structure includes several types of parameters. Applications set preferable
39	value to these parameters, then execute ioctl(2) with SNDRV_PCM_IOCTL_HW_REFINE	39	value to these parameters, then execute ioctl(2) with SNDRV_PCM_IOCTL_HW_REFINE
40	or SNDRV_PCM_IOCTL_HW_PARAMS. The former is used just for refining available	40	or SNDRV_PCM_IOCTL_HW_PARAMS. The former is used just for refining available
41	set of parameters. The latter is used for an actual decision of the parameters.	41	set of parameters. The latter is used for an actual decision of the parameters.
42		42
43	The :c:type:`struct snd_pcm_hw_params` structure has below members:	43	The struct snd_pcm_hw_params structure has below members:
44		44
45	``flags``	45	``flags``
46	Configurable. ALSA PCM core and some drivers handle this flag to select	46	Configurable. ALSA PCM core and some drivers handle this flag to select
47	convenient parameters or change their behaviour.	47	convenient parameters or change their behaviour.
48	``masks``	48	``masks``
49	Configurable. This type of parameter is described in	49	Configurable. This type of parameter is described in
50	:c:type:`struct snd_mask` and represent mask values. As of PCM protocol	50	struct snd_mask and represent mask values. As of PCM protocol
51	v2.0.13, three types are defined.	51	v2.0.13, three types are defined.
52		52
53	- SNDRV_PCM_HW_PARAM_ACCESS	53	- SNDRV_PCM_HW_PARAM_ACCESS
@@ -55,7 +55,7 @@ The :c:type:`struct snd_pcm_hw_params` structure has below members: · 1 unmodified line
55	- SNDRV_PCM_HW_PARAM_SUBFORMAT	55	- SNDRV_PCM_HW_PARAM_SUBFORMAT
56	``intervals``	56	``intervals``
57	Configurable. This type of parameter is described in	57	Configurable. This type of parameter is described in
58	:c:type:`struct snd_interval` and represent values with a range. As of	58	struct snd_interval and represent values with a range. As of
59	PCM protocol v2.0.13, twelve types are defined.	59	PCM protocol v2.0.13, twelve types are defined.
60		60
61	- SNDRV_PCM_HW_PARAM_SAMPLE_BITS	61	- SNDRV_PCM_HW_PARAM_SAMPLE_BITS
@@ -78,7 +78,7 @@ The :c:type:`struct snd_pcm_hw_params` structure has below members: · 16 unmodified lines
78	are going to be changed.	78	are going to be changed.
79	``cmask``	79	``cmask``
80	Read-only. After returning from ioctl(2), buffer in user space for	80	Read-only. After returning from ioctl(2), buffer in user space for
81	:c:type:`struct snd_pcm_hw_params` includes result of each operation.	81	struct snd_pcm_hw_params includes result of each operation.
82	This mask represents which mask/interval parameter is actually changed.	82	This mask represents which mask/interval parameter is actually changed.
83	``info``	83	``info``
84	Read-only. This represents hardware/driver capabilities as bit flags	84	Read-only. This represents hardware/driver capabilities as bit flags
@@ -110,10 +110,10 @@ The :c:type:`struct snd_pcm_hw_params` structure has below members: · 25 unmodified lines
110	value to this parameter but some drivers intentionally set zero with	110	value to this parameter but some drivers intentionally set zero with
111	a care of hardware design or data transmission protocol.	111	a care of hardware design or data transmission protocol.
112		112
113	ALSA PCM core handles buffer of :c:type:`struct snd_pcm_hw_params` when	113	ALSA PCM core handles buffer of struct snd_pcm_hw_params when
114	applications execute ioctl(2) with SNDRV_PCM_HW_REFINE or SNDRV_PCM_HW_PARAMS.	114	applications execute ioctl(2) with SNDRV_PCM_HW_REFINE or SNDRV_PCM_HW_PARAMS.
115	Parameters in the buffer are changed according to	115	Parameters in the buffer are changed according to
116	:c:type:`struct snd_pcm_hardware` and rules of constraints in the runtime. The	116	struct snd_pcm_hardware and rules of constraints in the runtime. The
117	structure describes capabilities of handled hardware. The rules describes	117	structure describes capabilities of handled hardware. The rules describes
118	dependencies on which a parameter is decided according to several parameters.	118	dependencies on which a parameter is decided according to several parameters.
119	A rule has a callback function, and drivers can register arbitrary functions	119	A rule has a callback function, and drivers can register arbitrary functions
@@ -121,17 +121,17 @@ to compute the target parameter. ALSA PCM core registers some rules to the · 1 unmodified line
121	runtime as a default.	121	runtime as a default.
122		122
123	Each driver can join in the interaction as long as it prepared for two stuffs	123	Each driver can join in the interaction as long as it prepared for two stuffs
124	in a callback of :c:type:`struct snd_pcm_ops.open`.	124	in a callback of struct snd_pcm_ops.open.
125		125
126	1. In the callback, drivers are expected to change a member of	126	1. In the callback, drivers are expected to change a member of
127	:c:type:`struct snd_pcm_hardware` type in the runtime, according to	127	struct snd_pcm_hardware type in the runtime, according to
128	capacities of corresponding hardware.	128	capacities of corresponding hardware.
129	2. In the same callback, drivers are also expected to register additional rules	129	2. In the same callback, drivers are also expected to register additional rules
130	of constraints into the runtime when several parameters have dependencies	130	of constraints into the runtime when several parameters have dependencies
131	due to hardware design.	131	due to hardware design.
132		132
133	The driver can refers to result of the interaction in a callback of	133	The driver can refers to result of the interaction in a callback of
134	:c:type:`struct snd_pcm_ops.hw_params`, however it should not change the	134	struct snd_pcm_ops.hw_params, however it should not change the
135	content.	135	content.
136		136
137	Tracepoints in this category are designed to trace changes of the	137	Tracepoints in this category are designed to trace changes of the
@@ -163,7 +163,7 @@ fields are different according to type of the parameter. For parameters of mask · 25 unmodified lines
163	type, the fields represent hexadecimal dump of content of the parameter. For	163	type, the fields represent hexadecimal dump of content of the parameter. For
164	parameters of interval type, the fields represent values of each member of	164	parameters of interval type, the fields represent values of each member of
165	``empty``, ``integer``, ``openmin``, ``min``, ``max``, ``openmax`` in	165	``empty``, ``integer``, ``openmin``, ``min``, ``max``, ``openmax`` in
166	:c:type:`struct snd_interval` in this order.	166	struct snd_interval in this order.
167		167
168	Tracepoints in drivers	168	Tracepoints in drivers
169	======================	169	======================

Documentation/sound/kernel-api/alsa-driver-api.rst+1−0

@@ -132,3 +132,4 @@ ISA DMA Helpers · 131 unmodified lines
132	Other Helper Macros	132	Other Helper Macros
133	-------------------	133	-------------------
134	.. kernel-doc:: include/sound/core.h	134	.. kernel-doc:: include/sound/core.h
		135	.. kernel-doc:: sound/sound_core.c

Documentation/sound/kernel-api/writing-an-alsa-driver.rst+49−61

 -  create ``remove`` callback.
--  create a :c:type:`struct pci_driver <pci_driver>` structure
+-  create a struct pci_driver structure
    containing the three pointers above.
 -  create an ``init`` function just calling the
 the ALSA middle layer will release all the attached components
 automatically.
-It would be typically just :c:func:`calling snd_card_free()`:
+It would be typically just calling :c:func:`snd_card_free()`:
 ::
 card->private_data for the chip-specific data. Note that these data are
 allocated by :c:func:`snd_card_new()`.
-The first argument, the pointer of struct :c:type:`struct device
+The first argument, the pointer of struct device, specifies the parent
-<device>`, specifies the parent device. For PCI devices, typically
+device. For PCI devices, typically ``&pci->`` is passed there.
-``&pci->`` is passed there.
 Components
 ----------
 After the card is created, you can attach the components (devices) to
 the card instance. In an ALSA driver, a component is represented as a
-:c:type:`struct snd_device <snd_device>` object. A component
+struct snd_device object. A component
 can be a PCM instance, a control interface, a raw MIDI interface, etc.
 Each such instance has one component entry.
   err = snd_card_new(&pci->dev, index[dev], id[dev], THIS_MODULE,
                      sizeof(struct mychip), &card);
-:c:type:`struct mychip <mychip>` is the type of the chip record.
+struct mychip is the type of the chip record.
 In return, the allocated record can be accessed as
 function (see below).
 Now assume that the PCI device has an I/O port with 8 bytes and an
-interrupt. Then :c:type:`struct mychip <mychip>` will have the
+interrupt. Then struct mychip will have the
 following fields:
 ::
 -----------
 So far, so good. Let's finish the missing PCI stuff. At first, we need a
-:c:type:`struct pci_device_id <pci_device_id>` table for
+struct pci_device_id table for
 this chipset. It's a table of PCI vendor/device ID number, and some
 masks.
   };
   MODULE_DEVICE_TABLE(pci, snd_mychip_ids);
-The first and second fields of the :c:type:`struct pci_device_id
+The first and second fields of the struct pci_device_id are the vendor
-<pci_device_id>` structure are the vendor and device IDs. If you
+and device IDs. If you have no reason to filter the matching devices, you can
-have no reason to filter the matching devices, you can leave the
+leave the remaining fields as above. The last field of the
-remaining fields as above. The last field of the :c:type:`struct
+struct pci_device_id contains private data for this entry. You can specify
-pci_device_id <pci_device_id>` struct contains private data
+any value here, for example, to define specific operations for supported
-for this entry. You can specify any value here, for example, to define
+device IDs. Such an example is found in the intel8x0 driver.
-specific operations for supported device IDs. Such an example is found
-in the intel8x0 driver.
 The last entry of this list is the terminator. You must specify this
 all-zero entry.
-Then, prepare the :c:type:`struct pci_driver <pci_driver>`
+Then, prepare the struct pci_driver
 record:
 ::
 If a chip supports multiple playbacks or captures, you can specify more
 numbers, but they must be handled properly in open/close, etc.
 callbacks. When you need to know which substream you are referring to,
-then it can be obtained from :c:type:`struct snd_pcm_substream
+then it can be obtained from struct snd_pcm_substream data passed to each
-<snd_pcm_substream>` data passed to each callback as follows:
+callback as follows:
 ::
 Hardware Description
 ~~~~~~~~~~~~~~~~~~~~
-The hardware descriptor (:c:type:`struct snd_pcm_hardware
+The hardware descriptor (struct snd_pcm_hardware) contains the definitions of
-<snd_pcm_hardware>`) contains the definitions of the fundamental
+the fundamental hardware configuration. Above all, you'll need to define this
-hardware configuration. Above all, you'll need to define this in the
+in the `PCM open callback`_. Note that the runtime instance holds the copy of
-`PCM open callback`_. Note that the runtime instance holds the copy of
 the descriptor, not the pointer to the existing descriptor. That is,
 in the open callback, you can modify the copied descriptor
 (``runtime->hw``) as you need. For example, if the maximum number of
 ~~~~~~~~~~~~~~
 The running status can be referred via ``runtime->status``. This is
-the pointer to the :c:type:`struct snd_pcm_mmap_status
+the pointer to the struct snd_pcm_mmap_status record.
-<snd_pcm_mmap_status>` record. For example, you can get the current
+For example, you can get the current
 DMA hardware pointer via ``runtime->status->hw_ptr``.
 The DMA application pointer can be referred via ``runtime->control``,
-which points to the :c:type:`struct snd_pcm_mmap_control
+which points to the struct snd_pcm_mmap_control record.
-<snd_pcm_mmap_control>` record. However, accessing directly to
+However, accessing directly to this value is not recommended.
-this value is not recommended.
 Private Data
 ~~~~~~~~~~~~
 number, it is advised to check what value other parts of the kernel
 return when the same kind of request fails.
-The callback function takes at least the argument with :c:type:`struct
+The callback function takes at least the argument with
-snd_pcm_substream <snd_pcm_substream>` pointer. To retrieve the chip
+struct snd_pcm_substream pointer. To retrieve the chip
 record from the given substream instance, you can use the following
 macro.
 :c:func:`snd_pcm_period_elapsed()` is called typically from the
 interrupt handler. But, if you set up the driver to use a threaded
 interrupt handler, this call can be in non-atomic context, too. In such
-a case, you can set ``nonatomic`` filed of :c:type:`struct snd_pcm
+a case, you can set ``nonatomic`` filed of struct snd_pcm object
-<snd_pcm>` object after creating it. When this flag is set, mutex
+after creating it. When this flag is set, mutex and rwsem are used internally
-and rwsem are used internally in the PCM core instead of spin and
+in the PCM core instead of spin and rwlocks, so that you can call all PCM
-rwlocks, so that you can call all PCM functions safely in a non-atomic
+functions safely in a non-atomic
 context.
 Constraints
 complete list. You can even define your own constraint rules. For
 example, let's suppose my_chip can manage a substream of 1 channel if
 and only if the format is ``S16_LE``, otherwise it supports any format
-specified in the :c:type:`struct snd_pcm_hardware
+specified in struct snd_pcm_hardware> (or in any other
-<snd_pcm_hardware>` structure (or in any other
 constraint_list). You can build a rule like this:
 ::
 To create a new control, you need to define the following three
 callbacks: ``info``, ``get`` and ``put``. Then, define a
-:c:type:`struct snd_kcontrol_new <snd_kcontrol_new>` record, such as:
+struct snd_kcontrol_new record, such as:
 ::
 ~~~~~~~~~~~~~
 The ``info`` callback is used to get detailed information on this
-control. This must store the values of the given :c:type:`struct
+control. This must store the values of the given
-snd_ctl_elem_info <snd_ctl_elem_info>` object. For example,
+struct snd_ctl_elem_info object. For example,
 for a boolean control with a single element:
 ::
   if (err < 0)
           return err;
-where ``my_control`` is the :c:type:`struct snd_kcontrol_new
+where ``my_control`` is the struct snd_kcontrol_new object defined above,
-<snd_kcontrol_new>` object defined above, and chip is the object
+and chip is the object pointer to be passed to kcontrol->private_data which
-pointer to be passed to kcontrol->private_data which can be referred
+can be referred to in callbacks.
-to in callbacks.
-:c:func:`snd_ctl_new1()` allocates a new :c:type:`struct
+:c:func:`snd_ctl_new1()` allocates a new struct snd_kcontrol instance, and
-snd_kcontrol <snd_kcontrol>` instance, and
 :c:func:`snd_ctl_add()` assigns the given control component to the
 card.
 This function takes the card pointer, the event-mask, and the control id
 pointer for the notification. The event-mask specifies the types of
 notification, for example, in the above example, the change of control
-values is notified. The id pointer is the pointer of :c:type:`struct
+values is notified. The id pointer is the pointer of struct snd_ctl_elem_id
-snd_ctl_elem_id <snd_ctl_elem_id>` to be notified. You can
+to be notified. You can find some examples in ``es1938.c`` or ``es1968.c``
-find some examples in ``es1938.c`` or ``es1968.c`` for hardware volume
+for hardware volume interrupts.
-interrupts.
 Metadata
 --------
 The bus record is shared among all belonging ac97 instances.
-And then call :c:func:`snd_ac97_mixer()` with an :c:type:`struct
+And then call :c:func:`snd_ac97_mixer()` with an struct snd_ac97_template
-snd_ac97_template <snd_ac97_template>` record together with
+record together with the bus pointer created above.
-the bus pointer created above.
 ::
 Usually, the port address corresponds to the command port and port + 1
 corresponds to the data port. If not, you may change the ``cport``
-field of :c:type:`struct snd_mpu401 <snd_mpu401>` manually afterward.
+field of struct snd_mpu401 manually afterward.
-However, :c:type:`struct snd_mpu401 <snd_mpu401>` pointer is
+However, struct snd_mpu401 pointer is
 not returned explicitly by :c:func:`snd_mpu401_uart_new()`. You
-need to cast ``rmidi->private_data`` to :c:type:`struct snd_mpu401
+need to cast ``rmidi->private_data`` to struct snd_mpu401 explicitly,
-<snd_mpu401>` explicitly,
 ::
   }
 If you know beforehand how many bytes you can accept, you can use a
-buffer size greater than one with the
+buffer size greater than one with the ``snd_rawmidi_transmit*()`` functions.
-:c:func:`snd_rawmidi_transmit\*()` functions.
 The ``trigger`` callback must not sleep. If the hardware FIFO is full
 before the substream buffer has been emptied, you have to continue
 :c:func:`snd_pcm_set_managed_buffer_all()` with
 ``SNDRV_DMA_TYPE_DEV_SG`` in the PCM constructor like other PCI
 pre-allocator. You need to pass ``&pci->dev``, where pci is
-the :c:type:`struct pci_dev <pci_dev>` pointer of the chip as
+the struct pci_dev pointer of the chip as
 well.
 ::
 The read/write callbacks of raw mode are more direct than the text mode.
 You need to use a low-level I/O functions such as
-:c:func:`copy_from/to_user()` to transfer the data.
+:c:func:`copy_from_user()` and :c:func:`copy_to_user()` to transfer the data.
 ::

Documentation/sphinx/automarkup.py+97−11

@@ -22,13 +22,34 @@ from itertools import chain · 21 unmodified lines
22	# :c:func: block (i.e. ":c:func:`mmap()`s" flakes out), so the last	22	# :c:func: block (i.e. ":c:func:`mmap()`s" flakes out), so the last
23	# bit tries to restrict matches to things that won't create trouble.	23	# bit tries to restrict matches to things that won't create trouble.
24	#	24	#
25	RE_function = re.compile(r'(([\w_][\w\d_]+))')	25	RE_function = re.compile(r'\b(([a-zA-Z_]\w+))', flags=re.ASCII)
26	RE_type = re.compile(r'(struct\|union\|enum\|typedef)\s+([\w_][\w\d_]+)')	26
		27	#
		28	# Sphinx 2 uses the same :c:type role for struct, union, enum and typedef
		29	#
		30	RE_generic_type = re.compile(r'\b(struct\|union\|enum\|typedef)\s+([a-zA-Z_]\w+)',
		31	flags=re.ASCII)
		32
		33	#
		34	# Sphinx 3 uses a different C role for each one of struct, union, enum and
		35	# typedef
		36	#
		37	RE_struct = re.compile(r'\b(struct)\s+([a-zA-Z_]\w+)', flags=re.ASCII)
		38	RE_union = re.compile(r'\b(union)\s+([a-zA-Z_]\w+)', flags=re.ASCII)
		39	RE_enum = re.compile(r'\b(enum)\s+([a-zA-Z_]\w+)', flags=re.ASCII)
		40	RE_typedef = re.compile(r'\b(typedef)\s+([a-zA-Z_]\w+)', flags=re.ASCII)
		41
27	#	42	#
28	# Detects a reference to a documentation page of the form Documentation/... with	43	# Detects a reference to a documentation page of the form Documentation/... with
29	# an optional extension	44	# an optional extension
30	#	45	#
31	RE_doc = re.compile(r'Documentation(/[\w\-_/]+)(\.\w+)*')	46	RE_doc = re.compile(r'\bDocumentation(/[\w\-_/]+)(\.\w+)*')
		47
		48	#
		49	# Reserved C words that we should skip when cross-referencing
		50	#
		51	Skipnames = [ 'for', 'if', 'register', 'sizeof', 'struct', 'unsigned' ]
		52
32		53
33	#	54	#
34	# Many places in the docs refer to common system calls. It is	55	# Many places in the docs refer to common system calls. It is
@@ -48,9 +69,22 @@ def markup_refs(docname, app, node): · 13 unmodified lines
48	#	69	#
49	# Associate each regex with the function that will markup its matches	70	# Associate each regex with the function that will markup its matches
50	#	71	#
51	markup_func = {RE_type: markup_c_ref,	72	markup_func_sphinx2 = {RE_doc: markup_doc_ref,
52	RE_function: markup_c_ref,	73	RE_function: markup_c_ref,
53	RE_doc: markup_doc_ref}	74	RE_generic_type: markup_c_ref}
		75
		76	markup_func_sphinx3 = {RE_doc: markup_doc_ref,
		77	RE_function: markup_func_ref_sphinx3,
		78	RE_struct: markup_c_ref,
		79	RE_union: markup_c_ref,
		80	RE_enum: markup_c_ref,
		81	RE_typedef: markup_c_ref}
		82
		83	if sphinx.version_info[0] >= 3:
		84	markup_func = markup_func_sphinx3
		85	else:
		86	markup_func = markup_func_sphinx2
		87
54	match_iterators = [regex.finditer(t) for regex in markup_func]	88	match_iterators = [regex.finditer(t) for regex in markup_func]
55	#	89	#
56	# Sort all references by the starting position in text	90	# Sort all references by the starting position in text
@@ -75,12 +109,63 @@ def markup_refs(docname, app, node): · 18 unmodified lines
75	return repl	109	return repl
76		110
77	#	111	#
78	# Try to replace a C reference (function() or struct/union/enum/typedef	112	# In sphinx3 we can cross-reference to C macro and function, each one with its
79	# type_name) with an appropriate cross reference.	113	# own C role, but both match the same regex, so we try both.
80	#	114	#
		115	def markup_func_ref_sphinx3(docname, app, match):
		116	class_str = ['c-func', 'c-macro']
		117	reftype_str = ['function', 'macro']
		118
		119	cdom = app.env.domains['c']
		120	#
		121	# Go through the dance of getting an xref out of the C domain
		122	#
		123	target = match.group(2)
		124	target_text = nodes.Text(match.group(0))
		125	xref = None
		126	if not (target in Skipfuncs or target in Skipnames):
		127	for class_s, reftype_s in zip(class_str, reftype_str):
		128	lit_text = nodes.literal(classes=['xref', 'c', class_s])
		129	lit_text += target_text
		130	pxref = addnodes.pending_xref('', refdomain = 'c',
		131	reftype = reftype_s,
		132	reftarget = target, modname = None,
		133	classname = None)
		134	#
		135	# XXX The Latex builder will throw NoUri exceptions here,
		136	# work around that by ignoring them.
		137	#
		138	try:
		139	xref = cdom.resolve_xref(app.env, docname, app.builder,
		140	reftype_s, target, pxref,
		141	lit_text)
		142	except NoUri:
		143	xref = None
		144
		145	if xref:
		146	return xref
		147
		148	return target_text
		149
81	def markup_c_ref(docname, app, match):	150	def markup_c_ref(docname, app, match):
82	class_str = {RE_function: 'c-func', RE_type: 'c-type'}	151	class_str = {# Sphinx 2 only
83	reftype_str = {RE_function: 'function', RE_type: 'type'}	152	RE_function: 'c-func',
		153	RE_generic_type: 'c-type',
		154	# Sphinx 3+ only
		155	RE_struct: 'c-struct',
		156	RE_union: 'c-union',
		157	RE_enum: 'c-enum',
		158	RE_typedef: 'c-type',
		159	}
		160	reftype_str = {# Sphinx 2 only
		161	RE_function: 'function',
		162	RE_generic_type: 'type',
		163	# Sphinx 3+ only
		164	RE_struct: 'struct',
		165	RE_union: 'union',
		166	RE_enum: 'enum',
		167	RE_typedef: 'type',
		168	}
84		169
85	cdom = app.env.domains['c']	170	cdom = app.env.domains['c']
86	#	171	#
@@ -89,7 +174,8 @@ def markup_c_ref(docname, app, match): · 2 unmodified lines
89	target = match.group(2)	174	target = match.group(2)
90	target_text = nodes.Text(match.group(0))	175	target_text = nodes.Text(match.group(0))
91	xref = None	176	xref = None
92	if not (match.re == RE_function and target in Skipfuncs):	177	if not ((match.re == RE_function and target in Skipfuncs)
		178	or (target in Skipnames)):
93	lit_text = nodes.literal(classes=['xref', 'c', class_str[match.re]])	179	lit_text = nodes.literal(classes=['xref', 'c', class_str[match.re]])
94	lit_text += target_text	180	lit_text += target_text
95	pxref = addnodes.pending_xref('', refdomain = 'c',	181	pxref = addnodes.pending_xref('', refdomain = 'c',

Documentation/sphinx/cdomain.py+92−1

@@ -40,14 +40,94 @@ from sphinx import addnodes · 39 unmodified lines
40	from sphinx.domains.c import c_funcptr_sig_re, c_sig_re	40	from sphinx.domains.c import c_funcptr_sig_re, c_sig_re
41	from sphinx.domains.c import CObject as Base_CObject	41	from sphinx.domains.c import CObject as Base_CObject
42	from sphinx.domains.c import CDomain as Base_CDomain	42	from sphinx.domains.c import CDomain as Base_CDomain
		43	from itertools import chain
		44	import re
43		45
44	__version__ = '1.0'	46	__version__ = '1.1'
45		47
46	# Get Sphinx version	48	# Get Sphinx version
47	major, minor, patch = sphinx.version_info[:3]	49	major, minor, patch = sphinx.version_info[:3]
48		50
		51	# Namespace to be prepended to the full name
		52	namespace = None
		53
		54	#
		55	# Handle trivial newer c domain tags that are part of Sphinx 3.1 c domain tags
		56	# - Store the namespace if ".. c:namespace::" tag is found
		57	#
		58	RE_namespace = re.compile(r'^\s..\sc:namespace::\s(\S+)\s$')
		59
		60	def markup_namespace(match):
		61	global namespace
		62
		63	namespace = match.group(1)
		64
		65	return ""
		66
		67	#
		68	# Handle c:macro for function-style declaration
		69	#
		70	RE_macro = re.compile(r'^\s..\sc:macro::\s(\S+)\s+(\S.)\s*$')
		71	def markup_macro(match):
		72	return ".. c:function:: " + match.group(1) + ' ' + match.group(2)
		73
		74	#
		75	# Handle newer c domain tags that are evaluated as .. c:type: for
		76	# backward-compatibility with Sphinx < 3.0
		77	#
		78	RE_ctype = re.compile(r'^\s..\sc:(struct\|union\|enum\|enumerator\|alias)::\s(.)$')
		79
		80	def markup_ctype(match):
		81	return ".. c:type:: " + match.group(2)
		82
		83	#
		84	# Handle newer c domain tags that are evaluated as :c:type: for
		85	# backward-compatibility with Sphinx < 3.0
		86	#
		87	RE_ctype_refs = re.compile(r':c:(var\|struct\|union\|enum\|enumerator)::`([^\`]+)`')
		88	def markup_ctype_refs(match):
		89	return ":c:type:`" + match.group(2) + '`'
		90
		91	#
		92	# Simply convert :c:expr: and :c:texpr: into a literal block.
		93	#
		94	RE_expr = re.compile(r':c:(expr\|texpr):`([^\`]+)`')
		95	def markup_c_expr(match):
		96	return '\ ``' + match.group(2) + '``\ '
		97
		98	#
		99	# Parse Sphinx 3.x C markups, replacing them by backward-compatible ones
		100	#
		101	def c_markups(app, docname, source):
		102	result = ""
		103	markup_func = {
		104	RE_namespace: markup_namespace,
		105	RE_expr: markup_c_expr,
		106	RE_macro: markup_macro,
		107	RE_ctype: markup_ctype,
		108	RE_ctype_refs: markup_ctype_refs,
		109	}
		110
		111	lines = iter(source[0].splitlines(True))
		112	for n in lines:
		113	match_iterators = [regex.finditer(n) for regex in markup_func]
		114	matches = sorted(chain(*match_iterators), key=lambda m: m.start())
		115	for m in matches:
		116	n = n[:m.start()] + markup_func[m.re](m) + n[m.end():]
		117
		118	result = result + n
		119
		120	source[0] = result
		121
		122	#
		123	# Now implements support for the cdomain namespacing logic
		124	#
		125
49	def setup(app):	126	def setup(app):
50		127
		128	# Handle easy Sphinx 3.1+ simple new tags: :c:expr and .. c:namespace::
		129	app.connect('source-read', c_markups)
		130
51	if (major == 1 and minor < 8):	131	if (major == 1 and minor < 8):
52	app.override_domain(CDomain)	132	app.override_domain(CDomain)
53	else:	133	else:
@@ -75,6 +155,8 @@ class CObject(Base_CObject): · 21 unmodified lines
75	function-like macro, the name of the macro is returned. Otherwise	155	function-like macro, the name of the macro is returned. Otherwise
76	``False`` is returned. """	156	``False`` is returned. """
77		157
		158	global namespace
		159
78	if not self.objtype == 'function':	160	if not self.objtype == 'function':
79	return False	161	return False
80		162
@@ -107,11 +189,16 @@ class CObject(Base_CObject): · 26 unmodified lines
107	param += nodes.emphasis(argname, argname)	189	param += nodes.emphasis(argname, argname)
108	paramlist += param	190	paramlist += param
109		191
		192	if namespace:
		193	fullname = namespace + "." + fullname
		194
110	return fullname	195	return fullname
111		196
112	def handle_signature(self, sig, signode):	197	def handle_signature(self, sig, signode):
113	"""Transform a C signature into RST nodes."""	198	"""Transform a C signature into RST nodes."""
114		199
		200	global namespace
		201
115	fullname = self.handle_func_like_macro(sig, signode)	202	fullname = self.handle_func_like_macro(sig, signode)
116	if not fullname:	203	if not fullname:
117	fullname = super(CObject, self).handle_signature(sig, signode)	204	fullname = super(CObject, self).handle_signature(sig, signode)
@@ -122,6 +209,10 @@ class CObject(Base_CObject): · 4 unmodified lines
122	else:	209	else:
123	# FIXME: handle :name: value of other declaration types?	210	# FIXME: handle :name: value of other declaration types?
124	pass	211	pass
		212	else:
		213	if namespace:
		214	fullname = namespace + "." + fullname
		215
125	return fullname	216	return fullname
126		217
127	def add_target_and_index(self, name, sig, signode):	218	def add_target_and_index(self, name, sig, signode):

Documentation/sphinx/kerneldoc.py+14−1

         'export': directives.unchanged,
         'internal': directives.unchanged,
         'identifiers': directives.unchanged,
+        'no-identifiers': directives.unchanged,
         'functions': directives.unchanged,
     }
     has_content = False
         env = self.state.document.settings.env
         cmd = [env.config.kerneldoc_bin, '-rst', '-enable-lineno']
+	# Pass the version string to kernel-doc, as it needs to use a different
+	# dialect, depending what the C domain supports for each specific
+	# Sphinx versions
+        cmd += ['-sphinx-version', sphinx.__version__]
         filename = env.config.kerneldoc_srctree + '/' + self.arguments[0]
         export_file_patterns = []
             else:
                 cmd += ['-no-doc-sections']
+        if 'no-identifiers' in self.options:
+            no_identifiers = self.options.get('no-identifiers').split()
+            if no_identifiers:
+                for i in no_identifiers:
+                    cmd += ['-nosymbol', i]
         for pattern in export_file_patterns:
             for f in glob.glob(env.config.kerneldoc_srctree + '/' + pattern):
                 env.note_dependency(os.path.abspath(f))
                     lineoffset = int(match.group(1)) - 1
                     # we must eat our comments since the upset the markup
                 else:
-                    result.append(line, filename, lineoffset)
+                    doc = env.srcdir + "/" + env.docname + ":" + str(self.lineno)
+                    result.append(line, doc + ": " + filename, lineoffset)
                     lineoffset += 1
             node = nodes.section()

Documentation/sphinx/parse-headers.pl+1−1

@@ -110,7 +110,7 @@ while (<IN>) { · 109 unmodified lines
110	) {	110	) {
111	my $s = $1;	111	my $s = $1;
112		112
113	$structs{$s} = "struct :c:type:`$s`\\ ";	113	$structs{$s} = "struct $s\\ ";
114	next;	114	next;
115	}	115	}
116	}	116	}

Documentation/trace/ftrace-uses.rst+6−6

@@ -55,17 +55,17 @@ an ftrace_ops with ftrace: · 54 unmodified lines
55		55
56	Both .flags and .private are optional. Only .func is required.	56	Both .flags and .private are optional. Only .func is required.
57		57
58	To enable tracing call:	58	To enable tracing call::
59		59
60	.. c:function:: register_ftrace_function(&ops);	60	register_ftrace_function(&ops);
61		61
62	To disable tracing call:	62	To disable tracing call::
63		63
64	.. c:function:: unregister_ftrace_function(&ops);	64	unregister_ftrace_function(&ops);
65		65
66	The above is defined by including the header:	66	The above is defined by including the header::
67		67
68	.. c:function:: #include <linux/ftrace.h>	68	#include <linux/ftrace.h>
69		69
70	The registered callback will start being called some time after the	70	The registered callback will start being called some time after the
71	register_ftrace_function() is called and before it returns. The exact time	71	register_ftrace_function() is called and before it returns. The exact time

Documentation/translations/it_IT/kernel-hacking/hacking.rst+1−1

@@ -402,7 +402,7 @@ il valore convertito. Tutte le varianti supportano anche il processo inverso: · 401 unmodified lines
402	:c:func:`be32_to_cpu()`, eccetera.	402	:c:func:`be32_to_cpu()`, eccetera.
403		403
404	Queste funzioni hanno principalmente due varianti: la variante per	404	Queste funzioni hanno principalmente due varianti: la variante per
405	puntatori, come :c:func:`cpu_to_be32p(), che prende un puntatore	405	puntatori, come :c:func:`cpu_to_be32p()`, che prende un puntatore
406	ad un tipo, e ritorna il valore convertito. L'altra variante per	406	ad un tipo, e ritorna il valore convertito. L'altra variante per
407	la famiglia di conversioni "in-situ", come :c:func:`cpu_to_be32s()`,	407	la famiglia di conversioni "in-situ", come :c:func:`cpu_to_be32s()`,
408	che convertono il valore puntato da un puntatore, e ritornano void.	408	che convertono il valore puntato da un puntatore, e ritornano void.

Documentation/translations/it_IT/kernel-hacking/locking.rst+2−0

@@ -1,5 +1,7 @@
1	.. include:: ../disclaimer-ita.rst	1	.. include:: ../disclaimer-ita.rst
2		2
		3	.. c:namespace:: it_IT
		4
3	:Original: :ref:`Documentation/kernel-hacking/locking.rst <kernel_hacking_lock>`	5	:Original: :ref:`Documentation/kernel-hacking/locking.rst <kernel_hacking_lock>`
4	:Translator: Federico Vaga <federico.vaga@vaga.pv.it>	6	:Translator: Federico Vaga <federico.vaga@vaga.pv.it>
5		7

Documentation/translations/zh_CN/arm64/amu.rst+2−2

@@ -4,9 +4,9 @@ · 3 unmodified lines
4		4
5	Translator: Bailu Lin <bailu.lin@vivo.com>	5	Translator: Bailu Lin <bailu.lin@vivo.com>
6		6
7	=================================	7	==================================
8	AArch64 Linux 中扩展的活动监控单元	8	AArch64 Linux 中扩展的活动监控单元
9	=================================	9	==================================
10		10
11	作者: Ionela Voinescu <ionela.voinescu@arm.com>	11	作者: Ionela Voinescu <ionela.voinescu@arm.com>
12		12

Documentation/userspace-api/media/cec/cec-func-close.rst+3−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: CEC
 .. _cec-func-close:
 cec-close - Close a cec device
 Synopsis
 ========
     #include <unistd.h>
 .. c:function:: int close( int fd )
-    :name: cec-close
 Arguments
 =========
 ``fd``
-    File descriptor returned by :c:func:`open() <cec-open>`.
+    File descriptor returned by :c:func:`open()`.
 Description
 ===========
 Closes the cec device. Resources associated with the file descriptor are
 freed. The device configuration remain unchanged.
 Return Value
 ============
-:c:func:`close() <cec-close>` returns 0 on success. On error, -1 is returned, and
+:c:func:`close()` returns 0 on success. On error, -1 is returned, and
 ``errno`` is set appropriately. Possible error codes are:
 ``EBADF``

Documentation/userspace-api/media/cec/cec-func-ioctl.rst+4−7

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: CEC
2		3
3	.. _cec-func-ioctl:	4	.. _cec-func-ioctl:
4		5
@@ -18,15 +19,13 @@ Synopsis · 13 unmodified lines
18		19
19	#include <sys/ioctl.h>	20	#include <sys/ioctl.h>
20		21
21		22	``int ioctl(int fd, int request, void *argp)``
22	.. c:function:: int ioctl( int fd, int request, void *argp )
23	:name: cec-ioctl
24		23
25	Arguments	24	Arguments
26	=========	25	=========
27		26
28	``fd``	27	``fd``
29	File descriptor returned by :c:func:`open() <cec-open>`.	28	File descriptor returned by :c:func:`open()`.
30		29
31	``request``	30	``request``
32	CEC ioctl request code as defined in the cec.h header file, for	31	CEC ioctl request code as defined in the cec.h header file, for
@@ -35,11 +34,10 @@ Arguments · 2 unmodified lines
35	``argp``	34	``argp``
36	Pointer to a request-specific structure.	35	Pointer to a request-specific structure.
37		36
38
39	Description	37	Description
40	===========	38	===========
41		39
42	The :c:func:`ioctl() <cec-ioctl>` function manipulates cec device parameters. The	40	The :c:func:`ioctl()` function manipulates cec device parameters. The
43	argument ``fd`` must be an open file descriptor.	41	argument ``fd`` must be an open file descriptor.
44		42
45	The ioctl ``request`` code specifies the cec function to be called. It	43	The ioctl ``request`` code specifies the cec function to be called. It
@@ -51,7 +49,6 @@ their parameters are located in the cec.h header file. All cec ioctl · 5 unmodified lines
51	requests, their respective function and parameters are specified in	49	requests, their respective function and parameters are specified in
52	:ref:`cec-user-func`.	50	:ref:`cec-user-func`.
53		51
54
55	Return Value	52	Return Value
56	============	53	============
57		54

Documentation/userspace-api/media/cec/cec-func-open.rst+3−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: CEC
 .. _cec-func-open:
     #include <fcntl.h>
 .. c:function:: int open( const char *device_name, int flags )
-   :name: cec-open
 Arguments
 =========
     Other flags have no effect.
 Description
 ===========
-To open a cec device applications call :c:func:`open() <cec-open>` with the
+To open a cec device applications call :c:func:`open()` with the
 desired device name. The function has no side effects; the device
 configuration remain unchanged.
 configuration will result in an error, and ``errno`` will be set to
 EBADF.
 Return Value
 ============
-:c:func:`open() <cec-open>` returns the new file descriptor on success. On error,
+:c:func:`open()` returns the new file descriptor on success. On error,
 -1 is returned, and ``errno`` is set appropriately. Possible error codes
 include:

Documentation/userspace-api/media/cec/cec-func-poll.rst+5−9

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: CEC
 .. _cec-func-poll:
 cec-poll - Wait for some event on a file descriptor
 Synopsis
 ========
     #include <sys/poll.h>
 .. c:function:: int poll( struct pollfd *ufds, unsigned int nfds, int timeout )
-   :name: cec-poll
 Arguments
 =========
 ``timeout``
    Timeout to wait for events
 Description
 ===========
-With the :c:func:`poll() <cec-poll>` function applications can wait for CEC
+With the :c:func:`poll()` function applications can wait for CEC
 events.
-On success :c:func:`poll() <cec-poll>` returns the number of file descriptors
+On success :c:func:`poll()` returns the number of file descriptors
 that have been selected (that is, file descriptors for which the
 ``revents`` field of the respective struct :c:type:`pollfd`
 is non-zero). CEC devices set the ``POLLIN`` and ``POLLRDNORM`` flags in
 a value of zero, on failure it returns -1 and the ``errno`` variable is
 set appropriately.
-For more details see the :c:func:`poll() <cec-poll>` manual page.
+For more details see the :c:func:`poll()` manual page.
 Return Value
 ============
-On success, :c:func:`poll() <cec-poll>` returns the number structures which have
+On success, :c:func:`poll()` returns the number structures which have
 non-zero ``revents`` fields, or zero if the call timed out. On error -1
 is returned, and the ``errno`` variable is set appropriately:

Documentation/userspace-api/media/cec/cec-ioc-adap-g-caps.rst+5−5

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: CEC
2		3
3	.. _CEC_ADAP_G_CAPS:	4	.. _CEC_ADAP_G_CAPS:
4		5
@@ -14,18 +15,18 @@ CEC_ADAP_G_CAPS - Query device capabilities · 9 unmodified lines
14	Synopsis	15	Synopsis
15	========	16	========
16		17
17	.. c:function:: int ioctl( int fd, CEC_ADAP_G_CAPS, struct cec_caps *argp )	18	.. c:macro:: CEC_ADAP_G_CAPS
18	:name: CEC_ADAP_G_CAPS	19
		20	``int ioctl(int fd, CEC_ADAP_G_CAPS, struct cec_caps *argp)``
19		21
20	Arguments	22	Arguments
21	=========	23	=========
22		24
23	``fd``	25	``fd``
24	File descriptor returned by :c:func:`open() <cec-open>`.	26	File descriptor returned by :c:func:`open()`.
25		27
26	``argp``	28	``argp``
27		29
28
29	Description	30	Description
30	===========	31	===========
31		32
@@ -62,7 +63,6 @@ returns the information to the application. The ioctl never fails. · 30 unmodified lines
62	- CEC Framework API version, formatted with the ``KERNEL_VERSION()``	63	- CEC Framework API version, formatted with the ``KERNEL_VERSION()``
63	macro.	64	macro.
64		65
65
66	.. tabularcolumns:: \|p{4.4cm}\|p{2.5cm}\|p{10.6cm}\|	66	.. tabularcolumns:: \|p{4.4cm}\|p{2.5cm}\|p{10.6cm}\|
67		67
68	.. _cec-capabilities:	68	.. _cec-capabilities:

Documentation/userspace-api/media/cec/cec-ioc-adap-g-conn-info.rst+6−5

@@ -2,6 +2,8 @@ · 1 unmodified line
2	..	2	..
3	.. Copyright 2019 Google LLC	3	.. Copyright 2019 Google LLC
4	..	4	..
		5	.. c:namespace:: CEC
		6
5	.. _CEC_ADAP_G_CONNECTOR_INFO:	7	.. _CEC_ADAP_G_CONNECTOR_INFO:
6		8
7	*******************************	9	*******************************
@@ -16,18 +18,18 @@ CEC_ADAP_G_CONNECTOR_INFO - Query HDMI connector information · 8 unmodified lines
16	Synopsis	18	Synopsis
17	========	19	========
18		20
19	.. c:function:: int ioctl( int fd, CEC_ADAP_G_CONNECTOR_INFO, struct cec_connector_info *argp )	21	.. c:macro:: CEC_ADAP_G_CONNECTOR_INFO
20	:name: CEC_ADAP_G_CONNECTOR_INFO	22
		23	``int ioctl(int fd, CEC_ADAP_G_CONNECTOR_INFO, struct cec_connector_info *argp)``
21		24
22	Arguments	25	Arguments
23	=========	26	=========
24		27
25	``fd``	28	``fd``
26	File descriptor returned by :c:func:`open() <cec-open>`.	29	File descriptor returned by :c:func:`open()`.
27		30
28	``argp``	31	``argp``
29		32
30
31	Description	33	Description
32	===========	34	===========
33		35
@@ -57,7 +59,6 @@ is only available if the ``CEC_CAP_CONNECTOR_INFO`` capability is set. · 23 unmodified lines
57	* - }	59	* - }
58	-	60	-
59		61
60
61	.. tabularcolumns:: \|p{4.4cm}\|p{2.5cm}\|p{10.6cm}\|	62	.. tabularcolumns:: \|p{4.4cm}\|p{2.5cm}\|p{10.6cm}\|
62		63
63	.. _connector-type:	64	.. _connector-type:

Documentation/userspace-api/media/cec/cec-ioc-adap-g-log-addrs.rst+8−12

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: CEC
2		3
3	.. _CEC_ADAP_LOG_ADDRS:	4	.. _CEC_ADAP_LOG_ADDRS:
4	.. _CEC_ADAP_G_LOG_ADDRS:	5	.. _CEC_ADAP_G_LOG_ADDRS:
@@ -13,21 +14,22 @@ Name · 8 unmodified lines
13		14
14	CEC_ADAP_G_LOG_ADDRS, CEC_ADAP_S_LOG_ADDRS - Get or set the logical addresses	15	CEC_ADAP_G_LOG_ADDRS, CEC_ADAP_S_LOG_ADDRS - Get or set the logical addresses
15		16
16
17	Synopsis	17	Synopsis
18	========	18	========
19		19
20	.. c:function:: int ioctl( int fd, CEC_ADAP_G_LOG_ADDRS, struct cec_log_addrs *argp )	20	.. c:macro:: CEC_ADAP_G_LOG_ADDRS
21	:name: CEC_ADAP_G_LOG_ADDRS	21
		22	``int ioctl(int fd, CEC_ADAP_G_LOG_ADDRS, struct cec_log_addrs *argp)``
		23
		24	.. c:macro:: CEC_ADAP_S_LOG_ADDRS
22		25
23	.. c:function:: int ioctl( int fd, CEC_ADAP_S_LOG_ADDRS, struct cec_log_addrs *argp )	26	``int ioctl(int fd, CEC_ADAP_S_LOG_ADDRS, struct cec_log_addrs *argp)``
24	:name: CEC_ADAP_S_LOG_ADDRS
25		27
26	Arguments	28	Arguments
27	=========	29	=========
28		30
29	``fd``	31	``fd``
30	File descriptor returned by :c:func:`open() <cec-open>`.	32	File descriptor returned by :c:func:`open()`.
31		33
32	``argp``	34	``argp``
33	Pointer to struct :c:type:`cec_log_addrs`.	35	Pointer to struct :c:type:`cec_log_addrs`.
@@ -148,7 +150,6 @@ logical address types are already defined will return with error ``EBUSY``. · 114 unmodified lines
148	give the CEC framework more information about the device type, even	150	give the CEC framework more information about the device type, even
149	though the framework won't use it directly in the CEC message.	151	though the framework won't use it directly in the CEC message.
150		152
151
152	.. tabularcolumns:: \|p{7.8cm}\|p{1.0cm}\|p{8.7cm}\|	153	.. tabularcolumns:: \|p{7.8cm}\|p{1.0cm}\|p{8.7cm}\|
153		154
154	.. _cec-log-addrs-flags:	155	.. _cec-log-addrs-flags:
@@ -185,7 +186,6 @@ logical address types are already defined will return with error ``EBUSY``. · 30 unmodified lines
185		186
186	All other messages are ignored.	187	All other messages are ignored.
187		188
188
189	.. tabularcolumns:: \|p{7.8cm}\|p{1.0cm}\|p{8.7cm}\|	189	.. tabularcolumns:: \|p{7.8cm}\|p{1.0cm}\|p{8.7cm}\|
190		190
191	.. _cec-versions:	191	.. _cec-versions:
@@ -211,7 +211,6 @@ logical address types are already defined will return with error ``EBUSY``. · 19 unmodified lines
211	- 6	211	- 6
212	- CEC version according to the HDMI 2.0 standard.	212	- CEC version according to the HDMI 2.0 standard.
213		213
214
215	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	214	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
216		215
217	.. _cec-prim-dev-types:	216	.. _cec-prim-dev-types:
@@ -257,7 +256,6 @@ logical address types are already defined will return with error ``EBUSY``. · 39 unmodified lines
257	- 7	256	- 7
258	- Use for a video processor device.	257	- Use for a video processor device.
259		258
260
261	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	259	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
262		260
263	.. _cec-log-addr-types:	261	.. _cec-log-addr-types:
@@ -306,7 +304,6 @@ logical address types are already defined will return with error ``EBUSY``. · 42 unmodified lines
306	Control).	304	Control).
307		305
308		306
309
310	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	307	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
311		308
312	.. _cec-all-dev-types-flags:	309	.. _cec-all-dev-types-flags:
@@ -348,7 +345,6 @@ logical address types are already defined will return with error ``EBUSY``. · 35 unmodified lines
348	- This supports the CEC Switch or Video Processing type.	345	- This supports the CEC Switch or Video Processing type.
349		346
350		347
351
352	Return Value	348	Return Value
353	============	349	============
354		350

Documentation/userspace-api/media/cec/cec-ioc-adap-g-phys-addr.rst+8−7

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: CEC
2		3
3	.. _CEC_ADAP_PHYS_ADDR:	4	.. _CEC_ADAP_PHYS_ADDR:
4	.. _CEC_ADAP_G_PHYS_ADDR:	5	.. _CEC_ADAP_G_PHYS_ADDR:
@@ -13,21 +14,22 @@ Name · 8 unmodified lines
13		14
14	CEC_ADAP_G_PHYS_ADDR, CEC_ADAP_S_PHYS_ADDR - Get or set the physical address	15	CEC_ADAP_G_PHYS_ADDR, CEC_ADAP_S_PHYS_ADDR - Get or set the physical address
15		16
16
17	Synopsis	17	Synopsis
18	========	18	========
19		19
20	.. c:function:: int ioctl( int fd, CEC_ADAP_G_PHYS_ADDR, __u16 *argp )	20	.. c:macro:: CEC_ADAP_G_PHYS_ADDR
21	:name: CEC_ADAP_G_PHYS_ADDR	21
		22	``int ioctl(int fd, CEC_ADAP_G_PHYS_ADDR, __u16 *argp)``
22		23
23	.. c:function:: int ioctl( int fd, CEC_ADAP_S_PHYS_ADDR, __u16 *argp )	24	.. c:macro:: CEC_ADAP_S_PHYS_ADDR
24	:name: CEC_ADAP_S_PHYS_ADDR	25
		26	``int ioctl(int fd, CEC_ADAP_S_PHYS_ADDR, __u16 *argp)``
25		27
26	Arguments	28	Arguments
27	=========	29	=========
28		30
29	``fd``	31	``fd``
30	File descriptor returned by :c:func:`open() <cec-open>`.	32	File descriptor returned by :c:func:`open()`.
31		33
32	``argp``	34	``argp``
33	Pointer to the CEC address.	35	Pointer to the CEC address.
@@ -71,7 +73,6 @@ For example, the EDID for each HDMI input of the TV will have a · 37 unmodified lines
71	different physical address of the form a.0.0.0 that the sources will	73	different physical address of the form a.0.0.0 that the sources will
72	read out and use as their physical address.	74	read out and use as their physical address.
73		75
74
75	Return Value	76	Return Value
76	============	77	============
77		78

Documentation/userspace-api/media/cec/cec-ioc-dqevent.rst+5−10

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: CEC
2		3
3	.. _CEC_DQEVENT:	4	.. _CEC_DQEVENT:
4		5
@@ -11,22 +12,21 @@ Name · 6 unmodified lines
11		12
12	CEC_DQEVENT - Dequeue a CEC event	13	CEC_DQEVENT - Dequeue a CEC event
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, CEC_DQEVENT, struct cec_event *argp )	18	.. c:macro:: CEC_DQEVENT
19	:name: CEC_DQEVENT	19
		20	``int ioctl(int fd, CEC_DQEVENT, struct cec_event *argp)``
20		21
21	Arguments	22	Arguments
22	=========	23	=========
23		24
24	``fd``	25	``fd``
25	File descriptor returned by :c:func:`open() <cec-open>`.	26	File descriptor returned by :c:func:`open()`.
26		27
27	``argp``	28	``argp``
28		29
29
30	Description	30	Description
31	===========	31	===========
32		32
@@ -72,7 +72,6 @@ it is guaranteed that the state did change in between the two events. · 39 unmodified lines
72	the HDMI driver is still configuring the device or because the HDMI	72	the HDMI driver is still configuring the device or because the HDMI
73	device was unbound.	73	device was unbound.
74		74
75
76	.. c:type:: cec_event_lost_msgs	75	.. c:type:: cec_event_lost_msgs
77		76
78	.. tabularcolumns:: \|p{1.0cm}\|p{2.0cm}\|p{14.5cm}\|	77	.. tabularcolumns:: \|p{1.0cm}\|p{2.0cm}\|p{14.5cm}\|
@@ -94,7 +93,6 @@ it is guaranteed that the state did change in between the two events. · 15 unmodified lines
94	replied to within a second according to the CEC specification,	93	replied to within a second according to the CEC specification,
95	this is more than enough.	94	this is more than enough.
96		95
97
98	.. tabularcolumns:: \|p{1.0cm}\|p{4.4cm}\|p{2.5cm}\|p{9.6cm}\|	96	.. tabularcolumns:: \|p{1.0cm}\|p{4.4cm}\|p{2.5cm}\|p{9.6cm}\|
99		97
100	.. c:type:: cec_event	98	.. c:type:: cec_event
@@ -130,7 +128,6 @@ it is guaranteed that the state did change in between the two events. · 29 unmodified lines
130	* - }	128	* - }
131	-	129	-
132		130
133
134	.. tabularcolumns:: \|p{5.6cm}\|p{0.9cm}\|p{11.0cm}\|	131	.. tabularcolumns:: \|p{5.6cm}\|p{0.9cm}\|p{11.0cm}\|
135		132
136	.. _cec-events:	133	.. _cec-events:
@@ -204,7 +201,6 @@ it is guaranteed that the state did change in between the two events. · 67 unmodified lines
204	if the 5V is high, then an initial event will be generated for that	201	if the 5V is high, then an initial event will be generated for that
205	filehandle.	202	filehandle.
206		203
207
208	.. tabularcolumns:: \|p{6.0cm}\|p{0.6cm}\|p{10.9cm}\|	204	.. tabularcolumns:: \|p{6.0cm}\|p{0.6cm}\|p{10.9cm}\|
209		205
210	.. _cec-event-flags:	206	.. _cec-event-flags:
@@ -230,7 +226,6 @@ it is guaranteed that the state did change in between the two events. · 19 unmodified lines
230	This is an indication that the application cannot keep up.	226	This is an indication that the application cannot keep up.
231		227
232		228
233
234	Return Value	229	Return Value
235	============	230	============
236		231

Documentation/userspace-api/media/cec/cec-ioc-g-mode.rst+8−8

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: CEC
2		3
3	.. _CEC_MODE:	4	.. _CEC_MODE:
4	.. _CEC_G_MODE:	5	.. _CEC_G_MODE:
@@ -13,17 +14,19 @@ CEC_G_MODE, CEC_S_MODE - Get or set exclusive use of the CEC adapter · 8 unmodified lines
13	Synopsis	14	Synopsis
14	========	15	========
15		16
16	.. c:function:: int ioctl( int fd, CEC_G_MODE, __u32 *argp )	17	.. c:macro:: CEC_G_MODE
17	:name: CEC_G_MODE
18		18
19	.. c:function:: int ioctl( int fd, CEC_S_MODE, __u32 *argp )	19	``int ioctl(int fd, CEC_G_MODE, __u32 *argp)``
20	:name: CEC_S_MODE	20
		21	.. c:macro:: CEC_S_MODE
		22
		23	``int ioctl(int fd, CEC_S_MODE, __u32 *argp)``
21		24
22	Arguments	25	Arguments
23	=========	26	=========
24		27
25	``fd``	28	``fd``
26	File descriptor returned by :c:func:`open() <cec-open>`.	29	File descriptor returned by :c:func:`open()`.
27		30
28	``argp``	31	``argp``
29	Pointer to CEC mode.	32	Pointer to CEC mode.
@@ -101,7 +104,6 @@ Available initiator modes are: · 71 unmodified lines
101	then an attempt to become one will return the ``EBUSY`` error code	104	then an attempt to become one will return the ``EBUSY`` error code
102	error.	105	error.
103		106
104
105	Available follower modes are:	107	Available follower modes are:
106		108
107	.. tabularcolumns:: \|p{6.6cm}\|p{0.9cm}\|p{10.0cm}\|	109	.. tabularcolumns:: \|p{6.6cm}\|p{0.9cm}\|p{10.0cm}\|
@@ -193,7 +195,6 @@ Available follower modes are: · 85 unmodified lines
193	the process has the ``CAP_NET_ADMIN`` capability. If that is not	195	the process has the ``CAP_NET_ADMIN`` capability. If that is not
194	set, then the ``EPERM`` error code is returned.	196	set, then the ``EPERM`` error code is returned.
195		197
196
197	Core message processing details:	198	Core message processing details:
198		199
199	.. tabularcolumns:: \|p{6.6cm}\|p{10.9cm}\|	200	.. tabularcolumns:: \|p{6.6cm}\|p{10.9cm}\|
@@ -272,7 +273,6 @@ Core message processing details: · 72 unmodified lines
272	and then just pass the message on to the follower(s).	273	and then just pass the message on to the follower(s).
273		274
274		275
275
276	Return Value	276	Return Value
277	============	277	============
278		278

Documentation/userspace-api/media/cec/cec-ioc-receive.rst+8−10

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: CEC
2		3
3	.. _CEC_TRANSMIT:	4	.. _CEC_TRANSMIT:
4	.. _CEC_RECEIVE:	5	.. _CEC_RECEIVE:
@@ -12,21 +13,22 @@ Name · 7 unmodified lines
12		13
13	CEC_RECEIVE, CEC_TRANSMIT - Receive or transmit a CEC message	14	CEC_RECEIVE, CEC_TRANSMIT - Receive or transmit a CEC message
14		15
15
16	Synopsis	16	Synopsis
17	========	17	========
18		18
19	.. c:function:: int ioctl( int fd, CEC_RECEIVE, struct cec_msg \*argp )	19	.. c:macro:: CEC_RECEIVE
20	:name: CEC_RECEIVE	20
		21	``int ioctl(int fd, CEC_RECEIVE, struct cec_msg *argp)``
21		22
22	.. c:function:: int ioctl( int fd, CEC_TRANSMIT, struct cec_msg \*argp )	23	.. c:macro:: CEC_TRANSMIT
23	:name: CEC_TRANSMIT	24
		25	``int ioctl(int fd, CEC_TRANSMIT, struct cec_msg *argp)``
24		26
25	Arguments	27	Arguments
26	=========	28	=========
27		29
28	``fd``	30	``fd``
29	File descriptor returned by :c:func:`open() <cec-open>`.	31	File descriptor returned by :c:func:`open()`.
30		32
31	``argp``	33	``argp``
32	Pointer to struct cec_msg.	34	Pointer to struct cec_msg.
@@ -194,7 +196,6 @@ View On' messages from initiator 0xf ('Unregistered') to destination 0 ('TV'). · 161 unmodified lines
194	supports this, otherwise it is always 0. This counter is only	196	supports this, otherwise it is always 0. This counter is only
195	valid if the :ref:`CEC_TX_STATUS_ERROR <CEC-TX-STATUS-ERROR>` status bit is set.	197	valid if the :ref:`CEC_TX_STATUS_ERROR <CEC-TX-STATUS-ERROR>` status bit is set.
196		198
197
198	.. tabularcolumns:: \|p{6.2cm}\|p{1.0cm}\|p{10.3cm}\|	199	.. tabularcolumns:: \|p{6.2cm}\|p{1.0cm}\|p{10.3cm}\|
199		200
200	.. _cec-msg-flags:	201	.. _cec-msg-flags:
@@ -228,7 +229,6 @@ View On' messages from initiator 0xf ('Unregistered') to destination 0 ('TV'). · 27 unmodified lines
228	capability. If that is not set, then the ``EPERM`` error code is	229	capability. If that is not set, then the ``EPERM`` error code is
229	returned.	230	returned.
230		231
231
232	.. tabularcolumns:: \|p{5.6cm}\|p{0.9cm}\|p{11.0cm}\|	232	.. tabularcolumns:: \|p{5.6cm}\|p{0.9cm}\|p{11.0cm}\|
233		233
234	.. _cec-tx-status:	234	.. _cec-tx-status:
@@ -298,7 +298,6 @@ View On' messages from initiator 0xf ('Unregistered') to destination 0 ('TV'). · 63 unmodified lines
298	- The transmit timed out. This should not normally happen and this	298	- The transmit timed out. This should not normally happen and this
299	indicates a driver problem.	299	indicates a driver problem.
300		300
301
302	.. tabularcolumns:: \|p{5.6cm}\|p{0.9cm}\|p{11.0cm}\|	301	.. tabularcolumns:: \|p{5.6cm}\|p{0.9cm}\|p{11.0cm}\|
303		302
304	.. _cec-rx-status:	303	.. _cec-rx-status:
@@ -335,7 +334,6 @@ View On' messages from initiator 0xf ('Unregistered') to destination 0 ('TV'). · 30 unmodified lines
335	reply was interrupted.	334	reply was interrupted.
336		335
337		336
338
339	Return Value	337	Return Value
340	============	338	============
341		339

Documentation/userspace-api/media/dvb/audio-bilingual-channel-select.rst+3−4

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.audio
2		3
3	.. _AUDIO_BILINGUAL_CHANNEL_SELECT:	4	.. _AUDIO_BILINGUAL_CHANNEL_SELECT:
4		5
@@ -16,9 +17,9 @@ AUDIO_BILINGUAL_CHANNEL_SELECT · 11 unmodified lines
16	Synopsis	17	Synopsis
17	--------	18	--------
18		19
19	.. c:function:: int ioctl(int fd, AUDIO_BILINGUAL_CHANNEL_SELECT, struct *audio_channel_select)	20	.. c:macro:: AUDIO_BILINGUAL_CHANNEL_SELECT
20	:name: AUDIO_BILINGUAL_CHANNEL_SELECT
21		21
		22	``int ioctl(int fd, AUDIO_BILINGUAL_CHANNEL_SELECT, struct audio_channel_select *select)``
22		23
23	Arguments	24	Arguments
24	---------	25	---------
@@ -39,7 +40,6 @@ Arguments · 14 unmodified lines
39		40
40	- Select the output format of the audio (mono left/right, stereo).	41	- Select the output format of the audio (mono left/right, stereo).
41		42
42
43	Description	43	Description
44	-----------	44	-----------
45		45
@@ -50,7 +50,6 @@ for MPEG decoders controlled through V4L2. · 4 unmodified lines
50	This ioctl call asks the Audio Device to select the requested channel	50	This ioctl call asks the Audio Device to select the requested channel
51	for bilingual streams if possible.	51	for bilingual streams if possible.
52		52
53
54	Return Value	53	Return Value
55	------------	54	------------
56		55

Documentation/userspace-api/media/dvb/audio-channel-select.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.audio
 .. _AUDIO_CHANNEL_SELECT:
 Synopsis
 --------
-.. c:function:: int ioctl(int fd, AUDIO_CHANNEL_SELECT, struct *audio_channel_select)
+.. c:macro:: AUDIO_CHANNEL_SELECT
-    :name: AUDIO_CHANNEL_SELECT
+``int ioctl(int fd, AUDIO_CHANNEL_SELECT, struct audio_channel_select *select)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -
        -  int fd
        -  Select the output format of the audio (mono left/right, stereo).
 Description
 -----------
 This ioctl call asks the Audio Device to select the requested channel if
 possible.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/audio-clear-buffer.rst+4−4

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.audio
2		3
3	.. _AUDIO_CLEAR_BUFFER:	4	.. _AUDIO_CLEAR_BUFFER:
4		5
@@ -16,8 +17,9 @@ AUDIO_CLEAR_BUFFER · 11 unmodified lines
16	Synopsis	17	Synopsis
17	--------	18	--------
18		19
19	.. c:function:: int ioctl(int fd, AUDIO_CLEAR_BUFFER)	20	.. c:macro:: AUDIO_CLEAR_BUFFER
20	:name: AUDIO_CLEAR_BUFFER	21
		22	``int ioctl(int fd, AUDIO_CLEAR_BUFFER)``
21		23
22	Arguments	24	Arguments
23	---------	25	---------
@@ -26,7 +28,6 @@ Arguments · 2 unmodified lines
26	:header-rows: 0	28	:header-rows: 0
27	:stub-columns: 0	29	:stub-columns: 0
28		30
29
30	- .. row 1	31	- .. row 1
31		32
32	- int fd	33	- int fd
@@ -39,7 +40,6 @@ Description · 6 unmodified lines
39	This ioctl call asks the Audio Device to clear all software and hardware	40	This ioctl call asks the Audio Device to clear all software and hardware
40	buffers of the audio decoder device.	41	buffers of the audio decoder device.
41		42
42
43	Return Value	43	Return Value
44	------------	44	------------
45		45

Documentation/userspace-api/media/dvb/audio-continue.rst+3−4

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.audio
 .. _AUDIO_CONTINUE:
 Synopsis
 --------
-.. c:function:: int  ioctl(int fd, AUDIO_CONTINUE)
+.. c:macro:: AUDIO_CONTINUE
-    :name: AUDIO_CONTINUE
+``int ioctl(int fd, AUDIO_CONTINUE)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
 This ioctl restarts the decoding and playing process previously paused
 with AUDIO_PAUSE command.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/audio-fclose.rst+1−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.audio
 .. _audio_fclose:
 --------
 .. c:function:: int close(int fd)
-    :name: dvb-audio-close
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  File descriptor returned by a previous call to open().
 Description
 -----------
 This system call closes a previously opened audio device.
 Return Value
 ------------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  ``EBADF``

Documentation/userspace-api/media/dvb/audio-fopen.rst+1−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.audio
 .. _audio_fopen:
 --------
 .. c:function:: int open(const char *deviceName, int flags)
-    :name: dvb-audio-open
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  const char \*deviceName
        -
        -  (blocking mode is the default)
 Description
 -----------
 in O_RDONLY mode, the only ioctl call that can be used is
 AUDIO_GET_STATUS. All other call will return with an error code.
 Return Value
 ------------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  ``ENODEV``

Documentation/userspace-api/media/dvb/audio-fwrite.rst+1−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.audio
 .. _audio_fwrite:
 --------
 .. c:function:: size_t write(int fd, const void *buf, size_t count)
-    :name: dvb-audio-write
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Size of buf.
 Description
 -----------
 until buffer space is available. The amount of data to be transferred is
 implied by count.
 Return Value
 ------------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  ``EPERM``

Documentation/userspace-api/media/dvb/audio-get-capabilities.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.audio
 .. _AUDIO_GET_CAPABILITIES:
 Synopsis
 --------
-.. c:function:: int ioctl(int fd, AUDIO_GET_CAPABILITIES, unsigned int *cap)
+.. c:macro:: AUDIO_GET_CAPABILITIES
-    :name: AUDIO_GET_CAPABILITIES
+``int ioctl(int fd, AUDIO_GET_CAPABILITIES, unsigned int *cap)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -
        -  int fd
        -  Returns a bit array of supported sound formats.
 Description
 -----------
 This ioctl call asks the Audio Device to tell us about the decoding
 capabilities of the audio hardware.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/audio-get-status.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.audio
 .. _AUDIO_GET_STATUS:
 Synopsis
 --------
-.. c:function:: int ioctl(int fd, AUDIO_GET_STATUS, struct audio_status *status)
+.. c:macro:: AUDIO_GET_STATUS
-    :name: AUDIO_GET_STATUS
+``int ioctl(int fd, AUDIO_GET_STATUS, struct audio_status *status)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -
        -  int fd
        -  Returns the current state of Audio Device.
 Description
 -----------
 This ioctl call asks the Audio Device to return the current state of the
 Audio Device.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/audio-pause.rst+4−5

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.audio
2		3
3	.. _AUDIO_PAUSE:	4	.. _AUDIO_PAUSE:
4		5
@@ -16,8 +17,9 @@ AUDIO_PAUSE · 11 unmodified lines
16	Synopsis	17	Synopsis
17	--------	18	--------
18		19
19	.. c:function:: int ioctl(int fd, AUDIO_PAUSE)	20	.. c:macro:: AUDIO_PAUSE
20	:name: AUDIO_PAUSE	21
		22	``int ioctl(int fd, AUDIO_PAUSE)``
21		23
22	Arguments	24	Arguments
23	---------	25	---------
@@ -26,14 +28,12 @@ Arguments · 2 unmodified lines
26	:header-rows: 0	28	:header-rows: 0
27	:stub-columns: 0	29	:stub-columns: 0
28		30
29
30	- .. row 1	31	- .. row 1
31		32
32	- int fd	33	- int fd
33		34
34	- File descriptor returned by a previous call to open().	35	- File descriptor returned by a previous call to open().
35		36
36
37	Description	37	Description
38	-----------	38	-----------
39		39
@@ -41,7 +41,6 @@ This ioctl call suspends the audio stream being played. Decoding and · 1 unmodified line
41	playing are paused. It is then possible to restart again decoding and	41	playing are paused. It is then possible to restart again decoding and
42	playing process of the audio stream using AUDIO_CONTINUE command.	42	playing process of the audio stream using AUDIO_CONTINUE command.
43		43
44
45	Return Value	44	Return Value
46	------------	45	------------
47		46

Documentation/userspace-api/media/dvb/audio-play.rst+3−4

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.audio
 .. _AUDIO_PLAY:
 Synopsis
 --------
-.. c:function:: int  ioctl(int fd, AUDIO_PLAY)
+.. c:macro:: AUDIO_PLAY
-    :name: AUDIO_PLAY
+``int ioctl(int fd, AUDIO_PLAY)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
 This ioctl call asks the Audio Device to start playing an audio stream
 from the selected source.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/audio-select-source.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.audio
 .. _AUDIO_SELECT_SOURCE:
 Synopsis
 --------
-.. c:function:: int ioctl(int fd, AUDIO_SELECT_SOURCE, struct audio_stream_source *source)
+.. c:macro:: AUDIO_SELECT_SOURCE
-    :name: AUDIO_SELECT_SOURCE
+``int ioctl(int fd, AUDIO_SELECT_SOURCE, struct audio_stream_source *source)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -
        -  int fd
        -  Indicates the source that shall be used for the Audio stream.
 Description
 -----------
 AUDIO_SOURCE_MEMORY is selected, the data is fed to the Audio Device
 through the write command.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/audio-set-av-sync.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.audio
 .. _AUDIO_SET_AV_SYNC:
 Synopsis
 --------
-.. c:function:: int  ioctl(int fd, AUDIO_SET_AV_SYNC, boolean state)
+.. c:macro:: AUDIO_SET_AV_SYNC
-    :name: AUDIO_SET_AV_SYNC
+``int ioctl(int fd, AUDIO_SET_AV_SYNC, boolean state)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -
        -  int fd
           FALSE: AV-sync OFF
 Description
 -----------
 This ioctl call asks the Audio Device to turn ON or OFF A/V
 synchronization.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/audio-set-bypass-mode.rst+4−5

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.audio
2		3
3	.. _AUDIO_SET_BYPASS_MODE:	4	.. _AUDIO_SET_BYPASS_MODE:
4		5
@@ -16,8 +17,9 @@ AUDIO_SET_BYPASS_MODE · 11 unmodified lines
16	Synopsis	17	Synopsis
17	--------	18	--------
18		19
19	.. c:function:: int ioctl(int fd, AUDIO_SET_BYPASS_MODE, boolean mode)	20	.. c:macro:: AUDIO_SET_BYPASS_MODE
20	:name: AUDIO_SET_BYPASS_MODE	21
		22	``int ioctl(int fd, AUDIO_SET_BYPASS_MODE, boolean mode)``
21		23
22	Arguments	24	Arguments
23	---------	25	---------
@@ -26,7 +28,6 @@ Arguments · 2 unmodified lines
26	:header-rows: 0	28	:header-rows: 0
27	:stub-columns: 0	29	:stub-columns: 0
28		30
29
30	-	31	-
31		32
32	- int fd	33	- int fd
@@ -44,7 +45,6 @@ Arguments · 11 unmodified lines
44		45
45	FALSE: Bypass is enabled	46	FALSE: Bypass is enabled
46		47
47
48	Description	48	Description
49	-----------	49	-----------
50		50
@@ -54,7 +54,6 @@ that can’t be handled by the Digital TV system shall be decoded. Dolby · 3 unmodified lines
54	DigitalTM streams are automatically forwarded by the Digital TV subsystem if	54	DigitalTM streams are automatically forwarded by the Digital TV subsystem if
55	the hardware can handle it.	55	the hardware can handle it.
56		56
57
58	Return Value	57	Return Value
59	------------	58	------------
60		59

Documentation/userspace-api/media/dvb/audio-set-id.rst+4−5

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.audio
2		3
3	.. _AUDIO_SET_ID:	4	.. _AUDIO_SET_ID:
4		5
@@ -16,8 +17,9 @@ AUDIO_SET_ID · 11 unmodified lines
16	Synopsis	17	Synopsis
17	--------	18	--------
18		19
19	.. c:function:: int ioctl(int fd, AUDIO_SET_ID, int id)	20	.. c:macro:: AUDIO_SET_ID
20	:name: AUDIO_SET_ID	21
		22	``int ioctl(int fd, AUDIO_SET_ID, int id)``
21		23
22	Arguments	24	Arguments
23	---------	25	---------
@@ -26,7 +28,6 @@ Arguments · 2 unmodified lines
26	:header-rows: 0	28	:header-rows: 0
27	:stub-columns: 0	29	:stub-columns: 0
28		30
29
30	-	31	-
31		32
32	- int fd	33	- int fd
@@ -39,7 +40,6 @@ Arguments · 6 unmodified lines
39		40
40	- audio sub-stream id	41	- audio sub-stream id
41		42
42
43	Description	43	Description
44	-----------	44	-----------
45		45
@@ -51,7 +51,6 @@ other stream types. If the stream type is set the id just specifies the · 5 unmodified lines
51	substream id of the audio stream and only the first 5 bits are	51	substream id of the audio stream and only the first 5 bits are
52	recognized.	52	recognized.
53		53
54
55	Return Value	54	Return Value
56	------------	55	------------
57		56

Documentation/userspace-api/media/dvb/audio-set-mixer.rst+4−5

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.audio
2		3
3	.. _AUDIO_SET_MIXER:	4	.. _AUDIO_SET_MIXER:
4		5
@@ -16,8 +17,9 @@ AUDIO_SET_MIXER · 11 unmodified lines
16	Synopsis	17	Synopsis
17	--------	18	--------
18		19
19	.. c:function:: int ioctl(int fd, AUDIO_SET_MIXER, struct audio_mixer *mix)	20	.. c:macro:: AUDIO_SET_MIXER
20	:name: AUDIO_SET_MIXER	21
		22	``int ioctl(int fd, AUDIO_SET_MIXER, struct audio_mixer *mix)``
21		23
22	Arguments	24	Arguments
23	---------	25	---------
@@ -26,7 +28,6 @@ Arguments · 2 unmodified lines
26	:header-rows: 0	28	:header-rows: 0
27	:stub-columns: 0	29	:stub-columns: 0
28		30
29
30	-	31	-
31		32
32	- int fd	33	- int fd
@@ -39,13 +40,11 @@ Arguments · 6 unmodified lines
39		40
40	- mixer settings.	41	- mixer settings.
41		42
42
43	Description	43	Description
44	-----------	44	-----------
45		45
46	This ioctl lets you adjust the mixer settings of the audio decoder.	46	This ioctl lets you adjust the mixer settings of the audio decoder.
47		47
48
49	Return Value	48	Return Value
50	------------	49	------------
51		50

Documentation/userspace-api/media/dvb/audio-set-mute.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.audio
 .. _AUDIO_SET_MUTE:
 Synopsis
 --------
-.. c:function:: int  ioctl(int fd, AUDIO_SET_MUTE, boolean state)
+.. c:macro:: AUDIO_SET_MUTE
-    :name: AUDIO_SET_MUTE
+``int ioctl(int fd, AUDIO_SET_MUTE, boolean state)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -
        -  int fd
           FALSE: Audio Un-mute
 Description
 -----------
 This ioctl call asks the audio device to mute the stream that is
 currently being played.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/audio-set-streamtype.rst+3−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.audio
 .. _AUDIO_SET_STREAMTYPE:
 Synopsis
 --------
-.. c:function:: int  ioctl(fd, AUDIO_SET_STREAMTYPE, int type)
+.. c:macro:: AUDIO_SET_STREAMTYPE
-    :name: AUDIO_SET_STREAMTYPE
+``int ioctl(fd, AUDIO_SET_STREAMTYPE, int type)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -
        -  int fd
        -  stream type
 Description
 -----------
 is useful if the stream offers several audio sub-streams like LPCM and
 AC3.
 Return Value
 ------------
 :ref:`Generic Error Codes <gen-errors>` chapter.
 .. flat-table::
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  ``EINVAL``

Documentation/userspace-api/media/dvb/audio-stop.rst+4−5

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.audio
2		3
3	.. _AUDIO_STOP:	4	.. _AUDIO_STOP:
4		5
@@ -16,8 +17,9 @@ AUDIO_STOP · 11 unmodified lines
16	Synopsis	17	Synopsis
17	--------	18	--------
18		19
19	.. c:function:: int ioctl(int fd, AUDIO_STOP)	20	.. c:macro:: AUDIO_STOP
20	:name: AUDIO_STOP	21
		22	``int ioctl(int fd, AUDIO_STOP)``
21		23
22	Arguments	24	Arguments
23	---------	25	---------
@@ -26,21 +28,18 @@ Arguments · 2 unmodified lines
26	:header-rows: 0	28	:header-rows: 0
27	:stub-columns: 0	29	:stub-columns: 0
28		30
29
30	- .. row 1	31	- .. row 1
31		32
32	- int fd	33	- int fd
33		34
34	- File descriptor returned by a previous call to open().	35	- File descriptor returned by a previous call to open().
35		36
36
37	Description	37	Description
38	-----------	38	-----------
39		39
40	This ioctl call asks the Audio Device to stop playing the current	40	This ioctl call asks the Audio Device to stop playing the current
41	stream.	41	stream.
42		42
43
44	Return Value	43	Return Value
45	------------	44	------------
46		45

Documentation/userspace-api/media/dvb/ca-fclose.rst+2−5

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.ca
2		3
3	.. _ca_fclose:	4	.. _ca_fclose:
4		5
@@ -11,26 +12,22 @@ Name · 6 unmodified lines
11		12
12	Digital TV CA close()	13	Digital TV CA close()
13		14
14
15	Synopsis	15	Synopsis
16	--------	16	--------
17		17
18	.. c:function:: int close(int fd)	18	.. c:function:: int close(int fd)
19	:name: dvb-ca-close
20
21		19
22	Arguments	20	Arguments
23	---------	21	---------
24		22
25	``fd``	23	``fd``
26	File descriptor returned by a previous call to :c:func:`open() <dvb-ca-open>`.	24	File descriptor returned by a previous call to :c:func:`open()`.
27		25
28	Description	26	Description
29	-----------	27	-----------
30		28
31	This system call closes a previously opened CA device.	29	This system call closes a previously opened CA device.
32		30
33
34	Return Value	31	Return Value
35	------------	32	------------
36		33

Documentation/userspace-api/media/dvb/ca-fopen.rst+1−6

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.ca
2		3
3	.. _ca_fopen:	4	.. _ca_fopen:
4		5
@@ -11,13 +12,10 @@ Name · 6 unmodified lines
11		12
12	Digital TV CA open()	13	Digital TV CA open()
13		14
14
15	Synopsis	15	Synopsis
16	--------	16	--------
17		17
18	.. c:function:: int open(const char *name, int flags)	18	.. c:function:: int open(const char *name, int flags)
19	:name: dvb-ca-open
20
21		19
22	Arguments	20	Arguments
23	---------	21	---------
@@ -45,7 +43,6 @@ Arguments · 21 unmodified lines
45	- open in non-blocking mode	43	- open in non-blocking mode
46	(blocking mode is the default)	44	(blocking mode is the default)
47		45
48
49	Description	46	Description
50	-----------	47	-----------
51		48
@@ -63,11 +60,9 @@ Only one user can open the CA Device in ``O_RDWR`` mode. All other · 11 unmodified lines
63	attempts to open the device in this mode will fail, and an error code	60	attempts to open the device in this mode will fail, and an error code
64	will be returned.	61	will be returned.
65		62
66
67	Return Value	63	Return Value
68	------------	64	------------
69		65
70
71	On success 0 is returned.	66	On success 0 is returned.
72		67
73	On error -1 is returned, and the ``errno`` variable is set	68	On error -1 is returned, and the ``errno`` variable is set

Documentation/userspace-api/media/dvb/ca-get-cap.rst+4−4

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.ca
 .. _CA_GET_CAP:
 CA_GET_CAP
 Synopsis
 --------
-.. c:function:: int ioctl(fd, CA_GET_CAP, struct ca_caps *caps)
+.. c:macro:: CA_GET_CAP
-    :name: CA_GET_CAP
+``int ioctl(fd, CA_GET_CAP, struct ca_caps *caps)``
 Arguments
 ---------
 ``fd``
-  File descriptor returned by a previous call to :c:func:`open() <dvb-ca-open>`.
+  File descriptor returned by a previous call to :c:func:`open()`.
 ``caps``
   Pointer to struct :c:type:`ca_caps`.

Documentation/userspace-api/media/dvb/ca-get-descr-info.rst+5−4

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.ca
2		3
3	.. _CA_GET_DESCR_INFO:	4	.. _CA_GET_DESCR_INFO:
4		5
@@ -11,18 +12,18 @@ Name · 6 unmodified lines
11		12
12	CA_GET_DESCR_INFO	13	CA_GET_DESCR_INFO
13		14
14
15	Synopsis	15	Synopsis
16	--------	16	--------
17		17
18	.. c:function:: int ioctl(fd, CA_GET_DESCR_INFO, struct ca_descr_info *desc)	18	.. c:macro:: CA_GET_DESCR_INFO
19	:name: CA_GET_DESCR_INFO	19
		20	``int ioctl(fd, CA_GET_DESCR_INFO, struct ca_descr_info *desc)``
20		21
21	Arguments	22	Arguments
22	---------	23	---------
23		24
24	``fd``	25	``fd``
25	File descriptor returned by a previous call to :c:func:`open() <dvb-ca-open>`.	26	File descriptor returned by a previous call to :c:func:`open()`.
26		27
27	``desc``	28	``desc``
28	Pointer to struct :c:type:`ca_descr_info`.	29	Pointer to struct :c:type:`ca_descr_info`.

Documentation/userspace-api/media/dvb/ca-get-msg.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.ca
 .. _CA_GET_MSG:
 CA_GET_MSG
 Synopsis
 --------
-.. c:function:: int ioctl(fd, CA_GET_MSG, struct ca_msg *msg)
+.. c:macro:: CA_GET_MSG
-    :name: CA_GET_MSG
+``int ioctl(fd, CA_GET_MSG, struct ca_msg *msg)``
 Arguments
 ---------
 ``fd``
-  File descriptor returned by a previous call to :c:func:`open() <dvb-ca-open>`.
+  File descriptor returned by a previous call to :c:func:`open()`.
 ``msg``
   Pointer to struct :c:type:`ca_msg`.
    Please notice that, on most drivers, this is done by reading from
    the /dev/adapter?/ca? device node.
 Return Value
 ------------
 On success 0 is returned.
 On error -1 is returned, and the ``errno`` variable is set

Documentation/userspace-api/media/dvb/ca-get-slot-info.rst+4−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.ca
 .. _CA_GET_SLOT_INFO:
 CA_GET_SLOT_INFO
 Synopsis
 --------
-.. c:function:: int ioctl(fd, CA_GET_SLOT_INFO, struct ca_slot_info *info)
+.. c:macro:: CA_GET_SLOT_INFO
-    :name: CA_GET_SLOT_INFO
+``int ioctl(fd, CA_GET_SLOT_INFO, struct ca_slot_info *info)``
 Arguments
 ---------
 ``fd``
-  File descriptor returned by a previous call to :c:func:`open() <cec-open>`.
+  File descriptor returned by a previous call to :c:func:`open()`.
 ``info``
   Pointer to struct :c:type:`ca_slot_info`.
 Returns information about a CA slot identified by
 :c:type:`ca_slot_info`.slot_num.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/ca-reset.rst+4−5

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.ca
2		3
3	.. _CA_RESET:	4	.. _CA_RESET:
4		5
@@ -11,19 +12,18 @@ Name · 6 unmodified lines
11		12
12	CA_RESET	13	CA_RESET
13		14
14
15	Synopsis	15	Synopsis
16	--------	16	--------
17		17
18	.. c:function:: int ioctl(fd, CA_RESET)	18	.. c:macro:: CA_RESET
19	:name: CA_RESET
20		19
		20	``int ioctl(fd, CA_RESET)``
21		21
22	Arguments	22	Arguments
23	---------	23	---------
24		24
25	``fd``	25	``fd``
26	File descriptor returned by a previous call to :c:func:`open() <cec-open>`.	26	File descriptor returned by a previous call to :c:func:`open()`.
27		27
28	Description	28	Description
29	-----------	29	-----------
@@ -31,7 +31,6 @@ Description · 1 unmodified line
31	Puts the Conditional Access hardware on its initial state. It should	31	Puts the Conditional Access hardware on its initial state. It should
32	be called before start using the CA hardware.	32	be called before start using the CA hardware.
33		33
34
35	Return Value	34	Return Value
36	------------	35	------------
37		36

Documentation/userspace-api/media/dvb/ca-send-msg.rst+4−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.ca
 .. _CA_SEND_MSG:
 CA_SEND_MSG
 Synopsis
 --------
-.. c:function:: int ioctl(fd, CA_SEND_MSG, struct ca_msg *msg)
+.. c:macro:: CA_SEND_MSG
-    :name: CA_SEND_MSG
+``int ioctl(fd, CA_SEND_MSG, struct ca_msg *msg)``
 Arguments
 ---------
 ``fd``
-  File descriptor returned by a previous call to :c:func:`open() <cec-open>`.
+  File descriptor returned by a previous call to :c:func:`open()`.
 ``msg``
   Pointer to struct :c:type:`ca_msg`.
 Description
 -----------

Documentation/userspace-api/media/dvb/ca-set-descr.rst+4−4

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.ca
 .. _CA_SET_DESCR:
 CA_SET_DESCR
 Synopsis
 --------
-.. c:function:: int ioctl(fd, CA_SET_DESCR, struct ca_descr *desc)
+.. c:macro:: CA_SET_DESCR
-    :name: CA_SET_DESCR
+``int ioctl(fd, CA_SET_DESCR, struct ca_descr *desc)``
 Arguments
 ---------
 ``fd``
-  File descriptor returned by a previous call to :c:func:`open() <cec-open>`.
+  File descriptor returned by a previous call to :c:func:`open()`.
 ``msg``
   Pointer to struct :c:type:`ca_descr`.

Documentation/userspace-api/media/dvb/dmx-add-pid.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.dmx
 .. _DMX_ADD_PID:
 DMX_ADD_PID
 Synopsis
 --------
-.. c:function:: int ioctl(fd, DMX_ADD_PID, __u16 *pid)
+.. c:macro:: DMX_ADD_PID
-    :name: DMX_ADD_PID
+``int ioctl(fd, DMX_ADD_PID, __u16 *pid)``
 Arguments
 ---------
 ``fd``
-    File descriptor returned by :c:func:`open() <dvb-dmx-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``pid``
    PID number to be filtered.
 Description
 -----------
 previously set up with :ref:`DMX_SET_PES_FILTER` and output equal to
 :c:type:`DMX_OUT_TSDEMUX_TAP <dmx_output>`.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/dmx-expbuf.rst+4−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.dmx
 .. _DMX_EXPBUF:
 .. warning:: this API is still experimental
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, DMX_EXPBUF, struct dmx_exportbuffer *argp )
+.. c:macro:: DMX_EXPBUF
-    :name: DMX_EXPBUF
+``int ioctl(int fd, DMX_EXPBUF, struct dmx_exportbuffer *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <dmx_fopen>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`dmx_exportbuffer`.
 Description
 ===========
 pass it to other DMABUF-aware devices. It is recommended to close a DMABUF
 file when it is no longer used to allow the associated memory to be reclaimed.
 Examples
 ========
 .. code-block:: c
     int buffer_export(int v4lfd, enum dmx_buf_type bt, int index, int *dmafd)

Documentation/userspace-api/media/dvb/dmx-fclose.rst+3−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.dmx
 .. _dmx_fclose:
 Digital TV demux close()
 Synopsis
 --------
 .. c:function:: int close(int fd)
-    :name: dvb-dmx-close
 Arguments
 ---------
 ``fd``
   File descriptor returned by a previous call to
-  :c:func:`open() <dvb-dmx-open>`.
+  :c:func:`open()`.
 Description
 -----------
 This system call deactivates and deallocates a filter that was
-previously allocated via the :c:func:`open() <dvb-dmx-open>` call.
+previously allocated via the :c:func:`open()` call.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/dmx-fopen.rst+1−4

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.dmx
 .. _dmx_fopen:
 Digital TV demux open()
 Synopsis
 --------
 .. c:function:: int open(const char *deviceName, int flags)
-    :name: dvb-dmx-open
 Arguments
 ---------
        - open in non-blocking mode
          (blocking mode is the default)
 Description
 -----------
 in blocking mode can later be put into non-blocking mode (and vice versa)
 using the ``F_SETFL`` command of the fcntl system call.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/dmx-fread.rst+2−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.dmx
 .. _dmx_fread:
 Digital TV demux read()
 Synopsis
 --------
 .. c:function:: size_t read(int fd, void *buf, size_t count)
-    :name: dvb-dmx-read
 Arguments
 ---------
 ``fd``
-  File descriptor returned by a previous call to :c:func:`open() <dvb-ca-open>`.
+  File descriptor returned by a previous call to :c:func:`open()`.
  ``buf``
    Buffer to be filled
    :c:type:`DMX_CHECK_CRC <dmx_sct_filter_params>` flag set,
    data that fails on CRC check will be silently ignored.
 Return Value
 ------------
        -  The driver failed to write to the callers buffer due to an
           invalid \*buf pointer.
 The generic error codes are described at the
 :ref:`Generic Error Codes <gen-errors>` chapter.

Documentation/userspace-api/media/dvb/dmx-fwrite.rst+2−4

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.dmx
 .. _dmx_fwrite:
 Digital TV demux write()
 Synopsis
 --------
 .. c:function:: ssize_t write(int fd, const void *buf, size_t count)
-    :name: dvb-dmx-write
 Arguments
 ---------
 ``fd``
-  File descriptor returned by a previous call to :c:func:`open() <dvb-ca-open>`.
+  File descriptor returned by a previous call to :c:func:`open()`.
 ``buf``
      Buffer with data to be written
 in the corresponding physical demux device, ``/dev/dvb/adapter?/demux?``.
 The amount of data to be transferred is implied by count.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/dmx-get-pes-pids.rst+5−7

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.dmx
2		3
3	.. _DMX_GET_PES_PIDS:	4	.. _DMX_GET_PES_PIDS:
4		5
@@ -11,23 +12,22 @@ Name · 6 unmodified lines
11		12
12	DMX_GET_PES_PIDS	13	DMX_GET_PES_PIDS
13		14
14
15	Synopsis	15	Synopsis
16	--------	16	--------
17		17
18	.. c:function:: int ioctl(fd, DMX_GET_PES_PIDS, __u16 pids[5])	18	.. c:macro:: DMX_GET_PES_PIDS
19	:name: DMX_GET_PES_PIDS	19
		20	``int ioctl(fd, DMX_GET_PES_PIDS, __u16 pids[5])``
20		21
21	Arguments	22	Arguments
22	---------	23	---------
23		24
24	``fd``	25	``fd``
25	File descriptor returned by :c:func:`open() <dvb-dmx-open>`.	26	File descriptor returned by :c:func:`open()`.
26		27
27	``pids``	28	``pids``
28	Array used to store 5 Program IDs.	29	Array used to store 5 Program IDs.
29		30
30
31	Description	31	Description
32	-----------	32	-----------
33		33
@@ -45,13 +45,11 @@ pids[DMX_PES_SUBTITLE] 3 first subtitle PID · 11 unmodified lines
45	pids[DMX_PES_PCR] 4 first Program Clock Reference PID	45	pids[DMX_PES_PCR] 4 first Program Clock Reference PID
46	======================= ======== =======================================	46	======================= ======== =======================================
47		47
48
49	.. note::	48	.. note::
50		49
51	A value equal to 0xffff means that the PID was not filled by the	50	A value equal to 0xffff means that the PID was not filled by the
52	Kernel.	51	Kernel.
53		52
54
55	Return Value	53	Return Value
56	------------	54	------------
57		55

Documentation/userspace-api/media/dvb/dmx-get-stc.rst+5−7

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.dmx
2		3
3	.. _DMX_GET_STC:	4	.. _DMX_GET_STC:
4		5
@@ -11,23 +12,22 @@ Name · 6 unmodified lines
11		12
12	DMX_GET_STC	13	DMX_GET_STC
13		14
14
15	Synopsis	15	Synopsis
16	--------	16	--------
17		17
18	.. c:function:: int ioctl( int fd, DMX_GET_STC, struct dmx_stc *stc)	18	.. c:macro:: DMX_GET_STC
19	:name: DMX_GET_STC	19
		20	``int ioctl(int fd, DMX_GET_STC, struct dmx_stc *stc)``
20		21
21	Arguments	22	Arguments
22	---------	23	---------
23		24
24	``fd``	25	``fd``
25	File descriptor returned by :c:func:`open() <dvb-dmx-open>`.	26	File descriptor returned by :c:func:`open()`.
26		27
27	``stc``	28	``stc``
28	Pointer to :c:type:`dmx_stc` where the stc data is to be stored.	29	Pointer to :c:type:`dmx_stc` where the stc data is to be stored.
29		30
30
31	Description	31	Description
32	-----------	32	-----------
33		33
@@ -39,7 +39,6 @@ The result is returned in form of a ratio with a 64 bit numerator · 5 unmodified lines
39	and a 32 bit denominator, so the real 90kHz STC value is	39	and a 32 bit denominator, so the real 90kHz STC value is
40	``stc->stc / stc->base``.	40	``stc->stc / stc->base``.
41		41
42
43	Return Value	42	Return Value
44	------------	43	------------
45		44
@@ -61,6 +60,5 @@ appropriately. · 15 unmodified lines
61		60
62	- Invalid stc number.	61	- Invalid stc number.
63		62
64
65	The generic error codes are described at the	63	The generic error codes are described at the
66	:ref:`Generic Error Codes <gen-errors>` chapter.	64	:ref:`Generic Error Codes <gen-errors>` chapter.

Documentation/userspace-api/media/dvb/dmx-mmap.rst+6−9

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.dmx
 .. _dmx-mmap:
     #include <unistd.h>
     #include <sys/mman.h>
 .. c:function:: void *mmap( void *start, size_t length, int prot, int flags, int fd, off_t offset )
-    :name: dmx-mmap
 Arguments
 =========
     ``MAP_FIXED`` requests that the driver selects no other address than
     the one specified. If the specified address cannot be used,
-    :ref:`mmap() <dmx-mmap>` will fail. If ``MAP_FIXED`` is specified,
+    :c:func:`mmap()` will fail. If ``MAP_FIXED`` is specified,
     ``start`` must be a multiple of the pagesize. Use of this option is
     discouraged.
        flags.
 ``fd``
-    File descriptor returned by :ref:`open() <dmx_fopen>`.
+    File descriptor returned by :c:func:`open()`.
 ``offset``
     Offset of the buffer in device memory, as returned by
     :ref:`DMX_QUERYBUF` ioctl.
 Description
 ===========
-The :ref:`mmap() <dmx-mmap>` function asks to map ``length`` bytes starting at
+The :c:func:`mmap()` function asks to map ``length`` bytes starting at
 ``offset`` in the memory of the device specified by ``fd`` into the
 application address space, preferably at address ``start``. This latter
 address is a hint only, and is usually specified as 0.
 :ref:`DMX_QUERYBUF` ioctl. Buffers must be allocated with the
 :ref:`DMX_REQBUFS` ioctl before they can be queried.
-To unmap buffers the :ref:`munmap() <dmx-munmap>` function is used.
+To unmap buffers the :c:func:`munmap()` function is used.
 Return Value
 ============
-On success :ref:`mmap() <dmx-mmap>` returns a pointer to the mapped buffer. On
+On success :c:func:`mmap()` returns a pointer to the mapped buffer. On
 error ``MAP_FAILED`` (-1) is returned, and the ``errno`` variable is set
 appropriately. Possible error codes are:

Documentation/userspace-api/media/dvb/dmx-munmap.rst+5−9

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.dmx
 .. _dmx-munmap:
 .. warning:: This API is still experimental.
 Synopsis
 ========
     #include <unistd.h>
     #include <sys/mman.h>
 .. c:function:: int munmap( void *start, size_t length )
-    :name: dmx-munmap
 Arguments
 =========
 ``start``
     Address of the mapped buffer as returned by the
-    :ref:`mmap() <dmx-mmap>` function.
+    :c:func:`mmap()` function.
 ``length``
     Length of the mapped buffer. This must be the same value as given to
-    :ref:`mmap() <dmx-mmap>`.
+    :c:func:`mmap()`.
 Description
 ===========
-Unmaps a previously with the :ref:`mmap() <dmx-mmap>` function mapped
+Unmaps a previously with the :c:func:`mmap()` function mapped
 buffer and frees it, if possible.
 Return Value
 ============
-On success :ref:`munmap() <dmx-munmap>` returns 0, on failure -1 and the
+On success :c:func:`munmap()` returns 0, on failure -1 and the
 ``errno`` variable is set appropriately:
 EINVAL

Documentation/userspace-api/media/dvb/dmx-qbuf.rst+8−9

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.dmx
2		3
3	.. _DMX_QBUF:	4	.. _DMX_QBUF:
4		5
@@ -13,27 +14,26 @@ DMX_QBUF - DMX_DQBUF - Exchange a buffer with the driver · 8 unmodified lines
13		14
14	.. warning:: this API is still experimental	15	.. warning:: this API is still experimental
15		16
16
17	Synopsis	17	Synopsis
18	========	18	========
19		19
20	.. c:function:: int ioctl( int fd, DMX_QBUF, struct dmx_buffer *argp )	20	.. c:macro:: DMX_QBUF
21	:name: DMX_QBUF	21
		22	``int ioctl(int fd, DMX_QBUF, struct dmx_buffer *argp)``
22		23
23	.. c:function:: int ioctl( int fd, DMX_DQBUF, struct dmx_buffer *argp )	24	.. c:macro:: DMX_DQBUF
24	:name: DMX_DQBUF
25		25
		26	``int ioctl(int fd, DMX_DQBUF, struct dmx_buffer *argp)``
26		27
27	Arguments	28	Arguments
28	=========	29	=========
29		30
30	``fd``	31	``fd``
31	File descriptor returned by :ref:`open() <dmx_fopen>`.	32	File descriptor returned by :c:func:`open()`.
32		33
33	``argp``	34	``argp``
34	Pointer to struct :c:type:`dmx_buffer`.	35	Pointer to struct :c:type:`dmx_buffer`.
35		36
36
37	Description	37	Description
38	===========	38	===========
39		39
@@ -60,13 +60,12 @@ the driver fills the remaining fields or returns an error code. · 20 unmodified lines
60		60
61	By default ``DMX_DQBUF`` blocks when no buffer is in the outgoing	61	By default ``DMX_DQBUF`` blocks when no buffer is in the outgoing
62	queue. When the ``O_NONBLOCK`` flag was given to the	62	queue. When the ``O_NONBLOCK`` flag was given to the
63	:ref:`open() <dmx_fopen>` function, ``DMX_DQBUF`` returns	63	:c:func:`open()` function, ``DMX_DQBUF`` returns
64	immediately with an ``EAGAIN`` error code when no buffer is available.	64	immediately with an ``EAGAIN`` error code when no buffer is available.
65		65
66	The struct :c:type:`dmx_buffer` structure is specified in	66	The struct :c:type:`dmx_buffer` structure is specified in
67	:ref:`buffer`.	67	:ref:`buffer`.
68		68
69
70	Return Value	69	Return Value
71	============	70	============
72		71

Documentation/userspace-api/media/dvb/dmx-querybuf.rst+4−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.dmx
 .. _DMX_QUERYBUF:
 .. warning:: this API is still experimental
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, DMX_QUERYBUF, struct dvb_buffer *argp )
+.. c:macro:: DMX_QUERYBUF
-    :name: DMX_QUERYBUF
+``int ioctl(int fd, DMX_QUERYBUF, struct dvb_buffer *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <dmx_fopen>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`dvb_buffer`.
 Description
 ===========

Documentation/userspace-api/media/dvb/dmx-remove-pid.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.dmx
 .. _DMX_REMOVE_PID:
 DMX_REMOVE_PID
 Synopsis
 --------
-.. c:function:: int ioctl(fd, DMX_REMOVE_PID, __u16 *pid)
+.. c:macro:: DMX_REMOVE_PID
-    :name: DMX_REMOVE_PID
+``int ioctl(fd, DMX_REMOVE_PID, __u16 *pid)``
 Arguments
 ---------
 ``fd``
-    File descriptor returned by :c:func:`open() <dvb-dmx-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``pid``
     PID of the PES filter to be removed.
 Description
 -----------
 equal to :c:type:`DMX_OUT_TSDEMUX_TAP <dmx_output>`, created via either
 :ref:`DMX_SET_PES_FILTER` or :ref:`DMX_ADD_PID`.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/dmx-reqbufs.rst+4−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.dmx
 .. _DMX_REQBUFS:
 .. warning:: this API is still experimental
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, DMX_REQBUFS, struct dmx_requestbuffers *argp )
+.. c:macro:: DMX_REQBUFS
-    :name: DMX_REQBUFS
+``int ioctl(int fd, DMX_REQBUFS, struct dmx_requestbuffers *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <dmx_fopen>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`dmx_requestbuffers`.
 A ``count`` value of zero frees all buffers, after aborting or finishing
 any DMA in progress.
 Return Value
 ============

Documentation/userspace-api/media/dvb/dmx-set-buffer-size.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.dmx
 .. _DMX_SET_BUFFER_SIZE:
 DMX_SET_BUFFER_SIZE
 Synopsis
 --------
-.. c:function:: int ioctl( int fd, DMX_SET_BUFFER_SIZE, unsigned long size)
+.. c:macro:: DMX_SET_BUFFER_SIZE
-    :name: DMX_SET_BUFFER_SIZE
+``int ioctl(int fd, DMX_SET_BUFFER_SIZE, unsigned long size)``
 Arguments
 ---------
 ``fd``
-    File descriptor returned by :c:func:`open() <dvb-dmx-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``size``
     Unsigned long size
 this function is not called a buffer size of ``2 * 4096`` bytes will be
 used.
 Return Value
 ------------
 On success 0 is returned.
 On error -1 is returned, and the ``errno`` variable is set

Documentation/userspace-api/media/dvb/dmx-set-filter.rst+5−7

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.dmx
2		3
3	.. _DMX_SET_FILTER:	4	.. _DMX_SET_FILTER:
4		5
@@ -11,24 +12,23 @@ Name · 6 unmodified lines
11		12
12	DMX_SET_FILTER	13	DMX_SET_FILTER
13		14
14
15	Synopsis	15	Synopsis
16	--------	16	--------
17		17
18	.. c:function:: int ioctl( int fd, DMX_SET_FILTER, struct dmx_sct_filter_params *params)	18	.. c:macro:: DMX_SET_FILTER
19	:name: DMX_SET_FILTER	19
		20	``int ioctl(int fd, DMX_SET_FILTER, struct dmx_sct_filter_params *params)``
20		21
21	Arguments	22	Arguments
22	---------	23	---------
23		24
24	``fd``	25	``fd``
25	File descriptor returned by :c:func:`open() <dvb-dmx-open>`.	26	File descriptor returned by :c:func:`open()`.
26		27
27	``params``	28	``params``
28		29
29	Pointer to structure containing filter parameters.	30	Pointer to structure containing filter parameters.
30		31
31
32	Description	32	Description
33	-----------	33	-----------
34		34
@@ -43,11 +43,9 @@ operation should be started immediately (without waiting for a · 8 unmodified lines
43	:ref:`DMX_START` ioctl call). If a filter was previously set-up, this	43	:ref:`DMX_START` ioctl call). If a filter was previously set-up, this
44	filter will be canceled, and the receive buffer will be flushed.	44	filter will be canceled, and the receive buffer will be flushed.
45		45
46
47	Return Value	46	Return Value
48	------------	47	------------
49		48
50
51	On success 0 is returned.	49	On success 0 is returned.
52		50
53	On error -1 is returned, and the ``errno`` variable is set	51	On error -1 is returned, and the ``errno`` variable is set

Documentation/userspace-api/media/dvb/dmx-set-pes-filter.rst+4−9

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.dmx
 .. _DMX_SET_PES_FILTER:
 DMX_SET_PES_FILTER
 Synopsis
 --------
-.. c:function:: int ioctl( int fd, DMX_SET_PES_FILTER, struct dmx_pes_filter_params *params)
+.. c:macro:: DMX_SET_PES_FILTER
-    :name: DMX_SET_PES_FILTER
+``int ioctl(int fd, DMX_SET_PES_FILTER, struct dmx_pes_filter_params *params)``
 Arguments
 ---------
 ``fd``
-    File descriptor returned by :c:func:`open() <dvb-dmx-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``params``
     Pointer to structure containing filter parameters.
 Description
 -----------
 packet identifier (PID), i.e. no PES header or payload filtering
 capability is supported.
 Return Value
 ------------
     :stub-columns: 0
     :widths: 1 16
     -  .. row 1
        -  ``EBUSY``
 	  Make sure that these filters are stopped before starting this
 	  filter.
 The generic error codes are described at the
 :ref:`Generic Error Codes <gen-errors>` chapter.

Documentation/userspace-api/media/dvb/dmx-start.rst+4−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.dmx
 .. _DMX_START:
 DMX_START
 Synopsis
 --------
-.. c:function:: int ioctl( int fd, DMX_START)
+.. c:macro:: DMX_START
-    :name: DMX_START
+``int ioctl(int fd, DMX_START)``
 Arguments
 ---------
 ``fd``
-    File descriptor returned by :c:func:`open() <dvb-dmx-open>`.
+    File descriptor returned by :c:func:`open()`.
 Description
 -----------
 This ioctl call is used to start the actual filtering operation defined
 via the ioctl calls :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER`.
 Return Value
 ------------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  ``EINVAL``
 	  Make sure that these filters are stopped before starting this
 	  filter.
 The generic error codes are described at the
 :ref:`Generic Error Codes <gen-errors>` chapter.

Documentation/userspace-api/media/dvb/dmx-stop.rst+4−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.dmx
 .. _DMX_STOP:
 DMX_STOP
 Synopsis
 --------
-.. c:function:: int ioctl( int fd, DMX_STOP)
+.. c:macro:: DMX_STOP
-    :name: DMX_STOP
+``int ioctl(int fd, DMX_STOP)``
 Arguments
 ---------
 ``fd``
-    File descriptor returned by :c:func:`open() <dvb-dmx-open>`.
+    File descriptor returned by :c:func:`open()`.
 Description
 -----------
 via the ioctl calls :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER` and
 started via the :ref:`DMX_START` command.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/fe-diseqc-recv-slave-reply.rst+4−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_DISEQC_RECV_SLAVE_REPLY:
 FE_DISEQC_RECV_SLAVE_REPLY - Receives reply from a DiSEqC 2.0 command
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, FE_DISEQC_RECV_SLAVE_REPLY, struct dvb_diseqc_slave_reply *argp )
+.. c:macro:: FE_DISEQC_RECV_SLAVE_REPLY
-    :name: FE_DISEQC_RECV_SLAVE_REPLY
+``int ioctl(int fd, FE_DISEQC_RECV_SLAVE_REPLY, struct dvb_diseqc_slave_reply *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <frontend_f_open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     pointer to struct :c:type:`dvb_diseqc_slave_reply`.
 Description
 ===========

Documentation/userspace-api/media/dvb/fe-diseqc-reset-overload.rst+4−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_DISEQC_RESET_OVERLOAD:
 FE_DISEQC_RESET_OVERLOAD - Restores the power to the antenna subsystem, if it was powered off due - to power overload.
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, FE_DISEQC_RESET_OVERLOAD, NULL )
+.. c:macro:: FE_DISEQC_RESET_OVERLOAD
-    :name: FE_DISEQC_RESET_OVERLOAD
+``int ioctl(int fd, FE_DISEQC_RESET_OVERLOAD, NULL)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <frontend_f_open>`.
+    File descriptor returned by :c:func:`open()`.
 Description
 ===========
 read/write access to the device. This call has no effect if the device
 is manually powered off. Not all Digital TV adapters support this ioctl.
 Return Value
 ============

Documentation/userspace-api/media/dvb/fe-diseqc-send-burst.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_DISEQC_SEND_BURST:
 FE_DISEQC_SEND_BURST - Sends a 22KHz tone burst for 2x1 mini DiSEqC satellite selection.
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, FE_DISEQC_SEND_BURST, enum fe_sec_mini_cmd tone )
+.. c:macro:: FE_DISEQC_SEND_BURST
-    :name: FE_DISEQC_SEND_BURST
+``int ioctl(int fd, FE_DISEQC_SEND_BURST, enum fe_sec_mini_cmd tone)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <frontend_f_open>`.
+    File descriptor returned by :c:func:`open()`.
 ``tone``
     An integer enumered value described at :c:type:`fe_sec_mini_cmd`.
 Description
 ===========
 It provides support for what's specified at
 `Digital Satellite Equipment Control (DiSEqC) - Simple "ToneBurst" Detection Circuit specification. <http://www.eutelsat.com/files/contributed/satellites/pdf/Diseqc/associated%20docs/simple_tone_burst_detec.pdf>`__
 Return Value
 ============

Documentation/userspace-api/media/dvb/fe-diseqc-send-master-cmd.rst+4−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_DISEQC_SEND_MASTER_CMD:
 FE_DISEQC_SEND_MASTER_CMD - Sends a DiSEqC command
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, FE_DISEQC_SEND_MASTER_CMD, struct dvb_diseqc_master_cmd *argp )
+.. c:macro:: FE_DISEQC_SEND_MASTER_CMD
-    :name: FE_DISEQC_SEND_MASTER_CMD
+``int ioctl(int fd, FE_DISEQC_SEND_MASTER_CMD, struct dvb_diseqc_master_cmd *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <frontend_f_open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     pointer to struct
     :c:type:`dvb_diseqc_master_cmd`
 Description
 ===========

Documentation/userspace-api/media/dvb/fe-dishnetwork-send-legacy-cmd.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_DISHNETWORK_SEND_LEGACY_CMD:
 FE_DISHNETWORK_SEND_LEGACY_CMD
 Synopsis
 ========
-.. c:function:: int  ioctl(int fd, FE_DISHNETWORK_SEND_LEGACY_CMD, unsigned long cmd)
+.. c:macro:: FE_DISHNETWORK_SEND_LEGACY_CMD
-    :name: FE_DISHNETWORK_SEND_LEGACY_CMD
+``int ioctl(int fd, FE_DISHNETWORK_SEND_LEGACY_CMD, unsigned long cmd)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :c:func:`open() <dvb-fe-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``cmd``
     Sends the specified raw cmd to the dish via DISEqC.
 Description
 ===========
 As support for this ioctl were added in 2004, this means that such
 dishes were already legacy in 2004.
 Return Value
 ============

Documentation/userspace-api/media/dvb/fe-enable-high-lnb-voltage.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_ENABLE_HIGH_LNB_VOLTAGE:
 FE_ENABLE_HIGH_LNB_VOLTAGE - Select output DC level between normal LNBf voltages or higher LNBf - voltages.
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, FE_ENABLE_HIGH_LNB_VOLTAGE, unsigned int high )
+.. c:macro:: FE_ENABLE_HIGH_LNB_VOLTAGE
-    :name: FE_ENABLE_HIGH_LNB_VOLTAGE
+``int ioctl(int fd, FE_ENABLE_HIGH_LNB_VOLTAGE, unsigned int high)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <frontend_f_open>`.
+    File descriptor returned by :c:func:`open()`.
 ``high``
     Valid flags:
     -  >0 - enables slightly higher voltages instead of 13/18V, in order
        to compensate for long antenna cables.
 Description
 ===========
 voltages between 0 (normal) or a value grater than 0 for higher
 voltages.
 Return Value
 ============

Documentation/userspace-api/media/dvb/fe-get-event.rst+4−8

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_GET_EVENT:
 .. attention:: This ioctl is deprecated.
 Synopsis
 ========
-.. c:function:: int  ioctl(int fd, FE_GET_EVENT, struct dvb_frontend_event *ev)
+.. c:macro:: FE_GET_EVENT
-    :name: FE_GET_EVENT
+``int ioctl(int fd, FE_GET_EVENT, struct dvb_frontend_event *ev)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :c:func:`open() <dvb-fe-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``ev``
     Points to the location where the event, if any, is to be stored.
 Description
 ===========
 with errno set to ``EWOULDBLOCK``. In the former case, the call blocks until
 an event becomes available.
 Return Value
 ============
 On error -1 is returned, and the ``errno`` variable is set
 appropriately.
 .. flat-table::
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  ``EWOULDBLOCK``

Documentation/userspace-api/media/dvb/fe-get-frontend.rst+4−8

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_GET_FRONTEND:
 .. attention:: This ioctl is deprecated.
 Synopsis
 ========
-.. c:function:: int ioctl(int fd, FE_GET_FRONTEND, struct dvb_frontend_parameters *p)
+.. c:macro:: FE_GET_FRONTEND
-    :name: FE_GET_FRONTEND
+``int ioctl(int fd, FE_GET_FRONTEND, struct dvb_frontend_parameters *p)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :c:func:`open() <dvb-fe-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``p``
     Points to parameters for tuning operation.
 Description
 ===========
 This ioctl call queries the currently effective frontend parameters. For
 this command, read-only access to the device is sufficient.
 Return Value
 ============
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  ``EINVAL``

Documentation/userspace-api/media/dvb/fe-get-info.rst+4−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_GET_INFO:
 FE_GET_INFO - Query Digital TV frontend capabilities and returns information
 about the - front-end. This call only requires read-only access to the device.
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, FE_GET_INFO, struct dvb_frontend_info *argp )
+.. c:macro:: FE_GET_INFO
-    :name: FE_GET_INFO
+``int ioctl(int fd, FE_GET_INFO, struct dvb_frontend_info *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <frontend_f_open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     pointer to struct :c:type:`dvb_frontend_info`
 Description
 ===========
 When the driver is not compatible with this specification the ioctl
 returns an error.
 frontend capabilities
 =====================
 The frontend capabilities are described at :c:type:`fe_caps`.
 Return Value
 ============

Documentation/userspace-api/media/dvb/fe-get-property.rst+7−8

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: DTV.fe
2		3
3	.. _FE_GET_PROPERTY:	4	.. _FE_GET_PROPERTY:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	FE_SET_PROPERTY - FE_GET_PROPERTY - FE_SET_PROPERTY sets one or more frontend properties. - FE_GET_PROPERTY returns one or more frontend properties.	13	FE_SET_PROPERTY - FE_GET_PROPERTY - FE_SET_PROPERTY sets one or more frontend properties. - FE_GET_PROPERTY returns one or more frontend properties.
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, FE_GET_PROPERTY, struct dtv_properties *argp )	18	.. c:macro:: FE_GET_PROPERTY
19	:name: FE_GET_PROPERTY	19
		20	``int ioctl(int fd, FE_GET_PROPERTY, struct dtv_properties *argp)``
20		21
21	.. c:function:: int ioctl( int fd, FE_SET_PROPERTY, struct dtv_properties *argp )	22	.. c:macro:: FE_SET_PROPERTY
22	:name: FE_SET_PROPERTY
23		23
		24	``int ioctl(int fd, FE_SET_PROPERTY, struct dtv_properties *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <frontend_f_open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`dtv_properties`.	33	Pointer to struct :c:type:`dtv_properties`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -63,7 +63,6 @@ depends on the delivery system and on the device: · 25 unmodified lines
63		63
64	- This call only requires read-only access to the device.	64	- This call only requires read-only access to the device.
65		65
66
67	Return Value	66	Return Value
68	============	67	============
69		68

Documentation/userspace-api/media/dvb/fe-read-ber.rst+4−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_READ_BER:
 Synopsis
 ========
-.. c:function:: int  ioctl(int fd, FE_READ_BER, uint32_t *ber)
+.. c:macro:: FE_READ_BER
-    :name: FE_READ_BER
+``int ioctl(int fd, FE_READ_BER, uint32_t *ber)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :c:func:`open() <dvb-fe-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``ber``
     The bit error rate is stored into \*ber.
 Description
 ===========
 received/demodulated by the front-end. For this command, read-only
 access to the device is sufficient.
 Return Value
 ============

Documentation/userspace-api/media/dvb/fe-read-signal-strength.rst+4−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_READ_SIGNAL_STRENGTH:
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, FE_READ_SIGNAL_STRENGTH, uint16_t *strength)
+.. c:macro:: FE_READ_SIGNAL_STRENGTH
-    :name: FE_READ_SIGNAL_STRENGTH
+``int ioctl(int fd, FE_READ_SIGNAL_STRENGTH, uint16_t *strength)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :c:func:`open() <dvb-fe-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``strength``
     The signal strength value is stored into \*strength.
 Description
 ===========
 currently received by the front-end. For this command, read-only access
 to the device is sufficient.
 Return Value
 ============

Documentation/userspace-api/media/dvb/fe-read-snr.rst+4−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_READ_SNR:
 Synopsis
 ========
-.. c:function:: int  ioctl(int fd, FE_READ_SNR, int16_t *snr)
+.. c:macro:: FE_READ_SNR
-    :name: FE_READ_SNR
+``int ioctl(int fd, FE_READ_SNR, int16_t *snr)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :c:func:`open() <dvb-fe-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``snr``
     The signal-to-noise ratio is stored into \*snr.
 Description
 ===========
 currently received by the front-end. For this command, read-only access
 to the device is sufficient.
 Return Value
 ============

Documentation/userspace-api/media/dvb/fe-read-status.rst+4−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_READ_STATUS:
 FE_READ_STATUS - Returns status information about the front-end. This call only requires - read-only access to the device
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, FE_READ_STATUS, unsigned int *status )
+.. c:macro:: FE_READ_STATUS
-    :name: FE_READ_STATUS
+``int ioctl(int fd, FE_READ_STATUS, unsigned int *status)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <frontend_f_open>`.
+    File descriptor returned by :c:func:`open()`.
 ``status``
     pointer to a bitmask integer filled with the values defined by enum
     :c:type:`fe_status`.
 Description
 ===========
    varies according with the architecture. This needs to be fixed in the
    future.
 int fe_status
 =============
 state changes of the frontend hardware. It is produced using the enum
 :c:type:`fe_status` values on a bitmask
 Return Value
 ============

Documentation/userspace-api/media/dvb/fe-read-uncorrected-blocks.rst+4−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_READ_UNCORRECTED_BLOCKS:
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, FE_READ_UNCORRECTED_BLOCKS, uint32_t *ublocks)
+.. c:macro:: FE_READ_UNCORRECTED_BLOCKS
-    :name: FE_READ_UNCORRECTED_BLOCKS
+``int ioctl(int fd, FE_READ_UNCORRECTED_BLOCKS, uint32_t *ublocks)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :c:func:`open() <dvb-fe-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``ublocks``
     The total number of uncorrected blocks seen by the driver so far.
 Description
 ===========
 calculated. For this command, read-only access to the device is
 sufficient.
 Return Value
 ============

Documentation/userspace-api/media/dvb/fe-set-frontend-tune-mode.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_SET_FRONTEND_TUNE_MODE:
 FE_SET_FRONTEND_TUNE_MODE - Allow setting tuner mode flags to the frontend.
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, FE_SET_FRONTEND_TUNE_MODE, unsigned int flags )
+.. c:macro:: FE_SET_FRONTEND_TUNE_MODE
-    :name: FE_SET_FRONTEND_TUNE_MODE
+``int ioctl(int fd, FE_SET_FRONTEND_TUNE_MODE, unsigned int flags)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <frontend_f_open>`.
+    File descriptor returned by :c:func:`open()`.
 ``flags``
     Valid flags:
        is closed, this flag will be automatically turned off when the
        device is reopened read-write.
 Description
 ===========
 Allow setting tuner mode flags to the frontend, between 0 (normal) or
 ``FE_TUNE_MODE_ONESHOT`` mode
 Return Value
 ============

Documentation/userspace-api/media/dvb/fe-set-frontend.rst+4−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_SET_FRONTEND:
 FE_SET_FRONTEND
 Synopsis
 ========
-.. c:function:: int ioctl(int fd, FE_SET_FRONTEND, struct dvb_frontend_parameters *p)
+.. c:macro:: FE_SET_FRONTEND
-    :name: FE_SET_FRONTEND
+``int ioctl(int fd, FE_SET_FRONTEND, struct dvb_frontend_parameters *p)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :c:func:`open() <dvb-fe-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``p``
     Points to parameters for tuning operation.
 Description
 ===========
 previous operation will be aborted in favor of the new one. This command
 requires read/write access to the device.
 Return Value
 ============
        -  Maximum supported symbol rate reached.
 Generic error codes are described at the
 :ref:`Generic Error Codes <gen-errors>` chapter.

Documentation/userspace-api/media/dvb/fe-set-tone.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_SET_TONE:
 FE_SET_TONE - Sets/resets the generation of the continuous 22kHz tone.
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, FE_SET_TONE, enum fe_sec_tone_mode tone )
+.. c:macro:: FE_SET_TONE
-    :name: FE_SET_TONE
+``int ioctl(int fd, FE_SET_TONE, enum fe_sec_tone_mode tone)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <frontend_f_open>`.
+    File descriptor returned by :c:func:`open()`.
 ``tone``
     an integer enumered value described at :c:type:`fe_sec_tone_mode`
 Description
 ===========
    capability of selecting the band. So, it is recommended that applications
    would change to SEC_TONE_OFF when the device is not used.
 Return Value
 ============

Documentation/userspace-api/media/dvb/fe-set-voltage.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _FE_SET_VOLTAGE:
 FE_SET_VOLTAGE - Allow setting the DC level sent to the antenna subsystem.
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, FE_SET_VOLTAGE, enum fe_sec_voltage voltage )
+.. c:macro:: FE_SET_VOLTAGE
-    :name: FE_SET_VOLTAGE
+``int ioctl(int fd, FE_SET_VOLTAGE, enum fe_sec_voltage voltage)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <frontend_f_open>`.
+    File descriptor returned by :c:func:`open()`.
 ``voltage``
     an integer enumered value described at :c:type:`fe_sec_voltage`
 Description
 ===========
    the voltage to SEC_VOLTAGE_OFF while the device is not is used is
    recommended.
 Return Value
 ============

Documentation/userspace-api/media/dvb/frontend_f_close.rst+2−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _frontend_f_close:
 fe-close - Close a frontend device
 Synopsis
 ========
     #include <unistd.h>
 .. c:function:: int close( int fd )
-    :name: dvb-fe-close
 Arguments
 =========
 ``fd``
-    File descriptor returned by :c:func:`open() <dvb-fe-open>`.
+    File descriptor returned by :c:func:`open()`.
 Description
 ===========
 closing a front-end device, its corresponding hardware might be powered
 down automatically.
 Return Value
 ============

Documentation/userspace-api/media/dvb/frontend_f_open.rst+2−8

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.fe
 .. _frontend_f_open:
 fe-open - Open a frontend device
 Synopsis
 ========
     #include <fcntl.h>
 .. c:function:: int open( const char *device_name, int flags )
-    :name: dvb-fe-open
 Arguments
 =========
     Other flags have no effect.
 Description
 ===========
 powered up, and that other front-ends may have been powered down to make
 that possible.
 Return Value
 ============
-On success :ref:`open() <frontend_f_open>` returns the new file descriptor.
+On success :c:func:`open()` returns the new file descriptor.
 On error, -1 is returned, and the ``errno`` variable is set appropriately.
 Possible error codes are:
 On success 0 is returned, and :c:type:`ca_slot_info` is filled.
 On error -1 is returned, and the ``errno`` variable is set
        -  The limit on the total number of files open on the system has been
 	  reached.
 The generic error codes are described at the
 :ref:`Generic Error Codes <gen-errors>` chapter.

Documentation/userspace-api/media/dvb/net-add-if.rst+4−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.net
 .. _NET_ADD_IF:
 NET_ADD_IF - Creates a new network interface for a given Packet ID.
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, NET_ADD_IF, struct dvb_net_if *net_if )
+.. c:macro:: NET_ADD_IF
-    :name: NET_ADD_IF
+``int ioctl(int fd, NET_ADD_IF, struct dvb_net_if *net_if)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <frontend_f_open>`.
+    File descriptor returned by :c:func:`open()`.
 ``net_if``
     pointer to struct :c:type:`dvb_net_if`
 Description
 ===========

Documentation/userspace-api/media/dvb/net-get-if.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.net
 .. _NET_GET_IF:
 NET_GET_IF - Read the configuration data of an interface created via - :ref:`NET_ADD_IF <net>`.
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, NET_GET_IF, struct dvb_net_if *net_if )
+.. c:macro:: NET_GET_IF
-    :name: NET_GET_IF
+``int ioctl(int fd, NET_GET_IF, struct dvb_net_if *net_if)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <frontend_f_open>`.
+    File descriptor returned by :c:func:`open()`.
 ``net_if``
     pointer to struct :c:type:`dvb_net_if`
 Description
 ===========
 created yet with :ref:`NET_ADD_IF <net>`, it will return -1 and fill
 the ``errno`` with ``EINVAL`` error code.
 Return Value
 ============

Documentation/userspace-api/media/dvb/net-remove-if.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.net
 .. _NET_REMOVE_IF:
 NET_REMOVE_IF - Removes a network interface.
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, NET_REMOVE_IF, int ifnum )
+.. c:macro:: NET_REMOVE_IF
-    :name: NET_REMOVE_IF
+``int ioctl(int fd, NET_REMOVE_IF, int ifnum)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <frontend_f_open>`.
+    File descriptor returned by :c:func:`open()`.
 ``net_if``
     number of the interface to be removed
 Description
 ===========
 The NET_REMOVE_IF ioctl deletes an interface previously created via
 :ref:`NET_ADD_IF <net>`.
 Return Value
 ============

Documentation/userspace-api/media/dvb/video-clear-buffer.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_CLEAR_BUFFER:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_CLEAR_BUFFER)
+.. c:macro:: VIDEO_CLEAR_BUFFER
-    :name: VIDEO_CLEAR_BUFFER
+``int ioctl(fd, VIDEO_CLEAR_BUFFER)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Equals VIDEO_CLEAR_BUFFER for this command.
 Description
 -----------
 This ioctl call clears all video buffers in the driver and in the
 decoder hardware.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/video-command.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_COMMAND:
 Synopsis
 --------
-.. c:function:: int ioctl(int fd, VIDEO_COMMAND, struct video_command *cmd)
+.. c:macro:: VIDEO_COMMAND
-    :name: VIDEO_COMMAND
+``int ioctl(int fd, VIDEO_COMMAND, struct video_command *cmd)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Commands the decoder.
 Description
 -----------
 :ref:`VIDIOC_DECODER_CMD` documentation for
 more information.
-.. c:type:: struct video_command
+.. c:type:: video_command
 .. code-block:: c
 		};
 	};
 Return Value
 ------------

Documentation/userspace-api/media/dvb/video-continue.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_CONTINUE:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_CONTINUE)
+.. c:macro:: VIDEO_CONTINUE
-    :name: VIDEO_CONTINUE
+``int ioctl(fd, VIDEO_CONTINUE)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Equals VIDEO_CONTINUE for this command.
 Description
 -----------
 This ioctl call restarts decoding and playing processes of the video
 stream which was played before a call to VIDEO_FREEZE was made.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/video-fast-forward.rst+3−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_FAST_FORWARD:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_FAST_FORWARD, int nFrames)
+.. c:macro:: VIDEO_FAST_FORWARD
-    :name: VIDEO_FAST_FORWARD
+``int ioctl(fd, VIDEO_FAST_FORWARD, int nFrames)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  The number of frames to skip.
 Description
 -----------
 I-frames. This call can only be used if VIDEO_SOURCE_MEMORY is
 selected.
 Return Value
 ------------
 :ref:`Generic Error Codes <gen-errors>` chapter.
 .. flat-table::
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  ``EPERM``

Documentation/userspace-api/media/dvb/video-fclose.rst+1−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _video_fclose:
 .. c:function:: int close(int fd)
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  File descriptor returned by a previous call to open().
 Description
 -----------
 This system call closes a previously opened video device.
 Return Value
 ------------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  ``EBADF``

Documentation/userspace-api/media/dvb/video-fopen.rst+1−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _video_fopen:
 .. c:function:: int open(const char *deviceName, int flags)
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  const char \*deviceName
        -
        -  (blocking mode is the default)
 Description
 -----------
 ioctl call that can be used is VIDEO_GET_STATUS. All other call will
 return an error code.
 Return Value
 ------------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  ``ENODEV``

Documentation/userspace-api/media/dvb/video-freeze.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_FREEZE:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_FREEZE)
+.. c:macro:: VIDEO_FREEZE
-    :name: VIDEO_FREEZE
+``int ioctl(fd, VIDEO_FREEZE)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Equals VIDEO_FREEZE for this command.
 Description
 -----------
 VIDEO_SELECT_SOURCE, the Digital TV subsystem will not decode any more data
 until the ioctl call VIDEO_CONTINUE or VIDEO_PLAY is performed.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/video-fwrite.rst+1−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _video_fwrite:
 .. c:function:: size_t write(int fd, const void *buf, size_t count)
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Size of buf.
 Description
 -----------
 is not specified the function will block until buffer space is
 available. The amount of data to be transferred is implied by count.
 Return Value
 ------------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  ``EPERM``

Documentation/userspace-api/media/dvb/video-get-capabilities.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_GET_CAPABILITIES:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_GET_CAPABILITIES, unsigned int *cap)
+.. c:macro:: VIDEO_GET_CAPABILITIES
-    :name: VIDEO_GET_CAPABILITIES
+``int ioctl(fd, VIDEO_GET_CAPABILITIES, unsigned int *cap)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Pointer to a location where to store the capability information.
 Description
 -----------
 On success it returns and integer which has bits set according to the
 defines in section ??.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/video-get-event.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_GET_EVENT:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_GET_EVENT, struct video_event *ev)
+.. c:macro:: VIDEO_GET_EVENT
-    :name: VIDEO_GET_EVENT
+``int ioctl(fd, VIDEO_GET_EVENT, struct video_event *ev)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Points to the location where the event, if any, is to be stored.
 Description
 -----------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  ``EWOULDBLOCK``

Documentation/userspace-api/media/dvb/video-get-frame-count.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_GET_FRAME_COUNT:
 Synopsis
 --------
-.. c:function:: int ioctl(int fd, VIDEO_GET_FRAME_COUNT, __u64 *pts)
+.. c:macro:: VIDEO_GET_FRAME_COUNT
-    :name: VIDEO_GET_FRAME_COUNT
+``int ioctl(int fd, VIDEO_GET_FRAME_COUNT, __u64 *pts)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Returns the number of frames displayed since the decoder was
 	  started.
 Description
 -----------
 This ioctl call asks the Video Device to return the number of displayed
 frames since the decoder was started.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/video-get-pts.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_GET_PTS:
 Synopsis
 --------
-.. c:function:: int ioctl(int fd, VIDEO_GET_PTS, __u64 *pts)
+.. c:macro:: VIDEO_GET_PTS
-    :name: VIDEO_GET_PTS
+``int ioctl(int fd, VIDEO_GET_PTS, __u64 *pts)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
 	  but may also be a value close to it like the PTS of the last
 	  decoded frame or the last PTS extracted by the PES parser.
 Description
 -----------
 This ioctl call asks the Video Device to return the current PTS
 timestamp.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/video-get-size.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_GET_SIZE:
 Synopsis
 --------
-.. c:function:: int ioctl(int fd, VIDEO_GET_SIZE, video_size_t *size)
+.. c:macro:: VIDEO_GET_SIZE
-    :name: VIDEO_GET_SIZE
+``int ioctl(int fd, VIDEO_GET_SIZE, video_size_t *size)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Returns the size and aspect ratio.
 Description
 -----------
 		video_format_t aspect_ratio;
 	} video_size_t;
 Return Value
 ------------

Documentation/userspace-api/media/dvb/video-get-status.rst+3−4

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_GET_STATUS:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_GET_STATUS, struct video_status *status)
+.. c:macro:: VIDEO_GET_STATUS
-    :name: VIDEO_GET_STATUS
+``int ioctl(fd, VIDEO_GET_STATUS, struct video_status *status)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Returns the current status of the Video Device.
 Description
 -----------

Documentation/userspace-api/media/dvb/video-play.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_PLAY:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_PLAY)
+.. c:macro:: VIDEO_PLAY
-    :name: VIDEO_PLAY
+``int ioctl(fd, VIDEO_PLAY)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Equals VIDEO_PLAY for this command.
 Description
 -----------
 This ioctl call asks the Video Device to start playing a video stream
 from the selected source.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/video-select-source.rst+3−4

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_SELECT_SOURCE:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_SELECT_SOURCE, video_stream_source_t source)
+.. c:macro:: VIDEO_SELECT_SOURCE
-    :name: VIDEO_SELECT_SOURCE
+``int ioctl(fd, VIDEO_SELECT_SOURCE, video_stream_source_t source)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Indicates which source shall be used for the Video stream.
 Description
 -----------

Documentation/userspace-api/media/dvb/video-set-blank.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_SET_BLANK:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_SET_BLANK, boolean mode)
+.. c:macro:: VIDEO_SET_BLANK
-    :name: VIDEO_SET_BLANK
+``int ioctl(fd, VIDEO_SET_BLANK, boolean mode)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -
        -  FALSE: Show last decoded frame.
 Description
 -----------
 This ioctl call asks the Video Device to blank out the picture.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/video-set-display-format.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_SET_DISPLAY_FORMAT:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_SET_DISPLAY_FORMAT)
+.. c:macro:: VIDEO_SET_DISPLAY_FORMAT
-    :name: VIDEO_SET_DISPLAY_FORMAT
+``int ioctl(fd, VIDEO_SET_DISPLAY_FORMAT)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Selects the video format to be used.
 Description
 -----------
 This ioctl call asks the Video Device to select the video format to be
 applied by the MPEG chip on the video.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/video-set-format.rst+3−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_SET_FORMAT:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_SET_FORMAT, video_format_t format)
+.. c:macro:: VIDEO_SET_FORMAT
-    :name: VIDEO_SET_FORMAT
+``int ioctl(fd, VIDEO_SET_FORMAT, video_format_t format)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  video format of TV as defined in section ??.
 Description
 -----------
 :ref:`Generic Error Codes <gen-errors>` chapter.
 .. flat-table::
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  ``EINVAL``

Documentation/userspace-api/media/dvb/video-set-streamtype.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_SET_STREAMTYPE:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_SET_STREAMTYPE, int type)
+.. c:macro:: VIDEO_SET_STREAMTYPE
-    :name: VIDEO_SET_STREAMTYPE
+``int ioctl(fd, VIDEO_SET_STREAMTYPE, int type)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  stream type
 Description
 -----------
 to it. If this call is not used the default of video PES is used. Some
 drivers might not support this call and always expect PES.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/video-slowmotion.rst+3−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_SLOWMOTION:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_SLOWMOTION, int nFrames)
+.. c:macro:: VIDEO_SLOWMOTION
-    :name: VIDEO_SLOWMOTION
+``int ioctl(fd, VIDEO_SLOWMOTION, int nFrames)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  The number of times to repeat each frame.
 Description
 -----------
 of times. This call can only be used if VIDEO_SOURCE_MEMORY is
 selected.
 Return Value
 ------------
 :ref:`Generic Error Codes <gen-errors>` chapter.
 .. flat-table::
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  ``EPERM``

Documentation/userspace-api/media/dvb/video-stillpicture.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_STILLPICTURE:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_STILLPICTURE, struct video_still_picture *sp)
+.. c:macro:: VIDEO_STILLPICTURE
-    :name: VIDEO_STILLPICTURE
+``int ioctl(fd, VIDEO_STILLPICTURE, struct video_still_picture *sp)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Pointer to a location where an I-frame and size is stored.
 Description
 -----------
 (I-frame). The input data shall contain an I-frame. If the pointer is
 NULL, then the current displayed still picture is blanked.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/video-stop.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_STOP:
 Synopsis
 --------
-.. c:function:: int ioctl(fd, VIDEO_STOP, boolean mode)
+.. c:macro:: VIDEO_STOP
-    :name: VIDEO_STOP
+``int ioctl(fd, VIDEO_STOP, boolean mode)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -
        -  FALSE: Show last decoded frame.
 Description
 -----------
 stream. Depending on the input parameter, the screen can be blanked out
 or displaying the last decoded frame.
 Return Value
 ------------

Documentation/userspace-api/media/dvb/video-try-command.rst+3−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: DTV.video
 .. _VIDEO_TRY_COMMAND:
 Synopsis
 --------
-.. c:function:: int ioctl(int fd, VIDEO_TRY_COMMAND, struct video_command *cmd)
+.. c:macro:: VIDEO_TRY_COMMAND
-    :name: VIDEO_TRY_COMMAND
+``int ioctl(int fd, VIDEO_TRY_COMMAND, struct video_command *cmd)``
 Arguments
 ---------
     :header-rows:  0
     :stub-columns: 0
     -  .. row 1
        -  int fd
        -  Try a decoder command.
 Description
 -----------
 :ref:`VIDIOC_TRY_DECODER_CMD <VIDIOC_DECODER_CMD>` documentation
 for more information.
 Return Value
 ------------

Documentation/userspace-api/media/mediactl/media-func-close.rst+3−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: MC
 .. _media-func-close:
 media-close - Close a media device
 Synopsis
 ========
     #include <unistd.h>
 .. c:function:: int close( int fd )
-    :name: mc-close
 Arguments
 =========
 ``fd``
-    File descriptor returned by :c:func:`open() <mc-open>`.
+    File descriptor returned by :c:func:`open()`.
 Description
 ===========
 Closes the media device. Resources associated with the file descriptor
 are freed. The device configuration remain unchanged.
 Return Value
 ============
-:ref:`close() <media-func-close>` returns 0 on success. On error, -1 is returned, and
+:c:func:`close()` returns 0 on success. On error, -1 is returned, and
 ``errno`` is set appropriately. Possible error codes are:
 EBADF

Documentation/userspace-api/media/mediactl/media-func-ioctl.rst+3−7

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: MC
2		3
3	.. _media-func-ioctl:	4	.. _media-func-ioctl:
4		5
@@ -11,7 +12,6 @@ Name · 6 unmodified lines
11		12
12	media-ioctl - Control a media device	13	media-ioctl - Control a media device
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
@@ -19,15 +19,13 @@ Synopsis · 1 unmodified line
19		19
20	#include <sys/ioctl.h>	20	#include <sys/ioctl.h>
21		21
22		22	``int ioctl(int fd, int request, void *argp)``
23	.. c:function:: int ioctl( int fd, int request, void *argp )
24	:name: mc-ioctl
25		23
26	Arguments	24	Arguments
27	=========	25	=========
28		26
29	``fd``	27	``fd``
30	File descriptor returned by :c:func:`open() <mc-open>`.	28	File descriptor returned by :c:func:`open()`.
31		29
32	``request``	30	``request``
33	Media ioctl request code as defined in the media.h header file, for	31	Media ioctl request code as defined in the media.h header file, for
@@ -36,7 +34,6 @@ Arguments · 2 unmodified lines
36	``argp``	34	``argp``
37	Pointer to a request-specific structure.	35	Pointer to a request-specific structure.
38		36
39
40	Description	37	Description
41	===========	38	===========
42		39
@@ -52,7 +49,6 @@ their parameters are located in the media.h header file. All media ioctl · 9 unmodified lines
52	requests, their respective function and parameters are specified in	49	requests, their respective function and parameters are specified in
53	:ref:`media-user-func`.	50	:ref:`media-user-func`.
54		51
55
56	Return Value	52	Return Value
57	============	53	============
58		54

Documentation/userspace-api/media/mediactl/media-func-open.rst+3−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: MC
 .. _media-func-open:
 media-open - Open a media device
 Synopsis
 ========
     #include <fcntl.h>
 .. c:function:: int open( const char *device_name, int flags )
-    :name: mc-open
 Arguments
 =========
     Open flags. Access mode must be either ``O_RDONLY`` or ``O_RDWR``.
     Other flags have no effect.
 Description
 ===========
-To open a media device applications call :ref:`open() <media-func-open>` with the
+To open a media device applications call :c:func:`open()` with the
 desired device name. The function has no side effects; the device
 configuration remain unchanged.
 configuration will result in an error, and ``errno`` will be set to
 EBADF.
 Return Value
 ============
-:ref:`open() <func-open>` returns the new file descriptor on success. On error,
+:c:func:`open()` returns the new file descriptor on success. On error,
 -1 is returned, and ``errno`` is set appropriately. Possible error codes
 are:

Documentation/userspace-api/media/mediactl/media-ioc-device-info.rst+4−9

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: MC
 .. _media_ioc_device_info:
 MEDIA_IOC_DEVICE_INFO - Query device information
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, MEDIA_IOC_DEVICE_INFO, struct media_device_info *argp )
+.. c:macro:: MEDIA_IOC_DEVICE_INFO
-    :name: MEDIA_IOC_DEVICE_INFO
+``int ioctl(int fd, MEDIA_IOC_DEVICE_INFO, struct media_device_info *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <media-func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`media_device_info`.
 Description
 ===========
 fills the structure and returns the information to the application. The
 ioctl never fails.
 .. c:type:: media_device_info
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
     :stub-columns: 0
     :widths:       1 1 2
     *  -  char
        -  ``driver``\ [16]
        -  Name of the driver implementing the media API as a NUL-terminated
        -  Reserved for future extensions. Drivers and applications must set
 	  this array to zero.
 The ``serial`` and ``bus_info`` fields can be used to distinguish
 between multiple instances of otherwise identical hardware. The serial
 number takes precedence when provided and can be assumed to be unique.
 used instead. The ``bus_info`` field is guaranteed to be unique, but can
 vary across reboots or device unplug/replug.
 Return Value
 ============

Documentation/userspace-api/media/mediactl/media-ioc-enum-entities.rst+4−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: MC
 .. _media_ioc_enum_entities:
 MEDIA_IOC_ENUM_ENTITIES - Enumerate entities and their properties
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, MEDIA_IOC_ENUM_ENTITIES, struct media_entity_desc *argp )
+.. c:macro:: MEDIA_IOC_ENUM_ENTITIES
-    :name: MEDIA_IOC_ENUM_ENTITIES
+``int ioctl(int fd, MEDIA_IOC_ENUM_ENTITIES, struct media_entity_desc *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <media-func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`media_entity_desc`.
 Description
 ===========
 enumerate entities by calling MEDIA_IOC_ENUM_ENTITIES with increasing
 id's until they get an error.
 .. c:type:: media_entity_desc
 .. tabularcolumns:: |p{1.5cm}|p{1.7cm}|p{1.6cm}|p{1.5cm}|p{11.2cm}|
     *  - }
        -
 Return Value
 ============

Documentation/userspace-api/media/mediactl/media-ioc-enum-links.rst+4−9

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: MC
 .. _media_ioc_enum_links:
 MEDIA_IOC_ENUM_LINKS - Enumerate all pads and links for a given entity
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, MEDIA_IOC_ENUM_LINKS, struct media_links_enum *argp )
+.. c:macro:: MEDIA_IOC_ENUM_LINKS
-    :name: MEDIA_IOC_ENUM_LINKS
+``int ioctl(int fd, MEDIA_IOC_ENUM_LINKS, struct media_links_enum *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <media-func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`media_links_enum`.
 Description
 ===========
 Only forward links that originate at one of the entity's source pads are
 returned during the enumeration process.
 .. c:type:: media_links_enum
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
        -  Reserved for future extensions. Drivers and applications must set
           the array to zero.
 .. c:type:: media_pad_desc
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
           the array to zero.
 .. c:type:: media_link_desc
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
        -  Reserved for future extensions. Drivers and applications must set
           the array to zero.
 Return Value
 ============

Documentation/userspace-api/media/mediactl/media-ioc-g-topology.rst+4−10

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: MC
 .. _media_ioc_g_topology:
 MEDIA_IOC_G_TOPOLOGY - Enumerate the graph topology and graph element properties
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, MEDIA_IOC_G_TOPOLOGY, struct media_v2_topology *argp )
+.. c:macro:: MEDIA_IOC_G_TOPOLOGY
-    :name: MEDIA_IOC_G_TOPOLOGY
+``int ioctl(int fd, MEDIA_IOC_G_TOPOLOGY, struct media_v2_topology *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <media-func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`media_v2_topology`.
 Description
 ===========
 	  converted to a 64-bits integer. It can be zero. if zero, the ioctl
 	  won't store the links. It will just update ``num_links``
 .. tabularcolumns:: |p{1.6cm}|p{3.2cm}|p{12.7cm}|
 .. c:type:: media_v2_entity
        -  Reserved for future extensions. Drivers and applications must set
 	  this array to zero.
 .. tabularcolumns:: |p{1.6cm}|p{3.2cm}|p{12.7cm}|
 .. c:type:: media_v2_interface
        -  Used only for device node interfaces. See
 	  :c:type:`media_v2_intf_devnode` for details.
 .. tabularcolumns:: |p{1.6cm}|p{3.2cm}|p{12.7cm}|
 .. c:type:: media_v2_intf_devnode
        -  Reserved for future extensions. Drivers and applications must set
 	  this array to zero.
 .. tabularcolumns:: |p{1.6cm}|p{3.2cm}|p{12.7cm}|
 .. c:type:: media_v2_link
        -  Reserved for future extensions. Drivers and applications must set
 	  this array to zero.
 Return Value
 ============

Documentation/userspace-api/media/mediactl/media-ioc-request-alloc.rst+5−6

 .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
+.. c:namespace:: MC
 .. _media_ioc_request_alloc:
 MEDIA_IOC_REQUEST_ALLOC - Allocate a request
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, MEDIA_IOC_REQUEST_ALLOC, int *argp )
+.. c:macro:: MEDIA_IOC_REQUEST_ALLOC
-    :name: MEDIA_IOC_REQUEST_ALLOC
+``int ioctl(int fd, MEDIA_IOC_REQUEST_ALLOC, int *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <media-func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to an integer.
 Description
 ===========
 for the request to complete.
 The request will remain allocated until all the file descriptors associated
-with it are closed by :ref:`close() <request-func-close>` and the driver no
+with it are closed by :c:func:`close()` and the driver no
 longer uses the request internally. See also
 :ref:`here <media-request-life-time>` for more information.

Documentation/userspace-api/media/mediactl/media-ioc-setup-link.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: MC
 .. _media_ioc_setup_link:
 MEDIA_IOC_SETUP_LINK - Modify the properties of a link
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, MEDIA_IOC_SETUP_LINK, struct media_link_desc *argp )
+.. c:macro:: MEDIA_IOC_SETUP_LINK
-    :name: MEDIA_IOC_SETUP_LINK
+``int ioctl(int fd, MEDIA_IOC_SETUP_LINK, struct media_link_desc *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <media-func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`media_link_desc`.
 Description
 ===========
 If the specified link can't be found the driver returns with an ``EINVAL``
 error code.
 Return Value
 ============

Documentation/userspace-api/media/mediactl/media-request-ioc-queue.rst+3−4

 .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
+.. c:namespace:: MC
 .. _media_request_ioc_queue:
 MEDIA_REQUEST_IOC_QUEUE - Queue a request
 Synopsis
 ========
-.. c:function:: int ioctl( int request_fd, MEDIA_REQUEST_IOC_QUEUE )
+.. c:macro:: MEDIA_REQUEST_IOC_QUEUE
-    :name: MEDIA_REQUEST_IOC_QUEUE
+``int ioctl(int request_fd, MEDIA_REQUEST_IOC_QUEUE)``
 Arguments
 =========
 ``request_fd``
     File descriptor returned by :ref:`MEDIA_IOC_REQUEST_ALLOC`.
 Description
 ===========

Documentation/userspace-api/media/mediactl/media-request-ioc-reinit.rst+4−4

 .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
+.. c:namespace:: MC
 .. _media_request_ioc_reinit:
 MEDIA_REQUEST_IOC_REINIT - Re-initialize a request
 Synopsis
 ========
-.. c:function:: int ioctl( int request_fd, MEDIA_REQUEST_IOC_REINIT )
+.. c:macro:: MEDIA_REQUEST_IOC_REINIT
-    :name: MEDIA_REQUEST_IOC_REINIT
+``int ioctl(int request_fd, MEDIA_REQUEST_IOC_REINIT)``
 Arguments
 =========
 request.
 Re-initializing a request will clear any existing data from the request.
-This avoids having to :ref:`close() <request-func-close>` a completed
+This avoids having to :c:func:`close()` a completed
 request and allocate a new request. Instead the completed request can just
 be re-initialized and it is ready to be used again.

Documentation/userspace-api/media/mediactl/request-api.rst+3−2

 .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
+.. c:namespace:: MC
 .. _media-request-api:
    Setting the same control through a request and also directly can lead to
    undefined behavior!
-User-space can :ref:`poll() <request-func-poll>` a request file descriptor in
+User-space can :c:func:`poll()` a request file descriptor in
 order to wait until the request completes. A request is considered complete
 once all its associated buffers are available for dequeuing and all the
 associated controls have been updated with the values at the time of completion.
 -------------------------
 Finally, a completed request can either be discarded or be reused. Calling
-:ref:`close() <request-func-close>` on a request file descriptor will make
+:c:func:`close()` on a request file descriptor will make
 that file descriptor unusable and the request will be freed once it is no
 longer in use by the kernel. That is, if the request is queued and then the
 file descriptor is closed, then it won't be freed until the driver completed

Documentation/userspace-api/media/mediactl/request-func-close.rst+2−6

 .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
+.. c:namespace:: MC.request
 .. _request-func-close:
 request-close - Close a request file descriptor
 Synopsis
 ========
     #include <unistd.h>
 .. c:function:: int close( int fd )
-    :name: req-close
 Arguments
 =========
 ``fd``
     File descriptor returned by :ref:`MEDIA_IOC_REQUEST_ALLOC`.
 Description
 ===========
 and the driver has completed the request.
 See :ref:`here <media-request-life-time>` for more information.
 Return Value
 ============
-:ref:`close() <request-func-close>` returns 0 on success. On error, -1 is
+:c:func:`close()` returns 0 on success. On error, -1 is
 returned, and ``errno`` is set appropriately. Possible error codes are:
 EBADF

Documentation/userspace-api/media/mediactl/request-func-ioctl.rst+2−6

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: MC
2		3
3	.. _request-func-ioctl:	4	.. _request-func-ioctl:
4		5
@@ -11,7 +12,6 @@ Name · 6 unmodified lines
11		12
12	request-ioctl - Control a request file descriptor	13	request-ioctl - Control a request file descriptor
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
@@ -19,9 +19,7 @@ Synopsis · 1 unmodified line
19		19
20	#include <sys/ioctl.h>	20	#include <sys/ioctl.h>
21		21
22		22	``int ioctl(int fd, int cmd, void *argp)``
23	.. c:function:: int ioctl( int fd, int cmd, void *argp )
24	:name: req-ioctl
25		23
26	Arguments	24	Arguments
27	=========	25	=========
@@ -36,7 +34,6 @@ Arguments · 8 unmodified lines
36	``argp``	34	``argp``
37	Pointer to a request-specific structure.	35	Pointer to a request-specific structure.
38		36
39
40	Description	37	Description
41	===========	38	===========
42		39
@@ -52,7 +49,6 @@ their parameters are located in the media.h header file. All request ioctl · 9 unmodified lines
52	commands, their respective function and parameters are specified in	49	commands, their respective function and parameters are specified in
53	:ref:`media-user-func`.	50	:ref:`media-user-func`.
54		51
55
56	Return Value	52	Return Value
57	============	53	============
58		54

Documentation/userspace-api/media/mediactl/request-func-poll.rst+4−8

 .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
+.. c:namespace:: MC
 .. _request-func-poll:
 request-poll - Wait for some event on a file descriptor
 Synopsis
 ========
     #include <sys/poll.h>
 .. c:function:: int poll( struct pollfd *ufds, unsigned int nfds, int timeout )
-   :name: request-poll
 Arguments
 =========
 ``timeout``
    Timeout to wait for events
 Description
 ===========
-With the :c:func:`poll() <request-func-poll>` function applications can wait
+With the :c:func:`poll()` function applications can wait
 for a request to complete.
-On success :c:func:`poll() <request-func-poll>` returns the number of file
+On success :c:func:`poll()` returns the number of file
 descriptors that have been selected (that is, file descriptors for which the
 ``revents`` field of the respective struct :c:type:`pollfd`
 is non-zero). Request file descriptor set the ``POLLPRI`` flag in ``revents``
 Attempting to poll for a request that is not yet queued will
 set the ``POLLERR`` flag in ``revents``.
 Return Value
 ============
-On success, :c:func:`poll() <request-func-poll>` returns the number of
+On success, :c:func:`poll()` returns the number of
 structures which have non-zero ``revents`` fields, or zero if the call
 timed out. On error -1 is returned, and the ``errno`` variable is set
 appropriately:

Documentation/userspace-api/media/rc/lirc-get-features.rst+4−5

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: RC
2		3
3	.. _lirc_get_features:	4	.. _lirc_get_features:
4		5
@@ -14,8 +15,9 @@ LIRC_GET_FEATURES - Get the underlying hardware device's features · 9 unmodified lines
14	Synopsis	15	Synopsis
15	========	16	========
16		17
17	.. c:function:: int ioctl( int fd, LIRC_GET_FEATURES, __u32 *features)	18	.. c:macro:: LIRC_GET_FEATURES
18	:name: LIRC_GET_FEATURES	19
		20	``int ioctl(int fd, LIRC_GET_FEATURES, __u32 *features)``
19		21
20	Arguments	22	Arguments
21	=========	23	=========
@@ -26,11 +28,9 @@ Arguments · 4 unmodified lines
26	``features``	28	``features``
27	Bitmask with the LIRC features.	29	Bitmask with the LIRC features.
28		30
29
30	Description	31	Description
31	===========	32	===========
32		33
33
34	Get the underlying hardware device's features. If a driver does not	34	Get the underlying hardware device's features. If a driver does not
35	announce support of certain features, calling of the corresponding ioctls	35	announce support of certain features, calling of the corresponding ioctls
36	is undefined.	36	is undefined.
@@ -184,7 +184,6 @@ LIRC features · 147 unmodified lines
184		184
185	Unused. Kept just to avoid breaking uAPI.	185	Unused. Kept just to avoid breaking uAPI.
186		186
187
188	Return Value	187	Return Value
189	============	188	============
190		189

Documentation/userspace-api/media/rc/lirc-get-rec-mode.rst+7−5

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: RC
2		3
3	.. _lirc_get_rec_mode:	4	.. _lirc_get_rec_mode:
4	.. _lirc_set_rec_mode:	5	.. _lirc_set_rec_mode:
@@ -15,11 +16,13 @@ LIRC_GET_REC_MODE/LIRC_SET_REC_MODE - Get/set current receive mode. · 10 unmodified lines
15	Synopsis	16	Synopsis
16	========	17	========
17		18
18	.. c:function:: int ioctl( int fd, LIRC_GET_REC_MODE, __u32 *mode)	19	.. c:macro:: LIRC_GET_REC_MODE
19	:name: LIRC_GET_REC_MODE
20		20
21	.. c:function:: int ioctl( int fd, LIRC_SET_REC_MODE, __u32 *mode)	21	``int ioctl(int fd, LIRC_GET_REC_MODE, __u32 *mode)``
22	:name: LIRC_SET_REC_MODE	22
		23	.. c:macro:: LIRC_SET_REC_MODE
		24
		25	``int ioctl(int fd, LIRC_SET_REC_MODE, __u32 *mode)``
23		26
24	Arguments	27	Arguments
25	=========	28	=========
@@ -47,7 +50,6 @@ Return Value · 21 unmodified lines
47	:header-rows: 0	50	:header-rows: 0
48	:stub-columns: 0	51	:stub-columns: 0
49		52
50
51	- .. row 1	53	- .. row 1
52		54
53	- ``ENODEV``	55	- ``ENODEV``

Documentation/userspace-api/media/rc/lirc-get-rec-resolution.rst+4−4

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: RC
2		3
3	.. _lirc_get_rec_resolution:	4	.. _lirc_get_rec_resolution:
4		5
@@ -14,8 +15,9 @@ LIRC_GET_REC_RESOLUTION - Obtain the value of receive resolution, in microsecond · 9 unmodified lines
14	Synopsis	15	Synopsis
15	========	16	========
16		17
17	.. c:function:: int ioctl( int fd, LIRC_GET_REC_RESOLUTION, __u32 *microseconds)	18	.. c:macro:: LIRC_GET_REC_RESOLUTION
18	:name: LIRC_GET_REC_RESOLUTION	19
		20	``int ioctl(int fd, LIRC_GET_REC_RESOLUTION, __u32 *microseconds)``
19		21
20	Arguments	22	Arguments
21	=========	23	=========
@@ -26,7 +28,6 @@ Arguments · 4 unmodified lines
26	``microseconds``	28	``microseconds``
27	Resolution, in microseconds.	29	Resolution, in microseconds.
28		30
29
30	Description	31	Description
31	===========	32	===========
32		33
@@ -38,7 +39,6 @@ This ioctl returns the integer value with such resolution, with can be · 5 unmodified lines
38	used by userspace applications like lircd to automatically adjust the	39	used by userspace applications like lircd to automatically adjust the
39	tolerance value.	40	tolerance value.
40		41
41
42	Return Value	42	Return Value
43	============	43	============
44		44

Documentation/userspace-api/media/rc/lirc-get-send-mode.rst+7−7

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: RC
2		3
3	.. _lirc_get_send_mode:	4	.. _lirc_get_send_mode:
4	.. _lirc_set_send_mode:	5	.. _lirc_set_send_mode:
@@ -15,11 +16,13 @@ LIRC_GET_SEND_MODE/LIRC_SET_SEND_MODE - Get/set current transmit mode. · 10 unmodified lines
15	Synopsis	16	Synopsis
16	========	17	========
17		18
18	.. c:function:: int ioctl( int fd, LIRC_GET_SEND_MODE, __u32 *mode )	19	.. c:macro:: LIRC_GET_SEND_MODE
19	:name: LIRC_GET_SEND_MODE
20		20
21	.. c:function:: int ioctl( int fd, LIRC_SET_SEND_MODE, __u32 *mode )	21	``int ioctl(int fd, LIRC_GET_SEND_MODE, __u32 *mode)``
22	:name: LIRC_SET_SEND_MODE	22
		23	.. c:macro:: LIRC_SET_SEND_MODE
		24
		25	``int ioctl(int fd, LIRC_SET_SEND_MODE, __u32 *mode)``
23		26
24	Arguments	27	Arguments
25	=========	28	=========
@@ -30,7 +33,6 @@ Arguments · 4 unmodified lines
30	``mode``	33	``mode``
31	The mode used for transmitting.	34	The mode used for transmitting.
32		35
33
34	Description	36	Description
35	===========	37	===========
36		38
@@ -44,14 +46,12 @@ modes the driver supports. · 7 unmodified lines
44	Return Value	46	Return Value
45	============	47	============
46		48
47
48	.. tabularcolumns:: \|p{2.5cm}\|p{15.0cm}\|	49	.. tabularcolumns:: \|p{2.5cm}\|p{15.0cm}\|
49		50
50	.. flat-table::	51	.. flat-table::
51	:header-rows: 0	52	:header-rows: 0
52	:stub-columns: 0	53	:stub-columns: 0
53		54
54
55	- .. row 1	55	- .. row 1
56		56
57	- ``ENODEV``	57	- ``ENODEV``

Documentation/userspace-api/media/rc/lirc-get-timeout.rst+7−6

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: RC
2		3
3	.. _lirc_get_min_timeout:	4	.. _lirc_get_min_timeout:
4	.. _lirc_get_max_timeout:	5	.. _lirc_get_max_timeout:
@@ -16,11 +17,13 @@ range for IR receive. · 11 unmodified lines
16	Synopsis	17	Synopsis
17	========	18	========
18		19
19	.. c:function:: int ioctl( int fd, LIRC_GET_MIN_TIMEOUT, __u32 *timeout)	20	.. c:macro:: LIRC_GET_MIN_TIMEOUT
20	:name: LIRC_GET_MIN_TIMEOUT
21		21
22	.. c:function:: int ioctl( int fd, LIRC_GET_MAX_TIMEOUT, __u32 *timeout)	22	``int ioctl(int fd, LIRC_GET_MIN_TIMEOUT, __u32 *timeout)``
23	:name: LIRC_GET_MAX_TIMEOUT	23
		24	.. c:macro:: LIRC_GET_MAX_TIMEOUT
		25
		26	``int ioctl(int fd, LIRC_GET_MAX_TIMEOUT, __u32 *timeout)``
24		27
25	Arguments	28	Arguments
26	=========	29	=========
@@ -31,7 +34,6 @@ Arguments · 4 unmodified lines
31	``timeout``	34	``timeout``
32	Timeout, in microseconds.	35	Timeout, in microseconds.
33		36
34
35	Description	37	Description
36	===========	38	===========
37		39
@@ -47,7 +49,6 @@ that can be set. · 9 unmodified lines
47	both ioctls will return the same value even though the timeout	49	both ioctls will return the same value even though the timeout
48	cannot be changed via :ref:`LIRC_SET_REC_TIMEOUT`.	50	cannot be changed via :ref:`LIRC_SET_REC_TIMEOUT`.
49		51
50
51	Return Value	52	Return Value
52	============	53	============
53		54

Documentation/userspace-api/media/rc/lirc-read.rst+3−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: RC
 .. _lirc-read:
 lirc-read - Read from a LIRC device
 Synopsis
 ========
     #include <unistd.h>
 .. c:function:: ssize_t read( int fd, void *buf, size_t count )
-    :name: lirc-read
 Arguments
 =========
 Description
 ===========
-:ref:`read() <lirc-read>` attempts to read up to ``count`` bytes from file
+:c:func:`read()` attempts to read up to ``count`` bytes from file
 descriptor ``fd`` into the buffer starting at ``buf``.  If ``count`` is zero,
-:ref:`read() <lirc-read>` returns zero and has no other results. If ``count``
+:c:func:`read()` returns zero and has no other results. If ``count``
 is greater than ``SSIZE_MAX``, the result is unspecified.
 The exact format of the data depends on what :ref:`lirc_modes` a driver
 used for transmission, and ``scancode`` to the decoded scancode,
 and the ``keycode`` set to the keycode or ``KEY_RESERVED``.
 Return Value
 ============

Documentation/userspace-api/media/rc/lirc-set-measure-carrier-mode.rst+4−4

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: RC
2		3
3	.. _lirc_set_measure_carrier_mode:	4	.. _lirc_set_measure_carrier_mode:
4		5
@@ -14,8 +15,9 @@ LIRC_SET_MEASURE_CARRIER_MODE - enable or disable measure mode · 9 unmodified lines
14	Synopsis	15	Synopsis
15	========	16	========
16		17
17	.. c:function:: int ioctl( int fd, LIRC_SET_MEASURE_CARRIER_MODE, __u32 *enable )	18	.. c:macro:: LIRC_SET_MEASURE_CARRIER_MODE
18	:name: LIRC_SET_MEASURE_CARRIER_MODE	19
		20	``int ioctl(int fd, LIRC_SET_MEASURE_CARRIER_MODE, __u32 *enable)``
19		21
20	Arguments	22	Arguments
21	=========	23	=========
@@ -27,7 +29,6 @@ Arguments · 5 unmodified lines
27	enable = 1 means enable measure mode, enable = 0 means disable measure	29	enable = 1 means enable measure mode, enable = 0 means disable measure
28	mode.	30	mode.
29		31
30
31	Description	32	Description
32	===========	33	===========
33		34
@@ -37,7 +38,6 @@ Enable or disable measure mode. If enabled, from the next key · 3 unmodified lines
37	press on, the driver will send ``LIRC_MODE2_FREQUENCY`` packets. By	38	press on, the driver will send ``LIRC_MODE2_FREQUENCY`` packets. By
38	default this should be turned off.	39	default this should be turned off.
39		40
40
41	Return Value	41	Return Value
42	============	42	============
43		43

Documentation/userspace-api/media/rc/lirc-set-rec-carrier-range.rst+4−2

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: RC
2		3
3	.. _lirc_set_rec_carrier_range:	4	.. _lirc_set_rec_carrier_range:
4		5
@@ -15,8 +16,9 @@ IR receive. · 10 unmodified lines
15	Synopsis	16	Synopsis
16	========	17	========
17		18
18	.. c:function:: int ioctl( int fd, LIRC_SET_REC_CARRIER_RANGE, __u32 *frequency )	19	.. c:macro:: LIRC_SET_REC_CARRIER_RANGE
19	:name: LIRC_SET_REC_CARRIER_RANGE	20
		21	``int ioctl(int fd, LIRC_SET_REC_CARRIER_RANGE, __u32 *frequency)``
20		22
21	Arguments	23	Arguments
22	=========	24	=========

Documentation/userspace-api/media/rc/lirc-set-rec-carrier.rst+4−4

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: RC
2		3
3	.. _lirc_set_rec_carrier:	4	.. _lirc_set_rec_carrier:
4		5
@@ -11,12 +12,12 @@ Name · 6 unmodified lines
11		12
12	LIRC_SET_REC_CARRIER - Set carrier used to modulate IR receive.	13	LIRC_SET_REC_CARRIER - Set carrier used to modulate IR receive.
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, LIRC_SET_REC_CARRIER, __u32 *frequency )	18	.. c:macro:: LIRC_SET_REC_CARRIER
19	:name: LIRC_SET_REC_CARRIER	19
		20	``int ioctl(int fd, LIRC_SET_REC_CARRIER, __u32 *frequency)``
20		21
21	Arguments	22	Arguments
22	=========	23	=========
@@ -37,7 +38,6 @@ Set receive carrier used to modulate IR PWM pulses and spaces. · 14 unmodified lines
37	If called together with :ref:`LIRC_SET_REC_CARRIER_RANGE`, this ioctl	38	If called together with :ref:`LIRC_SET_REC_CARRIER_RANGE`, this ioctl
38	sets the upper bound frequency that will be recognized by the device.	39	sets the upper bound frequency that will be recognized by the device.
39		40
40
41	Return Value	41	Return Value
42	============	42	============
43		43

Documentation/userspace-api/media/rc/lirc-set-rec-timeout-reports.rst+4−4

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: RC
2		3
3	.. _lirc_set_rec_timeout_reports:	4	.. _lirc_set_rec_timeout_reports:
4		5
@@ -14,8 +15,9 @@ LIRC_SET_REC_TIMEOUT_REPORTS - enable or disable timeout reports for IR receive · 9 unmodified lines
14	Synopsis	15	Synopsis
15	========	16	========
16		17
17	.. c:function:: int ioctl( int fd, LIRC_SET_REC_TIMEOUT_REPORTS, __u32 *enable )	18	.. c:macro:: LIRC_SET_REC_TIMEOUT_REPORTS
18	:name: LIRC_SET_REC_TIMEOUT_REPORTS	19
		20	``int ioctl(int fd, LIRC_SET_REC_TIMEOUT_REPORTS, __u32 *enable)``
19		21
20	Arguments	22	Arguments
21	=========	23	=========
@@ -27,7 +29,6 @@ Arguments · 5 unmodified lines
27	enable = 1 means enable timeout report, enable = 0 means disable timeout	29	enable = 1 means enable timeout report, enable = 0 means disable timeout
28	reports.	30	reports.
29		31
30
31	Description	32	Description
32	===========	33	===========
33		34
@@ -40,7 +41,6 @@ should be turned off. · 6 unmodified lines
40		41
41	This ioctl is only valid for :ref:`LIRC_MODE_MODE2 <lirc-mode-mode2>`.	42	This ioctl is only valid for :ref:`LIRC_MODE_MODE2 <lirc-mode-mode2>`.
42		43
43
44	Return Value	44	Return Value
45	============	45	============
46		46

Documentation/userspace-api/media/rc/lirc-set-rec-timeout.rst+7−6

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: RC
2		3
3	.. _lirc_set_rec_timeout:	4	.. _lirc_set_rec_timeout:
4	.. _lirc_get_rec_timeout:	5	.. _lirc_get_rec_timeout:
@@ -15,11 +16,13 @@ LIRC_GET_REC_TIMEOUT/LIRC_SET_REC_TIMEOUT - Get/set the integer value for IR ina · 10 unmodified lines
15	Synopsis	16	Synopsis
16	========	17	========
17		18
18	.. c:function:: int ioctl( int fd, LIRC_GET_REC_TIMEOUT, __u32 *timeout )	19	.. c:macro:: LIRC_GET_REC_TIMEOUT
19	:name: LIRC_GET_REC_TIMEOUT
20		20
21	.. c:function:: int ioctl( int fd, LIRC_SET_REC_TIMEOUT, __u32 *timeout )	21	``int ioctl(int fd, LIRC_GET_REC_TIMEOUT, __u32 *timeout)``
22	:name: LIRC_SET_REC_TIMEOUT	22
		23	.. c:macro:: LIRC_SET_REC_TIMEOUT
		24
		25	``int ioctl(int fd, LIRC_SET_REC_TIMEOUT, __u32 *timeout)``
23		26
24	Arguments	27	Arguments
25	=========	28	=========
@@ -30,7 +33,6 @@ Arguments · 4 unmodified lines
30	``timeout``	33	``timeout``
31	Timeout, in microseconds.	34	Timeout, in microseconds.
32		35
33
34	Description	36	Description
35	===========	37	===========
36		38
@@ -45,7 +47,6 @@ given value should be set. · 8 unmodified lines
45		47
46	The range of supported timeout is given by :ref:`LIRC_GET_MIN_TIMEOUT`.	48	The range of supported timeout is given by :ref:`LIRC_GET_MIN_TIMEOUT`.
47		49
48
49	Return Value	50	Return Value
50	============	51	============
51		52

Documentation/userspace-api/media/rc/lirc-set-send-carrier.rst+4−4

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: RC
2		3
3	.. _lirc_set_send_carrier:	4	.. _lirc_set_send_carrier:
4		5
@@ -11,12 +12,12 @@ Name · 6 unmodified lines
11		12
12	LIRC_SET_SEND_CARRIER - Set send carrier used to modulate IR TX.	13	LIRC_SET_SEND_CARRIER - Set send carrier used to modulate IR TX.
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, LIRC_SET_SEND_CARRIER, __u32 *frequency )	18	.. c:macro:: LIRC_SET_SEND_CARRIER
19	:name: LIRC_SET_SEND_CARRIER	19
		20	``int ioctl(int fd, LIRC_SET_SEND_CARRIER, __u32 *frequency)``
20		21
21	Arguments	22	Arguments
22	=========	23	=========
@@ -32,7 +33,6 @@ Description · 9 unmodified lines
32		33
33	Set send carrier used to modulate IR PWM pulses and spaces.	34	Set send carrier used to modulate IR PWM pulses and spaces.
34		35
35
36	Return Value	36	Return Value
37	============	37	============
38		38

Documentation/userspace-api/media/rc/lirc-set-send-duty-cycle.rst+4−4

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: RC
2		3
3	.. _lirc_set_send_duty_cycle:	4	.. _lirc_set_send_duty_cycle:
4		5
@@ -15,8 +16,9 @@ IR transmit. · 10 unmodified lines
15	Synopsis	16	Synopsis
16	========	17	========
17		18
18	.. c:function:: int ioctl( int fd, LIRC_SET_SEND_DUTY_CYCLE, __u32 *duty_cycle)	19	.. c:macro:: LIRC_SET_SEND_DUTY_CYCLE
19	:name: LIRC_SET_SEND_DUTY_CYCLE	20
		21	``int ioctl(int fd, LIRC_SET_SEND_DUTY_CYCLE, __u32 *duty_cycle)``
20		22
21	Arguments	23	Arguments
22	=========	24	=========
@@ -28,7 +30,6 @@ Arguments · 5 unmodified lines
28	Duty cicle, describing the pulse width in percent (from 1 to 99) of	30	Duty cicle, describing the pulse width in percent (from 1 to 99) of
29	the total cycle. Values 0 and 100 are reserved.	31	the total cycle. Values 0 and 100 are reserved.
30		32
31
32	Description	33	Description
33	===========	34	===========
34		35
@@ -38,7 +39,6 @@ Currently, no special meaning is defined for 0 or 100, but this · 3 unmodified lines
38	could be used to switch off carrier generation in the future, so	39	could be used to switch off carrier generation in the future, so
39	these values should be reserved.	40	these values should be reserved.
40		41
41
42	Return Value	42	Return Value
43	============	43	============
44		44

Documentation/userspace-api/media/rc/lirc-set-transmitter-mask.rst+4−4

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: RC
2		3
3	.. _lirc_set_transmitter_mask:	4	.. _lirc_set_transmitter_mask:
4		5
@@ -14,8 +15,9 @@ LIRC_SET_TRANSMITTER_MASK - Enables send codes on a given set of transmitters · 9 unmodified lines
14	Synopsis	15	Synopsis
15	========	16	========
16		17
17	.. c:function:: int ioctl( int fd, LIRC_SET_TRANSMITTER_MASK, __u32 *mask )	18	.. c:macro:: LIRC_SET_TRANSMITTER_MASK
18	:name: LIRC_SET_TRANSMITTER_MASK	19
		20	``int ioctl(int fd, LIRC_SET_TRANSMITTER_MASK, __u32 *mask)``
19		21
20	Arguments	22	Arguments
21	=========	23	=========
@@ -26,7 +28,6 @@ Arguments · 4 unmodified lines
26	``mask``	28	``mask``
27	Mask with channels to enable tx. Channel 0 is the least significant bit.	29	Mask with channels to enable tx. Channel 0 is the least significant bit.
28		30
29
30	Description	31	Description
31	===========	32	===========
32		33
@@ -42,7 +43,6 @@ When an invalid bit mask is given, i.e. a bit is set, even though the device · 9 unmodified lines
42	does not have so many transitters, then this ioctl returns the number of	43	does not have so many transitters, then this ioctl returns the number of
43	available transitters and does nothing otherwise.	44	available transitters and does nothing otherwise.
44		45
45
46	Return Value	46	Return Value
47	============	47	============
48		48

Documentation/userspace-api/media/rc/lirc-set-wideband-receiver.rst+4−4

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: RC
2		3
3	.. _lirc_set_wideband_receiver:	4	.. _lirc_set_wideband_receiver:
4		5
@@ -14,8 +15,9 @@ LIRC_SET_WIDEBAND_RECEIVER - enable wide band receiver. · 9 unmodified lines
14	Synopsis	15	Synopsis
15	========	16	========
16		17
17	.. c:function:: int ioctl( int fd, LIRC_SET_WIDEBAND_RECEIVER, __u32 *enable )	18	.. c:macro:: LIRC_SET_WIDEBAND_RECEIVER
18	:name: LIRC_SET_WIDEBAND_RECEIVER	19
		20	``int ioctl(int fd, LIRC_SET_WIDEBAND_RECEIVER, __u32 *enable)``
19		21
20	Arguments	22	Arguments
21	=========	23	=========
@@ -27,7 +29,6 @@ Arguments · 5 unmodified lines
27	enable = 1 means enable wideband receiver, enable = 0 means disable	29	enable = 1 means enable wideband receiver, enable = 0 means disable
28	wideband receiver.	30	wideband receiver.
29		31
30
31	Description	32	Description
32	===========	33	===========
33		34
@@ -47,7 +48,6 @@ reduced range of reception. · 13 unmodified lines
47	carrier reports. Trying to disable wide band receiver while carrier	48	carrier reports. Trying to disable wide band receiver while carrier
48	reports are active will do nothing.	49	reports are active will do nothing.
49		50
50
51	Return Value	51	Return Value
52	============	52	============
53		53

Documentation/userspace-api/media/rc/lirc-write.rst+2−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: RC
 .. _lirc-write:
 lirc-write - Write to a LIRC device
 Synopsis
 ========
     #include <unistd.h>
 .. c:function:: ssize_t write( int fd, void *buf, size_t count )
-    :name: lirc-write
 Arguments
 =========
 Description
 ===========
-:ref:`write() <lirc-write>` writes up to ``count`` bytes to the device
+:c:func:`write()` writes up to ``count`` bytes to the device
 referenced by the file descriptor ``fd`` from the buffer starting at
 ``buf``.
 ``EINVAL`` is returned. The write function blocks until the scancode
 is transmitted by the hardware.
 Return Value
 ============

Documentation/userspace-api/media/v4l/buffer.rst+3−25

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _buffer:
 flags are copied from the OUTPUT video buffer to the CAPTURE video
 buffer.
 Interactions between formats, controls and buffers
 ==================================================
 enough for all the desired formats and controls, or by allocating separate set
 of appropriately sized buffers for each use case).
 .. c:type:: v4l2_buffer
 struct v4l2_buffer
 	``V4L2_MEMORY_MMAP`` this is the offset of the buffer from the
 	start of the device memory. The value is returned by the driver
 	and apart of serving as parameter to the
-	:ref:`mmap() <func-mmap>` function not useful for applications.
+	:c:func:`mmap()` function not useful for applications.
 	See :ref:`mmap` for details
     * - unsigned long
       - ``userptr``
 	given, then ``EINVAL`` will be returned.
 .. c:type:: v4l2_plane
 struct v4l2_plane
       - ``mem_offset``
       - When the memory type in the containing struct
 	:c:type:`v4l2_buffer` is ``V4L2_MEMORY_MMAP``, this
-	is the value that should be passed to :ref:`mmap() <func-mmap>`,
+	is the value that should be passed to :c:func:`mmap()`,
 	similar to the ``offset`` field in struct
 	:c:type:`v4l2_buffer`.
     * - unsigned long
 	applications.
 .. c:type:: v4l2_buf_type
 enum v4l2_buf_type
       - Buffer for metadata output, see :ref:`metadata`.
 .. _buffer-flags:
 Buffer Flags
 .. _memory-flags:
-Memory Consistency Flags
-========================
-.. tabularcolumns:: |p{7.0cm}|p{2.2cm}|p{8.3cm}|
-.. cssclass:: longtable
-.. flat-table::
-    :header-rows:  0
-    :stub-columns: 0
-    :widths:       3 1 4
-.. c:type:: v4l2_memory
 enum v4l2_memory
 ================
       - The buffer is used for :ref:`DMA shared buffer <dmabuf>` I/O.
 Timecodes
 =========
 (struct :c:type:`timeval` timestamps are stored in the struct
 :c:type:`v4l2_buffer` ``timestamp`` field.)
 .. c:type:: v4l2_timecode
 struct v4l2_timecode
       - The "user group" bits from the timecode.
 .. _timecode-type:
 Timecode Types
       -
 .. _timecode-flags:
 Timecode Flags

Documentation/userspace-api/media/v4l/dev-capture.rst+2−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _capture:
 .. note:: The same device file names are used for video output devices.
 Querying Capabilities
 =====================
 streaming I/O methods must be supported. Tuners and audio inputs are
 optional.
 Supplemental Functions
 ======================
 :ref:`video input <video>` ioctls must be supported by all video
 capture devices.
 Image Format Negotiation
 ========================
 format, the number of bits per pixel or width and height. Together they
 also define how images are scaled in the process.
-As usual these parameters are *not* reset at :ref:`open() <func-open>`
+As usual these parameters are *not* reset at :c:func:`open()`
 time to permit Unix tool chains, programming a device and then reading
 from it as if it was a plain file. Well written V4L2 applications ensure
 they really get what they want, including cropping and scaling.
 requests and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does.
 :ref:`VIDIOC_TRY_FMT <VIDIOC_G_FMT>` is optional.
 Reading Images
 ==============

Documentation/userspace-api/media/v4l/dev-output.rst+2−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _output:
 .. note:: The same device file names are used also for video capture devices.
 Querying Capabilities
 =====================
 streaming I/O methods must be supported. Modulators and audio outputs
 are optional.
 Supplemental Functions
 ======================
 :ref:`video output <video>` ioctls must be supported by all video
 output devices.
 Image Format Negotiation
 ========================
 the number of bits per pixel or width and height. Together they also
 define how images are scaled in the process.
-As usual these parameters are *not* reset at :ref:`open() <func-open>`
+As usual these parameters are *not* reset at :c:func:`open()`
 time to permit Unix tool chains, programming a device and then writing
 to it as if it was a plain file. Well written V4L2 applications ensure
 they really get what they want, including cropping and scaling.
 requests and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does.
 :ref:`VIDIOC_TRY_FMT <VIDIOC_G_FMT>` is optional.
 Writing Images
 ==============

Documentation/userspace-api/media/v4l/dev-raw-vbi.rst+6−13

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _raw-vbi:
 Accessed as ``/dev/vbi``, raw VBI capturing or output is the default
 device function.
 Querying Capabilities
 =====================
 read/write, streaming or asynchronous I/O methods must be supported. VBI
 devices may or may not have a tuner or modulator.
 Supplemental Functions
 ======================
 ioctls as needed. The :ref:`video standard <standard>` ioctls provide
 information vital to program a VBI device, therefore must be supported.
 Raw VBI Format Negotiation
 ==========================
 query the sampling parameters. Moreover, to allow for some flexibility
 applications can also suggest different parameters.
-As usual these parameters are *not* reset at :ref:`open() <func-open>`
+As usual these parameters are *not* reset at :c:func:`open()`
 time to permit Unix tool chains, programming a device and then reading
 from it as if it was a plain file. Well written V4L2 applications should
 always ensure they really get what they want, requesting reasonable
 overlap, or when the driver supports multiple opens and another process
 already requested VBI capturing or output. Anyway, applications must
 expect other resource allocation points which may return ``EBUSY``, at the
-:ref:`VIDIOC_STREAMON` ioctl and the first :ref:`read() <func-read>`
+:ref:`VIDIOC_STREAMON` ioctl and the first :c:func:`read()`
-, :ref:`write() <func-write>` and :ref:`select() <func-select>` calls.
+, :c:func:`write()` and :c:func:`select()` calls.
 VBI devices must implement both the :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` and
 :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl, even if :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ignores all requests
       - This array is reserved for future extensions. Drivers and
 	applications must set it to zero.
 .. tabularcolumns:: |p{4.4cm}|p{1.5cm}|p{11.6cm}|
 .. _vbifmt-flags:
 	non-zero.
 .. _vbi-hsync:
 .. kernel-figure:: vbi_hsync.svg
     **Figure 4.1. Line synchronization**
 .. _vbi-525:
 .. kernel-figure:: vbi_525.svg
 the negotiated VBI parameters, should be refused by the driver. A format
 change during active I/O is not permitted.
 Reading and writing VBI images
 ==============================
 The total size of a frame computes as follows:
 .. code-block:: c
     (count[0] + count[1]) * samples_per_line * sample size in bytes
 using buffer timestamps.
 Remember the :ref:`VIDIOC_STREAMON <VIDIOC_STREAMON>` ioctl and the
-first :ref:`read() <func-read>`, :ref:`write() <func-write>` and
+first :c:func:`read()`, :c:func:`write()` and
-:ref:`select() <func-select>` call can be resource allocation
+:c:func:`select()` call can be resource allocation
 points returning an ``EBUSY`` error code if the required hardware resources
 are temporarily unavailable, for example the device is already in use by
 another process.

Documentation/userspace-api/media/v4l/dev-rds.rst+3−9

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _rds:
 the linux-media mailing list:
 `https://linuxtv.org/lists.php <https://linuxtv.org/lists.php>`__.
 Querying Capabilities
 =====================
 :ref:`Writing RDS data <writing-rds-data>` and
 :ref:`FM Transmitter Control Reference <fm-tx-controls>`.
 .. _reading-rds-data:
 Reading RDS data
 ================
 RDS data can be read from the radio device with the
-:ref:`read() <func-read>` function. The data is packed in groups of
+:c:func:`read()` function. The data is packed in groups of
 three bytes.
 .. _writing-rds-data:
 Writing RDS data
 ================
 RDS data can be written to the radio device with the
-:ref:`write() <func-write>` function. The data is packed in groups of
+:c:func:`write()` function. The data is packed in groups of
 three bytes, as follows:
 RDS datastructures
 ==================
 .. c:type:: v4l2_rds_data
 .. tabularcolumns:: |p{2.5cm}|p{2.5cm}|p{12.5cm}|
       - Block description
 .. _v4l2-rds-block:
 .. tabularcolumns:: |p{2.9cm}|p{14.6cm}|
 	reception of this block.
 .. _v4l2-rds-block-codes:
 .. tabularcolumns:: |p{6.4cm}|p{2.0cm}|p{1.2cm}|p{7.9cm}|

Documentation/userspace-api/media/v4l/dev-sliced-vbi.rst+7−24

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _sliced:
 Different file descriptors must be used to pass raw and sliced VBI data
 simultaneously, if this is supported by the driver.
 Querying Capabilities
 =====================
 read/write, streaming or asynchronous :ref:`I/O methods <io>` must be
 supported. Sliced VBI devices may have a tuner or modulator.
 Supplemental Functions
 ======================
 The :ref:`video standard <standard>` ioctls provide information vital
 to program a sliced VBI device, therefore must be supported.
 .. _sliced-vbi-format-negotitation:
 Sliced VBI Format Negotiation
 resources are temporarily unavailable. Other resource allocation points
 which may return ``EBUSY`` can be the
 :ref:`VIDIOC_STREAMON` ioctl and the first
-:ref:`read() <func-read>`, :ref:`write() <func-write>` and
+:c:func:`read()`, :c:func:`write()` and
-:ref:`select() <func-select>` call.
+:c:func:`select()` call.
 .. c:type:: v4l2_sliced_vbi_format
     * - __u32
       - ``io_size``
       - :cspan:`2` Maximum number of bytes passed by one
-	:ref:`read() <func-read>` or :ref:`write() <func-write>` call,
+	:c:func:`read()` or :c:func:`write()` call,
 	and the buffer size in bytes for the
 	:ref:`VIDIOC_QBUF` and
 	:ref:`VIDIOC_DQBUF <VIDIOC_QBUF>` ioctl. Drivers set this field
     \normalsize
 Drivers may return an ``EINVAL`` error code when applications attempt to
 read or write data without prior format negotiation, after switching the
 video standard (which may invalidate the negotiated VBI parameters) and
 format while i/o is in progress (between a
 :ref:`VIDIOC_STREAMON` and
 :ref:`VIDIOC_STREAMOFF <VIDIOC_STREAMON>` call, and after the first
-:ref:`read() <func-read>` or :ref:`write() <func-write>` call).
+:c:func:`read()` or :c:func:`write()` call).
 Reading and writing sliced VBI data
 ===================================
-A single :ref:`read() <func-read>` or :ref:`write() <func-write>`
+A single :c:func:`read()` or :c:func:`write()`
 call must pass all data belonging to one video frame. That is an array
 of struct :c:type:`v4l2_sliced_vbi_data` structures with one or
 more elements and a total size not exceeding ``io_size`` bytes. Likewise
 of one video frame. The ``id`` of unused
 struct :c:type:`v4l2_sliced_vbi_data` elements must be zero.
 .. c:type:: v4l2_sliced_vbi_data
 struct v4l2_sliced_vbi_data
 	bytes at the end of this array are undefined, drivers and
 	applications shall ignore them.
 Packets are always passed in ascending line number order, without
-duplicate line numbers. The :ref:`write() <func-write>` function and
+duplicate line numbers. The :c:func:`write()` function and
 the :ref:`VIDIOC_QBUF` ioctl must return an ``EINVAL``
 error code when applications violate this rule. They must also return an
 EINVAL error code when applications pass an incorrect field or line
 :ref:`user pointer <userp>`) I/O. The latter bears the possibility of
 synchronizing video and VBI data by using buffer timestamps.
 Sliced VBI Data in MPEG Streams
 ===============================
 The following subsections specify the format of the embedded sliced VBI
 data.
 MPEG Stream Embedded, Sliced VBI Data Format: NONE
 --------------------------------------------------
 MPEG stream when this format is set. No MPEG stream data structures are
 specified for this format.
 MPEG Stream Embedded, Sliced VBI Data Format: IVTV
 --------------------------------------------------
 with 18 lines/field with 43 bytes of data/line and a 4 byte magic
 number).
 .. c:type:: v4l2_mpeg_vbi_fmt_ivtv
 struct v4l2_mpeg_vbi_fmt_ivtv
 	valid and that 36 lines of sliced VBI data are present.
 .. c:type:: v4l2_mpeg_vbi_itv0
 .. c:type:: v4l2_mpeg_vbi_ITV0
 	value:
 	::
 	    linemask[0] b0:     line  6  first field
 	applications.
 .. _v4l2-mpeg-vbi-itv0-1:
 struct v4l2_mpeg_vbi_ITV0
 	lines 6 through 23 of the second field.
 .. c:type:: v4l2_mpeg_vbi_itv0_line
 struct v4l2_mpeg_vbi_itv0_line
       - The sliced VBI data for the line.
 .. _ITV0-Line-Identifier-Constants:
 Line Identifiers for struct v4l2_mpeg_vbi_itv0_line id field
 	description of the line payload.
 .. [#f1]
    According to :ref:`ETS 300 706 <ets300706>` lines 6-22 of the first
    field and lines 5-22 of the second field may carry Teletext data.

Documentation/userspace-api/media/v4l/diff-v4l.rst+6−33

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _diff-v4l:
 V4L calls were removed from Kernel, but the library :ref:`libv4l`
 supports the conversion of a V4L API system call into a V4L2 one.
 Opening and Closing Devices
 ===========================
 numbers, but the system administrator can assign arbitrary minor numbers
 using driver module options. The major device number remains 81.
 .. _v4l-dev:
 .. flat-table:: V4L Device Types, Names and Numbers
       - ``/dev/vbi``, ``/dev/vbi0`` to ``/dev/vbi31``
       - 224-255
 V4L prohibits (or used to prohibit) multiple opens of a device file.
 V4L2 drivers *may* support multiple opens, see :ref:`open` for details
 and consequences.
 V4L drivers respond to V4L2 ioctls with an ``EINVAL`` error code.
 Querying Capabilities
 =====================
       - ``-``
       - See above.
 The ``audios`` field was replaced by ``capabilities`` flag
 ``V4L2_CAP_AUDIO``, indicating *if* the device has any audio inputs or
 outputs. To determine their number applications can enumerate audio
 dimensions returns the closest size possible, taking into account the
 current video standard, cropping and scaling limitations.
 Video Sources
 =============
 video input types were renamed as follows:
 .. flat-table::
     :header-rows:  1
     :stub-columns: 0
     * - ``VIDEO_TYPE_CAMERA``
       - ``V4L2_INPUT_TYPE_CAMERA``
 Unlike the ``tuners`` field expressing the number of tuners of this
 input, V4L2 assumes each video input is connected to at most one tuner.
 However a tuner can have more than one input, i. e. RF connectors, and a
 meantime. V4L2 has a similar, albeit more comprehensive approach to
 video standards, see :ref:`standard` for more information.
 Tuning
 ======
 to a struct :c:type:`v4l2_frequency` instead of an
 unsigned long integer.
 .. _v4l-image-properties:
 Image Properties
 :ref:`VIDIOC_S_CTRL <VIDIOC_G_CTRL>` ioctls:
 .. flat-table::
     :header-rows:  1
     :stub-columns: 0
     * - ``whiteness``
       - ``V4L2_CID_WHITENESS``
 The V4L picture controls are assumed to range from 0 to 65535 with no
 particular reset value. The V4L2 API permits arbitrary limits and
 defaults which can be queried with the
 into the struct :c:type:`v4l2_pix_format`:
 .. flat-table::
     :header-rows:  1
     :stub-columns: 0
     * - ``VIDEO_PALETTE_YUV410P``
       - :ref:`V4L2_PIX_FMT_YVU410 <V4L2-PIX-FMT-YVU410>`
 V4L2 image formats are defined in :ref:`pixfmt`. The image format can
 be selected with the :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl.
 Audio
 =====
 :ref:`VIDIOC_S_CTRL <VIDIOC_G_CTRL>` ioctls:
 .. flat-table::
     :header-rows:  1
     :stub-columns: 0
     * - ``balance``
       - ``V4L2_CID_AUDIO_BALANCE``
 To determine which of these controls are supported by a driver V4L
 provides the ``flags`` ``VIDEO_AUDIO_VOLUME``, ``VIDEO_AUDIO_BASS``,
 ``VIDEO_AUDIO_TREBLE`` and ``VIDEO_AUDIO_BALANCE``. In the V4L2 API the
 the :ref:`VIDIOC_QUERYCTRL` ioctl. For general
 information about controls see :ref:`control`.
 Frame Buffer Overlay
 ====================
 The ``VIDIOCCAPTURE`` ioctl to enable or disable overlay was renamed to
 :ref:`VIDIOC_OVERLAY`.
 Cropping
 ========
 select a capture or overlay format with the
 :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl.
 Reading Images, Memory Mapping
 ==============================
 Capturing using the read method
 -------------------------------
 There is no essential difference between reading images from a V4L or
-V4L2 device using the :ref:`read() <func-read>` function, however V4L2
+V4L2 device using the :c:func:`read()` function, however V4L2
 drivers are not required to support this I/O method. Applications can
 determine if the function is available with the
 :ref:`VIDIOC_QUERYCAP` ioctl. All V4L2 devices
 exchanging data with applications must support the
-:ref:`select() <func-select>` and :ref:`poll() <func-poll>`
+:c:func:`select()` and :c:func:`poll()`
 functions.
 To select an image format and size, V4L provides the ``VIDIOCSPICT`` and
 For more information about the V4L2 read interface see :ref:`rw`.
 Capturing using memory mapping
 ------------------------------
 differences.
 .. flat-table::
     :header-rows:  1
     :stub-columns: 0
 	``VIDIOCGMBUF`` ioctl is available to query the number of buffers,
 	the offset of each buffer from the start of the virtual file, and
 	the overall amount of memory used, which can be used as arguments
-	for the :ref:`mmap() <func-mmap>` function.
+	for the :c:func:`mmap()` function.
       - Buffers are individually mapped. The offset and size of each
 	buffer can be determined with the
 	:ref:`VIDIOC_QUERYBUF` ioctl.
 	the incoming queue. Filled buffers are dequeued from the outgoing
 	queue with the :ref:`VIDIOC_DQBUF <VIDIOC_QBUF>` ioctl. To wait
 	until filled buffers become available this function,
-	:ref:`select() <func-select>` or :ref:`poll() <func-poll>` can
+	:c:func:`select()` or :c:func:`poll()` can
 	be used. The :ref:`VIDIOC_STREAMON` ioctl
 	must be called once after enqueuing one or more buffers to start
 	capturing. Its counterpart
 	signal status, if known, with the
 	:ref:`VIDIOC_ENUMINPUT` ioctl.
 For a more in-depth discussion of memory mapping and examples, see
 :ref:`mmap`.
 Reading Raw VBI Data
 ====================
 with the following parameters:
 .. flat-table::
     :header-rows:  1
     :stub-columns: 0
     * - flags
       - 0
 Undocumented in the V4L specification, in Linux 2.3 the
 ``VIDIOCGVBIFMT`` and ``VIDIOCSVBIFMT`` ioctls using struct
 ``vbi_format`` were added to determine the VBI image
 Apparently only the Zoran (ZR 36120) driver implements these ioctls. The
 semantics differ from those specified for V4L2 in two ways. The
-parameters are reset on :ref:`open() <func-open>` and
+parameters are reset on :c:func:`open()` and
 ``VIDIOCSVBIFMT`` always returns an ``EINVAL`` error code if the parameters
 are invalid.
 Miscellaneous
 =============

Documentation/userspace-api/media/v4l/dmabuf.rst+4−4

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _dmabuf:
 driver must be switched into DMABUF I/O mode by calling the
 :ref:`VIDIOC_REQBUFS <VIDIOC_REQBUFS>` with the desired buffer type.
 Example: Initiating streaming I/O with DMABUF file descriptors
 ==============================================================
 Two methods exist to suspend execution of the application until one or
 more buffers can be dequeued. By default :ref:`VIDIOC_DQBUF
 <VIDIOC_QBUF>` blocks when no buffer is in the outgoing queue. When the
-``O_NONBLOCK`` flag was given to the :ref:`open() <func-open>` function,
+``O_NONBLOCK`` flag was given to the :c:func:`open()` function,
 :ref:`VIDIOC_DQBUF <VIDIOC_QBUF>` returns immediately with an ``EAGAIN``
 error code when no buffer is available. The
-:ref:`select() <func-select>` and :ref:`poll() <func-poll>`
+:c:func:`select()` and :c:func:`poll()`
 functions are always available.
 To start and stop capturing or displaying applications call the
 :ref:`VIDIOC_REQBUFS <VIDIOC_REQBUFS>`, :ref:`VIDIOC_QBUF <VIDIOC_QBUF>`,
 :ref:`VIDIOC_DQBUF <VIDIOC_QBUF>`, :ref:`VIDIOC_STREAMON
 <VIDIOC_STREAMON>` and :ref:`VIDIOC_STREAMOFF <VIDIOC_STREAMON>` ioctls,
-and the :ref:`select() <func-select>` and :ref:`poll() <func-poll>`
+and the :c:func:`select()` and :c:func:`poll()`
 functions.

Documentation/userspace-api/media/v4l/format.rst+3−4

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _format:
 Data Formats
 ************
 Data Format Negotiation
 =======================
 When applications omit the :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl its locking side
 effects are implied by the next step, the selection of an I/O method
 with the :ref:`VIDIOC_REQBUFS` ioctl or implicit
-with the first :ref:`read() <func-read>` or
+with the first :c:func:`read()` or
-:ref:`write() <func-write>` call.
+:c:func:`write()` call.
 Generally only one logical stream can be assigned to a file descriptor,
 the exception being drivers permitting simultaneous video capturing and
 :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` and :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl. Implementation of the
 :ref:`VIDIOC_TRY_FMT <VIDIOC_G_FMT>` is highly recommended but optional.
 Image Format Enumeration
 ========================

Documentation/userspace-api/media/v4l/func-close.rst+2−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _func-close:
 v4l2-close - Close a V4L2 device
 Synopsis
 ========
     #include <unistd.h>
 .. c:function:: int close( int fd )
-    :name: v4l2-close
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 Description
 ===========
 parameters, current input or output, control values or other properties
 remain unchanged.
 Return Value
 ============

Documentation/userspace-api/media/v4l/func-ioctl.rst+3−7

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _func-ioctl:	4	.. _func-ioctl:
4		5
@@ -11,7 +12,6 @@ Name · 6 unmodified lines
11		12
12	v4l2-ioctl - Program a V4L2 device	13	v4l2-ioctl - Program a V4L2 device
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
@@ -19,15 +19,13 @@ Synopsis · 1 unmodified line
19		19
20	#include <sys/ioctl.h>	20	#include <sys/ioctl.h>
21		21
22		22	``int ioctl(int fd, int request, void *argp)``
23	.. c:function:: int ioctl( int fd, int request, void *argp )
24	:name: v4l2-ioctl
25		23
26	Arguments	24	Arguments
27	=========	25	=========
28		26
29	``fd``	27	``fd``
30	File descriptor returned by :ref:`open() <func-open>`.	28	File descriptor returned by :c:func:`open()`.
31		29
32	``request``	30	``request``
33	V4L2 ioctl request code as defined in the ``videodev2.h`` header	31	V4L2 ioctl request code as defined in the ``videodev2.h`` header
@@ -36,7 +34,6 @@ Arguments · 2 unmodified lines
36	``argp``	34	``argp``
37	Pointer to a function parameter, usually a structure.	35	Pointer to a function parameter, usually a structure.
38		36
39
40	Description	37	Description
41	===========	38	===========
42		39
@@ -50,7 +47,6 @@ include the version in the kernel sources on the system they compile on. · 7 unmodified lines
50	All V4L2 ioctl requests, their respective function and parameters are	47	All V4L2 ioctl requests, their respective function and parameters are
51	specified in :ref:`user-func`.	48	specified in :ref:`user-func`.
52		49
53
54	Return Value	50	Return Value
55	============	51	============
56		52

Documentation/userspace-api/media/v4l/func-mmap.rst+7−11

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _func-mmap:
 v4l2-mmap - Map device memory into application address space
 Synopsis
 ========
     #include <unistd.h>
     #include <sys/mman.h>
 .. c:function:: void *mmap( void *start, size_t length, int prot, int flags, int fd, off_t offset )
-    :name: v4l2-mmap
 Arguments
 =========
       #. The Linux ``videobuf`` kernel module, which is used by some
 	 drivers supports only ``PROT_READ`` | ``PROT_WRITE``. When the
 	 driver does not support the desired protection, the
-	 :ref:`mmap() <func-mmap>` function fails.
+	 :c:func:`mmap()` function fails.
       #. Device memory accesses (e. g. the memory on a graphics card
 	 with video capturing hardware) may incur a performance penalty
     ``MAP_FIXED`` requests that the driver selects no other address than
     the one specified. If the specified address cannot be used,
-    :ref:`mmap() <func-mmap>` will fail. If ``MAP_FIXED`` is specified,
+    :c:func:`mmap()` will fail. If ``MAP_FIXED`` is specified,
     ``start`` must be a multiple of the pagesize. Use of this option is
     discouraged.
        flags.
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``offset``
     Offset of the buffer in device memory. This must be the same value
     in the struct :c:type:`v4l2_plane` ``m`` union
     ``mem_offset`` field for the multi-planar API.
 Description
 ===========
-The :ref:`mmap() <func-mmap>` function asks to map ``length`` bytes starting at
+The :c:func:`mmap()` function asks to map ``length`` bytes starting at
 ``offset`` in the memory of the device specified by ``fd`` into the
 application address space, preferably at address ``start``. This latter
 address is a hint only, and is usually specified as 0.
 allocated with the :ref:`VIDIOC_REQBUFS` ioctl
 before they can be queried.
-To unmap buffers the :ref:`munmap() <func-munmap>` function is used.
+To unmap buffers the :c:func:`munmap()` function is used.
 Return Value
 ============
-On success :ref:`mmap() <func-mmap>` returns a pointer to the mapped buffer. On
+On success :c:func:`mmap()` returns a pointer to the mapped buffer. On
 error ``MAP_FAILED`` (-1) is returned, and the ``errno`` variable is set
 appropriately. Possible error codes are:

Documentation/userspace-api/media/v4l/func-munmap.rst+5−9

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _func-munmap:
 v4l2-munmap - Unmap device memory
 Synopsis
 ========
     #include <unistd.h>
     #include <sys/mman.h>
 .. c:function:: int munmap( void *start, size_t length )
-    :name: v4l2-munmap
 Arguments
 =========
 ``start``
     Address of the mapped buffer as returned by the
-    :ref:`mmap() <func-mmap>` function.
+    :c:func:`mmap()` function.
 ``length``
     Length of the mapped buffer. This must be the same value as given to
-    :ref:`mmap() <func-mmap>` and returned by the driver in the struct
+    :c:func:`mmap()` and returned by the driver in the struct
     :c:type:`v4l2_buffer` ``length`` field for the
     single-planar API and in the struct
     :c:type:`v4l2_plane` ``length`` field for the
     multi-planar API.
 Description
 ===========
-Unmaps a previously with the :ref:`mmap() <func-mmap>` function mapped
+Unmaps a previously with the :c:func:`mmap()` function mapped
 buffer and frees it, if possible.
 Return Value
 ============
-On success :ref:`munmap() <func-munmap>` returns 0, on failure -1 and the
+On success :c:func:`munmap()` returns 0, on failure -1 and the
 ``errno`` variable is set appropriately:
 EINVAL

Documentation/userspace-api/media/v4l/func-open.rst+5−9

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _func-open:
 v4l2-open - Open a V4L2 device
 Synopsis
 ========
     #include <fcntl.h>
 .. c:function:: int open( const char *device_name, int flags )
-    :name: v4l2-open
 Arguments
 =========
     technicality, input devices still support only reading and output
     devices only writing.
-    When the ``O_NONBLOCK`` flag is given, the :ref:`read() <func-read>`
+    When the ``O_NONBLOCK`` flag is given, the :c:func:`read()`
     function and the :ref:`VIDIOC_DQBUF <VIDIOC_QBUF>` ioctl will
     return the ``EAGAIN`` error code when no data is available or no
     buffer is in the driver outgoing queue, otherwise these functions
     Other flags have no effect.
 Description
 ===========
-To open a V4L2 device applications call :ref:`open() <func-open>` with the
+To open a V4L2 device applications call :c:func:`open()` with the
 desired device name. This function has no side effects; all data format
 parameters, current input or output, control values or other properties
-remain unchanged. At the first :ref:`open() <func-open>` call after loading the
+remain unchanged. At the first :c:func:`open()` call after loading the
 driver they will be reset to default values, drivers are never in an
 undefined state.
 Return Value
 ============
-On success :ref:`open() <func-open>` returns the new file descriptor. On error
+On success :c:func:`open()` returns the new file descriptor. On error
 -1 is returned, and the ``errno`` variable is set appropriately.
 Possible error codes are:

Documentation/userspace-api/media/v4l/func-poll.rst+18−22

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _func-poll:
 v4l2-poll - Wait for some event on a file descriptor
 Synopsis
 ========
     #include <sys/poll.h>
 .. c:function:: int poll( struct pollfd *ufds, unsigned int nfds, int timeout )
-    :name: v4l2-poll
 Arguments
 =========
 Description
 ===========
-With the :ref:`poll() <func-poll>` function applications can suspend execution
+With the :c:func:`poll()` function applications can suspend execution
 until the driver has captured data or is ready to accept data for
 output.
 (capture) or the incoming queue isn't full (display) the function
 returns immediately.
-On success :ref:`poll() <func-poll>` returns the number of file descriptors
+On success :c:func:`poll()` returns the number of file descriptors
 that have been selected (that is, file descriptors for which the
-``revents`` field of the respective :c:func:`struct pollfd` structure
+``revents`` field of the respective ``struct pollfd`` structure
 is non-zero). Capture devices set the ``POLLIN`` and ``POLLRDNORM``
 flags in the ``revents`` field, output devices the ``POLLOUT`` and
 ``POLLWRNORM`` flags. When the function timed out it returns a value of
 zero, on failure it returns -1 and the ``errno`` variable is set
 appropriately. When the application did not call
-:ref:`VIDIOC_STREAMON <VIDIOC_STREAMON>` the :ref:`poll() <func-poll>`
+:ref:`VIDIOC_STREAMON <VIDIOC_STREAMON>` the :c:func:`poll()`
 function succeeds, but sets the ``POLLERR`` flag in the ``revents``
 field. When the application has called
 :ref:`VIDIOC_STREAMON <VIDIOC_STREAMON>` for a capture device but
 hasn't yet called :ref:`VIDIOC_QBUF <VIDIOC_QBUF>`, the
-:ref:`poll() <func-poll>` function succeeds and sets the ``POLLERR`` flag in
+:c:func:`poll()` function succeeds and sets the ``POLLERR`` flag in
 the ``revents`` field. For output devices this same situation will cause
-:ref:`poll() <func-poll>` to succeed as well, but it sets the ``POLLOUT`` and
+:c:func:`poll()` to succeed as well, but it sets the ``POLLOUT`` and
 ``POLLWRNORM`` flags in the ``revents`` field.
 If an event occurred (see :ref:`VIDIOC_DQEVENT`)
 then ``POLLPRI`` will be set in the ``revents`` field and
-:ref:`poll() <func-poll>` will return.
+:c:func:`poll()` will return.
-When use of the :ref:`read() <func-read>` function has been negotiated and the
+When use of the :c:func:`read()` function has been negotiated and the
-driver does not capture yet, the :ref:`poll() <func-poll>` function starts
+driver does not capture yet, the :c:func:`poll()` function starts
 capturing. When that fails it returns a ``POLLERR`` as above. Otherwise
 it waits until data has been captured and can be read. When the driver
 captures continuously (as opposed to, for example, still images) the
 function may return immediately.
-When use of the :ref:`write() <func-write>` function has been negotiated and the
+When use of the :c:func:`write()` function has been negotiated and the
-driver does not stream yet, the :ref:`poll() <func-poll>` function starts
+driver does not stream yet, the :c:func:`poll()` function starts
 streaming. When that fails it returns a ``POLLERR`` as above. Otherwise
 it waits until the driver is ready for a non-blocking
-:ref:`write() <func-write>` call.
+:c:func:`write()` call.
 If the caller is only interested in events (just ``POLLPRI`` is set in
-the ``events`` field), then :ref:`poll() <func-poll>` will *not* start
+the ``events`` field), then :c:func:`poll()` will *not* start
 streaming if the driver does not stream yet. This makes it possible to
 just poll for events and not for buffers.
-All drivers implementing the :ref:`read() <func-read>` or :ref:`write() <func-write>`
+All drivers implementing the :c:func:`read()` or :c:func:`write()`
-function or streaming I/O must also support the :ref:`poll() <func-poll>`
+function or streaming I/O must also support the :c:func:`poll()`
 function.
-For more details see the :ref:`poll() <func-poll>` manual page.
+For more details see the :c:func:`poll()` manual page.
 Return Value
 ============
-On success, :ref:`poll() <func-poll>` returns the number structures which have
+On success, :c:func:`poll()` returns the number structures which have
 non-zero ``revents`` fields, or zero if the call timed out. On error -1
 is returned, and the ``errno`` variable is set appropriately:

Documentation/userspace-api/media/v4l/func-read.rst+18−21

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _func-read:
 v4l2-read - Read from a V4L2 device
 Synopsis
 ========
     #include <unistd.h>
 .. c:function:: ssize_t read( int fd, void *buf, size_t count )
-    :name: v4l2-read
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``buf``
    Buffer to be filled
 Description
 ===========
-:ref:`read() <func-read>` attempts to read up to ``count`` bytes from file
+:c:func:`read()` attempts to read up to ``count`` bytes from file
 descriptor ``fd`` into the buffer starting at ``buf``. The layout of the
 data in the buffer is discussed in the respective device interface
-section, see ##. If ``count`` is zero, :ref:`read() <func-read>` returns zero
+section, see ##. If ``count`` is zero, :c:func:`read()` returns zero
 and has no other results. If ``count`` is greater than ``SSIZE_MAX``,
 the result is unspecified. Regardless of the ``count`` value each
-:ref:`read() <func-read>` call will provide at most one frame (two fields)
+:c:func:`read()` call will provide at most one frame (two fields)
 worth of data.
-By default :ref:`read() <func-read>` blocks until data becomes available. When
+By default :c:func:`read()` blocks until data becomes available. When
-the ``O_NONBLOCK`` flag was given to the :ref:`open() <func-open>`
+the ``O_NONBLOCK`` flag was given to the :c:func:`open()`
 function it returns immediately with an ``EAGAIN`` error code when no data
-is available. The :ref:`select() <func-select>` or
+is available. The :c:func:`select()` or
-:ref:`poll() <func-poll>` functions can always be used to suspend
+:c:func:`poll()` functions can always be used to suspend
 execution until data becomes available. All drivers supporting the
-:ref:`read() <func-read>` function must also support :ref:`select() <func-select>` and
+:c:func:`read()` function must also support :c:func:`select()` and
-:ref:`poll() <func-poll>`.
+:c:func:`poll()`.
 Drivers can implement read functionality in different ways, using a
 single or multiple buffers and discarding the oldest or newest frames
 once the internal buffers are filled.
-:ref:`read() <func-read>` never returns a "snapshot" of a buffer being filled.
+:c:func:`read()` never returns a "snapshot" of a buffer being filled.
 Using a single buffer the driver will stop capturing when the
 application starts reading the buffer until the read is finished. Thus
 only the period of the vertical blanking interval is available for
 reading, or the capture rate must fall below the nominal frame rate of
 the video standard.
-The behavior of :ref:`read() <func-read>` when called during the active picture
+The behavior of :c:func:`read()` when called during the active picture
 period or the vertical blanking separating the top and bottom field
 depends on the discarding policy. A driver discarding the oldest frames
 keeps capturing into an internal buffer, continuously overwriting the
 previously, not read frame, and returns the frame being received at the
-time of the :ref:`read() <func-read>` call as soon as it is complete.
+time of the :c:func:`read()` call as soon as it is complete.
 A driver discarding the newest frames stops capturing until the next
-:ref:`read() <func-read>` call. The frame being received at :ref:`read() <func-read>`
+:c:func:`read()` call. The frame being received at :c:func:`read()`
 time is discarded, returning the following frame instead. Again this
 implies a reduction of the capture rate to one half or less of the
 nominal frame rate. An example of this model is the video read mode of
-the bttv driver, initiating a DMA to user memory when :ref:`read() <func-read>`
+the bttv driver, initiating a DMA to user memory when :c:func:`read()`
 is called and returning when the DMA finished.
 In the multiple buffer model drivers maintain a ring of internal
 however. The discarding policy is not reported and cannot be changed.
 For minimum requirements see :ref:`devices`.
 Return Value
 ============
 On success, the number of bytes read is returned. It is not an error if
 this number is smaller than the number of bytes requested, or the amount
 of data required for one frame. This may happen for example because
-:ref:`read() <func-read>` was interrupted by a signal. On error, -1 is
+:c:func:`read()` was interrupted by a signal. On error, -1 is
 returned, and the ``errno`` variable is set appropriately. In this case
 the next read will start at the beginning of a new frame. Possible error
 codes are:
     communicate with a remote device (USB camera etc.).
 EINVAL
-    The :ref:`read() <func-read>` function is not supported by this driver, not
+    The :c:func:`read()` function is not supported by this driver, not
     on this device, or generally not on this type of device.

Documentation/userspace-api/media/v4l/func-select.rst+19−23

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _func-select:
 v4l2-select - Synchronous I/O multiplexing
 Synopsis
 ========
     #include <sys/types.h>
     #include <unistd.h>
 .. c:function:: int select( int nfds, fd_set *readfds, fd_set *writefds, fd_set *exceptfds, struct timeval *timeout )
-    :name: v4l2-select
 Arguments
 =========
 ``timeout``
   Maximum time to wait.
 Description
 ===========
-With the :ref:`select() <func-select>` function applications can suspend
+With the :c:func:`select()` function applications can suspend
 execution until the driver has captured data or is ready to accept data
 for output.
 :ref:`VIDIOC_DQBUF <VIDIOC_QBUF>` ioctl. When buffers are already in
 the outgoing queue of the driver the function returns immediately.
-On success :ref:`select() <func-select>` returns the total number of bits set in
+On success :c:func:`select()` returns the total number of bits set in
-:c:func:`struct fd_set`. When the function timed out it returns
+``fd_set``. When the function timed out it returns
 a value of zero. On failure it returns -1 and the ``errno`` variable is
 set appropriately. When the application did not call
 :ref:`VIDIOC_QBUF` or
-:ref:`VIDIOC_STREAMON` yet the :ref:`select() <func-select>`
+:ref:`VIDIOC_STREAMON` yet the :c:func:`select()`
 function succeeds, setting the bit of the file descriptor in ``readfds``
 or ``writefds``, but subsequent :ref:`VIDIOC_DQBUF <VIDIOC_QBUF>`
 calls will fail. [#f1]_
-When use of the :ref:`read() <func-read>` function has been negotiated and the
+When use of the :c:func:`read()` function has been negotiated and the
-driver does not capture yet, the :ref:`select() <func-select>` function starts
+driver does not capture yet, the :c:func:`select()` function starts
-capturing. When that fails, :ref:`select() <func-select>` returns successful and
+capturing. When that fails, :c:func:`select()` returns successful and
-a subsequent :ref:`read() <func-read>` call, which also attempts to start
+a subsequent :c:func:`read()` call, which also attempts to start
 capturing, will return an appropriate error code. When the driver
 captures continuously (as opposed to, for example, still images) and
-data is already available the :ref:`select() <func-select>` function returns
+data is already available the :c:func:`select()` function returns
 immediately.
-When use of the :ref:`write() <func-write>` function has been negotiated the
+When use of the :c:func:`write()` function has been negotiated the
-:ref:`select() <func-select>` function just waits until the driver is ready for a
+:c:func:`select()` function just waits until the driver is ready for a
-non-blocking :ref:`write() <func-write>` call.
+non-blocking :c:func:`write()` call.
-All drivers implementing the :ref:`read() <func-read>` or :ref:`write() <func-write>`
+All drivers implementing the :c:func:`read()` or :c:func:`write()`
-function or streaming I/O must also support the :ref:`select() <func-select>`
+function or streaming I/O must also support the :c:func:`select()`
 function.
-For more details see the :ref:`select() <func-select>` manual page.
+For more details see the :c:func:`select()` manual page.
 Return Value
 ============
-On success, :ref:`select() <func-select>` returns the number of descriptors
+On success, :c:func:`select()` returns the number of descriptors
 contained in the three returned descriptor sets, which will be zero if
 the timeout expired. On error -1 is returned, and the ``errno`` variable
 is set appropriately; the sets and ``timeout`` are undefined. Possible
     ``FD_SETSIZE``.
 .. [#f1]
-   The Linux kernel implements :ref:`select() <func-select>` like the
+   The Linux kernel implements :c:func:`select()` like the
-   :ref:`poll() <func-poll>` function, but :ref:`select() <func-select>` cannot
+   :c:func:`poll()` function, but :c:func:`select()` cannot
    return a ``POLLERR``.

Documentation/userspace-api/media/v4l/func-write.rst+5−8

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _func-write:
 v4l2-write - Write to a V4L2 device
 Synopsis
 ========
     #include <unistd.h>
 .. c:function:: ssize_t write( int fd, void *buf, size_t count )
-    :name: v4l2-write
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``buf``
      Buffer with data to be written
 Description
 ===========
-:ref:`write() <func-write>` writes up to ``count`` bytes to the device
+:c:func:`write()` writes up to ``count`` bytes to the device
 referenced by the file descriptor ``fd`` from the buffer starting at
 ``buf``. When the hardware outputs are not active yet, this function
-enables them. When ``count`` is zero, :ref:`write() <func-write>` returns 0
+enables them. When ``count`` is zero, :c:func:`write()` returns 0
 without any other effect.
 When the application does not provide more data in time, the previous
 Sliced Teletext or Closed Caption data is not repeated, the driver
 inserts a blank line instead.
 Return Value
 ============
     I/O error. This indicates some hardware problem.
 EINVAL
-    The :ref:`write() <func-write>` function is not supported by this driver,
+    The :c:func:`write()` function is not supported by this driver,
     not on this device, or generally not on this type of device.

Documentation/userspace-api/media/v4l/hist-v4l2.rst+4−66

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _hist-v4l2:
 another four years and two stable kernel releases until the new API was
 finally accepted for inclusion into the kernel in its present form.
 Early Versions
 ==============
 1998-08-20: First version.
-1998-08-27: The :ref:`select() <func-select>` function was introduced.
+1998-08-27: The :c:func:`select()` function was introduced.
 1998-09-10: New video standard interface.
 1998-09-18: The ``VIDIOC_NONCAP`` ioctl was replaced by the otherwise
-meaningless ``O_TRUNC`` :ref:`open() <func-open>` flag, and the
+meaningless ``O_TRUNC`` :c:func:`open()` flag, and the
 aliases ``O_NONCAP`` and ``O_NOIO`` were defined. Applications can set
 this flag if they intend to access controls only, as opposed to capture
 applications which need exclusive access. The ``VIDEO_STD_XXX``
 1999-01-19: The ``VIDIOC_NEXTBUF`` ioctl was removed.
 V4L2 Version 0.16 1999-01-31
 ============================
 are gone. VIDIOC_QBUF takes a v4l2_buffer as a parameter. Added
 digital zoom (cropping) controls.
 V4L2 Version 0.18 1999-03-16
 ============================
 writers, this changes how you implement your ioctl handler. See the
 Driver Writer's Guide. Added some more control id codes.
 V4L2 Version 0.19 1999-06-05
 ============================
 1999-06-05: Changed the value of V4L2_CID_WHITENESS.
 V4L2 Version 0.20 (1999-09-10)
 ==============================
    VIDIOC_STREAMON, VIDIOC_STREAMOFF, VIDIOC_S_FREQ,
    VIDIOC_S_INPUT, VIDIOC_S_OUTPUT, VIDIOC_S_EFFECT. For example
    .. code-block:: c
        err = ioctl (fd, VIDIOC_XXX, V4L2_XXX);
    becomes
    .. code-block:: c
        int a = V4L2_XXX; err = ioctl(fd, VIDIOC_XXX, &a);
    field counts captured frames, it is ignored by output devices. When a
    capture driver drops a frame, the sequence number of that frame is skipped.
 V4L2 Version 0.20 incremental changes
 =====================================
    were added. The former is an alias for the old ``V4L2_TYPE_VBI``, the
    latter was missing in the ``videodev.h`` file.
 V4L2 Version 0.20 2002-07-25
 ============================
 Added sliced VBI interface proposal.
 V4L2 in Linux 2.5.46, 2002-10
 =============================
 1.  As specified in :ref:`related`, drivers must make related device
     functions available under all minor device numbers.
-2.  The :ref:`open() <func-open>` function requires access mode
+2.  The :c:func:`open()` function requires access mode
     ``O_RDWR`` regardless of the device type. All V4L2 drivers
     exchanging data with applications must support the ``O_NONBLOCK``
     flag. The ``O_NOIO`` flag, a V4L2 symbol which aliased the
     the buffer type names changed as follows.
     .. flat-table::
 	:header-rows:  1
 	:stub-columns: 0
     V4L2 documentation was inaccurate, this has been corrected in
     :ref:`pixfmt`.
 V4L2 2003-06-19
 ===============
    Kernel 2.6.39. Drivers and applications assuming a constant parameter
    need an update.
 V4L2 2003-11-05
 ===============
    refer to bytes in memory, in ascending address order.
    .. flat-table::
        :header-rows:  1
        :stub-columns: 0
 	 - R, G, B, X
 	 - B, G, R, X
    The ``V4L2_PIX_FMT_BGR24`` example was always correct.
    In :ref:`v4l-image-properties` the mapping of the V4L
    RGB pixel formats differently. These issues have yet to be addressed,
    for details see :ref:`pixfmt-rgb`.
 V4L2 in Linux 2.6.6, 2004-05-09
 ===============================
    ioctl, while the read-only version was renamed to
    ``VIDIOC_CROPCAP_OLD``. The old ioctl was removed on Kernel 2.6.39.
 V4L2 in Linux 2.6.8
 ===================
    the new ``V4L2_BUF_FLAG_INPUT`` flag. The ``flags`` field is no
    longer read-only.
 V4L2 spec erratum 2004-08-01
 ============================
    also missing from examples. Also on the ``VIDIOC_DQBUF`` page the ``EIO``
    error code was not documented.
 V4L2 in Linux 2.6.14
 ====================
    :ref:`sliced` and replaces the interface first proposed in V4L2
    specification 0.8.
 V4L2 in Linux 2.6.15
 ====================
    ``VIDIOC_G_MPEGCOMP`` and ``VIDIOC_S_MPEGCOMP`` ioctls where removed
    in Linux 2.6.25.)
 V4L2 spec erratum 2005-11-27
 ============================
 :ref:`standard` the :ref:`VIDIOC_S_STD <VIDIOC_G_STD>` call used
 the wrong argument type.
 V4L2 spec erratum 2006-01-10
 ============================
    write-only as stated on its reference page. The ioctl changed in 2003
    as noted above.
 V4L2 spec erratum 2006-02-03
 ============================
 1. In struct v4l2_captureparm and struct v4l2_outputparm the ``timeperframe``
    field gives the time in seconds, not microseconds.
 V4L2 spec erratum 2006-02-04
 ============================
    ``V4L2_TUNER_MODE_STEREO`` for this purpose is deprecated now. See
    the :ref:`VIDIOC_G_TUNER <VIDIOC_G_TUNER>` section for details.
 V4L2 spec erratum 2006-09-23 (Draft 0.15)
 =========================================
    extended from 224-239 to 224-255. Accordingly device file names
    ``/dev/vbi0`` to ``/dev/vbi31`` are possible now.
 V4L2 in Linux 2.6.18
 ====================
    ``V4L2_CTRL_FLAG_INACTIVE`` and ``V4L2_CTRL_FLAG_SLIDER``
    (:ref:`control-flags`). See :ref:`extended-controls` for details.
 V4L2 in Linux 2.6.19
 ====================
 3. A new pixel format ``V4L2_PIX_FMT_RGB444`` (:ref:`pixfmt-rgb`) was
    added.
 V4L2 spec erratum 2006-10-12 (Draft 0.17)
 =========================================
 1. ``V4L2_PIX_FMT_HM12`` (:ref:`reserved-formats`) is a YUV 4:2:0, not
    4:2:2 format.
 V4L2 in Linux 2.6.21
 ====================
    General Public License version two or later, and under a 3-clause
    BSD-style license.
 V4L2 in Linux 2.6.22
 ====================
    This may **break compatibility** with existing applications. Drivers
    supporting the "host order RGB32" format are not known.
 V4L2 in Linux 2.6.24
 ====================
    ``V4L2_PIX_FMT_YUV555``, ``V4L2_PIX_FMT_YUV565`` and
    ``V4L2_PIX_FMT_YUV32`` were added.
 V4L2 in Linux 2.6.25
 ====================
    interface in Linux 2.6.18, where finally removed from the
    ``videodev2.h`` header file.
 V4L2 in Linux 2.6.26
 ====================
 2. Added user controls ``V4L2_CID_CHROMA_AGC`` and
    ``V4L2_CID_COLOR_KILLER``.
 V4L2 in Linux 2.6.27
 ====================
    ``V4L2_PIX_FMT_PCA561``, ``V4L2_PIX_FMT_SGBRG8``,
    ``V4L2_PIX_FMT_PAC207`` and ``V4L2_PIX_FMT_PJPG`` were added.
 V4L2 in Linux 2.6.28
 ====================
 3. The pixel formats ``V4L2_PIX_FMT_SGRBG10`` and
    ``V4L2_PIX_FMT_SGRBG10DPCM8`` were added.
 V4L2 in Linux 2.6.29
 ====================
    ``V4L2_CID_ZOOM_RELATIVE``, ``V4L2_CID_ZOOM_CONTINUOUS`` and
    ``V4L2_CID_PRIVACY``.
 V4L2 in Linux 2.6.30
 ====================
 2. New control ``V4L2_CID_COLORFX`` was added.
 V4L2 in Linux 2.6.32
 ====================
 9. Added Remote Controller chapter, describing the default Remote
    Controller mapping for media devices.
 V4L2 in Linux 2.6.33
 ====================
 1. Added support for Digital Video timings in order to support HDTV
    receivers and transmitters.
 V4L2 in Linux 2.6.34
 ====================
 1. Added ``V4L2_CID_IRIS_ABSOLUTE`` and ``V4L2_CID_IRIS_RELATIVE``
    controls to the :ref:`Camera controls class <camera-controls>`.
 V4L2 in Linux 2.6.37
 ====================
    applications found that used it. It was originally scheduled for
    removal in 2.6.35.
 V4L2 in Linux 2.6.39
 ====================
    drivers and applications. See :ref:`multi-planar API <planar-apis>`
    for details.
 V4L2 in Linux 3.1
 =================
    Added V4L2_CTRL_TYPE_BITMASK.
 V4L2 in Linux 3.2
 =================
    Does not affect the compatibility of current drivers and
    applications. See :ref:`selection API <selection-api>` for details.
 V4L2 in Linux 3.3
 =================
 2. Added the device_caps field to struct v4l2_capabilities and added
    the new V4L2_CAP_DEVICE_CAPS capability.
 V4L2 in Linux 3.4
 =================
    :ref:`VIDIOC_QUERY_DV_TIMINGS` and
    :ref:`VIDIOC_DV_TIMINGS_CAP`.
 V4L2 in Linux 3.5
 =================
    ``V4L2_CID_AUTO_FOCUS_START``, ``V4L2_CID_AUTO_FOCUS_STOP``,
    ``V4L2_CID_AUTO_FOCUS_STATUS`` and ``V4L2_CID_AUTO_FOCUS_RANGE``.
 V4L2 in Linux 3.6
 =================
 3. Added support for frequency band enumerations:
    :ref:`VIDIOC_ENUM_FREQ_BANDS`.
 V4L2 in Linux 3.9
 =================
 2. Added ``V4L2_EVENT_CTRL_CH_RANGE`` control event changes flag. See
    :ref:`ctrl-changes-flags`.
 V4L2 in Linux 3.10
 ==================
 2. Added new debugging ioctl
    :ref:`VIDIOC_DBG_G_CHIP_INFO`.
 V4L2 in Linux 3.11
 ==================
 1. Remove obsolete ``VIDIOC_DBG_G_CHIP_IDENT`` ioctl.
 V4L2 in Linux 3.14
 ==================
 1. In struct v4l2_rect, the type of ``width`` and
    ``height`` fields changed from _s32 to _u32.
 V4L2 in Linux 3.15
 ==================
 1. Added Software Defined Radio (SDR) Interface.
 V4L2 in Linux 3.16
 ==================
 1. Added event V4L2_EVENT_SOURCE_CHANGE.
 V4L2 in Linux 3.17
 ==================
 2. Added compound control types and
    :ref:`VIDIOC_QUERY_EXT_CTRL <VIDIOC_QUERYCTRL>`.
 V4L2 in Linux 3.18
 ==================
 1. Added ``V4L2_CID_PAN_SPEED`` and ``V4L2_CID_TILT_SPEED`` camera
    controls.
 V4L2 in Linux 3.19
 ==================
 3. Added transmitter support for Software Defined Radio (SDR) Interface.
 .. _other:
 Relation of V4L2 to other Linux multimedia APIs
 ===============================================
 .. _xvideo:
 X Video Extension
 an interface to MPEG-2 decoding hardware. This API is useful to display
 images captured with V4L2 devices.
 Digital Video
 -------------
 DVB API has no connection to the V4L2 API except that drivers for hybrid
 hardware may support both.
 Audio Interfaces
 ----------------
 [to do - OSS/ALSA]
 .. _experimental:
 Experimental API Elements
 -  :ref:`VIDIOC_DBG_G_CHIP_INFO` ioctl.
 .. _obsolete:
 Obsolete API Elements

Documentation/userspace-api/media/v4l/io.rst+3−3

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _io:
 a device. All drivers exchanging data with applications must support at
 least one of them.
-The classic I/O method using the :ref:`read() <func-read>` and
+The classic I/O method using the :c:func:`read()` and
-:ref:`write() <func-write>` function is automatically selected after opening a
+:c:func:`write()` function is automatically selected after opening a
 V4L2 device. When the driver does not support this method attempts to
 read or write will fail at any time.
 The following sections describe the various I/O methods in more detail.
 .. toctree::
     :maxdepth: 1

Documentation/userspace-api/media/v4l/libv4l-introduction.rst+13−17

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _libv4l-introduction:
 libv4l consists of 3 different libraries:
 libv4lconvert
 =============
 libv4lconvert/processing offers the actual video processing
 functionality.
 libv4l1
 =======
 Since those functions are emulations of the old V4L1 API, it shouldn't
 be used for new applications.
 libv4l2
 =======
 keeps enumerating the hardware supported formats, plus the emulated
 formats offered by libv4l at the end.
 .. _libv4l-ops:
 Libv4l device control functions
 Those functions operate just like the gcc function ``dup()`` and
 V4L2 functions
-:c:func:`open() <v4l2-open>`, :c:func:`close() <v4l2-close>`,
+:c:func:`open()`, :c:func:`close()`,
-:c:func:`ioctl() <v4l2-ioctl>`, :c:func:`read() <v4l2-read>`,
+:c:func:`ioctl()`, :c:func:`read()`,
-:c:func:`mmap() <v4l2-mmap>` and :c:func:`munmap() <v4l2-munmap>`:
+:c:func:`mmap()` and :c:func:`munmap()`:
 .. c:function:: int v4l2_open(const char *file, int oflag, ...)
-   operates like the :c:func:`open() <v4l2-open>` function.
+   operates like the :c:func:`open()` function.
 .. c:function:: int v4l2_close(int fd)
-   operates like the :c:func:`close() <v4l2-close>` function.
+   operates like the :c:func:`close()` function.
 .. c:function:: int v4l2_dup(int fd)
 .. c:function:: int v4l2_ioctl (int fd, unsigned long int request, ...)
-   operates like the :c:func:`ioctl() <v4l2-ioctl>` function.
+   operates like the :c:func:`ioctl()` function.
 .. c:function:: int v4l2_read (int fd, void* buffer, size_t n)
-   operates like the :c:func:`read() <v4l2-read>` function.
+   operates like the :c:func:`read()` function.
 .. c:function:: void v4l2_mmap(void *start, size_t length, int prot, int flags, int fd, int64_t offset);
-   operates like the :c:func:`munmap() <v4l2-munmap>` function.
+   operates like the :c:func:`munmap()` function.
 .. c:function:: int v4l2_munmap(void *_start, size_t length);
-   operates like the :c:func:`munmap() <v4l2-munmap>` function.
+   operates like the :c:func:`munmap()` function.
 Those functions provide additional control:
    of the given v4l control id. when the cid does not exist, could not be
    accessed for some reason, or some error occurred 0 is returned.
 v4l1compat.so wrapper library
 =============================
 This library intercepts calls to
-:c:func:`open() <v4l2-open>`, :c:func:`close() <v4l2-close>`,
+:c:func:`open()`, :c:func:`close()`,
-:c:func:`ioctl() <v4l2-ioctl>`, :c:func:`mmap() <v4l2-mmap>` and
+:c:func:`ioctl()`, :c:func:`mmap()` and
-:c:func:`munmap() <v4l2-munmap>`
+:c:func:`munmap()`
 operations and redirects them to the libv4l counterparts, by using
 ``LD_PRELOAD=/usr/lib/v4l1compat.so``. It also emulates V4L1 calls via V4L2
 API.

Documentation/userspace-api/media/v4l/mmap.rst+13−13

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _mmap:
 the allocated memory, provided none of the buffers are still mapped.
 Before applications can access the buffers they must map them into their
-address space with the :ref:`mmap() <func-mmap>` function. The
+address space with the :c:func:`mmap()` function. The
 location of the buffers in device memory can be determined with the
 :ref:`VIDIOC_QUERYBUF` ioctl. In the single-planar
 API case, the ``m.offset`` and ``length`` returned in a struct
 :c:type:`v4l2_buffer` are passed as sixth and second
-parameter to the :ref:`mmap() <func-mmap>` function. When using the
+parameter to the :c:func:`mmap()` function. When using the
 multi-planar API, struct :c:type:`v4l2_buffer` contains an
 array of struct :c:type:`v4l2_plane` structures, each
 containing its own ``m.offset`` and ``length``. When using the
 multi-planar API, every plane of every buffer has to be mapped
-separately, so the number of calls to :ref:`mmap() <func-mmap>` should
+separately, so the number of calls to :c:func:`mmap()` should
 be equal to number of buffers times number of planes in each buffer. The
 offset and length values must not be modified. Remember, the buffers are
 allocated in physical memory, as opposed to virtual memory, which can be
 swapped out to disk. Applications should free the buffers as soon as
-possible with the :ref:`munmap() <func-munmap>` function.
+possible with the :c:func:`munmap()` function.
 Example: Mapping buffers in the single-planar API
 =================================================
     for (i = 0; i < reqbuf.count; i++)
 	munmap(buffers[i].start, buffers[i].length);
 Example: Mapping buffers in the multi-planar API
 ================================================
 methods exist to suspend execution of the application until one or more
 buffers can be dequeued.  By default :ref:`VIDIOC_DQBUF <VIDIOC_QBUF>`
 blocks when no buffer is in the outgoing queue. When the ``O_NONBLOCK``
-flag was given to the :ref:`open() <func-open>` function,
+flag was given to the :c:func:`open()` function,
 :ref:`VIDIOC_DQBUF <VIDIOC_QBUF>` returns immediately with an ``EAGAIN``
-error code when no buffer is available. The :ref:`select() <func-select>`
+error code when no buffer is available. The :c:func:`select()`
-or :ref:`poll() <func-poll>` functions are always available.
+or :c:func:`poll()` functions are always available.
 To start and stop capturing or output applications call the
 :ref:`VIDIOC_STREAMON <VIDIOC_STREAMON>` and :ref:`VIDIOC_STREAMOFF
 <VIDIOC_QUERYBUF>`, :ref:`VIDIOC_QBUF <VIDIOC_QBUF>`, :ref:`VIDIOC_DQBUF
 <VIDIOC_QBUF>`, :ref:`VIDIOC_STREAMON <VIDIOC_STREAMON>`
 and :ref:`VIDIOC_STREAMOFF <VIDIOC_STREAMON>` ioctls, the :ref:`mmap()
-<func-mmap>`, :ref:`munmap() <func-munmap>`, :ref:`select()
+<func-mmap>`, :c:func:`munmap()`, :ref:`select()
-<func-select>` and :ref:`poll() <func-poll>` function. [#f3]_
+<func-select>` and :c:func:`poll()` function. [#f3]_
 [capture example]
 .. [#f1]
    One could use one file descriptor and set the buffer type field
    accordingly when calling :ref:`VIDIOC_QBUF` etc.,
-   but it makes the :ref:`select() <func-select>` function ambiguous. We also
+   but it makes the :c:func:`select()` function ambiguous. We also
    like the clean approach of one file descriptor per logical stream.
    Video overlay for example is also a logical stream, although the CPU
    is not needed for continuous operation.
    scatter-gather lists and the like.
 .. [#f3]
-   At the driver level :ref:`select() <func-select>` and :ref:`poll() <func-poll>` are
+   At the driver level :c:func:`select()` and :c:func:`poll()` are
-   the same, and :ref:`select() <func-select>` is too important to be optional.
+   the same, and :c:func:`select()` is too important to be optional.
    The rest should be evident.

Documentation/userspace-api/media/v4l/open.rst+6−9

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _open:
 drivers. The user must enter a device name, or the application can try
 the conventional device names.
 .. _related:
 Related Devices
 support it and if they did it was certainly never tested. In addition,
 switching a device node between different functions only works when
 using the streaming I/O API, not with the
-:ref:`read() <func-read>`/\ :ref:`write() <func-write>` API.
+:c:func:`read()`/\ :c:func:`write()` API.
 Today each V4L2 device node supports just one function.
 linux-media mailing list:
 `https://linuxtv.org/lists.php <https://linuxtv.org/lists.php>`__.
 Multiple Opens
 ==============
 Once an application has allocated the memory buffers needed for
 streaming data (by calling the :ref:`VIDIOC_REQBUFS`
 or :ref:`VIDIOC_CREATE_BUFS` ioctls, or
-implicitly by calling the :ref:`read() <func-read>` or
+implicitly by calling the :c:func:`read()` or
-:ref:`write() <func-write>` functions) that application (filehandle)
+:c:func:`write()` functions) that application (filehandle)
 becomes the owner of the device. It is no longer allowed to make changes
 that would affect the buffer sizes (e.g. by calling the
 :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl) and other applications are
 descriptor. Applications can request additional access privileges using
 the priority mechanism described in :ref:`app-pri`.
 Shared Data Streams
 ===================
 or similar means. This is better handled by a proxy application in user
 space.
 Functions
 =========
 To open and close V4L2 devices applications use the
-:ref:`open() <func-open>` and :ref:`close() <func-close>` function,
+:c:func:`open()` and :c:func:`close()` function,
 respectively. Devices are programmed using the
 :ref:`ioctl() <func-ioctl>` function as explained in the following
 sections.
 .. [#f1]
    There are still some old and obscure drivers that have not been
    updated to allow for multiple opens. This implies that for such
-   drivers :ref:`open() <func-open>` can return an ``EBUSY`` error code
+   drivers :c:func:`open()` can return an ``EBUSY`` error code
    when the device is already in use.
 .. [#f2]

Documentation/userspace-api/media/v4l/rw.rst+9−9

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _rw:
 Read/Write
 **********
-Input and output devices support the :ref:`read() <func-read>` and
+Input and output devices support the :c:func:`read()` and
-:ref:`write() <func-write>` function, respectively, when the
+:c:func:`write()` function, respectively, when the
 ``V4L2_CAP_READWRITE`` flag in the ``capabilities`` field of struct
 :c:type:`v4l2_capability` returned by the
 :ref:`VIDIOC_QUERYCAP` ioctl is set.
 setup to exchange data. It permits command line stunts like this (the
 vidctrl tool is fictitious):
 .. code-block:: none
     $ vidctrl /dev/video --input=0 --format=YUYV --size=352x288
     $ dd if=/dev/video of=myimage.422 bs=202752 count=1
-To read from the device applications use the :ref:`read() <func-read>`
+To read from the device applications use the :c:func:`read()`
-function, to write the :ref:`write() <func-write>` function. Drivers
+function, to write the :c:func:`write()` function. Drivers
 must implement one I/O method if they exchange data with applications,
 but it need not be this. [#f1]_ When reading or writing is supported, the
-driver must also support the :ref:`select() <func-select>` and
+driver must also support the :c:func:`select()` and
-:ref:`poll() <func-poll>` function. [#f2]_
+:c:func:`poll()` function. [#f2]_
 .. [#f1]
    It would be desirable if applications could depend on drivers
    capturing still images.
 .. [#f2]
-   At the driver level :ref:`select() <func-select>` and :ref:`poll() <func-poll>` are
+   At the driver level :c:func:`select()` and :c:func:`poll()` are
-   the same, and :ref:`select() <func-select>` is too important to be optional.
+   the same, and :c:func:`select()` is too important to be optional.

Documentation/userspace-api/media/v4l/streaming-par.rst+3−2

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _streaming-par:	4	.. _streaming-par:
4		5
@@ -14,13 +15,13 @@ The current video standard determines a nominal number of frames per · 9 unmodified lines
14	second. If less than this number of frames is to be captured or output,	15	second. If less than this number of frames is to be captured or output,
15	applications can request frame skipping or duplicating on the driver	16	applications can request frame skipping or duplicating on the driver
16	side. This is especially useful when using the	17	side. This is especially useful when using the
17	:ref:`read() <func-read>` or :ref:`write() <func-write>`, which are	18	:c:func:`read()` or :c:func:`write()`, which are
18	not augmented by timestamps or sequence counters, and to avoid	19	not augmented by timestamps or sequence counters, and to avoid
19	unnecessary data copying.	20	unnecessary data copying.
20		21
21	Finally these ioctls can be used to determine the number of buffers used	22	Finally these ioctls can be used to determine the number of buffers used
22	internally by a driver in read/write mode. For implications see the	23	internally by a driver in read/write mode. For implications see the
23	section discussing the :ref:`read() <func-read>` function.	24	section discussing the :c:func:`read()` function.
24		25
25	To get and set the streaming parameters applications call the	26	To get and set the streaming parameters applications call the
26	:ref:`VIDIOC_G_PARM <VIDIOC_G_PARM>` and	27	:ref:`VIDIOC_G_PARM <VIDIOC_G_PARM>` and

Documentation/userspace-api/media/v4l/userp.rst+6−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _userp:
 Two methods exist to suspend execution of the application until one or
 more buffers can be dequeued. By default :ref:`VIDIOC_DQBUF
 <VIDIOC_QBUF>` blocks when no buffer is in the outgoing queue. When the
-``O_NONBLOCK`` flag was given to the :ref:`open() <func-open>` function,
+``O_NONBLOCK`` flag was given to the :c:func:`open()` function,
 :ref:`VIDIOC_DQBUF <VIDIOC_QBUF>` returns immediately with an ``EAGAIN``
 error code when no buffer is available. The :ref:`select()
-<func-select>` or :ref:`poll() <func-poll>` function are always
+<func-select>` or :c:func:`poll()` function are always
 available.
 To start and stop capturing or output applications call the
 :ref:`VIDIOC_REQBUFS <VIDIOC_REQBUFS>`, :ref:`VIDIOC_QBUF <VIDIOC_QBUF>`,
 :ref:`VIDIOC_DQBUF <VIDIOC_QBUF>`, :ref:`VIDIOC_STREAMON <VIDIOC_STREAMON>`
 and :ref:`VIDIOC_STREAMOFF <VIDIOC_STREAMON>` ioctls, the
-:ref:`select() <func-select>` and :ref:`poll() <func-poll>` function. [#f2]_
+:c:func:`select()` and :c:func:`poll()` function. [#f2]_
 .. [#f1]
    We expect that frequently used buffers are typically not swapped out.
    because an application may share them with other processes.
 .. [#f2]
-   At the driver level :ref:`select() <func-select>` and :ref:`poll() <func-poll>` are
+   At the driver level :c:func:`select()` and :c:func:`poll()` are
-   the same, and :ref:`select() <func-select>` is too important to be optional.
+   the same, and :c:func:`select()` is too important to be optional.
    The rest should be evident.

Documentation/userspace-api/media/v4l/vidioc-create-bufs.rst+4−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_CREATE_BUFS:
 VIDIOC_CREATE_BUFS - Create buffers for Memory Mapped or User Pointer or DMA Buffer I/O
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_CREATE_BUFS, struct v4l2_create_buffers *argp )
+.. c:macro:: VIDIOC_CREATE_BUFS
-    :name: VIDIOC_CREATE_BUFS
+``int ioctl(int fd, VIDIOC_CREATE_BUFS, struct v4l2_create_buffers *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_create_buffers`.
 Description
 ===========
 the ``index`` fields respectively. On return ``count`` can be smaller
 than the number requested.
 .. c:type:: v4l2_create_buffers
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
       - A place holder for future extensions. Drivers and applications
 	must set the array to zero.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-cropcap.rst+4−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_CROPCAP:
 VIDIOC_CROPCAP - Information about the video cropping and scaling abilities
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_CROPCAP, struct v4l2_cropcap *argp )
+.. c:macro:: VIDIOC_CROPCAP
-    :name: VIDIOC_CROPCAP
+``int ioctl(int fd, VIDIOC_CROPCAP, struct v4l2_cropcap *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_cropcap`.
 Description
 ===========
    Starting with kernel 4.13 both variations are allowed.
 .. _v4l2-rect-crop:
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
       - ``height``
       - Height of the rectangle, in pixels.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-dbg-g-chip-info.rst+4−9

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_DBG_G_CHIP_INFO:
 VIDIOC_DBG_G_CHIP_INFO - Identify the chips on a TV card
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_DBG_G_CHIP_INFO, struct v4l2_dbg_chip_info *argp )
+.. c:macro:: VIDIOC_DBG_G_CHIP_INFO
-    :name: VIDIOC_DBG_G_CHIP_INFO
+``int ioctl(int fd, VIDIOC_DBG_G_CHIP_INFO, struct v4l2_dbg_chip_info *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_dbg_chip_info`.
 Description
 ===========
 `https://linuxtv.org/repo/ <https://linuxtv.org/repo/>`__ for access
 instructions.
 .. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{3.5cm}|p{7.0cm}|
 .. _name-v4l2-dbg-match:
       -
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
 .. c:type:: v4l2_dbg_chip_info
       - Reserved fields, both application and driver must set these to 0.
 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
 .. _name-chip-match-types:
       - 4
       - Match the nth sub-device.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-dbg-g-register.rst+7−11

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_DBG_G_REGISTER:	4	.. _VIDIOC_DBG_G_REGISTER:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_DBG_G_REGISTER - VIDIOC_DBG_S_REGISTER - Read or write hardware registers	13	VIDIOC_DBG_G_REGISTER - VIDIOC_DBG_S_REGISTER - Read or write hardware registers
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_DBG_G_REGISTER, struct v4l2_dbg_register *argp )	18	.. c:macro:: VIDIOC_DBG_G_REGISTER
19	:name: VIDIOC_DBG_G_REGISTER	19
		20	``int ioctl(int fd, VIDIOC_DBG_G_REGISTER, struct v4l2_dbg_register *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_DBG_S_REGISTER, const struct v4l2_dbg_register *argp )	22	.. c:macro:: VIDIOC_DBG_S_REGISTER
22	:name: VIDIOC_DBG_S_REGISTER
23		23
		24	``int ioctl(int fd, VIDIOC_DBG_S_REGISTER, const struct v4l2_dbg_register *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_dbg_register`.	33	Pointer to struct :c:type:`v4l2_dbg_register`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -85,7 +85,6 @@ It is available from the LinuxTV v4l-dvb repository; see · 47 unmodified lines
85	`https://linuxtv.org/repo/ <https://linuxtv.org/repo/>`__ for access	85	`https://linuxtv.org/repo/ <https://linuxtv.org/repo/>`__ for access
86	instructions.	86	instructions.
87		87
88
89	.. tabularcolumns:: \|p{3.5cm}\|p{3.5cm}\|p{3.5cm}\|p{7.0cm}\|	88	.. tabularcolumns:: \|p{3.5cm}\|p{3.5cm}\|p{3.5cm}\|p{7.0cm}\|
90		89
91	.. c:type:: v4l2_dbg_match	90	.. c:type:: v4l2_dbg_match
@@ -112,7 +111,6 @@ instructions. · 20 unmodified lines
112	-	111	-
113		112
114		113
115
116	.. c:type:: v4l2_dbg_register	114	.. c:type:: v4l2_dbg_register
117		115
118	.. flat-table:: struct v4l2_dbg_register	116	.. flat-table:: struct v4l2_dbg_register
@@ -133,7 +131,6 @@ instructions. · 14 unmodified lines
133	- The value read from, or to be written into the register.	131	- The value read from, or to be written into the register.
134		132
135		133
136
137	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	134	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
138		135
139	.. _chip-match-types:	136	.. _chip-match-types:
@@ -151,7 +148,6 @@ instructions. · 11 unmodified lines
151	- 4	148	- 4
152	- Match the nth sub-device.	149	- Match the nth sub-device.
153		150
154
155	Return Value	151	Return Value
156	============	152	============
157		153

Documentation/userspace-api/media/v4l/vidioc-decoder-cmd.rst+8−11

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_DECODER_CMD:
 VIDIOC_DECODER_CMD - VIDIOC_TRY_DECODER_CMD - Execute an decoder command
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_DECODER_CMD, struct v4l2_decoder_cmd *argp )
+.. c:macro:: VIDIOC_DECODER_CMD
-    :name: VIDIOC_DECODER_CMD
+``int ioctl(int fd, VIDIOC_DECODER_CMD, struct v4l2_decoder_cmd *argp)``
-.. c:function:: int ioctl( int fd, VIDIOC_TRY_DECODER_CMD, struct v4l2_decoder_cmd *argp )
+.. c:macro:: VIDIOC_TRY_DECODER_CMD
-    :name: VIDIOC_TRY_DECODER_CMD
+``int ioctl(int fd, VIDIOC_TRY_DECODER_CMD, struct v4l2_decoder_cmd *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     pointer to struct :c:type:`v4l2_decoder_cmd`.
 Description
 ===========
 The ``cmd`` field must contain the command code. Some commands use the
 ``flags`` field for additional information.
-A :ref:`write() <func-write>` or :ref:`VIDIOC_STREAMON`
+A :c:func:`write()` or :ref:`VIDIOC_STREAMON`
 call sends an implicit START command to the decoder if it has not been
 started yet. Applies to both queues of mem2mem decoders.
-A :ref:`close() <func-close>` or :ref:`VIDIOC_STREAMOFF <VIDIOC_STREAMON>`
+A :c:func:`close()` or :ref:`VIDIOC_STREAMOFF <VIDIOC_STREAMON>`
 call of a streaming file descriptor sends an implicit immediate STOP
 command to the decoder, and all buffered data is discarded. Applies to both
 queues of mem2mem decoders.
 introduced in Linux 3.3. They are, however, mandatory for stateful mem2mem decoders
 (as further documented in :ref:`decoder`).
 .. tabularcolumns:: |p{1.1cm}|p{2.4cm}|p{1.2cm}|p{1.6cm}|p{10.6cm}|
 .. c:type:: v4l2_decoder_cmd
       -
 .. tabularcolumns:: |p{5.6cm}|p{0.6cm}|p{11.3cm}|
 .. _decoder-cmds:

Documentation/userspace-api/media/v4l/vidioc-dqevent.rst+4−15

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_DQEVENT:
 VIDIOC_DQEVENT - Dequeue event
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_DQEVENT, struct v4l2_event *argp )
+.. c:macro:: VIDIOC_DQEVENT
-    :name: VIDIOC_DQEVENT
+``int ioctl(int fd, VIDIOC_DQEVENT, struct v4l2_event *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_event`.
 Description
 ===========
 exceptions which the application may get by e.g. using the select system
 call.
 .. tabularcolumns:: |p{3.0cm}|p{4.4cm}|p{2.4cm}|p{7.7cm}|
 .. c:type:: v4l2_event
 	zero.
 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
 .. cssclass:: longtable
       - Base event number for driver-private events.
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
 .. c:type:: v4l2_event_vsync
       - The upcoming field. See enum :c:type:`v4l2_field`.
 .. tabularcolumns:: |p{3.5cm}|p{3.0cm}|p{1.8cm}|p{8.5cm}|
 .. c:type:: v4l2_event_ctrl
 	:ref:`v4l2_queryctrl <v4l2-queryctrl>`.
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
 .. c:type:: v4l2_event_frame_sync
       - The sequence number of the frame being received.
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
 .. c:type:: v4l2_event_src_change
 	:ref:`src-changes-flags`.
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
 .. c:type:: v4l2_event_motion_det
 	automatically assigned to the default region 0.
 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
 .. _ctrl-changes-flags:
 	step or the default value of the control changed.
 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
 .. _src-changes-flags:
 	loss of signal and so restarting streaming I/O is required in order for
 	the hardware to synchronize to the video signal.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-dv-timings-cap.rst+7−10

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_DV_TIMINGS_CAP:	4	.. _VIDIOC_DV_TIMINGS_CAP:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_DV_TIMINGS_CAP - VIDIOC_SUBDEV_DV_TIMINGS_CAP - The capabilities of the Digital Video receiver/transmitter	13	VIDIOC_DV_TIMINGS_CAP - VIDIOC_SUBDEV_DV_TIMINGS_CAP - The capabilities of the Digital Video receiver/transmitter
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_DV_TIMINGS_CAP, struct v4l2_dv_timings_cap *argp )	18	.. c:macro:: VIDIOC_DV_TIMINGS_CAP
19	:name: VIDIOC_DV_TIMINGS_CAP	19
		20	``int ioctl(int fd, VIDIOC_DV_TIMINGS_CAP, struct v4l2_dv_timings_cap *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_DV_TIMINGS_CAP, struct v4l2_dv_timings_cap *argp )	22	.. c:macro:: VIDIOC_SUBDEV_DV_TIMINGS_CAP
22	:name: VIDIOC_SUBDEV_DV_TIMINGS_CAP
23		23
		24	``int ioctl(int fd, VIDIOC_SUBDEV_DV_TIMINGS_CAP, struct v4l2_dv_timings_cap *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_dv_timings_cap`.	33	Pointer to struct :c:type:`v4l2_dv_timings_cap`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -55,7 +55,6 @@ the desired pad number in the struct · 17 unmodified lines
55	zero the ``reserved`` array. Attempts to query capabilities on a pad	55	zero the ``reserved`` array. Attempts to query capabilities on a pad
56	that doesn't support them will return an ``EINVAL`` error code.	56	that doesn't support them will return an ``EINVAL`` error code.
57		57
58
59	.. tabularcolumns:: \|p{1.2cm}\|p{3.0cm}\|p{13.3cm}\|	58	.. tabularcolumns:: \|p{1.2cm}\|p{3.0cm}\|p{13.3cm}\|
60		59
61	.. c:type:: v4l2_bt_timings_cap	60	.. c:type:: v4l2_bt_timings_cap
@@ -97,7 +96,6 @@ that doesn't support them will return an ``EINVAL`` error code. · 35 unmodified lines
97	Drivers must set the array to zero.	96	Drivers must set the array to zero.
98		97
99		98
100
101	.. tabularcolumns:: \|p{1.0cm}\|p{4.0cm}\|p{3.5cm}\|p{9.2cm}\|	99	.. tabularcolumns:: \|p{1.0cm}\|p{4.0cm}\|p{3.5cm}\|p{9.2cm}\|
102		100
103	.. c:type:: v4l2_dv_timings_cap	101	.. c:type:: v4l2_dv_timings_cap
@@ -153,7 +151,6 @@ that doesn't support them will return an ``EINVAL`` error code. · 49 unmodified lines
153	- Can support non-standard timings, i.e. timings not belonging to	151	- Can support non-standard timings, i.e. timings not belonging to
154	the standards set in the ``standards`` field.	152	the standards set in the ``standards`` field.
155		153
156
157	Return Value	154	Return Value
158	============	155	============
159		156

Documentation/userspace-api/media/v4l/vidioc-encoder-cmd.rst+11−14

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_ENCODER_CMD:	4	.. _VIDIOC_ENCODER_CMD:
4		5
@@ -11,22 +12,22 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_ENCODER_CMD - VIDIOC_TRY_ENCODER_CMD - Execute an encoder command	13	VIDIOC_ENCODER_CMD - VIDIOC_TRY_ENCODER_CMD - Execute an encoder command
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_ENCODER_CMD, struct v4l2_encoder_cmd *argp )	18	.. c:macro:: VIDIOC_ENCODER_CMD
19	:name: VIDIOC_ENCODER_CMD	19
		20	``int ioctl(int fd, VIDIOC_ENCODER_CMD, struct v4l2_encoder_cmd *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_TRY_ENCODER_CMD, struct v4l2_encoder_cmd *argp )	22	.. c:macro:: VIDIOC_TRY_ENCODER_CMD
22	:name: VIDIOC_TRY_ENCODER_CMD
23		23
		24	``int ioctl(int fd, VIDIOC_TRY_ENCODER_CMD, struct v4l2_encoder_cmd *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_encoder_cmd`.	33	Pointer to struct :c:type:`v4l2_encoder_cmd`.
@@ -47,16 +48,16 @@ this structure. · 14 unmodified lines
47	The ``cmd`` field must contain the command code. Some commands use the	48	The ``cmd`` field must contain the command code. Some commands use the
48	``flags`` field for additional information.	49	``flags`` field for additional information.
49		50
50	After a STOP command, :ref:`read() <func-read>` calls will read	51	After a STOP command, :c:func:`read()` calls will read
51	the remaining data buffered by the driver. When the buffer is empty,	52	the remaining data buffered by the driver. When the buffer is empty,
52	:ref:`read() <func-read>` will return zero and the next :ref:`read() <func-read>`	53	:c:func:`read()` will return zero and the next :c:func:`read()`
53	call will restart the encoder.	54	call will restart the encoder.
54		55
55	A :ref:`read() <func-read>` or :ref:`VIDIOC_STREAMON <VIDIOC_STREAMON>`	56	A :c:func:`read()` or :ref:`VIDIOC_STREAMON <VIDIOC_STREAMON>`
56	call sends an implicit START command to the encoder if it has not been	57	call sends an implicit START command to the encoder if it has not been
57	started yet. Applies to both queues of mem2mem encoders.	58	started yet. Applies to both queues of mem2mem encoders.
58		59
59	A :ref:`close() <func-close>` or :ref:`VIDIOC_STREAMOFF <VIDIOC_STREAMON>`	60	A :c:func:`close()` or :ref:`VIDIOC_STREAMOFF <VIDIOC_STREAMON>`
60	call of a streaming file descriptor sends an implicit immediate STOP to	61	call of a streaming file descriptor sends an implicit immediate STOP to
61	the encoder, and all buffered data is discarded. Applies to both queues of	62	the encoder, and all buffered data is discarded. Applies to both queues of
62	mem2mem encoders.	63	mem2mem encoders.
@@ -65,7 +66,6 @@ These ioctls are optional, not all drivers may support them. They were · 2 unmodified lines
65	introduced in Linux 2.6.21. They are, however, mandatory for stateful mem2mem	66	introduced in Linux 2.6.21. They are, however, mandatory for stateful mem2mem
66	encoders (as further documented in :ref:`encoder`).	67	encoders (as further documented in :ref:`encoder`).
67		68
68
69	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	69	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
70		70
71	.. c:type:: v4l2_encoder_cmd	71	.. c:type:: v4l2_encoder_cmd
@@ -89,7 +89,6 @@ encoders (as further documented in :ref:`encoder`). · 17 unmodified lines
89	the array to zero.	89	the array to zero.
90		90
91		91
92
93	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	92	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
94		93
95	.. _encoder-cmds:	94	.. _encoder-cmds:
@@ -134,7 +133,6 @@ encoders (as further documented in :ref:`encoder`). · 38 unmodified lines
134	the encoder is already running, this command does nothing. No	133	the encoder is already running, this command does nothing. No
135	flags are defined for this command.	134	flags are defined for this command.
136		135
137
138	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	136	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
139		137
140	.. _encoder-flags:	138	.. _encoder-flags:
@@ -151,7 +149,6 @@ encoders (as further documented in :ref:`encoder`). · 10 unmodified lines
151		149
152	Does not apply to :ref:`encoder`.	150	Does not apply to :ref:`encoder`.
153		151
154
155	Return Value	152	Return Value
156	============	153	============
157		154

Documentation/userspace-api/media/v4l/vidioc-enum-dv-timings.rst+7−9

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_ENUM_DV_TIMINGS:	4	.. _VIDIOC_ENUM_DV_TIMINGS:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_ENUM_DV_TIMINGS - VIDIOC_SUBDEV_ENUM_DV_TIMINGS - Enumerate supported Digital Video timings	13	VIDIOC_ENUM_DV_TIMINGS - VIDIOC_SUBDEV_ENUM_DV_TIMINGS - Enumerate supported Digital Video timings
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_ENUM_DV_TIMINGS, struct v4l2_enum_dv_timings *argp )	18	.. c:macro:: VIDIOC_ENUM_DV_TIMINGS
19	:name: VIDIOC_ENUM_DV_TIMINGS	19
		20	``int ioctl(int fd, VIDIOC_ENUM_DV_TIMINGS, struct v4l2_enum_dv_timings *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_ENUM_DV_TIMINGS, struct v4l2_enum_dv_timings *argp )	22	.. c:macro:: VIDIOC_SUBDEV_ENUM_DV_TIMINGS
22	:name: VIDIOC_SUBDEV_ENUM_DV_TIMINGS
23		23
		24	``int ioctl(int fd, VIDIOC_SUBDEV_ENUM_DV_TIMINGS, struct v4l2_enum_dv_timings *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_enum_dv_timings`.	33	Pointer to struct :c:type:`v4l2_enum_dv_timings`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -65,7 +65,6 @@ pad number in the struct · 27 unmodified lines
65	Attempts to enumerate timings on a pad that doesn't support them will	65	Attempts to enumerate timings on a pad that doesn't support them will
66	return an ``EINVAL`` error code.	66	return an ``EINVAL`` error code.
67		67
68
69	.. c:type:: v4l2_enum_dv_timings	68	.. c:type:: v4l2_enum_dv_timings
70		69
71	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	70	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
@@ -91,7 +90,6 @@ return an ``EINVAL`` error code. · 19 unmodified lines
91	- ``timings``	90	- ``timings``
92	- The timings.	91	- The timings.
93		92
94
95	Return Value	93	Return Value
96	============	94	============
97		95

Documentation/userspace-api/media/v4l/vidioc-enum-fmt.rst+4−8

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_ENUM_FMT:
 VIDIOC_ENUM_FMT - Enumerate image formats
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_ENUM_FMT, struct v4l2_fmtdesc *argp )
+.. c:macro:: VIDIOC_ENUM_FMT
-    :name: VIDIOC_ENUM_FMT
+``int ioctl(int fd, VIDIOC_ENUM_FMT, struct v4l2_fmtdesc *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_fmtdesc`.
 Description
 ===========
    formats shall not depend on the active configuration of the video device
    or device pipeline.
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
 .. c:type:: v4l2_fmtdesc
 	zero.
 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
 .. _fmtdesc-flags:
 	device when calling the :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl with
 	:ref:`V4L2_PIX_FMT_FLAG_SET_CSC <v4l2-pix-fmt-flag-set-csc>` set.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-enum-frameintervals.rst+4−11

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_ENUM_FRAMEINTERVALS:
 VIDIOC_ENUM_FRAMEINTERVALS - Enumerate frame intervals
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_ENUM_FRAMEINTERVALS, struct v4l2_frmivalenum *argp )
+.. c:macro:: VIDIOC_ENUM_FRAMEINTERVALS
-    :name: VIDIOC_ENUM_FRAMEINTERVALS
+``int ioctl(int fd, VIDIOC_ENUM_FRAMEINTERVALS, struct v4l2_frmivalenum *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_frmivalenum`
     that contains a pixel format and size and receives a frame interval.
 Description
 ===========
        frame_rate = 1 / frame_interval
 Structs
 =======
 the application, *OUT* denotes values that the driver fills in. The
 application should zero out all members except for the *IN* fields.
 .. c:type:: v4l2_frmival_stepwise
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
       - Frame interval step size [s].
 .. c:type:: v4l2_frmivalenum
 .. tabularcolumns:: |p{1.8cm}|p{4.4cm}|p{2.4cm}|p{8.9cm}|
 	applications.
 Enums
 =====
 .. c:type:: v4l2_frmivaltypes
 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
       - 3
       - Step-wise defined frame interval.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-enum-framesizes.rst+4−12

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_ENUM_FRAMESIZES:
 VIDIOC_ENUM_FRAMESIZES - Enumerate frame sizes
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_ENUM_FRAMESIZES, struct v4l2_frmsizeenum *argp )
+.. c:macro:: VIDIOC_ENUM_FRAMESIZES
-    :name: VIDIOC_ENUM_FRAMESIZES
+``int ioctl(int fd, VIDIOC_ENUM_FRAMESIZES, struct v4l2_frmsizeenum *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_frmsizeenum`
     that contains an index and pixel format and receives a frame width
     and height.
 Description
 ===========
 enumeration data is consistent if the application does not perform any
 other ioctl calls while it runs the frame size enumeration.
 Structs
 =======
 the application, *OUT* denotes values that the driver fills in. The
 application should zero out all members except for the *IN* fields.
 .. c:type:: v4l2_frmsize_discrete
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
       - Height of the frame [pixel].
 .. c:type:: v4l2_frmsize_stepwise
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
       - Frame height step size [pixel].
 .. c:type:: v4l2_frmsizeenum
 .. tabularcolumns:: |p{1.4cm}|p{5.9cm}|p{2.3cm}|p{8.0cm}|
 	applications.
 Enums
 =====
 .. c:type:: v4l2_frmsizetypes
 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
       - 3
       - Step-wise defined frame size.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-enum-freq-bands.rst+4−8

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_ENUM_FREQ_BANDS:
 VIDIOC_ENUM_FREQ_BANDS - Enumerate supported frequency bands
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_ENUM_FREQ_BANDS, struct v4l2_frequency_band *argp )
+.. c:macro:: VIDIOC_ENUM_FREQ_BANDS
-    :name: VIDIOC_ENUM_FREQ_BANDS
+``int ioctl(int fd, VIDIOC_ENUM_FREQ_BANDS, struct v4l2_frequency_band *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_frequency_band`.
 Description
 ===========
 This ioctl is supported if the ``V4L2_TUNER_CAP_FREQ_BANDS`` capability
 of the corresponding tuner/modulator is set.
 .. tabularcolumns:: |p{2.9cm}|p{2.9cm}|p{5.8cm}|p{2.9cm}|p{3.0cm}|
 .. c:type:: v4l2_frequency_band
 	Applications and drivers must set the array to zero.
 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
 .. _band-modulation:
       - 0x08
       - Amplitude Modulation, commonly used for analog radio.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-enumaudio.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_ENUMAUDIO:
 VIDIOC_ENUMAUDIO - Enumerate audio inputs
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_ENUMAUDIO, struct v4l2_audio *argp )
+.. c:macro:: VIDIOC_ENUMAUDIO
-    :name: VIDIOC_ENUMAUDIO
+``int ioctl(int fd, VIDIOC_ENUMAUDIO, struct v4l2_audio *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_audio`.
 Description
 ===========
 See :ref:`VIDIOC_G_AUDIO <VIDIOC_G_AUDIO>` for a description of struct
 :c:type:`v4l2_audio`.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-enumaudioout.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_ENUMAUDOUT:
 VIDIOC_ENUMAUDOUT - Enumerate audio outputs
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_ENUMAUDOUT, struct v4l2_audioout *argp )
+.. c:macro:: VIDIOC_ENUMAUDOUT
-    :name: VIDIOC_ENUMAUDOUT
+``int ioctl(int fd, VIDIOC_ENUMAUDOUT, struct v4l2_audioout *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_audioout`.
 Description
 ===========
 See :ref:`VIDIOC_G_AUDIOout <VIDIOC_G_AUDOUT>` for a description of struct
 :c:type:`v4l2_audioout`.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-enuminput.rst+4−10

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_ENUMINPUT:
 VIDIOC_ENUMINPUT - Enumerate video inputs
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_ENUMINPUT, struct v4l2_input *argp )
+.. c:macro:: VIDIOC_ENUMINPUT
-    :name: VIDIOC_ENUMINPUT
+``int ioctl(int fd, VIDIOC_ENUMINPUT, struct v4l2_input *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_input`.
 Description
 ===========
 index is out of bounds. To enumerate all inputs applications shall begin
 at index zero, incrementing by one until the driver returns ``EINVAL``.
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
 .. c:type:: v4l2_input
 	zero.
 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
 .. _input-type:
       - This input is a touch device for capturing raw touch data.
 .. tabularcolumns:: |p{4.8cm}|p{2.6cm}|p{10.1cm}|
 .. _input-status:
       - VTR time constant. [?]
 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
 .. _input-capabilities:
 	``V4L2_SEL_TGT_NATIVE_SIZE`` selection target, see
 	:ref:`v4l2-selections-common`.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-enumoutput.rst+4−9

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_ENUMOUTPUT:
 VIDIOC_ENUMOUTPUT - Enumerate video outputs
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_ENUMOUTPUT, struct v4l2_output *argp )
+.. c:macro:: VIDIOC_ENUMOUTPUT
-    :name: VIDIOC_ENUMOUTPUT
+``int ioctl(int fd, VIDIOC_ENUMOUTPUT, struct v4l2_output *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_output`.
 Description
 ===========
 shall begin at index zero, incrementing by one until the driver returns
 ``EINVAL``.
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
 .. c:type:: v4l2_output
 	zero.
 .. tabularcolumns:: |p{7.0cm}|p{1.8cm}|p{8.7cm}|
 .. _output-type:
       - The video output will be copied to a :ref:`video overlay <overlay>`.
 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
 .. _output-capabilities:
 	``V4L2_SEL_TGT_NATIVE_SIZE`` selection target, see
 	:ref:`v4l2-selections-common`.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-enumstd.rst+7−16

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_ENUMSTD:	4	.. _VIDIOC_ENUMSTD:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_ENUMSTD - VIDIOC_SUBDEV_ENUMSTD - Enumerate supported video standards	13	VIDIOC_ENUMSTD - VIDIOC_SUBDEV_ENUMSTD - Enumerate supported video standards
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_ENUMSTD, struct v4l2_standard *argp )	18	.. c:macro:: VIDIOC_ENUMSTD
19	:name: VIDIOC_ENUMSTD	19
		20	``int ioctl(int fd, VIDIOC_ENUMSTD, struct v4l2_standard *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_ENUMSTD, struct v4l2_standard *argp )	22	.. c:macro:: VIDIOC_SUBDEV_ENUMSTD
22	:name: VIDIOC_SUBDEV_ENUMSTD
23		23
		24	``int ioctl(int fd, VIDIOC_SUBDEV_ENUMSTD, struct v4l2_standard *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_standard`.	33	Pointer to struct :c:type:`v4l2_standard`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -45,7 +45,6 @@ zero, incrementing by one until the driver returns ``EINVAL``. Drivers may · 7 unmodified lines
45	enumerate a different set of standards after switching the video input	45	enumerate a different set of standards after switching the video input
46	or output. [#f1]_	46	or output. [#f1]_
47		47
48
49	.. c:type:: v4l2_standard	48	.. c:type:: v4l2_standard
50		49
51	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	50	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
@@ -85,7 +84,6 @@ or output. [#f1]_ · 33 unmodified lines
85	zero.	84	zero.
86		85
87		86
88
89	.. c:type:: v4l2_fract	87	.. c:type:: v4l2_fract
90		88
91	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	89	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
@@ -102,7 +100,6 @@ or output. [#f1]_ · 10 unmodified lines
102	- ``denominator``	100	- ``denominator``
103	-	101	-
104		102
105
106	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	103	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
107		104
108	.. _v4l2-std-id:	105	.. _v4l2-std-id:
@@ -120,7 +117,6 @@ or output. [#f1]_ · 11 unmodified lines
120	standards.	117	standards.
121		118
122		119
123
124	.. code-block:: c	120	.. code-block:: c
125		121
126	#define V4L2_STD_PAL_B ((v4l2_std_id)0x00000001)	122	#define V4L2_STD_PAL_B ((v4l2_std_id)0x00000001)
@@ -142,7 +138,6 @@ rate, and PAL color modulation with a 4.43 MHz color subcarrier. Some · 15 unmodified lines
142	PAL video recorders can play back NTSC tapes in this mode for display on	138	PAL video recorders can play back NTSC tapes in this mode for display on
143	a 50/60 Hz agnostic PAL TV.	139	a 50/60 Hz agnostic PAL TV.
144		140
145
146	.. code-block:: c	141	.. code-block:: c
147		142
148	#define V4L2_STD_NTSC_M ((v4l2_std_id)0x00001000)	143	#define V4L2_STD_NTSC_M ((v4l2_std_id)0x00001000)
@@ -152,7 +147,6 @@ a 50/60 Hz agnostic PAL TV. · 3 unmodified lines
152	``V4L2_STD_NTSC_443`` is a hybrid standard with 525 lines, 60 Hz refresh	147	``V4L2_STD_NTSC_443`` is a hybrid standard with 525 lines, 60 Hz refresh
153	rate, and NTSC color modulation with a 4.43 MHz color subcarrier.	148	rate, and NTSC color modulation with a 4.43 MHz color subcarrier.
154		149
155
156	.. code-block:: c	150	.. code-block:: c
157		151
158	#define V4L2_STD_NTSC_M_KR ((v4l2_std_id)0x00008000)	152	#define V4L2_STD_NTSC_M_KR ((v4l2_std_id)0x00008000)
@@ -175,7 +169,6 @@ terrestrial digital TV standards. Presently the V4L2 API does not · 16 unmodified lines
175	support digital TV. See also the Linux DVB API at	169	support digital TV. See also the Linux DVB API at
176	`https://linuxtv.org <https://linuxtv.org>`__.	170	`https://linuxtv.org <https://linuxtv.org>`__.
177		171
178
179	.. code-block:: c	172	.. code-block:: c
180		173
181	#define V4L2_STD_PAL_BG (V4L2_STD_PAL_B \|	174	#define V4L2_STD_PAL_BG (V4L2_STD_PAL_B \|
@@ -228,7 +221,6 @@ support digital TV. See also the Linux DVB API at · 46 unmodified lines
228	#define V4L2_STD_ALL (V4L2_STD_525_60 \|	221	#define V4L2_STD_ALL (V4L2_STD_525_60 \|
229	V4L2_STD_625_50)	222	V4L2_STD_625_50)
230		223
231
232	.. raw:: latex	224	.. raw:: latex
233		225
234	\begingroup	226	\begingroup
@@ -303,7 +295,6 @@ support digital TV. See also the Linux DVB API at · 68 unmodified lines
303	\endgroup	295	\endgroup
304		296
305		297
306
307	Return Value	298	Return Value
308	============	299	============
309		300

Documentation/userspace-api/media/v4l/vidioc-expbuf.rst+4−10

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_EXPBUF:
 VIDIOC_EXPBUF - Export a buffer as a DMABUF file descriptor.
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_EXPBUF, struct v4l2_exportbuffer *argp )
+.. c:macro:: VIDIOC_EXPBUF
-    :name: VIDIOC_EXPBUF
+``int ioctl(int fd, VIDIOC_EXPBUF, struct v4l2_exportbuffer *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_exportbuffer`.
 Description
 ===========
 recommended to close a DMABUF file when it is no longer used to allow
 the associated memory to be reclaimed.
 Examples
 ========
 .. code-block:: c
     int buffer_export(int v4lfd, enum v4l2_buf_type bt, int index, int *dmafd)
 	return 0;
     }
 .. code-block:: c
     int buffer_export_mp(int v4lfd, enum v4l2_buf_type bt, int index,
 	return 0;
     }
 .. c:type:: v4l2_exportbuffer
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
       - Reserved field for future use. Drivers and applications must set
 	the array to zero.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-g-audio.rst+7−11

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_AUDIO:	4	.. _VIDIOC_G_AUDIO:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_AUDIO - VIDIOC_S_AUDIO - Query or select the current audio input and its attributes	13	VIDIOC_G_AUDIO - VIDIOC_S_AUDIO - Query or select the current audio input and its attributes
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_AUDIO, struct v4l2_audio *argp )	18	.. c:macro:: VIDIOC_G_AUDIO
19	:name: VIDIOC_G_AUDIO	19
		20	``int ioctl(int fd, VIDIOC_G_AUDIO, struct v4l2_audio *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_S_AUDIO, const struct v4l2_audio *argp )	22	.. c:macro:: VIDIOC_S_AUDIO
22	:name: VIDIOC_S_AUDIO
23		23
		24	``int ioctl(int fd, VIDIOC_S_AUDIO, const struct v4l2_audio *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_audio`.	33	Pointer to struct :c:type:`v4l2_audio`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -49,7 +49,6 @@ ioctl. Drivers may switch to a different audio mode if the request · 11 unmodified lines
49	cannot be satisfied. However, this is a write-only ioctl, it does not	49	cannot be satisfied. However, this is a write-only ioctl, it does not
50	return the actual new audio mode.	50	return the actual new audio mode.
51		51
52
53	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	52	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
54		53
55	.. c:type:: v4l2_audio	54	.. c:type:: v4l2_audio
@@ -80,7 +79,6 @@ return the actual new audio mode. · 24 unmodified lines
80	the array to zero.	79	the array to zero.
81		80
82		81
83
84	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	82	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
85		83
86	.. _audio-capability:	84	.. _audio-capability:
@@ -101,7 +99,6 @@ return the actual new audio mode. · 14 unmodified lines
101	- Automatic Volume Level mode is supported.	99	- Automatic Volume Level mode is supported.
102		100
103		101
104
105	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	102	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
106		103
107	.. _audio-mode:	104	.. _audio-mode:
@@ -115,7 +112,6 @@ return the actual new audio mode. · 7 unmodified lines
115	- 0x00001	112	- 0x00001
116	- AVL mode is on.	113	- AVL mode is on.
117		114
118
119	Return Value	115	Return Value
120	============	116	============
121		117

Documentation/userspace-api/media/v4l/vidioc-g-audioout.rst+7−9

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_AUDOUT:	4	.. _VIDIOC_G_AUDOUT:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_AUDOUT - VIDIOC_S_AUDOUT - Query or select the current audio output	13	VIDIOC_G_AUDOUT - VIDIOC_S_AUDOUT - Query or select the current audio output
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_AUDOUT, struct v4l2_audioout *argp )	18	.. c:macro:: VIDIOC_G_AUDOUT
19	:name: VIDIOC_G_AUDOUT	19
		20	``int ioctl(int fd, VIDIOC_G_AUDOUT, struct v4l2_audioout *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_S_AUDOUT, const struct v4l2_audioout *argp )	22	.. c:macro:: VIDIOC_S_AUDOUT
22	:name: VIDIOC_S_AUDOUT
23		23
		24	``int ioctl(int fd, VIDIOC_S_AUDOUT, const struct v4l2_audioout *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_audioout`.	33	Pointer to struct :c:type:`v4l2_audioout`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -56,7 +56,6 @@ as ``VIDIOC_G_AUDOUT`` does. · 18 unmodified lines
56	Connectors on a TV card to loop back the received audio signal	56	Connectors on a TV card to loop back the received audio signal
57	to a sound card are not audio outputs in this sense.	57	to a sound card are not audio outputs in this sense.
58		58
59
60	.. c:type:: v4l2_audioout	59	.. c:type:: v4l2_audioout
61		60
62	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	61	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
@@ -87,7 +86,6 @@ as ``VIDIOC_G_AUDOUT`` does. · 24 unmodified lines
87	- Reserved for future extensions. Drivers and applications must set	86	- Reserved for future extensions. Drivers and applications must set
88	the array to zero.	87	the array to zero.
89		88
90
91	Return Value	89	Return Value
92	============	90	============
93		91

Documentation/userspace-api/media/v4l/vidioc-g-crop.rst+7−9

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_CROP:	4	.. _VIDIOC_G_CROP:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_CROP - VIDIOC_S_CROP - Get or set the current cropping rectangle	13	VIDIOC_G_CROP - VIDIOC_S_CROP - Get or set the current cropping rectangle
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_CROP, struct v4l2_crop *argp )	18	.. c:macro:: VIDIOC_G_CROP
19	:name: VIDIOC_G_CROP	19
		20	``int ioctl(int fd, VIDIOC_G_CROP, struct v4l2_crop *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_S_CROP, const struct v4l2_crop *argp )	22	.. c:macro:: VIDIOC_S_CROP
22	:name: VIDIOC_S_CROP
23		23
		24	``int ioctl(int fd, VIDIOC_S_CROP, const struct v4l2_crop *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_crop`.	33	Pointer to struct :c:type:`v4l2_crop`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -69,7 +69,6 @@ been negotiated. · 31 unmodified lines
69	When cropping is not supported then no parameters are changed and	69	When cropping is not supported then no parameters are changed and
70	:ref:`VIDIOC_S_CROP <VIDIOC_G_CROP>` returns the ``EINVAL`` error code.	70	:ref:`VIDIOC_S_CROP <VIDIOC_G_CROP>` returns the ``EINVAL`` error code.
71		71
72
73	.. c:type:: v4l2_crop	72	.. c:type:: v4l2_crop
74		73
75	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	74	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
@@ -100,7 +99,6 @@ When cropping is not supported then no parameters are changed and · 24 unmodified lines
100		99
101	Starting with kernel 4.13 both variations are allowed.	100	Starting with kernel 4.13 both variations are allowed.
102		101
103
104	Return Value	102	Return Value
105	============	103	============
106		104

Documentation/userspace-api/media/v4l/vidioc-g-ctrl.rst+7−9

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_CTRL:	4	.. _VIDIOC_G_CTRL:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_CTRL - VIDIOC_S_CTRL - Get or set the value of a control	13	VIDIOC_G_CTRL - VIDIOC_S_CTRL - Get or set the value of a control
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_CTRL, struct v4l2_control *argp )	18	.. c:macro:: VIDIOC_G_CTRL
19	:name: VIDIOC_G_CTRL	19
		20	``int ioctl(int fd, VIDIOC_G_CTRL, struct v4l2_control *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_S_CTRL, struct v4l2_control *argp )	22	.. c:macro:: VIDIOC_S_CTRL
22	:name: VIDIOC_S_CTRL
23		23
		24	``int ioctl(int fd, VIDIOC_S_CTRL, struct v4l2_control *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_control`.	33	Pointer to struct :c:type:`v4l2_control`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -55,7 +55,6 @@ These ioctls work only with user controls. For other control classes the · 17 unmodified lines
55	:ref:`VIDIOC_S_EXT_CTRLS <VIDIOC_G_EXT_CTRLS>` or	55	:ref:`VIDIOC_S_EXT_CTRLS <VIDIOC_G_EXT_CTRLS>` or
56	:ref:`VIDIOC_TRY_EXT_CTRLS <VIDIOC_G_EXT_CTRLS>` must be used.	56	:ref:`VIDIOC_TRY_EXT_CTRLS <VIDIOC_G_EXT_CTRLS>` must be used.
57		57
58
59	.. c:type:: v4l2_control	58	.. c:type:: v4l2_control
60		59
61	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	60	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
@@ -72,7 +71,6 @@ These ioctls work only with user controls. For other control classes the · 10 unmodified lines
72	- ``value``	71	- ``value``
73	- New value or current value.	72	- New value or current value.
74		73
75
76	Return Value	74	Return Value
77	============	75	============
78		76

Documentation/userspace-api/media/v4l/vidioc-g-dv-timings.rst+13−13

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_DV_TIMINGS:	4	.. _VIDIOC_G_DV_TIMINGS:
4		5
@@ -11,33 +12,34 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_DV_TIMINGS - VIDIOC_S_DV_TIMINGS - VIDIOC_SUBDEV_G_DV_TIMINGS - VIDIOC_SUBDEV_S_DV_TIMINGS - Get or set DV timings for input or output	13	VIDIOC_G_DV_TIMINGS - VIDIOC_S_DV_TIMINGS - VIDIOC_SUBDEV_G_DV_TIMINGS - VIDIOC_SUBDEV_S_DV_TIMINGS - Get or set DV timings for input or output
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_DV_TIMINGS, struct v4l2_dv_timings *argp )	18	.. c:macro:: VIDIOC_G_DV_TIMINGS
19	:name: VIDIOC_G_DV_TIMINGS	19
		20	``int ioctl(int fd, VIDIOC_G_DV_TIMINGS, struct v4l2_dv_timings *argp)``
		21
		22	.. c:macro:: VIDIOC_S_DV_TIMINGS
		23
		24	``int ioctl(int fd, VIDIOC_S_DV_TIMINGS, struct v4l2_dv_timings *argp)``
20		25
21	.. c:function:: int ioctl( int fd, VIDIOC_S_DV_TIMINGS, struct v4l2_dv_timings *argp )	26	.. c:macro:: VIDIOC_SUBDEV_G_DV_TIMINGS
22	:name: VIDIOC_S_DV_TIMINGS
23		27
24	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_G_DV_TIMINGS, struct v4l2_dv_timings *argp )	28	``int ioctl(int fd, VIDIOC_SUBDEV_G_DV_TIMINGS, struct v4l2_dv_timings *argp)``
25	:name: VIDIOC_SUBDEV_G_DV_TIMINGS
26		29
27	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_S_DV_TIMINGS, struct v4l2_dv_timings *argp )	30	.. c:macro:: VIDIOC_SUBDEV_S_DV_TIMINGS
28	:name: VIDIOC_SUBDEV_S_DV_TIMINGS
29		31
		32	``int ioctl(int fd, VIDIOC_SUBDEV_S_DV_TIMINGS, struct v4l2_dv_timings *argp)``
30		33
31	Arguments	34	Arguments
32	=========	35	=========
33		36
34	``fd``	37	``fd``
35	File descriptor returned by :ref:`open() <func-open>`.	38	File descriptor returned by :c:func:`open()`.
36		39
37	``argp``	40	``argp``
38	Pointer to struct :c:type:`v4l2_dv_timings`.	41	Pointer to struct :c:type:`v4l2_dv_timings`.
39		42
40
41	Description	43	Description
42	===========	44	===========
43		45
@@ -60,7 +62,6 @@ the current input or output does not support DV timings (e.g. if · 16 unmodified lines
60	:ref:`VIDIOC_ENUMINPUT` does not set the	62	:ref:`VIDIOC_ENUMINPUT` does not set the
61	``V4L2_IN_CAP_DV_TIMINGS`` flag), then ``ENODATA`` error code is returned.	63	``V4L2_IN_CAP_DV_TIMINGS`` flag), then ``ENODATA`` error code is returned.
62		64
63
64	Return Value	65	Return Value
65	============	66	============
66		67
@@ -170,7 +171,6 @@ EPERM · 103 unmodified lines
170	- Reserved for future extensions. Drivers and applications must set	171	- Reserved for future extensions. Drivers and applications must set
171	the array to zero.	172	the array to zero.
172		173
173
174	.. tabularcolumns:: \|p{3.5cm}\|p{3.5cm}\|p{7.0cm}\|p{3.5cm}\|	174	.. tabularcolumns:: \|p{3.5cm}\|p{3.5cm}\|p{7.0cm}\|p{3.5cm}\|
175		175
176	.. c:type:: v4l2_dv_timings	176	.. c:type:: v4l2_dv_timings

Documentation/userspace-api/media/v4l/vidioc-g-edid.rst+12−13

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_EDID:	4	.. _VIDIOC_G_EDID:
4		5
@@ -11,34 +12,34 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_EDID - VIDIOC_S_EDID - VIDIOC_SUBDEV_G_EDID - VIDIOC_SUBDEV_S_EDID - Get or set the EDID of a video receiver/transmitter	13	VIDIOC_G_EDID - VIDIOC_S_EDID - VIDIOC_SUBDEV_G_EDID - VIDIOC_SUBDEV_S_EDID - Get or set the EDID of a video receiver/transmitter
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_EDID, struct v4l2_edid *argp )	18	.. c:macro:: VIDIOC_G_EDID
19	:name: VIDIOC_G_EDID	19
		20	``int ioctl(int fd, VIDIOC_G_EDID, struct v4l2_edid *argp)``
		21
		22	.. c:macro:: VIDIOC_S_EDID
20		23
21	.. c:function:: int ioctl( int fd, VIDIOC_S_EDID, struct v4l2_edid *argp )	24	``int ioctl(int fd, VIDIOC_S_EDID, struct v4l2_edid *argp)``
22	:name: VIDIOC_S_EDID
23		25
		26	.. c:macro:: VIDIOC_SUBDEV_G_EDID
24		27
25	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_G_EDID, struct v4l2_edid *argp )	28	``int ioctl(int fd, VIDIOC_SUBDEV_G_EDID, struct v4l2_edid *argp)``
26	:name: VIDIOC_SUBDEV_G_EDID
27		29
28	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_S_EDID, struct v4l2_edid *argp )	30	.. c:macro:: VIDIOC_SUBDEV_S_EDID
29	:name: VIDIOC_SUBDEV_S_EDID
30		31
		32	``int ioctl(int fd, VIDIOC_SUBDEV_S_EDID, struct v4l2_edid *argp)``
31		33
32	Arguments	34	Arguments
33	=========	35	=========
34		36
35	``fd``	37	``fd``
36	File descriptor returned by :ref:`open() <func-open>`.	38	File descriptor returned by :c:func:`open()`.
37		39
38	``argp``	40	``argp``
39	Pointer to struct :c:type:`v4l2_edid`.	41	Pointer to struct :c:type:`v4l2_edid`.
40		42
41
42	Description	43	Description
43	===========	44	===========
44		45
@@ -97,7 +98,6 @@ this will drive the hotplug pin low and/or block the source from reading · 52 unmodified lines
97	the EDID data in some way. In any case, the end result is the same: the	98	the EDID data in some way. In any case, the end result is the same: the
98	EDID is no longer available.	99	EDID is no longer available.
99		100
100
101	.. c:type:: v4l2_edid	101	.. c:type:: v4l2_edid
102		102
103	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	103	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
@@ -132,7 +132,6 @@ EDID is no longer available. · 28 unmodified lines
132	- Pointer to memory that contains the EDID. The minimum size is	132	- Pointer to memory that contains the EDID. The minimum size is
133	``blocks`` * 128.	133	``blocks`` * 128.
134		134
135
136	Return Value	135	Return Value
137	============	136	============
138		137

Documentation/userspace-api/media/v4l/vidioc-g-enc-index.rst+4−9

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_G_ENC_INDEX:
 VIDIOC_G_ENC_INDEX - Get meta data about a compressed video stream
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_G_ENC_INDEX, struct v4l2_enc_idx *argp )
+.. c:macro:: VIDIOC_G_ENC_INDEX
-    :name: VIDIOC_G_ENC_INDEX
+``int ioctl(int fd, VIDIOC_G_ENC_INDEX, struct v4l2_enc_idx *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_enc_idx`.
 Description
 ===========
 Currently this ioctl is only defined for MPEG-2 program streams and
 video elementary streams.
 .. tabularcolumns:: |p{3.8cm}|p{5.6cm}|p{8.1cm}|
 .. c:type:: v4l2_enc_idx
 	their ``offset``.
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
 .. c:type:: v4l2_enc_idx_entry
       - Reserved for future extensions. Drivers must set the array to
 	zero.
 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
 .. _enc-idx-flags:
       - *AND* the flags field with this mask to obtain the picture coding
 	type.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-g-ext-ctrls.rst+8−13

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_G_EXT_CTRLS:
 VIDIOC_G_EXT_CTRLS - VIDIOC_S_EXT_CTRLS - VIDIOC_TRY_EXT_CTRLS - Get or set the value of several controls, try control values
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_G_EXT_CTRLS, struct v4l2_ext_controls *argp )
+.. c:macro:: VIDIOC_G_EXT_CTRLS
-    :name: VIDIOC_G_EXT_CTRLS
+``int ioctl(int fd, VIDIOC_G_EXT_CTRLS, struct v4l2_ext_controls *argp)``
-.. c:function:: int ioctl( int fd, VIDIOC_S_EXT_CTRLS, struct v4l2_ext_controls *argp )
+.. c:macro:: VIDIOC_S_EXT_CTRLS
-    :name: VIDIOC_S_EXT_CTRLS
+``int ioctl(int fd, VIDIOC_S_EXT_CTRLS, struct v4l2_ext_controls *argp)``
-.. c:function:: int ioctl( int fd, VIDIOC_TRY_EXT_CTRLS, struct v4l2_ext_controls *argp )
+.. c:macro:: VIDIOC_TRY_EXT_CTRLS
-    :name: VIDIOC_TRY_EXT_CTRLS
+``int ioctl(int fd, VIDIOC_TRY_EXT_CTRLS, struct v4l2_ext_controls *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_ext_controls`.
 Description
 ===========
 were set/get. Only low-level errors (e. g. a failed i2c command) can
 still cause this situation.
 .. tabularcolumns:: |p{1.2cm}|p{3.0cm}|p{1.5cm}|p{11.8cm}|
 .. c:type:: v4l2_ext_control
     * - }
       -
 .. tabularcolumns:: |p{4.0cm}|p{2.2cm}|p{2.1cm}|p{8.2cm}|
 .. c:type:: v4l2_ext_controls
 	Ignored if ``count`` equals zero.
 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
 .. _ctrl-class:
       - The class containing RF tuner controls. These controls are
 	described in :ref:`rf-tuner-controls`.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-g-fbuf.rst+7−11

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_FBUF:	4	.. _VIDIOC_G_FBUF:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_FBUF - VIDIOC_S_FBUF - Get or set frame buffer overlay parameters	13	VIDIOC_G_FBUF - VIDIOC_S_FBUF - Get or set frame buffer overlay parameters
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_FBUF, struct v4l2_framebuffer *argp )	18	.. c:macro:: VIDIOC_G_FBUF
19	:name: VIDIOC_G_FBUF	19
		20	``int ioctl(int fd, VIDIOC_G_FBUF, struct v4l2_framebuffer *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_S_FBUF, const struct v4l2_framebuffer *argp )	22	.. c:macro:: VIDIOC_S_FBUF
22	:name: VIDIOC_S_FBUF
23		23
		24	``int ioctl(int fd, VIDIOC_S_FBUF, const struct v4l2_framebuffer *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_framebuffer`.	33	Pointer to struct :c:type:`v4l2_framebuffer`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -75,7 +75,6 @@ jeopardize the system security, its stability or even damage the · 37 unmodified lines
75	hardware, therefore only the superuser can set the parameters for a	75	hardware, therefore only the superuser can set the parameters for a
76	destructive video overlay.	76	destructive video overlay.
77		77
78
79	.. tabularcolumns:: \|p{3.5cm}\|p{3.5cm}\|p{3.5cm}\|p{7.0cm}\|	78	.. tabularcolumns:: \|p{3.5cm}\|p{3.5cm}\|p{3.5cm}\|p{7.0cm}\|
80		79
81	.. c:type:: v4l2_framebuffer	80	.. c:type:: v4l2_framebuffer
@@ -208,7 +207,6 @@ destructive video overlay. · 126 unmodified lines
208	- ``priv``	207	- ``priv``
209	- Reserved. Drivers and applications must set this field to zero.	208	- Reserved. Drivers and applications must set this field to zero.
210		209
211
212	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	210	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
213		211
214	.. _framebuffer-cap:	212	.. _framebuffer-cap:
@@ -257,7 +255,6 @@ destructive video overlay. · 42 unmodified lines
257	chroma-key colors are replaced by framebuffer pixels, which is	255	chroma-key colors are replaced by framebuffer pixels, which is
258	exactly opposite of ``V4L2_FBUF_CAP_CHROMAKEY``	256	exactly opposite of ``V4L2_FBUF_CAP_CHROMAKEY``
259		257
260
261	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	258	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
262		259
263	.. _framebuffer-flags:	260	.. _framebuffer-flags:
@@ -332,7 +329,6 @@ destructive video overlay. · 68 unmodified lines
332	other, so same ``chromakey`` field of struct	329	other, so same ``chromakey`` field of struct
333	:c:type:`v4l2_window` is being used.	330	:c:type:`v4l2_window` is being used.
334		331
335
336	Return Value	332	Return Value
337	============	333	============
338		334

Documentation/userspace-api/media/v4l/vidioc-g-fmt.rst+11−11

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_FMT:	4	.. _VIDIOC_G_FMT:
4		5
@@ -11,29 +12,30 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_FMT - VIDIOC_S_FMT - VIDIOC_TRY_FMT - Get or set the data format, try a format	13	VIDIOC_G_FMT - VIDIOC_S_FMT - VIDIOC_TRY_FMT - Get or set the data format, try a format
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_FMT, struct v4l2_format *argp )	18	.. c:macro:: VIDIOC_G_FMT
19	:name: VIDIOC_G_FMT	19
		20	``int ioctl(int fd, VIDIOC_G_FMT, struct v4l2_format *argp)``
		21
		22	.. c:macro:: VIDIOC_S_FMT
		23
		24	``int ioctl(int fd, VIDIOC_S_FMT, struct v4l2_format *argp)``
20		25
21	.. c:function:: int ioctl( int fd, VIDIOC_S_FMT, struct v4l2_format *argp )	26	.. c:macro:: VIDIOC_TRY_FMT
22	:name: VIDIOC_S_FMT
23		27
24	.. c:function:: int ioctl( int fd, VIDIOC_TRY_FMT, struct v4l2_format *argp )	28	``int ioctl(int fd, VIDIOC_TRY_FMT, struct v4l2_format *argp)``
25	:name: VIDIOC_TRY_FMT
26		29
27	Arguments	30	Arguments
28	=========	31	=========
29		32
30	``fd``	33	``fd``
31	File descriptor returned by :ref:`open() <func-open>`.	34	File descriptor returned by :c:func:`open()`.
32		35
33	``argp``	36	``argp``
34	Pointer to struct :c:type:`v4l2_format`.	37	Pointer to struct :c:type:`v4l2_format`.
35		38
36
37	Description	39	Description
38	===========	40	===========
39		41
@@ -85,7 +87,6 @@ recommended drivers are not required to implement this ioctl. · 45 unmodified lines
85	The format as returned by :ref:`VIDIOC_TRY_FMT <VIDIOC_G_FMT>` must be identical to what	87	The format as returned by :ref:`VIDIOC_TRY_FMT <VIDIOC_G_FMT>` must be identical to what
86	:ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` returns for the same input or output.	88	:ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` returns for the same input or output.
87		89
88
89	.. c:type:: v4l2_format	90	.. c:type:: v4l2_format
90		91
91	.. tabularcolumns:: \|p{1.2cm}\|p{4.6cm}\|p{3.0cm}\|p{8.6cm}\|	92	.. tabularcolumns:: \|p{1.2cm}\|p{4.6cm}\|p{3.0cm}\|p{8.6cm}\|
@@ -135,7 +136,6 @@ The format as returned by :ref:`VIDIOC_TRY_FMT <VIDIOC_G_FMT>` must be identical · 43 unmodified lines
135	* - }	136	* - }
136	-	137	-
137		138
138
139	Return Value	139	Return Value
140	============	140	============
141		141

Documentation/userspace-api/media/v4l/vidioc-g-frequency.rst+7−9

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_FREQUENCY:	4	.. _VIDIOC_G_FREQUENCY:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_FREQUENCY - VIDIOC_S_FREQUENCY - Get or set tuner or modulator radio frequency	13	VIDIOC_G_FREQUENCY - VIDIOC_S_FREQUENCY - Get or set tuner or modulator radio frequency
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_FREQUENCY, struct v4l2_frequency *argp )	18	.. c:macro:: VIDIOC_G_FREQUENCY
19	:name: VIDIOC_G_FREQUENCY	19
		20	``int ioctl(int fd, VIDIOC_G_FREQUENCY, struct v4l2_frequency *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_S_FREQUENCY, const struct v4l2_frequency *argp )	22	.. c:macro:: VIDIOC_S_FREQUENCY
22	:name: VIDIOC_S_FREQUENCY
23		23
		24	``int ioctl(int fd, VIDIOC_S_FREQUENCY, const struct v4l2_frequency *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_frequency`.	33	Pointer to struct :c:type:`v4l2_frequency`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -51,7 +51,6 @@ structure. When the requested frequency is not possible the driver · 13 unmodified lines
51	assumes the closest possible value. However :ref:`VIDIOC_S_FREQUENCY <VIDIOC_G_FREQUENCY>` is a	51	assumes the closest possible value. However :ref:`VIDIOC_S_FREQUENCY <VIDIOC_G_FREQUENCY>` is a
52	write-only ioctl, it does not return the actual new frequency.	52	write-only ioctl, it does not return the actual new frequency.
53		53
54
55	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	54	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
56		55
57	.. c:type:: v4l2_frequency	56	.. c:type:: v4l2_frequency
@@ -89,7 +88,6 @@ write-only ioctl, it does not return the actual new frequency. · 31 unmodified lines
89	- Reserved for future extensions. Drivers and applications must set	88	- Reserved for future extensions. Drivers and applications must set
90	the array to zero.	89	the array to zero.
91		90
92
93	Return Value	91	Return Value
94	============	92	============
95		93

Documentation/userspace-api/media/v4l/vidioc-g-input.rst+7−8

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_INPUT:	4	.. _VIDIOC_G_INPUT:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_INPUT - VIDIOC_S_INPUT - Query or select the current video input	13	VIDIOC_G_INPUT - VIDIOC_S_INPUT - Query or select the current video input
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_INPUT, int *argp )	18	.. c:macro:: VIDIOC_G_INPUT
19	:name: VIDIOC_G_INPUT	19
		20	``int ioctl(int fd, VIDIOC_G_INPUT, int *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_S_INPUT, int *argp )	22	.. c:macro:: VIDIOC_S_INPUT
22	:name: VIDIOC_S_INPUT
23		23
		24	``int ioctl(int fd, VIDIOC_S_INPUT, int *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer an integer with input index.	33	Pointer an integer with input index.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -52,7 +52,6 @@ other parameters. · 14 unmodified lines
52	Information about video inputs is available using the	52	Information about video inputs is available using the
53	:ref:`VIDIOC_ENUMINPUT` ioctl.	53	:ref:`VIDIOC_ENUMINPUT` ioctl.
54		54
55
56	Return Value	55	Return Value
57	============	56	============
58		57

Documentation/userspace-api/media/v4l/vidioc-g-jpegcomp.rst+7−10

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_JPEGCOMP:	4	.. _VIDIOC_G_JPEGCOMP:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_JPEGCOMP - VIDIOC_S_JPEGCOMP	13	VIDIOC_G_JPEGCOMP - VIDIOC_S_JPEGCOMP
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_JPEGCOMP, v4l2_jpegcompression *argp )	18	.. c:macro:: VIDIOC_G_JPEGCOMP
19	:name: VIDIOC_G_JPEGCOMP	19
		20	``int ioctl(int fd, VIDIOC_G_JPEGCOMP, v4l2_jpegcompression *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_S_JPEGCOMP, const v4l2_jpegcompression *argp )	22	.. c:macro:: VIDIOC_S_JPEGCOMP
22	:name: VIDIOC_S_JPEGCOMP
23		23
		24	``int ioctl(int fd, VIDIOC_S_JPEGCOMP, const v4l2_jpegcompression *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_jpegcompression`.	33	Pointer to struct :c:type:`v4l2_jpegcompression`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -54,7 +54,6 @@ stored in the JPEG-encoded fields. These define how the JPEG field is · 16 unmodified lines
54	encoded. If you omit them, applications assume you've used standard	54	encoded. If you omit them, applications assume you've used standard
55	encoding. You usually do want to add them.	55	encoding. You usually do want to add them.
56		56
57
58	.. tabularcolumns:: \|p{1.2cm}\|p{3.0cm}\|p{13.3cm}\|	57	.. tabularcolumns:: \|p{1.2cm}\|p{3.0cm}\|p{13.3cm}\|
59		58
60	.. c:type:: v4l2_jpegcompression	59	.. c:type:: v4l2_jpegcompression
@@ -92,7 +91,6 @@ encoding. You usually do want to add them. · 31 unmodified lines
92	control is exposed by a driver applications should use it instead	91	control is exposed by a driver applications should use it instead
93	and ignore this field.	92	and ignore this field.
94		93
95
96	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	94	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
97		95
98	.. _jpeg-markers:	96	.. _jpeg-markers:
@@ -118,7 +116,6 @@ encoding. You usually do want to add them. · 19 unmodified lines
118	- (1<<7)	116	- (1<<7)
119	- App segment, driver will always use APP0	117	- App segment, driver will always use APP0
120		118
121
122	Return Value	119	Return Value
123	============	120	============
124		121

Documentation/userspace-api/media/v4l/vidioc-g-modulator.rst+7−10

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_MODULATOR:	4	.. _VIDIOC_G_MODULATOR:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_MODULATOR - VIDIOC_S_MODULATOR - Get or set modulator attributes	13	VIDIOC_G_MODULATOR - VIDIOC_S_MODULATOR - Get or set modulator attributes
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_MODULATOR, struct v4l2_modulator *argp )	18	.. c:macro:: VIDIOC_G_MODULATOR
19	:name: VIDIOC_G_MODULATOR	19
		20	``int ioctl(int fd, VIDIOC_G_MODULATOR, struct v4l2_modulator *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_S_MODULATOR, const struct v4l2_modulator *argp )	22	.. c:macro:: VIDIOC_S_MODULATOR
22	:name: VIDIOC_S_MODULATOR
23		23
		24	``int ioctl(int fd, VIDIOC_S_MODULATOR, const struct v4l2_modulator *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_modulator`.	33	Pointer to struct :c:type:`v4l2_modulator`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -60,7 +60,6 @@ context. · 22 unmodified lines
60	To change the radio frequency the	60	To change the radio frequency the
61	:ref:`VIDIOC_S_FREQUENCY <VIDIOC_G_FREQUENCY>` ioctl is available.	61	:ref:`VIDIOC_S_FREQUENCY <VIDIOC_G_FREQUENCY>` ioctl is available.
62		62
63
64	.. tabularcolumns:: \|p{2.9cm}\|p{2.9cm}\|p{5.8cm}\|p{2.9cm}\|p{3.0cm}\|	63	.. tabularcolumns:: \|p{2.9cm}\|p{2.9cm}\|p{5.8cm}\|p{2.9cm}\|p{3.0cm}\|
65		64
66	.. c:type:: v4l2_modulator	65	.. c:type:: v4l2_modulator
@@ -121,7 +120,6 @@ To change the radio frequency the · 54 unmodified lines
121	Drivers and applications must set the array to zero.	120	Drivers and applications must set the array to zero.
122		121
123		122
124
125	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	123	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
126		124
127	.. _modulator-txsubchans:	125	.. _modulator-txsubchans:
@@ -182,7 +180,6 @@ To change the radio frequency the · 54 unmodified lines
182	- 0x0010	180	- 0x0010
183	- Enable the RDS encoder for a radio FM transmitter.	181	- Enable the RDS encoder for a radio FM transmitter.
184		182
185
186	Return Value	183	Return Value
187	============	184	============
188		185

Documentation/userspace-api/media/v4l/vidioc-g-output.rst+7−8

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_OUTPUT:	4	.. _VIDIOC_G_OUTPUT:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_OUTPUT - VIDIOC_S_OUTPUT - Query or select the current video output	13	VIDIOC_G_OUTPUT - VIDIOC_S_OUTPUT - Query or select the current video output
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_OUTPUT, int *argp )	18	.. c:macro:: VIDIOC_G_OUTPUT
19	:name: VIDIOC_G_OUTPUT	19
		20	``int ioctl(int fd, VIDIOC_G_OUTPUT, int *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_S_OUTPUT, int *argp )	22	.. c:macro:: VIDIOC_S_OUTPUT
22	:name: VIDIOC_S_OUTPUT
23		23
		24	``int ioctl(int fd, VIDIOC_S_OUTPUT, int *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to an integer with output index.	33	Pointer to an integer with output index.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -53,7 +53,6 @@ negotiating any other parameters. · 15 unmodified lines
53	Information about video outputs is available using the	53	Information about video outputs is available using the
54	:ref:`VIDIOC_ENUMOUTPUT` ioctl.	54	:ref:`VIDIOC_ENUMOUTPUT` ioctl.
55		55
56
57	Return Value	56	Return Value
58	============	57	============
59		58

Documentation/userspace-api/media/v4l/vidioc-g-parm.rst+12−18

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_PARM:	4	.. _VIDIOC_G_PARM:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_PARM - VIDIOC_S_PARM - Get or set streaming parameters	13	VIDIOC_G_PARM - VIDIOC_S_PARM - Get or set streaming parameters
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_PARM, v4l2_streamparm *argp )	18	.. c:macro:: VIDIOC_G_PARM
19	:name: VIDIOC_G_PARM	19
		20	``int ioctl(int fd, VIDIOC_G_PARM, v4l2_streamparm *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_S_PARM, v4l2_streamparm *argp )	22	.. c:macro:: VIDIOC_S_PARM
22	:name: VIDIOC_S_PARM
23		23
		24	``int ioctl(int fd, VIDIOC_S_PARM, v4l2_streamparm *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_streamparm`.	33	Pointer to struct :c:type:`v4l2_streamparm`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -48,7 +48,7 @@ format, on the other hand, may change the frame interval. · 10 unmodified lines
48		48
49	Further these ioctls can be used to determine the number of buffers used	49	Further these ioctls can be used to determine the number of buffers used
50	internally by a driver in read/write mode. For implications see the	50	internally by a driver in read/write mode. For implications see the
51	section discussing the :ref:`read() <func-read>` function.	51	section discussing the :c:func:`read()` function.
52		52
53	To get and set the streaming parameters applications call the	53	To get and set the streaming parameters applications call the
54	:ref:`VIDIOC_G_PARM <VIDIOC_G_PARM>` and	54	:ref:`VIDIOC_G_PARM <VIDIOC_G_PARM>` and
@@ -56,7 +56,6 @@ To get and set the streaming parameters applications call the · 1 unmodified line
56	pointer to a struct :c:type:`v4l2_streamparm` which contains a	56	pointer to a struct :c:type:`v4l2_streamparm` which contains a
57	union holding separate parameters for input and output devices.	57	union holding separate parameters for input and output devices.
58		58
59
60	.. tabularcolumns:: \|p{3.5cm}\|p{3.5cm}\|p{3.5cm}\|p{7.0cm}\|	59	.. tabularcolumns:: \|p{3.5cm}\|p{3.5cm}\|p{3.5cm}\|p{7.0cm}\|
61		60
62	.. c:type:: v4l2_streamparm	61	.. c:type:: v4l2_streamparm
@@ -89,7 +88,6 @@ union holding separate parameters for input and output devices. · 26 unmodified lines
89	-	88	-
90		89
91		90
92
93	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	91	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
94		92
95	.. c:type:: v4l2_captureparm	93	.. c:type:: v4l2_captureparm
@@ -138,7 +136,7 @@ union holding separate parameters for input and output devices. · 42 unmodified lines
138	* - __u32	136	* - __u32
139	- ``readbuffers``	137	- ``readbuffers``
140	- Applications set this field to the desired number of buffers used	138	- Applications set this field to the desired number of buffers used
141	internally by the driver in :ref:`read() <func-read>` mode.	139	internally by the driver in :c:func:`read()` mode.
142	Drivers return the actual number of buffers. When an application	140	Drivers return the actual number of buffers. When an application
143	requests zero buffers, drivers should just return the current	141	requests zero buffers, drivers should just return the current
144	setting rather than the minimum or an error code. For details see	142	setting rather than the minimum or an error code. For details see
@@ -149,7 +147,6 @@ union holding separate parameters for input and output devices. · 4 unmodified lines
149	the array to zero.	147	the array to zero.
150		148
151		149
152
153	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	150	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
154		151
155	.. c:type:: v4l2_outputparm	152	.. c:type:: v4l2_outputparm
@@ -172,7 +169,7 @@ union holding separate parameters for input and output devices. · 16 unmodified lines
172	* - :cspan:`2`	169	* - :cspan:`2`
173		170
174	The field is intended to repeat frames on the driver side in	171	The field is intended to repeat frames on the driver side in
175	:ref:`write() <func-write>` mode (in streaming mode timestamps	172	:c:func:`write()` mode (in streaming mode timestamps
176	can be used to throttle the output), saving I/O bandwidth.	173	can be used to throttle the output), saving I/O bandwidth.
177		174
178	For stateful encoders (see :ref:`encoder`) this represents the	175	For stateful encoders (see :ref:`encoder`) this represents the
@@ -199,7 +196,7 @@ union holding separate parameters for input and output devices. · 20 unmodified lines
199	* - __u32	196	* - __u32
200	- ``writebuffers``	197	- ``writebuffers``
201	- Applications set this field to the desired number of buffers used	198	- Applications set this field to the desired number of buffers used
202	internally by the driver in :ref:`write() <func-write>` mode. Drivers	199	internally by the driver in :c:func:`write()` mode. Drivers
203	return the actual number of buffers. When an application requests	200	return the actual number of buffers. When an application requests
204	zero buffers, drivers should just return the current setting	201	zero buffers, drivers should just return the current setting
205	rather than the minimum or an error code. For details see	202	rather than the minimum or an error code. For details see
@@ -210,7 +207,6 @@ union holding separate parameters for input and output devices. · 4 unmodified lines
210	the array to zero.	207	the array to zero.
211		208
212		209
213
214	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	210	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
215		211
216	.. _parm-caps:	212	.. _parm-caps:
@@ -226,7 +222,6 @@ union holding separate parameters for input and output devices. · 9 unmodified lines
226	field.	222	field.
227		223
228		224
229
230	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	225	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
231		226
232	.. _parm-flags:	227	.. _parm-flags:
@@ -265,8 +260,7 @@ union holding separate parameters for input and output devices. · 32 unmodified lines
265		260
266	- Moving objects in the image might have excessive motion blur.	261	- Moving objects in the image might have excessive motion blur.
267		262
268	- Capture might only work through the :ref:`read() <func-read>` call.	263	- Capture might only work through the :c:func:`read()` call.
269
270		264
271	Return Value	265	Return Value
272	============	266	============

Documentation/userspace-api/media/v4l/vidioc-g-priority.rst+7−9

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_PRIORITY:	4	.. _VIDIOC_G_PRIORITY:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_PRIORITY - VIDIOC_S_PRIORITY - Query or request the access priority associated with a file descriptor	13	VIDIOC_G_PRIORITY - VIDIOC_S_PRIORITY - Query or request the access priority associated with a file descriptor
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_PRIORITY, enum v4l2_priority *argp )	18	.. c:macro:: VIDIOC_G_PRIORITY
19	:name: VIDIOC_G_PRIORITY	19
		20	``int ioctl(int fd, VIDIOC_G_PRIORITY, enum v4l2_priority *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_S_PRIORITY, const enum v4l2_priority *argp )	22	.. c:macro:: VIDIOC_S_PRIORITY
22	:name: VIDIOC_S_PRIORITY
23		23
		24	``int ioctl(int fd, VIDIOC_S_PRIORITY, const enum v4l2_priority *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to an enum :c:type:`v4l2_priority` type.	33	Pointer to an enum :c:type:`v4l2_priority` type.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -43,7 +43,6 @@ To request an access priority applications store the desired priority in · 5 unmodified lines
43	an enum v4l2_priority variable and call :ref:`VIDIOC_S_PRIORITY <VIDIOC_G_PRIORITY>` ioctl	43	an enum v4l2_priority variable and call :ref:`VIDIOC_S_PRIORITY <VIDIOC_G_PRIORITY>` ioctl
44	with a pointer to this variable.	44	with a pointer to this variable.
45		45
46
47	.. c:type:: v4l2_priority	46	.. c:type:: v4l2_priority
48		47
49	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	48	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
@@ -78,7 +77,6 @@ with a pointer to this variable. · 28 unmodified lines
78	it blocks any other fd from changing device properties. Usually	77	it blocks any other fd from changing device properties. Usually
79	applications which must not be interrupted, like video recording.	78	applications which must not be interrupted, like video recording.
80		79
81
82	Return Value	80	Return Value
83	============	81	============
84		82

Documentation/userspace-api/media/v4l/vidioc-g-selection.rst+6−9

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_G_SELECTION:
 VIDIOC_G_SELECTION - VIDIOC_S_SELECTION - Get or set one of the selection rectangles
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_G_SELECTION, struct v4l2_selection *argp )
+.. c:macro:: VIDIOC_G_SELECTION
-    :name: VIDIOC_G_SELECTION
+``int ioctl(int fd, VIDIOC_G_SELECTION, struct v4l2_selection *argp)``
-.. c:function:: int ioctl( int fd, VIDIOC_S_SELECTION, struct v4l2_selection *argp )
+.. c:macro:: VIDIOC_S_SELECTION
-    :name: VIDIOC_S_SELECTION
+``int ioctl(int fd, VIDIOC_S_SELECTION, struct v4l2_selection *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_selection`.
 Selection targets and flags are documented in
 :ref:`v4l2-selections-common`.
 .. _sel-const-adjust:
 .. kernel-figure::  constraints.svg
 .. c:type:: v4l2_selection
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
    Starting with kernel 4.13 both variations are allowed.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-g-sliced-vbi-cap.rst+4−8

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_G_SLICED_VBI_CAP:
 VIDIOC_G_SLICED_VBI_CAP - Query sliced VBI capabilities
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_G_SLICED_VBI_CAP, struct v4l2_sliced_vbi_cap *argp )
+.. c:macro:: VIDIOC_G_SLICED_VBI_CAP
-    :name: VIDIOC_G_SLICED_VBI_CAP
+``int ioctl(int fd, VIDIOC_G_SLICED_VBI_CAP, struct v4l2_sliced_vbi_cap *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_sliced_vbi_cap`.
 Description
 ===========
    The ``type`` field was added, and the ioctl changed from read-only
    to write-read, in Linux 2.6.19.
 .. c:type:: v4l2_sliced_vbi_cap
 .. tabularcolumns:: |p{1.2cm}|p{4.2cm}|p{4.1cm}|p{4.0cm}|p{4.0cm}|
    See also :ref:`vbi-525` and :ref:`vbi-625`.
 .. raw:: latex
     \scriptsize
     \normalsize
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-g-std.rst+13−11

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_STD:	4	.. _VIDIOC_G_STD:
4		5
@@ -11,33 +12,34 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_STD - VIDIOC_S_STD - VIDIOC_SUBDEV_G_STD - VIDIOC_SUBDEV_S_STD - Query or select the video standard of the current input	13	VIDIOC_G_STD - VIDIOC_S_STD - VIDIOC_SUBDEV_G_STD - VIDIOC_SUBDEV_S_STD - Query or select the video standard of the current input
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_STD, v4l2_std_id *argp )	18	.. c:macro:: VIDIOC_G_STD
19	:name: VIDIOC_G_STD	19
		20	``int ioctl(int fd, VIDIOC_G_STD, v4l2_std_id *argp)``
		21
		22	.. c:macro:: VIDIOC_S_STD
20		23
21	.. c:function:: int ioctl( int fd, VIDIOC_S_STD, const v4l2_std_id *argp )	24	``int ioctl(int fd, VIDIOC_S_STD, const v4l2_std_id *argp)``
22	:name: VIDIOC_S_STD
23		25
24	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_G_STD, v4l2_std_id *argp )	26	.. c:macro:: VIDIOC_SUBDEV_G_STD
25	:name: VIDIOC_SUBDEV_G_STD
26		27
27	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_S_STD, const v4l2_std_id *argp )	28	``int ioctl(int fd, VIDIOC_SUBDEV_G_STD, v4l2_std_id *argp)``
28	:name: VIDIOC_SUBDEV_S_STD
29		29
		30	.. c:macro:: VIDIOC_SUBDEV_S_STD
		31
		32	``int ioctl(int fd, VIDIOC_SUBDEV_S_STD, const v4l2_std_id *argp)``
30		33
31	Arguments	34	Arguments
32	=========	35	=========
33		36
34	``fd``	37	``fd``
35	File descriptor returned by :ref:`open() <func-open>`.	38	File descriptor returned by :c:func:`open()`.
36		39
37	``argp``	40	``argp``
38	Pointer to :c:type:`v4l2_std_id`.	41	Pointer to :c:type:`v4l2_std_id`.
39		42
40
41	Description	43	Description
42	===========	44	===========
43		45

Documentation/userspace-api/media/v4l/vidioc-g-tuner.rst+7−12

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_G_TUNER:	4	.. _VIDIOC_G_TUNER:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_G_TUNER - VIDIOC_S_TUNER - Get or set tuner attributes	13	VIDIOC_G_TUNER - VIDIOC_S_TUNER - Get or set tuner attributes
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_G_TUNER, struct v4l2_tuner *argp )	18	.. c:macro:: VIDIOC_G_TUNER
19	:name: VIDIOC_G_TUNER	19
		20	``int ioctl(int fd, VIDIOC_G_TUNER, struct v4l2_tuner *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_S_TUNER, const struct v4l2_tuner *argp )	22	.. c:macro:: VIDIOC_S_TUNER
22	:name: VIDIOC_S_TUNER
23		23
		24	``int ioctl(int fd, VIDIOC_S_TUNER, const struct v4l2_tuner *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_tuner`.	33	Pointer to struct :c:type:`v4l2_tuner`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -59,7 +59,6 @@ to zero. The term 'tuner' means SDR receiver in this context. · 21 unmodified lines
59	To change the radio frequency the	59	To change the radio frequency the
60	:ref:`VIDIOC_S_FREQUENCY <VIDIOC_G_FREQUENCY>` ioctl is available.	60	:ref:`VIDIOC_S_FREQUENCY <VIDIOC_G_FREQUENCY>` ioctl is available.
61		61
62
63	.. tabularcolumns:: \|p{1.3cm}\|p{3.0cm}\|p{6.6cm}\|p{6.6cm}\|	62	.. tabularcolumns:: \|p{1.3cm}\|p{3.0cm}\|p{6.6cm}\|p{6.6cm}\|
64		63
65	.. c:type:: v4l2_tuner	64	.. c:type:: v4l2_tuner
@@ -183,7 +182,6 @@ To change the radio frequency the · 117 unmodified lines
183	Drivers and applications must set the array to zero.	182	Drivers and applications must set the array to zero.
184		183
185		184
186
187	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	185	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
188		186
189	.. c:type:: v4l2_tuner_type	187	.. c:type:: v4l2_tuner_type
@@ -207,7 +205,6 @@ To change the radio frequency the · 17 unmodified lines
207	- 5	205	- 5
208	- Tuner controls the RF part of a Software Digital Radio (SDR)	206	- Tuner controls the RF part of a Software Digital Radio (SDR)
209		207
210
211	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	208	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
212		209
213	.. _tuner-capability:	210	.. _tuner-capability:
@@ -299,7 +296,6 @@ To change the radio frequency the · 85 unmodified lines
299	instead of 62.5 kHz.	296	instead of 62.5 kHz.
300		297
301		298
302
303	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	299	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
304		300
305	.. _tuner-rxsubchans:	301	.. _tuner-rxsubchans:
@@ -338,7 +334,6 @@ To change the radio frequency the · 32 unmodified lines
338	- The tuner receives an RDS channel.	334	- The tuner receives an RDS channel.
339		335
340		336
341
342	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	337	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
343		338
344	.. _tuner-audmode:	339	.. _tuner-audmode:

Documentation/userspace-api/media/v4l/vidioc-log-status.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_LOG_STATUS:
 VIDIOC_LOG_STATUS - Log driver status information
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_LOG_STATUS)
+.. c:macro:: VIDIOC_LOG_STATUS
-    :name: VIDIOC_LOG_STATUS
+``int ioctl(int fd, VIDIOC_LOG_STATUS)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 Description
 ===========
 This ioctl is optional and not all drivers support it. It was introduced
 in Linux 2.6.15.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-overlay.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_OVERLAY:
 VIDIOC_OVERLAY - Start or stop video overlay
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_OVERLAY, const int *argp )
+.. c:macro:: VIDIOC_OVERLAY
-    :name: VIDIOC_OVERLAY
+``int ioctl(int fd, VIDIOC_OVERLAY, const int *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to an integer.
 Description
 ===========
 :ref:`VIDIOC_STREAMOFF <VIDIOC_STREAMON>` with
 ``V4L2_BUF_TYPE_VIDEO_OVERLAY``.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-prepare-buf.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_PREPARE_BUF:
 VIDIOC_PREPARE_BUF - Prepare a buffer for I/O
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_PREPARE_BUF, struct v4l2_buffer *argp )
+.. c:macro:: VIDIOC_PREPARE_BUF
-    :name: VIDIOC_PREPARE_BUF
+``int ioctl(int fd, VIDIOC_PREPARE_BUF, struct v4l2_buffer *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_buffer`.
 Description
 ===========
 The struct :c:type:`v4l2_buffer` structure is specified in
 :ref:`buffer`.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-qbuf.rst+8−9

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_QBUF:	4	.. _VIDIOC_QBUF:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_QBUF - VIDIOC_DQBUF - Exchange a buffer with the driver	13	VIDIOC_QBUF - VIDIOC_DQBUF - Exchange a buffer with the driver
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_QBUF, struct v4l2_buffer *argp )	18	.. c:macro:: VIDIOC_QBUF
19	:name: VIDIOC_QBUF	19
		20	``int ioctl(int fd, VIDIOC_QBUF, struct v4l2_buffer *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_DQBUF, struct v4l2_buffer *argp )	22	.. c:macro:: VIDIOC_DQBUF
22	:name: VIDIOC_DQBUF
23		23
		24	``int ioctl(int fd, VIDIOC_DQBUF, struct v4l2_buffer *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_buffer`.	33	Pointer to struct :c:type:`v4l2_buffer`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -142,13 +142,12 @@ API is used the ``m.fd`` fields of the passed array of struct · 104 unmodified lines
142		142
143	By default ``VIDIOC_DQBUF`` blocks when no buffer is in the outgoing	143	By default ``VIDIOC_DQBUF`` blocks when no buffer is in the outgoing
144	queue. When the ``O_NONBLOCK`` flag was given to the	144	queue. When the ``O_NONBLOCK`` flag was given to the
145	:ref:`open() <func-open>` function, ``VIDIOC_DQBUF`` returns	145	:c:func:`open()` function, ``VIDIOC_DQBUF`` returns
146	immediately with an ``EAGAIN`` error code when no buffer is available.	146	immediately with an ``EAGAIN`` error code when no buffer is available.
147		147
148	The struct :c:type:`v4l2_buffer` structure is specified in	148	The struct :c:type:`v4l2_buffer` structure is specified in
149	:ref:`buffer`.	149	:ref:`buffer`.
150		150
151
152	Return Value	151	Return Value
153	============	152	============
154		153

Documentation/userspace-api/media/v4l/vidioc-query-dv-timings.rst+7−8

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_QUERY_DV_TIMINGS:	4	.. _VIDIOC_QUERY_DV_TIMINGS:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_QUERY_DV_TIMINGS - VIDIOC_SUBDEV_QUERY_DV_TIMINGS - Sense the DV preset received by the current input	13	VIDIOC_QUERY_DV_TIMINGS - VIDIOC_SUBDEV_QUERY_DV_TIMINGS - Sense the DV preset received by the current input
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_QUERY_DV_TIMINGS, struct v4l2_dv_timings *argp )	18	.. c:macro:: VIDIOC_QUERY_DV_TIMINGS
19	:name: VIDIOC_QUERY_DV_TIMINGS	19
		20	``int ioctl(int fd, VIDIOC_QUERY_DV_TIMINGS, struct v4l2_dv_timings *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_QUERY_DV_TIMINGS, struct v4l2_dv_timings *argp )	22	.. c:macro:: VIDIOC_SUBDEV_QUERY_DV_TIMINGS
22	:name: VIDIOC_SUBDEV_QUERY_DV_TIMINGS
23		23
		24	``int ioctl(int fd, VIDIOC_SUBDEV_QUERY_DV_TIMINGS, struct v4l2_dv_timings *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_dv_timings`.	33	Pointer to struct :c:type:`v4l2_dv_timings`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -65,7 +65,6 @@ and returns ``ERANGE``. In that case the application can call · 27 unmodified lines
65	found timings with the hardware's capabilities in order to give more	65	found timings with the hardware's capabilities in order to give more
66	precise feedback to the user.	66	precise feedback to the user.
67		67
68
69	Return Value	68	Return Value
70	============	69	============
71		70

Documentation/userspace-api/media/v4l/vidioc-querybuf.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_QUERYBUF:
 VIDIOC_QUERYBUF - Query the status of a buffer
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_QUERYBUF, struct v4l2_buffer *argp )
+.. c:macro:: VIDIOC_QUERYBUF
-    :name: VIDIOC_QUERYBUF
+``int ioctl(int fd, VIDIOC_QUERYBUF, struct v4l2_buffer *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_buffer`.
 Description
 ===========
 The struct :c:type:`v4l2_buffer` structure is specified in
 :ref:`buffer`.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-querycap.rst+6−10

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_QUERYCAP:
 VIDIOC_QUERYCAP - Query device capabilities
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_QUERYCAP, struct v4l2_capability *argp )
+.. c:macro:: VIDIOC_QUERYCAP
-    :name: VIDIOC_QUERYCAP
+``int ioctl(int fd, VIDIOC_QUERYCAP, struct v4l2_capability *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_capability`.
 Description
 ===========
 filled by the driver. When the driver is not compatible with this
 specification the ioctl returns an ``EINVAL`` error code.
 .. tabularcolumns:: |p{1.5cm}|p{2.5cm}|p{13cm}|
 .. c:type:: v4l2_capability
 	zero.
 .. tabularcolumns:: |p{6.1cm}|p{2.2cm}|p{8.7cm}|
 .. _device-capabilities:
       - The device supports the :ref:`metadata` capture interface.
     * - ``V4L2_CAP_READWRITE``
       - 0x01000000
-      - The device supports the :ref:`read() <rw>` and/or
+      - The device supports the :c:func:`read()` and/or
-	:ref:`write() <rw>` I/O methods.
+	:c:func:`write()` I/O methods.
     * - ``V4L2_CAP_ASYNCIO``
       - 0x02000000
       - The device supports the :ref:`asynchronous <async>` I/O methods.
 	only appear in the ``capabilities`` field and never in the
 	``device_caps`` field.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-queryctrl.rst+8−14

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_QUERYCTRL:	4	.. _VIDIOC_QUERYCTRL:
4		5
@@ -11,31 +12,29 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_QUERYCTRL - VIDIOC_QUERY_EXT_CTRL - VIDIOC_QUERYMENU - Enumerate controls and menu control items	13	VIDIOC_QUERYCTRL - VIDIOC_QUERY_EXT_CTRL - VIDIOC_QUERYMENU - Enumerate controls and menu control items
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, int VIDIOC_QUERYCTRL, struct v4l2_queryctrl *argp )	18	``int ioctl(int fd, int VIDIOC_QUERYCTRL, struct v4l2_queryctrl *argp)``
19	:name: VIDIOC_QUERYCTRL	19
		20	.. c:macro:: VIDIOC_QUERY_EXT_CTRL
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_QUERY_EXT_CTRL, struct v4l2_query_ext_ctrl *argp )	22	``int ioctl(int fd, VIDIOC_QUERY_EXT_CTRL, struct v4l2_query_ext_ctrl *argp)``
22	:name: VIDIOC_QUERY_EXT_CTRL
23		23
24	.. c:function:: int ioctl( int fd, VIDIOC_QUERYMENU, struct v4l2_querymenu *argp )	24	.. c:macro:: VIDIOC_QUERYMENU
25	:name: VIDIOC_QUERYMENU
26		25
		26	``int ioctl(int fd, VIDIOC_QUERYMENU, struct v4l2_querymenu *argp)``
27		27
28	Arguments	28	Arguments
29	=========	29	=========
30		30
31	``fd``	31	``fd``
32	File descriptor returned by :ref:`open() <func-open>`.	32	File descriptor returned by :c:func:`open()`.
33		33
34	``argp``	34	``argp``
35	Pointer to struct :c:type:`v4l2_queryctrl`, :c:type:`v4l2_query_ext_ctrl`	35	Pointer to struct :c:type:`v4l2_queryctrl`, :c:type:`v4l2_query_ext_ctrl`
36	or :c:type:`v4l2_querymenu` (depending on the ioctl).	36	or :c:type:`v4l2_querymenu` (depending on the ioctl).
37		37
38
39	Description	38	Description
40	===========	39	===========
41		40
@@ -95,7 +94,6 @@ inclusive. · 53 unmodified lines
95		94
96	See also the examples in :ref:`control`.	95	See also the examples in :ref:`control`.
97		96
98
99	.. tabularcolumns:: \|p{1.2cm}\|p{3.6cm}\|p{12.7cm}\|	97	.. tabularcolumns:: \|p{1.2cm}\|p{3.6cm}\|p{12.7cm}\|
100		98
101	.. _v4l2-queryctrl:	99	.. _v4l2-queryctrl:
@@ -174,7 +172,6 @@ See also the examples in :ref:`control`. · 72 unmodified lines
174	zero.	172	zero.
175		173
176		174
177
178	.. tabularcolumns:: \|p{1.2cm}\|p{5.0cm}\|p{11.3cm}\|	175	.. tabularcolumns:: \|p{1.2cm}\|p{5.0cm}\|p{11.3cm}\|
179		176
180	.. _v4l2-query-ext-ctrl:	177	.. _v4l2-query-ext-ctrl:
@@ -275,7 +272,6 @@ See also the examples in :ref:`control`. · 94 unmodified lines
275	the array to zero.	272	the array to zero.
276		273
277		274
278
279	.. tabularcolumns:: \|p{1.2cm}\|p{1.0cm}\|p{1.7cm}\|p{13.0cm}\|	275	.. tabularcolumns:: \|p{1.2cm}\|p{1.0cm}\|p{1.7cm}\|p{13.0cm}\|
280		276
281	.. _v4l2-querymenu:	277	.. _v4l2-querymenu:
@@ -311,7 +307,6 @@ See also the examples in :ref:`control`. · 29 unmodified lines
311	zero.	307	zero.
312		308
313		309
314
315	.. tabularcolumns:: \|p{5.8cm}\|p{1.4cm}\|p{1.0cm}\|p{1.4cm}\|p{6.9cm}\|	310	.. tabularcolumns:: \|p{5.8cm}\|p{1.4cm}\|p{1.0cm}\|p{1.4cm}\|p{6.9cm}\|
316		311
317	.. c:type:: v4l2_ctrl_type	312	.. c:type:: v4l2_ctrl_type
@@ -582,7 +577,6 @@ See also the examples in :ref:`control`. · 264 unmodified lines
582	streaming is in progress since most drivers do not support changing	577	streaming is in progress since most drivers do not support changing
583	the format in that case.	578	the format in that case.
584		579
585
586	Return Value	580	Return Value
587	============	581	============
588		582

Documentation/userspace-api/media/v4l/vidioc-querystd.rst+7−8

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_QUERYSTD:	4	.. _VIDIOC_QUERYSTD:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_QUERYSTD - VIDIOC_SUBDEV_QUERYSTD - Sense the video standard received by the current input	13	VIDIOC_QUERYSTD - VIDIOC_SUBDEV_QUERYSTD - Sense the video standard received by the current input
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_QUERYSTD, v4l2_std_id *argp )	18	.. c:macro:: VIDIOC_QUERYSTD
19	:name: VIDIOC_QUERYSTD	19
		20	``int ioctl(int fd, VIDIOC_QUERYSTD, v4l2_std_id *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_QUERYSTD, v4l2_std_id *argp )	22	.. c:macro:: VIDIOC_SUBDEV_QUERYSTD
22	:name: VIDIOC_SUBDEV_QUERYSTD
23		23
		24	``int ioctl(int fd, VIDIOC_SUBDEV_QUERYSTD, v4l2_std_id *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to :c:type:`v4l2_std_id`.	33	Pointer to :c:type:`v4l2_std_id`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -58,7 +58,6 @@ or output. · 20 unmodified lines
58	standard is valid they will have to stop streaming, set the new	58	standard is valid they will have to stop streaming, set the new
59	standard, allocate new buffers and start streaming again.	59	standard, allocate new buffers and start streaming again.
60		60
61
62	Return Value	61	Return Value
63	============	62	============
64		63

Documentation/userspace-api/media/v4l/vidioc-reqbufs.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_REQBUFS:
 VIDIOC_REQBUFS - Initiate Memory Mapping, User Pointer I/O or DMA buffer I/O
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_REQBUFS, struct v4l2_requestbuffers *argp )
+.. c:macro:: VIDIOC_REQBUFS
-    :name: VIDIOC_REQBUFS
+``int ioctl(int fd, VIDIOC_REQBUFS, struct v4l2_requestbuffers *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_requestbuffers`.
 aborting or finishing any DMA in progress, an implicit
 :ref:`VIDIOC_STREAMOFF <VIDIOC_STREAMON>`.
 .. c:type:: v4l2_requestbuffers
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
         :ref:`V4L2_BUF_FLAG_NO_CACHE_INVALIDATE <V4L2-BUF-FLAG-NO-CACHE-INVALIDATE>` and
         :ref:`V4L2_BUF_FLAG_NO_CACHE_CLEAN <V4L2-BUF-FLAG-NO-CACHE-CLEAN>`.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-s-hw-freq-seek.rst+4−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_S_HW_FREQ_SEEK:
 VIDIOC_S_HW_FREQ_SEEK - Perform a hardware frequency seek
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_S_HW_FREQ_SEEK, struct v4l2_hw_freq_seek *argp )
+.. c:macro:: VIDIOC_S_HW_FREQ_SEEK
-    :name: VIDIOC_S_HW_FREQ_SEEK
+``int ioctl(int fd, VIDIOC_S_HW_FREQ_SEEK, struct v4l2_hw_freq_seek *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_hw_freq_seek`.
 Description
 ===========
 If this ioctl is called from a non-blocking filehandle, then ``EAGAIN``
 error code is returned and no seek takes place.
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
 .. c:type:: v4l2_hw_freq_seek
       - Reserved for future extensions. Applications must set the array to
 	zero.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-streamon.rst+7−7

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_STREAMON:	4	.. _VIDIOC_STREAMON:
4		5
@@ -11,22 +12,22 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_STREAMON - VIDIOC_STREAMOFF - Start or stop streaming I/O	13	VIDIOC_STREAMON - VIDIOC_STREAMOFF - Start or stop streaming I/O
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_STREAMON, const int *argp )	18	.. c:macro:: VIDIOC_STREAMON
19	:name: VIDIOC_STREAMON	19
		20	``int ioctl(int fd, VIDIOC_STREAMON, const int *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_STREAMOFF, const int *argp )	22	.. c:macro:: VIDIOC_STREAMOFF
22	:name: VIDIOC_STREAMOFF
23		23
		24	``int ioctl(int fd, VIDIOC_STREAMOFF, const int *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to an integer.	33	Pointer to an integer.
@@ -84,7 +85,6 @@ state as mentioned above. · 51 unmodified lines
84	no notion of starting or stopping "now". Buffer timestamps can be used	85	no notion of starting or stopping "now". Buffer timestamps can be used
85	to synchronize with other events.	86	to synchronize with other events.
86		87
87
88	Return Value	88	Return Value
89	============	89	============
90		90

Documentation/userspace-api/media/v4l/vidioc-subdev-enum-frame-interval.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL:
 VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL - Enumerate frame intervals
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL, struct v4l2_subdev_frame_interval_enum * argp )
+.. c:macro:: VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL
-    :name: VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL
+``int ioctl(int fd, VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL, struct v4l2_subdev_frame_interval_enum * argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_subdev_frame_interval_enum`.
 Description
 ===========
       - Reserved for future extensions. Applications and drivers must set
 	the array to zero.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-subdev-enum-frame-size.rst+4−7

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_SUBDEV_ENUM_FRAME_SIZE:
 VIDIOC_SUBDEV_ENUM_FRAME_SIZE - Enumerate media bus frame sizes
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_ENUM_FRAME_SIZE, struct v4l2_subdev_frame_size_enum * argp )
+.. c:macro:: VIDIOC_SUBDEV_ENUM_FRAME_SIZE
-    :name: VIDIOC_SUBDEV_ENUM_FRAME_SIZE
+``int ioctl(int fd, VIDIOC_SUBDEV_ENUM_FRAME_SIZE, struct v4l2_subdev_frame_size_enum * argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_subdev_frame_size_enum`.
 Description
 ===========
 :ref:`VIDIOC_SUBDEV_G_FMT` for more
 information about try formats.
 .. c:type:: v4l2_subdev_frame_size_enum
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|
       - Reserved for future extensions. Applications and drivers must set
 	the array to zero.
 Return Value
 ============

Documentation/userspace-api/media/v4l/vidioc-subdev-enum-mbus-code.rst+4−6

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_SUBDEV_ENUM_MBUS_CODE:
 VIDIOC_SUBDEV_ENUM_MBUS_CODE - Enumerate media bus formats
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_ENUM_MBUS_CODE, struct v4l2_subdev_mbus_code_enum * argp )
+.. c:macro:: VIDIOC_SUBDEV_ENUM_MBUS_CODE
-    :name: VIDIOC_SUBDEV_ENUM_MBUS_CODE
+``int ioctl(int fd, VIDIOC_SUBDEV_ENUM_MBUS_CODE, struct v4l2_subdev_mbus_code_enum * argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_subdev_mbus_code_enum`.
 Description
 ===========
 See :ref:`VIDIOC_SUBDEV_G_FMT` for more
 information about the try formats.
 .. c:type:: v4l2_subdev_mbus_code_enum
 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|

Documentation/userspace-api/media/v4l/vidioc-subdev-g-crop.rst+7−9

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_SUBDEV_G_CROP:	4	.. _VIDIOC_SUBDEV_G_CROP:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_SUBDEV_G_CROP - VIDIOC_SUBDEV_S_CROP - Get or set the crop rectangle on a subdev pad	13	VIDIOC_SUBDEV_G_CROP - VIDIOC_SUBDEV_S_CROP - Get or set the crop rectangle on a subdev pad
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_G_CROP, struct v4l2_subdev_crop *argp )	18	.. c:macro:: VIDIOC_SUBDEV_G_CROP
19	:name: VIDIOC_SUBDEV_G_CROP	19
		20	``int ioctl(int fd, VIDIOC_SUBDEV_G_CROP, struct v4l2_subdev_crop *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_S_CROP, const struct v4l2_subdev_crop *argp )	22	.. c:macro:: VIDIOC_SUBDEV_S_CROP
22	:name: VIDIOC_SUBDEV_S_CROP
23		23
		24	``int ioctl(int fd, VIDIOC_SUBDEV_S_CROP, const struct v4l2_subdev_crop *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_subdev_crop`.	33	Pointer to struct :c:type:`v4l2_subdev_crop`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -76,7 +76,6 @@ rectangle doesn't match the device capabilities. They must instead · 38 unmodified lines
76	modify the rectangle to match what the hardware can provide. The	76	modify the rectangle to match what the hardware can provide. The
77	modified format should be as close as possible to the original request.	77	modified format should be as close as possible to the original request.
78		78
79
80	.. c:type:: v4l2_subdev_crop	79	.. c:type:: v4l2_subdev_crop
81		80
82	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	81	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
@@ -101,7 +100,6 @@ modified format should be as close as possible to the original request. · 18 unmodified lines
101	- Reserved for future extensions. Applications and drivers must set	100	- Reserved for future extensions. Applications and drivers must set
102	the array to zero.	101	the array to zero.
103		102
104
105	Return Value	103	Return Value
106	============	104	============
107		105

Documentation/userspace-api/media/v4l/vidioc-subdev-g-fmt.rst+7−10

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_SUBDEV_G_FMT:	4	.. _VIDIOC_SUBDEV_G_FMT:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_SUBDEV_G_FMT - VIDIOC_SUBDEV_S_FMT - Get or set the data format on a subdev pad	13	VIDIOC_SUBDEV_G_FMT - VIDIOC_SUBDEV_S_FMT - Get or set the data format on a subdev pad
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_G_FMT, struct v4l2_subdev_format *argp )	18	.. c:macro:: VIDIOC_SUBDEV_G_FMT
19	:name: VIDIOC_SUBDEV_G_FMT	19
		20	``int ioctl(int fd, VIDIOC_SUBDEV_G_FMT, struct v4l2_subdev_format *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_S_FMT, struct v4l2_subdev_format *argp )	22	.. c:macro:: VIDIOC_SUBDEV_S_FMT
22	:name: VIDIOC_SUBDEV_S_FMT
23		23
		24	``int ioctl(int fd, VIDIOC_SUBDEV_S_FMT, struct v4l2_subdev_format *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_subdev_format`.	33	Pointer to struct :c:type:`v4l2_subdev_format`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -81,7 +81,6 @@ doesn't match the device capabilities. They must instead modify the · 43 unmodified lines
81	format to match what the hardware can provide. The modified format	81	format to match what the hardware can provide. The modified format
82	should be as close as possible to the original request.	82	should be as close as possible to the original request.
83		83
84
85	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	84	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
86		85
87	.. c:type:: v4l2_subdev_format	86	.. c:type:: v4l2_subdev_format
@@ -108,7 +107,6 @@ should be as close as possible to the original request. · 20 unmodified lines
108	the array to zero.	107	the array to zero.
109		108
110		109
111
112	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|	110	.. tabularcolumns:: \|p{6.6cm}\|p{2.2cm}\|p{8.7cm}\|
113		111
114	.. _v4l2-subdev-format-whence:	112	.. _v4l2-subdev-format-whence:
@@ -125,7 +123,6 @@ should be as close as possible to the original request. · 10 unmodified lines
125	- 1	123	- 1
126	- Active formats, applied to the hardware.	124	- Active formats, applied to the hardware.
127		125
128
129	Return Value	126	Return Value
130	============	127	============
131		128

Documentation/userspace-api/media/v4l/vidioc-subdev-g-frame-interval.rst+7−9

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_SUBDEV_G_FRAME_INTERVAL:	4	.. _VIDIOC_SUBDEV_G_FRAME_INTERVAL:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_SUBDEV_G_FRAME_INTERVAL - VIDIOC_SUBDEV_S_FRAME_INTERVAL - Get or set the frame interval on a subdev pad	13	VIDIOC_SUBDEV_G_FRAME_INTERVAL - VIDIOC_SUBDEV_S_FRAME_INTERVAL - Get or set the frame interval on a subdev pad
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_G_FRAME_INTERVAL, struct v4l2_subdev_frame_interval *argp )	18	.. c:macro:: VIDIOC_SUBDEV_G_FRAME_INTERVAL
19	:name: VIDIOC_SUBDEV_G_FRAME_INTERVAL	19
		20	``int ioctl(int fd, VIDIOC_SUBDEV_G_FRAME_INTERVAL, struct v4l2_subdev_frame_interval *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_S_FRAME_INTERVAL, struct v4l2_subdev_frame_interval *argp )	22	.. c:macro:: VIDIOC_SUBDEV_S_FRAME_INTERVAL
22	:name: VIDIOC_SUBDEV_S_FRAME_INTERVAL
23		23
		24	``int ioctl(int fd, VIDIOC_SUBDEV_S_FRAME_INTERVAL, struct v4l2_subdev_frame_interval *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_subdev_frame_interval`.	33	Pointer to struct :c:type:`v4l2_subdev_frame_interval`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -74,7 +74,6 @@ Sub-devices that support the frame interval ioctls should implement them · 36 unmodified lines
74	on a single pad only. Their behaviour when supported on multiple pads of	74	on a single pad only. Their behaviour when supported on multiple pads of
75	the same sub-device is not defined.	75	the same sub-device is not defined.
76		76
77
78	.. c:type:: v4l2_subdev_frame_interval	77	.. c:type:: v4l2_subdev_frame_interval
79		78
80	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	79	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
@@ -95,7 +94,6 @@ the same sub-device is not defined. · 14 unmodified lines
95	- Reserved for future extensions. Applications and drivers must set	94	- Reserved for future extensions. Applications and drivers must set
96	the array to zero.	95	the array to zero.
97		96
98
99	Return Value	97	Return Value
100	============	98	============
101		99

Documentation/userspace-api/media/v4l/vidioc-subdev-g-selection.rst+7−10

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_SUBDEV_G_SELECTION:	4	.. _VIDIOC_SUBDEV_G_SELECTION:
4		5
@@ -11,27 +12,26 @@ Name · 6 unmodified lines
11		12
12	VIDIOC_SUBDEV_G_SELECTION - VIDIOC_SUBDEV_S_SELECTION - Get or set selection rectangles on a subdev pad	13	VIDIOC_SUBDEV_G_SELECTION - VIDIOC_SUBDEV_S_SELECTION - Get or set selection rectangles on a subdev pad
13		14
14
15	Synopsis	15	Synopsis
16	========	16	========
17		17
18	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_G_SELECTION, struct v4l2_subdev_selection *argp )	18	.. c:macro:: VIDIOC_SUBDEV_G_SELECTION
19	:name: VIDIOC_SUBDEV_G_SELECTION	19
		20	``int ioctl(int fd, VIDIOC_SUBDEV_G_SELECTION, struct v4l2_subdev_selection *argp)``
20		21
21	.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_S_SELECTION, struct v4l2_subdev_selection *argp )	22	.. c:macro:: VIDIOC_SUBDEV_S_SELECTION
22	:name: VIDIOC_SUBDEV_S_SELECTION
23		23
		24	``int ioctl(int fd, VIDIOC_SUBDEV_S_SELECTION, struct v4l2_subdev_selection *argp)``
24		25
25	Arguments	26	Arguments
26	=========	27	=========
27		28
28	``fd``	29	``fd``
29	File descriptor returned by :ref:`open() <func-open>`.	30	File descriptor returned by :c:func:`open()`.
30		31
31	``argp``	32	``argp``
32	Pointer to struct :c:type:`v4l2_subdev_selection`.	33	Pointer to struct :c:type:`v4l2_subdev_selection`.
33		34
34
35	Description	35	Description
36	===========	36	===========
37		37
@@ -58,7 +58,6 @@ There are two types of selection targets: actual and bounds. The actual · 20 unmodified lines
58	targets are the targets which configure the hardware. The BOUNDS target	58	targets are the targets which configure the hardware. The BOUNDS target
59	will return a rectangle that contain all possible actual rectangles.	59	will return a rectangle that contain all possible actual rectangles.
60		60
61
62	Discovering supported features	61	Discovering supported features
63	------------------------------	62	------------------------------
64		63
@@ -69,7 +68,6 @@ return ``EINVAL``. · 4 unmodified lines
69	Selection targets and flags are documented in	68	Selection targets and flags are documented in
70	:ref:`v4l2-selections-common`.	69	:ref:`v4l2-selections-common`.
71		70
72
73	.. c:type:: v4l2_subdev_selection	71	.. c:type:: v4l2_subdev_selection
74		72
75	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|	73	.. tabularcolumns:: \|p{4.4cm}\|p{4.4cm}\|p{8.7cm}\|
@@ -100,7 +98,6 @@ Selection targets and flags are documented in · 24 unmodified lines
100	- Reserved for future extensions. Applications and drivers must set	98	- Reserved for future extensions. Applications and drivers must set
101	the array to zero.	99	the array to zero.
102		100
103
104	Return Value	101	Return Value
105	============	102	============
106		103

Documentation/userspace-api/media/v4l/vidioc-subdev-querycap.rst+4−5

 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+.. c:namespace:: V4L
 .. _VIDIOC_SUBDEV_QUERYCAP:
 VIDIOC_SUBDEV_QUERYCAP - Query sub-device capabilities
 Synopsis
 ========
-.. c:function:: int ioctl( int fd, VIDIOC_SUBDEV_QUERYCAP, struct v4l2_subdev_capability *argp )
+.. c:macro:: VIDIOC_SUBDEV_QUERYCAP
-    :name: VIDIOC_SUBDEV_QUERYCAP
+``int ioctl(int fd, VIDIOC_SUBDEV_QUERYCAP, struct v4l2_subdev_capability *argp)``
 Arguments
 =========
 ``fd``
-    File descriptor returned by :ref:`open() <func-open>`.
+    File descriptor returned by :c:func:`open()`.
 ``argp``
     Pointer to struct :c:type:`v4l2_subdev_capability`.
 Description
 ===========

Documentation/userspace-api/media/v4l/vidioc-subscribe-event.rst+7−10

@@ -1,4 +1,5 @@
1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later	1	.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
		2	.. c:namespace:: V4L
2		3
3	.. _VIDIOC_SUBSCRIBE_EVENT:	4	.. _VIDIOC_SUBSCRIBE_EVENT:
4	.. _VIDIOC_UNSUBSCRIBE_EVENT:	5	.. _VIDIOC_UNSUBSCRIBE_EVENT:
@@ -12,34 +13,32 @@ Name · 7 unmodified lines
12		13
13	VIDIOC_SUBSCRIBE_EVENT - VIDIOC_UNSUBSCRIBE_EVENT - Subscribe or unsubscribe event	14	VIDIOC_SUBSCRIBE_EVENT - VIDIOC_UNSUBSCRIBE_EVENT - Subscribe or unsubscribe event
14		15
15
16	Synopsis	16	Synopsis
17	========	17	========
18		18
19	.. c:function:: int ioctl( int fd, VIDIOC_SUBSCRIBE_EVENT, struct v4l2_event_subscription *argp )	19	.. c:macro:: VIDIOC_SUBSCRIBE_EVENT
20	:name: VIDIOC_SUBSCRIBE_EVENT	20
		21	``int ioctl(int fd, VIDIOC_SUBSCRIBE_EVENT, struct v4l2_event_subscription *argp)``
21		22
22	.. c:function:: int ioctl( int fd, VIDIOC_UNSUBSCRIBE_EVENT, struct v4l2_event_subscription *argp )	23	.. c:macro:: VIDIOC_UNSUBSCRIBE_EVENT
23	:name: VIDIOC_UNSUBSCRIBE_EVENT
24		24
		25	``int ioctl(int fd, VIDIOC_UNSUBSCRIBE_EVENT, struct v4l2_event_subscription *argp)``
25		26
26	Arguments	27	Arguments
27	=========	28	=========
28		29
29	``fd``	30	``fd``
30	File descriptor returned by :ref:`open() <func-open>`.	31	File descriptor returned by :c:func:`open()`.
31		32
32	``argp``	33	``argp``
33	Pointer to struct :c:type:`v4l2_event_subscription`.	34	Pointer to struct :c:type:`v4l2_event_subscription`.
34		35
35
36	Description	36	Description
37	===========	37	===========
38		38
39	Subscribe or unsubscribe V4L2 event. Subscribed events are dequeued by	39	Subscribe or unsubscribe V4L2 event. Subscribed events are dequeued by
40	using the :ref:`VIDIOC_DQEVENT` ioctl.	40	using the :ref:`VIDIOC_DQEVENT` ioctl.
41		41
42
43	.. tabularcolumns:: \|p{4.6cm}\|p{4.4cm}\|p{8.7cm}\|	42	.. tabularcolumns:: \|p{4.6cm}\|p{4.4cm}\|p{8.7cm}\|
44		43
45	.. c:type:: v4l2_event_subscription	44	.. c:type:: v4l2_event_subscription
@@ -72,7 +71,6 @@ using the :ref:`VIDIOC_DQEVENT` ioctl. · 26 unmodified lines
72	the array to zero.	71	the array to zero.
73		72
74		73
75
76	.. tabularcolumns:: \|p{6.8cm}\|p{2.2cm}\|p{8.5cm}\|	74	.. tabularcolumns:: \|p{6.8cm}\|p{2.2cm}\|p{8.5cm}\|
77		75
78	.. _event-flags:	76	.. _event-flags:
@@ -107,7 +105,6 @@ using the :ref:`VIDIOC_DQEVENT` ioctl. · 28 unmodified lines
107	Think carefully when you set this flag so you won't get into	105	Think carefully when you set this flag so you won't get into
108	situations like that.	106	situations like that.
109		107
110
111	Return Value	108	Return Value
112	============	109	============
113		110

Documentation/virt/uml/user_mode_linux_howto_v2.rst+1−0

@@ -679,6 +679,7 @@ Starting UML · 678 unmodified lines
679		679
680	We can now run UML.	680	We can now run UML.
681	::	681	::
		682
682	# linux mem=2048M umid=TEST \	683	# linux mem=2048M umid=TEST \
683	ubd0=Filesystem.img \	684	ubd0=Filesystem.img \
684	vec0:transport=tap,ifname=tap0,depth=128,gro=1 \	685	vec0:transport=tap,ifname=tap0,depth=128,gro=1 \

Documentation/vm/hmm.rst+1−1

@@ -360,7 +360,7 @@ between device driver specific code and shared common code: · 359 unmodified lines
360	system memory page, locks the page with ``lock_page()``, and fills in the	360	system memory page, locks the page with ``lock_page()``, and fills in the
361	``dst`` array entry with::	361	``dst`` array entry with::
362		362
363	dst[i] = migrate_pfn(page_to_pfn(dpage)) \| MIGRATE_PFN_LOCKED;	363	dst[i] = migrate_pfn(page_to_pfn(dpage)) \| MIGRATE_PFN_LOCKED;
364		364
365	Now that the driver knows that this page is being migrated, it can	365	Now that the driver knows that this page is being migrated, it can
366	invalidate device private MMU mappings and copy device private memory	366	invalidate device private MMU mappings and copy device private memory

Documentation/vm/ksm.rst+1−1

@@ -26,7 +26,7 @@ tree. · 25 unmodified lines
26		26
27	If a KSM page is shared between less than ``max_page_sharing`` VMAs,	27	If a KSM page is shared between less than ``max_page_sharing`` VMAs,
28	the node of the stable tree that represents such KSM page points to a	28	the node of the stable tree that represents such KSM page points to a
29	list of :c:type:`struct rmap_item` and the ``page->mapping`` of the	29	list of struct rmap_item and the ``page->mapping`` of the
30	KSM page points to the stable tree node.	30	KSM page points to the stable tree node.
31		31
32	When the sharing passes this threshold, KSM adds a second dimension to	32	When the sharing passes this threshold, KSM adds a second dimension to

Documentation/vm/memory-model.rst+3−3

MAINTAINERS+8−8

@@ -1500,7 +1500,7 @@ L: linux-arm-kernel@lists.infradead.org (moderated for non-subscribers) · 1499 unmodified lines
1500	S: Maintained	1500	S: Maintained
1501	F: Documentation/devicetree/bindings/arm/actions.yaml	1501	F: Documentation/devicetree/bindings/arm/actions.yaml
1502	F: Documentation/devicetree/bindings/clock/actions,owl-cmu.txt	1502	F: Documentation/devicetree/bindings/clock/actions,owl-cmu.txt
1503	F: Documentation/devicetree/bindings/dma/owl-dma.txt	1503	F: Documentation/devicetree/bindings/dma/owl-dma.yaml
1504	F: Documentation/devicetree/bindings/i2c/i2c-owl.txt	1504	F: Documentation/devicetree/bindings/i2c/i2c-owl.txt
1505	F: Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.yaml	1505	F: Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.yaml
1506	F: Documentation/devicetree/bindings/mmc/owl-mmc.yaml	1506	F: Documentation/devicetree/bindings/mmc/owl-mmc.yaml
@@ -5868,7 +5868,7 @@ L: linux-renesas-soc@vger.kernel.org · 4361 unmodified lines
5868	S: Supported	5868	S: Supported
5869	T: git git://linuxtv.org/pinchartl/media drm/du/next	5869	T: git git://linuxtv.org/pinchartl/media drm/du/next
5870	F: Documentation/devicetree/bindings/display/bridge/renesas,dw-hdmi.txt	5870	F: Documentation/devicetree/bindings/display/bridge/renesas,dw-hdmi.txt
5871	F: Documentation/devicetree/bindings/display/bridge/renesas,lvds.txt	5871	F: Documentation/devicetree/bindings/display/bridge/renesas,lvds.yaml
5872	F: Documentation/devicetree/bindings/display/renesas,du.txt	5872	F: Documentation/devicetree/bindings/display/renesas,du.txt
5873	F: drivers/gpu/drm/rcar-du/	5873	F: drivers/gpu/drm/rcar-du/
5874	F: drivers/gpu/drm/shmobile/	5874	F: drivers/gpu/drm/shmobile/
@@ -7000,7 +7000,7 @@ M: Frank Li <Frank.li@nxp.com> · 1125 unmodified lines
7000	L: linux-arm-kernel@lists.infradead.org	7000	L: linux-arm-kernel@lists.infradead.org
7001	S: Maintained	7001	S: Maintained
7002	F: Documentation/admin-guide/perf/imx-ddr.rst	7002	F: Documentation/admin-guide/perf/imx-ddr.rst
7003	F: Documentation/devicetree/bindings/perf/fsl-imx-ddr.txt	7003	F: Documentation/devicetree/bindings/perf/fsl-imx-ddr.yaml
7004	F: drivers/perf/fsl_imx8_ddr_perf.c	7004	F: drivers/perf/fsl_imx8_ddr_perf.c
7005		7005
7006	FREESCALE IMX I2C DRIVER	7006	FREESCALE IMX I2C DRIVER
@@ -7008,7 +7008,7 @@ M: Oleksij Rempel <o.rempel@pengutronix.de> · 1 unmodified line
7008	R: Pengutronix Kernel Team <kernel@pengutronix.de>	7008	R: Pengutronix Kernel Team <kernel@pengutronix.de>
7009	L: linux-i2c@vger.kernel.org	7009	L: linux-i2c@vger.kernel.org
7010	S: Maintained	7010	S: Maintained
7011	F: Documentation/devicetree/bindings/i2c/i2c-imx.txt	7011	F: Documentation/devicetree/bindings/i2c/i2c-imx.yaml
7012	F: drivers/i2c/busses/i2c-imx.c	7012	F: drivers/i2c/busses/i2c-imx.c
7013		7013
7014	FREESCALE IMX LPI2C DRIVER	7014	FREESCALE IMX LPI2C DRIVER
@@ -7016,7 +7016,7 @@ M: Dong Aisheng <aisheng.dong@nxp.com> · 1 unmodified line
7016	L: linux-i2c@vger.kernel.org	7016	L: linux-i2c@vger.kernel.org
7017	L: linux-imx@nxp.com	7017	L: linux-imx@nxp.com
7018	S: Maintained	7018	S: Maintained
7019	F: Documentation/devicetree/bindings/i2c/i2c-imx-lpi2c.txt	7019	F: Documentation/devicetree/bindings/i2c/i2c-imx-lpi2c.yaml
7020	F: drivers/i2c/busses/i2c-imx-lpi2c.c	7020	F: drivers/i2c/busses/i2c-imx-lpi2c.c
7021		7021
7022	FREESCALE QORIQ DPAA ETHERNET DRIVER	7022	FREESCALE QORIQ DPAA ETHERNET DRIVER
@@ -11677,7 +11677,7 @@ MIPS GENERIC PLATFORM · 4654 unmodified lines
11677	M: Paul Burton <paulburton@kernel.org>	11677	M: Paul Burton <paulburton@kernel.org>
11678	L: linux-mips@vger.kernel.org	11678	L: linux-mips@vger.kernel.org
11679	S: Supported	11679	S: Supported
11680	F: Documentation/devicetree/bindings/power/mti,mips-cpc.txt	11680	F: Documentation/devicetree/bindings/power/mti,mips-cpc.yaml
11681	F: arch/mips/generic/	11681	F: arch/mips/generic/
11682	F: arch/mips/tools/generic-board-config.sh	11682	F: arch/mips/tools/generic-board-config.sh
11683		11683
@@ -12568,7 +12568,7 @@ NXP SGTL5000 DRIVER · 884 unmodified lines
12568	M: Fabio Estevam <festevam@gmail.com>	12568	M: Fabio Estevam <festevam@gmail.com>
12569	L: alsa-devel@alsa-project.org (moderated for non-subscribers)	12569	L: alsa-devel@alsa-project.org (moderated for non-subscribers)
12570	S: Maintained	12570	S: Maintained
12571	F: Documentation/devicetree/bindings/sound/sgtl5000.txt	12571	F: Documentation/devicetree/bindings/sound/sgtl5000.yaml
12572	F: sound/soc/codecs/sgtl5000*	12572	F: sound/soc/codecs/sgtl5000*
12573		12573
12574	NXP SJA1105 ETHERNET SWITCH DRIVER	12574	NXP SJA1105 ETHERNET SWITCH DRIVER
@@ -16868,7 +16868,7 @@ SYNOPSYS DESIGNWARE DMAC DRIVER · 4293 unmodified lines
16868	M: Viresh Kumar <vireshk@kernel.org>	16868	M: Viresh Kumar <vireshk@kernel.org>
16869	R: Andy Shevchenko <andriy.shevchenko@linux.intel.com>	16869	R: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
16870	S: Maintained	16870	S: Maintained
16871	F: Documentation/devicetree/bindings/dma/snps-dma.txt	16871	F: Documentation/devicetree/bindings/dma/snps,dma-spear1340.yaml
16872	F: drivers/dma/dw/	16872	F: drivers/dma/dw/
16873	F: include/dt-bindings/dma/dw-dmac.h	16873	F: include/dt-bindings/dma/dw-dmac.h
16874	F: include/linux/dma/dw.h	16874	F: include/linux/dma/dw.h

block/bio.c+2−2

@@ -327,7 +327,7 @@ static void bio_chain_endio(struct bio *bio) · 326 unmodified lines
327	/**	327	/**
328	* bio_chain - chain bio completions	328	* bio_chain - chain bio completions
329	* @bio: the target bio	329	* @bio: the target bio
330	* @parent: the @bio's parent bio	330	* @parent: the parent bio of @bio
331	*	331	*
332	* The caller won't have a bi_end_io called when @bio completes - instead,	332	* The caller won't have a bi_end_io called when @bio completes - instead,
333	* @parent's bi_end_io won't be called until both @parent and @bio have	333	* @parent's bi_end_io won't be called until both @parent and @bio have
@@ -1093,7 +1093,7 @@ static int __bio_iov_append_get_pages(struct bio bio, struct iov_iter iter) · 759 unmodified lines
1093	* released.	1093	* released.
1094	*	1094	*
1095	* The function tries, but does not guarantee, to pin as many pages as	1095	* The function tries, but does not guarantee, to pin as many pages as
1096	* fit into the bio, or are requested in *iter, whatever is smaller. If	1096	* fit into the bio, or are requested in @iter, whatever is smaller. If
1097	* MM encounters an error pinning the requested pages, it stops. Error	1097	* MM encounters an error pinning the requested pages, it stops. Error
1098	* is returned only if 0 pages could be pinned.	1098	* is returned only if 0 pages could be pinned.
1099	*/	1099	*/

drivers/base/core.c+5−2

  * -EPROBE_DEFER and propagate error upwards.
  * In case of -EPROBE_DEFER it sets also defer probe reason, which can be
  * checked later by reading devices_deferred debugfs attribute.
- * It replaces code sequence:
+ * It replaces code sequence::
+ *
  * 	if (err != -EPROBE_DEFER)
  * 		dev_err(dev, ...);
  * 	else
  * 		dev_dbg(dev, ...);
  * 	return err;
- * with
+ *
+ * with::
+ *
  * 	return dev_err_probe(dev, err, ...);
  *
  * Returns @err.

drivers/net/appletalk/Kconfig+1−1

@@ -48,7 +48,7 @@ config LTPC · 47 unmodified lines
48	If you are in doubt, this card is the one with the 65C02 chip on it.	48	If you are in doubt, this card is the one with the 65C02 chip on it.
49	You also need version 1.3.3 or later of the netatalk package.	49	You also need version 1.3.3 or later of the netatalk package.
50	This driver is experimental, which means that it may not work.	50	This driver is experimental, which means that it may not work.
51	See the file <file:Documentation/networking/ltpc.rst>.	51	See the file <file:Documentation/networking/device_drivers/appletalk/ltpc.rst>.
52		52
53	config COPS	53	config COPS
54	tristate "COPS LocalTalk PC support"	54	tristate "COPS LocalTalk PC support"

drivers/net/hamradio/scc.c+1−1

@@ -7,7 +7,7 @@ · 6 unmodified lines
7	* ------------------	7	* ------------------
8	*	8	*
9	* You can find a subset of the documentation in	9	* You can find a subset of the documentation in
10	* Documentation/networking/device_drivers/wan/z8530drv.rst.	10	* Documentation/networking/device_drivers/hamradio/z8530drv.rst.
11	*/	11	*/
12		12
13	/*	13	/*

include/kunit/test.h+9−5

 /**
  * struct kunit_resource - represents a *test managed resource*
  * @data: for the user to store arbitrary data.
+ * @name: optional name
  * @free: a user supplied function to free the resource. Populated by
  * kunit_resource_alloc().
  *
  */
 struct kunit_resource {
 	void *data;
-	const char *name;		/* optional name */
+	const char *name;
+	kunit_resource_free_t free;
 	/* private: internal use only. */
-	kunit_resource_free_t free;
 	struct kref refcount;
 	struct list_head node;
 };
  *        none is supplied, the resource data value is simply set to @data.
  *	  If an init function is supplied, @data is passed to it instead.
  * @free: a user-supplied function to free the resource (if needed).
+ * @res: The resource.
  * @data: value to pass to init function or set in resource data field.
  */
 int kunit_add_resource(struct kunit *test,
  * @test: The test context object.
  * @init: a user-supplied function to initialize the resource data, if needed.
  * @free: a user-supplied function to free the resource data, if needed.
- * @name_data: name and data to be set for resource.
+ * @res: The resource.
+ * @name: name to be set for resource.
+ * @data: value to pass to init function or set in resource data field.
  */
 int kunit_add_named_resource(struct kunit *test,
 			     kunit_resource_init_t init,
 }
 /**
- * kunit_remove_resource: remove resource from resource list associated with
+ * kunit_remove_resource() - remove resource from resource list associated with
- *			  test.
+ *			     test.
  * @test: The test context object.
  * @res: The resource to be removed.
  *

include/linux/devfreq.h+1−6

 void devfreq_suspend(void);
 void devfreq_resume(void);
-/**
+/* update_devfreq() - Reevaluate the device and configure frequency */
- * update_devfreq() - Reevaluate the device and configure frequency
- * @devfreq:	the devfreq device
- *
- * Note: devfreq->lock must be held
- */
 int update_devfreq(struct devfreq *devfreq);
 /* Helper functions for devfreq user device driver with OPP. */

include/linux/input/sparse-keymap.h+1−0

@@ -20,6 +20,7 @@ · 19 unmodified lines
20	* private definitions.	20	* private definitions.
21	* @code: Device-specific data identifying the button/switch	21	* @code: Device-specific data identifying the button/switch
22	* @keycode: KEY_* code assigned to a key/button	22	* @keycode: KEY_* code assigned to a key/button
		23	* @sw: struct with code/value used by KE_SW and KE_VSW
23	* @sw.code: SW_* code assigned to a switch	24	* @sw.code: SW_* code assigned to a switch
24	* @sw.value: Value that should be sent in an input even when KE_SW	25	* @sw.value: Value that should be sent in an input even when KE_SW
25	* switch is toggled. KE_VSW switches ignore this field and	26	* switch is toggled. KE_VSW switches ignore this field and

include/linux/math64.h+4−4

include/linux/usb/typec_altmode.h+16−0

@@ -152,10 +152,26 @@ struct typec_altmode_driver { · 151 unmodified lines
152	#define to_altmode_driver(d) container_of(d, struct typec_altmode_driver, \	152	#define to_altmode_driver(d) container_of(d, struct typec_altmode_driver, \
153	driver)	153	driver)
154		154
		155	/**
		156	* typec_altmode_register_driver - registers a USB Type-C alternate mode
		157	* device driver
		158	* @drv: pointer to struct typec_altmode_driver
		159	*
		160	* These drivers will be bind to the partner alternate mode devices. They will
		161	* handle all SVID specific communication.
		162	*/
155	#define typec_altmode_register_driver(drv) \	163	#define typec_altmode_register_driver(drv) \
156	__typec_altmode_register_driver(drv, THIS_MODULE)	164	__typec_altmode_register_driver(drv, THIS_MODULE)
157	int __typec_altmode_register_driver(struct typec_altmode_driver *drv,	165	int __typec_altmode_register_driver(struct typec_altmode_driver *drv,
158	struct module *module);	166	struct module *module);
		167	/**
		168	* typec_altmode_unregister_driver - unregisters a USB Type-C alternate mode
		169	* device driver
		170	* @drv: pointer to struct typec_altmode_driver
		171	*
		172	* These drivers will be bind to the partner alternate mode devices. They will
		173	* handle all SVID specific communication.
		174	*/
159	void typec_altmode_unregister_driver(struct typec_altmode_driver *drv);	175	void typec_altmode_unregister_driver(struct typec_altmode_driver *drv);
160		176
161	#define module_typec_altmode_driver(__typec_altmode_driver) \	177	#define module_typec_altmode_driver(__typec_altmode_driver) \

include/net/cfg80211.h+1−0

@@ -474,6 +474,7 @@ struct ieee80211_sta_s1g_cap { · 473 unmodified lines
474	* @n_bitrates: Number of bitrates in @bitrates	474	* @n_bitrates: Number of bitrates in @bitrates
475	* @ht_cap: HT capabilities in this band	475	* @ht_cap: HT capabilities in this band
476	* @vht_cap: VHT capabilities in this band	476	* @vht_cap: VHT capabilities in this band
		477	* @s1g_cap: S1G capabilities in this band
477	* @edmg_cap: EDMG capabilities in this band	478	* @edmg_cap: EDMG capabilities in this band
478	* @s1g_cap: S1G capabilities in this band (S1B band only, of course)	479	* @s1g_cap: S1G capabilities in this band (S1B band only, of course)
479	* @n_iftype_data: number of iftype data entries	480	* @n_iftype_data: number of iftype data entries

kernel/rcu/tree.c+6−8

  * @monitor_todo: Tracks whether a @monitor_work delayed work is pending
  * @initialized: The @rcu_work fields have been initialized
  * @count: Number of objects for which GP not started
+ * @bkvcache:
+ *	A simple cache list that contains objects for reuse purpose.
+ *	In order to save some per-cpu space the list is singular.
+ *	Even though it is lockless an access has to be protected by the
+ *	per-cpu lock.
+ * @nr_bkv_objs: number of allocated objects at @bkvcache.
  *
  * This is a per-CPU structure.  The reason that it is not included in
  * the rcu_data structure is to permit this code to be extracted from
 	bool monitor_todo;
 	bool initialized;
 	int count;
-	/*
-	 * A simple cache list that contains objects for
-	 * reuse purpose. In order to save some per-cpu
-	 * space the list is singular. Even though it is
-	 * lockless an access has to be protected by the
-	 * per-cpu lock.
-	 */
 	struct llist_head bkvcache;
 	int nr_bkv_objs;
 };

kernel/workqueue.c+3−0

  * stable state - idle, on timer or on worklist.
  *
  * Return:
+ *
+ *  ========	================================================================
  *  1		if @work was pending and we successfully stole PENDING
  *  0		if @work was idle and we claimed PENDING
  *  -EAGAIN	if PENDING couldn't be grabbed at the moment, safe to busy-retry
  *  -ENOENT	if someone else is canceling @work, this state may persist
  *		for arbitrarily long
+ *  ========	================================================================
  *
  * Note:
  * On >= 0 return, the caller owns @work's PENDING bit.  To avoid getting

mm/ksm.c+1−1

@@ -81,7 +81,7 @@ · 80 unmodified lines
81	* different KSM page copy of that content	81	* different KSM page copy of that content
82	*	82	*
83	* Internally, the regular nodes, "dups" and "chains" are represented	83	* Internally, the regular nodes, "dups" and "chains" are represented
84	* using the same :c:type:`struct stable_node` structure.	84	* using the same struct stable_node structure.
85	*	85	*
86	* In addition to the stable tree, KSM uses a second data structure called the	86	* In addition to the stable tree, KSM uses a second data structure called the
87	* unstable tree: this tree holds pointers to pages which have been found to	87	* unstable tree: this tree holds pointers to pages which have been found to

mm/memblock.c+4−4

@@ -48,12 +48,12 @@ · 47 unmodified lines
48	* boot regardless of the possible restrictions and memory hot(un)plug;	48	* boot regardless of the possible restrictions and memory hot(un)plug;
49	* the ``physmem`` type is only available on some architectures.	49	* the ``physmem`` type is only available on some architectures.
50	*	50	*
51	* Each region is represented by :c:type:`struct memblock_region` that	51	* Each region is represented by struct memblock_region that
52	* defines the region extents, its attributes and NUMA node id on NUMA	52	* defines the region extents, its attributes and NUMA node id on NUMA
53	* systems. Every memory type is described by the :c:type:`struct	53	* systems. Every memory type is described by the struct memblock_type
54	* memblock_type` which contains an array of memory regions along with	54	* which contains an array of memory regions along with
55	* the allocator metadata. The "memory" and "reserved" types are nicely	55	* the allocator metadata. The "memory" and "reserved" types are nicely
56	* wrapped with :c:type:`struct memblock`. This structure is statically	56	* wrapped with struct memblock. This structure is statically
57	* initialized at build time. The region arrays are initially sized to	57	* initialized at build time. The region arrays are initially sized to
58	* %INIT_MEMBLOCK_REGIONS for "memory" and %INIT_MEMBLOCK_RESERVED_REGIONS	58	* %INIT_MEMBLOCK_REGIONS for "memory" and %INIT_MEMBLOCK_RESERVED_REGIONS
59	* for "reserved". The region array for "physmem" is initially sized to	59	* for "reserved". The region array for "physmem" is initially sized to

scripts/kernel-doc+223−82

@@ -56,6 +56,13 @@ Output format selection (mutually exclusive): · 55 unmodified lines
56	-rst Output reStructuredText format.	56	-rst Output reStructuredText format.
57	-none Do not output documentation, only warnings.	57	-none Do not output documentation, only warnings.
58		58
		59	Output format selection modifier (affects only ReST output):
		60
		61	-sphinx-version Use the ReST C domain dialect compatible with an
		62	specific Sphinx Version.
		63	If not specified, kernel-doc will auto-detect using
		64	the sphinx-build version found on PATH.
		65
59	Output selection (mutually exclusive):	66	Output selection (mutually exclusive):
60	-export Only output documentation for symbols that have been	67	-export Only output documentation for symbols that have been
61	exported using EXPORT_SYMBOL() or EXPORT_SYMBOL_GPL()	68	exported using EXPORT_SYMBOL() or EXPORT_SYMBOL_GPL()
@@ -66,9 +73,8 @@ Output selection (mutually exclusive): · 4 unmodified lines
66	-function NAME Only output documentation for the given function(s)	73	-function NAME Only output documentation for the given function(s)
67	or DOC: section title(s). All other functions and DOC:	74	or DOC: section title(s). All other functions and DOC:
68	sections are ignored. May be specified multiple times.	75	sections are ignored. May be specified multiple times.
69	-nofunction NAME Do NOT output documentation for the given function(s);	76	-nosymbol NAME Exclude the specified symbols from the output
70	only output documentation for the other functions and	77	documentation. May be specified multiple times.
71	DOC: sections. May be specified multiple times.
72		78
73	Output selection modifiers:	79	Output selection modifiers:
74	-no-doc-sections Do not output DOC: sections.	80	-no-doc-sections Do not output DOC: sections.
@@ -271,6 +277,8 @@ if ($#ARGV == -1) { · 196 unmodified lines
271	}	277	}
272		278
273	my $kernelversion;	279	my $kernelversion;
		280	my ($sphinx_major, $sphinx_minor, $sphinx_patch);
		281
274	my $dohighlight = "";	282	my $dohighlight = "";
275		283
276	my $verbose = 0;	284	my $verbose = 0;
@@ -286,9 +294,8 @@ my $modulename = "Kernel API"; · 9 unmodified lines
286	use constant {	294	use constant {
287	OUTPUT_ALL => 0, # output all symbols and doc sections	295	OUTPUT_ALL => 0, # output all symbols and doc sections
288	OUTPUT_INCLUDE => 1, # output only specified symbols	296	OUTPUT_INCLUDE => 1, # output only specified symbols
289	OUTPUT_EXCLUDE => 2, # output everything except specified symbols	297	OUTPUT_EXPORTED => 2, # output exported symbols
290	OUTPUT_EXPORTED => 3, # output exported symbols	298	OUTPUT_INTERNAL => 3, # output non-exported symbols
291	OUTPUT_INTERNAL => 4, # output non-exported symbols
292	};	299	};
293	my $output_selection = OUTPUT_ALL;	300	my $output_selection = OUTPUT_ALL;
294	my $show_not_found = 0; # No longer used	301	my $show_not_found = 0; # No longer used
@@ -313,6 +320,7 @@ my $man_date = ('January', 'February', 'March', 'April', 'May', 'June', · 18 unmodified lines
313	# CAVEAT EMPTOR! Some of the others I localised may not want to be, which	320	# CAVEAT EMPTOR! Some of the others I localised may not want to be, which
314	# could cause "use of undefined value" or other bugs.	321	# could cause "use of undefined value" or other bugs.
315	my ($function, %function_table, %parametertypes, $declaration_purpose);	322	my ($function, %function_table, %parametertypes, $declaration_purpose);
		323	my %nosymbol_table = ();
316	my $declaration_start_line;	324	my $declaration_start_line;
317	my ($type, $declaration_name, $return_type);	325	my ($type, $declaration_name, $return_type);
318	my ($newsection, $newcontents, $prototype, $brcount, %source_map);	326	my ($newsection, $newcontents, $prototype, $brcount, %source_map);
@@ -432,10 +440,9 @@ while ($ARGV[0] =~ m/^--?(.*)/) { · 113 unmodified lines
432	$output_selection = OUTPUT_INCLUDE;	440	$output_selection = OUTPUT_INCLUDE;
433	$function = shift @ARGV;	441	$function = shift @ARGV;
434	$function_table{$function} = 1;	442	$function_table{$function} = 1;
435	} elsif ($cmd eq "nofunction") { # output all except specific functions	443	} elsif ($cmd eq "nosymbol") { # Exclude specific symbols
436	$output_selection = OUTPUT_EXCLUDE;	444	my $symbol = shift @ARGV;
437	$function = shift @ARGV;	445	$nosymbol_table{$symbol} = 1;
438	$function_table{$function} = 1;
439	} elsif ($cmd eq "export") { # only exported symbols	446	} elsif ($cmd eq "export") { # only exported symbols
440	$output_selection = OUTPUT_EXPORTED;	447	$output_selection = OUTPUT_EXPORTED;
441	%function_table = ();	448	%function_table = ();
@@ -457,6 +464,23 @@ while ($ARGV[0] =~ m/^--?(.*)/) { · 15 unmodified lines
457	$enable_lineno = 1;	464	$enable_lineno = 1;
458	} elsif ($cmd eq 'show-not-found') {	465	} elsif ($cmd eq 'show-not-found') {
459	$show_not_found = 1; # A no-op but don't fail	466	$show_not_found = 1; # A no-op but don't fail
		467	} elsif ($cmd eq "sphinx-version") {
		468	my $ver_string = shift @ARGV;
		469	if ($ver_string =~ m/^(\d+)(\.\d+)?(\.\d+)?/) {
		470	$sphinx_major = $1;
		471	if (defined($2)) {
		472	$sphinx_minor = substr($2,1);
		473	} else {
		474	$sphinx_minor = 0;
		475	}
		476	if (defined($3)) {
		477	$sphinx_patch = substr($3,1)
		478	} else {
		479	$sphinx_patch = 0;
		480	}
		481	} else {
		482	die "Sphinx version should either major.minor or major.minor.patch format\n";
		483	}
460	} else {	484	} else {
461	# Unknown argument	485	# Unknown argument
462	usage();	486	usage();
@@ -465,6 +489,51 @@ while ($ARGV[0] =~ m/^--?(.*)/) { · 2 unmodified lines
465		489
466	# continue execution near EOF;	490	# continue execution near EOF;
467		491
		492	# The C domain dialect changed on Sphinx 3. So, we need to check the
		493	# version in order to produce the right tags.
		494	sub findprog($)
		495	{
		496	foreach(split(/:/, $ENV{PATH})) {
		497	return "$_/$_[0]" if(-x "$_/$_[0]");
		498	}
		499	}
		500
		501	sub get_sphinx_version()
		502	{
		503	my $ver;
		504
		505	my $cmd = "sphinx-build";
		506	if (!findprog($cmd)) {
		507	my $cmd = "sphinx-build3";
		508	if (!findprog($cmd)) {
		509	$sphinx_major = 1;
		510	$sphinx_minor = 2;
		511	$sphinx_patch = 0;
		512	printf STDERR "Warning: Sphinx version not found. Using default (Sphinx version %d.%d.%d)\n",
		513	$sphinx_major, $sphinx_minor, $sphinx_patch;
		514	return;
		515	}
		516	}
		517
		518	open IN, "$cmd --version 2>&1 \|";
		519	while (<IN>) {
		520	if (m/^\s*sphinx-build\s+([\d]+)\.([\d\.]+)(\+\/[\da-f]+)?$/) {
		521	$sphinx_major = $1;
		522	$sphinx_minor = $2;
		523	$sphinx_patch = $3;
		524	last;
		525	}
		526	# Sphinx 1.2.x uses a different format
		527	if (m/^\sSphinx.\s+([\d]+)\.([\d\.]+)$/) {
		528	$sphinx_major = $1;
		529	$sphinx_minor = $2;
		530	$sphinx_patch = $3;
		531	last;
		532	}
		533	}
		534	close IN;
		535	}
		536
468	# get kernel version from env	537	# get kernel version from env
469	sub get_kernel_version() {	538	sub get_kernel_version() {
470	my $version = 'unknown kernel version';	539	my $version = 'unknown kernel version';
@@ -531,11 +600,11 @@ sub dump_doc_section { · 60 unmodified lines
531	return;	600	return;
532	}	601	}
533		602
		603	return if (defined($nosymbol_table{$name}));
		604
534	if (($output_selection == OUTPUT_ALL) \|\|	605	if (($output_selection == OUTPUT_ALL) \|\|
535	($output_selection == OUTPUT_INCLUDE &&	606	(($output_selection == OUTPUT_INCLUDE) &&
536	defined($function_table{$name})) \|\|	607	defined($function_table{$name})))
537	($output_selection == OUTPUT_EXCLUDE &&
538	!defined($function_table{$name})))
539	{	608	{
540	dump_section($file, $name, $contents);	609	dump_section($file, $name, $contents);
541	output_blockhead({'sectionlist' => \@sectionlist,	610	output_blockhead({'sectionlist' => \@sectionlist,
@@ -618,10 +687,10 @@ sub output_function_man(%) { · 76 unmodified lines
618	$type = $args{'parametertypes'}{$parameter};	687	$type = $args{'parametertypes'}{$parameter};
619	if ($type =~ m/([^$]\(\)\s$\s$([^$]*)\)/) {	688	if ($type =~ m/([^$]\(\)\s$\s$([^$]*)\)/) {
620	# pointer-to-function	689	# pointer-to-function
621	print ".BI \"" . $parenth . $1 . "\" " . $parameter . " \") (" . $2 . ")" . $post . "\"\n";	690	print ".BI \"" . $parenth . $1 . "\" " . " \") (" . $2 . ")" . $post . "\"\n";
622	} else {	691	} else {
623	$type =~ s/([^\*])$/$1 /;	692	$type =~ s/([^\*])$/$1 /;
624	print ".BI \"" . $parenth . $type . "\" " . $parameter . " \"" . $post . "\"\n";	693	print ".BI \"" . $parenth . $type . "\" " . " \"" . $post . "\"\n";
625	}	694	}
626	$count++;	695	$count++;
627	$parenth = "";	696	$parenth = "";
@@ -761,6 +830,8 @@ sub output_blockhead_rst(%) { · 133 unmodified lines
761	my ($parameter, $section);	830	my ($parameter, $section);
762		831
763	foreach $section (@{$args{'sectionlist'}}) {	832	foreach $section (@{$args{'sectionlist'}}) {
		833	next if (defined($nosymbol_table{$section}));
		834
764	if ($output_selection != OUTPUT_INCLUDE) {	835	if ($output_selection != OUTPUT_INCLUDE) {
765	print "$section\n\n";	836	print "$section\n\n";
766	}	837	}
@@ -846,16 +917,37 @@ sub output_function_rst(%) { · 79 unmodified lines
846	my ($parameter, $section);	917	my ($parameter, $section);
847	my $oldprefix = $lineprefix;	918	my $oldprefix = $lineprefix;
848	my $start = "";	919	my $start = "";
849		920	my $is_macro = 0;
850	if ($args{'typedef'}) {	921
851	print ".. c:type:: ". $args{'function'} . "\n\n";	922	if ($sphinx_major < 3) {
852	print_lineno($declaration_start_line);	923	if ($args{'typedef'}) {
853	print " Typedef: ";	924	print ".. c:type:: ". $args{'function'} . "\n\n";
854	$lineprefix = "";	925	print_lineno($declaration_start_line);
855	output_highlight_rst($args{'purpose'});	926	print " Typedef: ";
856	$start = "\n\nSyntax\n\n ``";	927	$lineprefix = "";
		928	output_highlight_rst($args{'purpose'});
		929	$start = "\n\nSyntax\n\n ``";
		930	$is_macro = 1;
		931	} else {
		932	print ".. c:function:: ";
		933	}
857	} else {	934	} else {
858	print ".. c:function:: ";	935	if ($args{'typedef'} \|\| $args{'functiontype'} eq "") {
		936	$is_macro = 1;
		937	print ".. c:macro:: ". $args{'function'} . "\n\n";
		938	} else {
		939	print ".. c:function:: ";
		940	}
		941
		942	if ($args{'typedef'}) {
		943	print_lineno($declaration_start_line);
		944	print " Typedef: ";
		945	$lineprefix = "";
		946	output_highlight_rst($args{'purpose'});
		947	$start = "\n\nSyntax\n\n ``";
		948	} else {
		949	print "``" if ($is_macro);
		950	}
859	}	951	}
860	if ($args{'functiontype'} ne "") {	952	if ($args{'functiontype'} ne "") {
861	$start .= $args{'functiontype'} . " " . $args{'function'} . " (";	953	$start .= $args{'functiontype'} . " " . $args{'function'} . " (";
@@ -876,13 +968,15 @@ sub output_function_rst(%) { · 14 unmodified lines
876	# pointer-to-function	968	# pointer-to-function
877	print $1 . $parameter . ") (" . $2 . ")";	969	print $1 . $parameter . ") (" . $2 . ")";
878	} else {	970	} else {
879	print $type . " " . $parameter;	971	print $type;
880	}	972	}
881	}	973	}
882	if ($args{'typedef'}) {	974	if ($is_macro) {
883	print ");``\n\n";	975	print ")``\n\n";
884	} else {	976	} else {
885	print ")\n\n";	977	print ")\n\n";
		978	}
		979	if (!$args{'typedef'}) {
886	print_lineno($declaration_start_line);	980	print_lineno($declaration_start_line);
887	$lineprefix = " ";	981	$lineprefix = " ";
888	output_highlight_rst($args{'purpose'});	982	output_highlight_rst($args{'purpose'});
@@ -897,7 +991,7 @@ sub output_function_rst(%) { · 8 unmodified lines
897	$type = $args{'parametertypes'}{$parameter};	991	$type = $args{'parametertypes'}{$parameter};
898		992
899	if ($type ne "") {	993	if ($type ne "") {
900	print "``$type $parameter``\n";	994	print "``$type``\n";
901	} else {	995	} else {
902	print "``$parameter``\n";	996	print "``$parameter``\n";
903	}	997	}
@@ -938,9 +1032,14 @@ sub output_enum_rst(%) { · 34 unmodified lines
938	my ($parameter);	1032	my ($parameter);
939	my $oldprefix = $lineprefix;	1033	my $oldprefix = $lineprefix;
940	my $count;	1034	my $count;
941	my $name = "enum " . $args{'enum'};
942		1035
943	print "\n\n.. c:type:: " . $name . "\n\n";	1036	if ($sphinx_major < 3) {
		1037	my $name = "enum " . $args{'enum'};
		1038	print "\n\n.. c:type:: " . $name . "\n\n";
		1039	} else {
		1040	my $name = $args{'enum'};
		1041	print "\n\n.. c:enum:: " . $name . "\n\n";
		1042	}
944	print_lineno($declaration_start_line);	1043	print_lineno($declaration_start_line);
945	$lineprefix = " ";	1044	$lineprefix = " ";
946	output_highlight_rst($args{'purpose'});	1045	output_highlight_rst($args{'purpose'});
@@ -966,8 +1065,13 @@ sub output_typedef_rst(%) { · 19 unmodified lines
966	my %args = %{$_[0]};	1065	my %args = %{$_[0]};
967	my ($parameter);	1066	my ($parameter);
968	my $oldprefix = $lineprefix;	1067	my $oldprefix = $lineprefix;
969	my $name = "typedef " . $args{'typedef'};	1068	my $name;
970		1069
		1070	if ($sphinx_major < 3) {
		1071	$name = "typedef " . $args{'typedef'};
		1072	} else {
		1073	$name = $args{'typedef'};
		1074	}
971	print "\n\n.. c:type:: " . $name . "\n\n";	1075	print "\n\n.. c:type:: " . $name . "\n\n";
972	print_lineno($declaration_start_line);	1076	print_lineno($declaration_start_line);
973	$lineprefix = " ";	1077	$lineprefix = " ";
@@ -982,9 +1086,14 @@ sub output_struct_rst(%) { · 8 unmodified lines
982	my %args = %{$_[0]};	1086	my %args = %{$_[0]};
983	my ($parameter);	1087	my ($parameter);
984	my $oldprefix = $lineprefix;	1088	my $oldprefix = $lineprefix;
985	my $name = $args{'type'} . " " . $args{'struct'};
986		1089
987	print "\n\n.. c:type:: " . $name . "\n\n";	1090	if ($sphinx_major < 3) {
		1091	my $name = $args{'type'} . " " . $args{'struct'};
		1092	print "\n\n.. c:type:: " . $name . "\n\n";
		1093	} else {
		1094	my $name = $args{'struct'};
		1095	print "\n\n.. c:struct:: " . $name . "\n\n";
		1096	}
988	print_lineno($declaration_start_line);	1097	print_lineno($declaration_start_line);
989	$lineprefix = " ";	1098	$lineprefix = " ";
990	output_highlight_rst($args{'purpose'});	1099	output_highlight_rst($args{'purpose'});
@@ -1043,12 +1152,14 @@ sub output_declaration { · 52 unmodified lines
1043	my $name = shift;	1152	my $name = shift;
1044	my $functype = shift;	1153	my $functype = shift;
1045	my $func = "output_${functype}_$output_mode";	1154	my $func = "output_${functype}_$output_mode";
		1155
		1156	return if (defined($nosymbol_table{$name}));
		1157
1046	if (($output_selection == OUTPUT_ALL) \|\|	1158	if (($output_selection == OUTPUT_ALL) \|\|
1047	(($output_selection == OUTPUT_INCLUDE \|\|	1159	(($output_selection == OUTPUT_INCLUDE \|\|
1048	$output_selection == OUTPUT_EXPORTED) &&	1160	$output_selection == OUTPUT_EXPORTED) &&
1049	defined($function_table{$name})) \|\|	1161	defined($function_table{$name})) \|\|
1050	(($output_selection == OUTPUT_EXCLUDE \|\|	1162	($output_selection == OUTPUT_INTERNAL &&
1051	$output_selection == OUTPUT_INTERNAL) &&
1052	!($functype eq "function" && defined($function_table{$name}))))	1163	!($functype eq "function" && defined($function_table{$name}))))
1053	{	1164	{
1054	&$func(@_);	1165	&$func(@_);
@@ -1229,6 +1340,8 @@ sub show_warnings($$) { · 174 unmodified lines
1229	my $functype = shift;	1340	my $functype = shift;
1230	my $name = shift;	1341	my $name = shift;
1231		1342
		1343	return 0 if (defined($nosymbol_table{$name}));
		1344
1232	return 1 if ($output_selection == OUTPUT_ALL);	1345	return 1 if ($output_selection == OUTPUT_ALL);
1233		1346
1234	if ($output_selection == OUTPUT_EXPORTED) {	1347	if ($output_selection == OUTPUT_EXPORTED) {
@@ -1252,27 +1365,28 @@ sub show_warnings($$) { · 17 unmodified lines
1252	return 0;	1365	return 0;
1253	}	1366	}
1254	}	1367	}
1255	if ($output_selection == OUTPUT_EXCLUDE) {
1256	if (!defined($function_table{$name})) {
1257	return 1;
1258	} else {
1259	return 0;
1260	}
1261	}
1262	die("Please add the new output type at show_warnings()");	1368	die("Please add the new output type at show_warnings()");
1263	}	1369	}
1264		1370
1265	sub dump_enum($$) {	1371	sub dump_enum($$) {
1266	my $x = shift;	1372	my $x = shift;
1267	my $file = shift;	1373	my $file = shift;
		1374	my $members;
		1375
1268		1376
1269	$x =~ s@/\.?\*/@@gos; # strip comments.	1377	$x =~ s@/\.?\*/@@gos; # strip comments.
1270	# strip #define macros inside enums	1378	# strip #define macros inside enums
1271	$x =~ s@#\s((define\|ifdef)\s+\|endif)[^;];@@gos;	1379	$x =~ s@#\s((define\|ifdef)\s+\|endif)[^;];@@gos;
1272		1380
1273	if ($x =~ /enum\s+(\w)\s\{(.*)\}/) {	1381	if ($x =~ /typedef\s+enum\s\{(.)\}\s(\w)\s*;/) {
		1382	$declaration_name = $2;
		1383	$members = $1;
		1384	} elsif ($x =~ /enum\s+(\w)\s\{(.*)\}/) {
1274	$declaration_name = $1;	1385	$declaration_name = $1;
1275	my $members = $2;	1386	$members = $2;
		1387	}
		1388
		1389	if ($declaration_name) {
1276	my %_members;	1390	my %_members;
1277		1391
1278	$members =~ s/\s+$//;	1392	$members =~ s/\s+$//;
@@ -1307,8 +1421,7 @@ sub dump_enum($$) { · 28 unmodified lines
1307	'sections' => \%sections,	1421	'sections' => \%sections,
1308	'purpose' => $declaration_purpose	1422	'purpose' => $declaration_purpose
1309	});	1423	});
1310	}	1424	} else {
1311	else {
1312	print STDERR "${file}:$.: error: Cannot parse enum!\n";	1425	print STDERR "${file}:$.: error: Cannot parse enum!\n";
1313	++$errors;	1426	++$errors;
1314	}	1427	}
@@ -1403,7 +1516,7 @@ sub create_parameterlist($$$$) { · 88 unmodified lines
1403	# Treat preprocessor directive as a typeless variable just to fill	1516	# Treat preprocessor directive as a typeless variable just to fill
1404	# corresponding data structures "correctly". Catch it later in	1517	# corresponding data structures "correctly". Catch it later in
1405	# output_* subs.	1518	# output_* subs.
1406	push_parameter($arg, "", $file);	1519	push_parameter($arg, "", "", $file);
1407	} elsif ($arg =~ m/$.+$\s*\(/) {	1520	} elsif ($arg =~ m/$.+$\s*\(/) {
1408	# pointer-to-function	1521	# pointer-to-function
1409	$arg =~ tr/#/,/;	1522	$arg =~ tr/#/,/;
@@ -1412,7 +1525,7 @@ sub create_parameterlist($$$$) { · 2 unmodified lines
1412	$type = $arg;	1525	$type = $arg;
1413	$type =~ s/([^\(]+\(\?)\s$param/$1/;	1526	$type =~ s/([^\(]+\(\?)\s$param/$1/;
1414	save_struct_actual($param);	1527	save_struct_actual($param);
1415	push_parameter($param, $type, $file, $declaration_name);	1528	push_parameter($param, $type, $arg, $file, $declaration_name);
1416	} elsif ($arg) {	1529	} elsif ($arg) {
1417	$arg =~ s/\s:\s/:/g;	1530	$arg =~ s/\s:\s/:/g;
1418	$arg =~ s/\s*\[/\[/g;	1531	$arg =~ s/\s*\[/\[/g;
@@ -1437,26 +1550,28 @@ sub create_parameterlist($$$$) { · 18 unmodified lines
1437	foreach $param (@args) {	1550	foreach $param (@args) {
1438	if ($param =~ m/^(\+)\s(.*)/) {	1551	if ($param =~ m/^(\+)\s(.*)/) {
1439	save_struct_actual($2);	1552	save_struct_actual($2);
1440	push_parameter($2, "$type $1", $file, $declaration_name);	1553
		1554	push_parameter($2, "$type $1", $arg, $file, $declaration_name);
1441	}	1555	}
1442	elsif ($param =~ m/(.*?):(\d+)/) {	1556	elsif ($param =~ m/(.*?):(\d+)/) {
1443	if ($type ne "") { # skip unnamed bit-fields	1557	if ($type ne "") { # skip unnamed bit-fields
1444	save_struct_actual($1);	1558	save_struct_actual($1);
1445	push_parameter($1, "$type:$2", $file, $declaration_name)	1559	push_parameter($1, "$type:$2", $arg, $file, $declaration_name)
1446	}	1560	}
1447	}	1561	}
1448	else {	1562	else {
1449	save_struct_actual($param);	1563	save_struct_actual($param);
1450	push_parameter($param, $type, $file, $declaration_name);	1564	push_parameter($param, $type, $arg, $file, $declaration_name);
1451	}	1565	}
1452	}	1566	}
1453	}	1567	}
1454	}	1568	}
1455	}	1569	}
1456		1570
1457	sub push_parameter($$$$) {	1571	sub push_parameter($$$$$) {
1458	my $param = shift;	1572	my $param = shift;
1459	my $type = shift;	1573	my $type = shift;
		1574	my $org_arg = shift;
1460	my $file = shift;	1575	my $file = shift;
1461	my $declaration_name = shift;	1576	my $declaration_name = shift;
1462		1577
@@ -1520,8 +1635,8 @@ sub push_parameter($$$$) { · 57 unmodified lines
1520	# "[blah" in a parameter string;	1635	# "[blah" in a parameter string;
1521	###$param =~ s/\s*//g;	1636	###$param =~ s/\s*//g;
1522	push @parameterlist, $param;	1637	push @parameterlist, $param;
1523	$type =~ s/\s\s+/ /g;	1638	$org_arg =~ s/\s\s+/ /g;
1524	$parametertypes{$param} = $type;	1639	$parametertypes{$param} = $org_arg;
1525	}	1640	}
1526		1641
1527	sub check_sections($$$$$) {	1642	sub check_sections($$$$$) {
@@ -1595,7 +1710,7 @@ sub dump_function($$) { · 67 unmodified lines
1595	my $file = shift;	1710	my $file = shift;
1596	my $noret = 0;	1711	my $noret = 0;
1597		1712
1598	print_lineno($.);	1713	print_lineno($new_start_line);
1599		1714
1600	$prototype =~ s/^static +//;	1715	$prototype =~ s/^static +//;
1601	$prototype =~ s/^extern +//;	1716	$prototype =~ s/^extern +//;
@@ -1672,30 +1787,48 @@ sub dump_function($$) { · 70 unmodified lines
1672	return;	1787	return;
1673	}	1788	}
1674		1789
1675	my $prms = join " ", @parameterlist;	1790	my $prms = join " ", @parameterlist;
1676	check_sections($file, $declaration_name, "function", $sectcheck, $prms);	1791	check_sections($file, $declaration_name, "function", $sectcheck, $prms);
1677		1792
1678	# This check emits a lot of warnings at the moment, because many	1793	# This check emits a lot of warnings at the moment, because many
1679	# functions don't have a 'Return' doc section. So until the number	1794	# functions don't have a 'Return' doc section. So until the number
1680	# of warnings goes sufficiently down, the check is only performed in	1795	# of warnings goes sufficiently down, the check is only performed in
1681	# verbose mode.	1796	# verbose mode.
1682	# TODO: always perform the check.	1797	# TODO: always perform the check.
1683	if ($verbose && !$noret) {	1798	if ($verbose && !$noret) {
1684	check_return_section($file, $declaration_name, $return_type);	1799	check_return_section($file, $declaration_name, $return_type);
1685	}	1800	}
1686		1801
1687	output_declaration($declaration_name,	1802	# The function parser can be called with a typedef parameter.
1688	'function',	1803	# Handle it.
1689	{'function' => $declaration_name,	1804	if ($return_type =~ /typedef/) {
1690	'module' => $modulename,	1805	output_declaration($declaration_name,
1691	'functiontype' => $return_type,	1806	'function',
1692	'parameterlist' => \@parameterlist,	1807	{'function' => $declaration_name,
1693	'parameterdescs' => \%parameterdescs,	1808	'typedef' => 1,
1694	'parametertypes' => \%parametertypes,	1809	'module' => $modulename,
1695	'sectionlist' => \@sectionlist,	1810	'functiontype' => $return_type,
1696	'sections' => \%sections,	1811	'parameterlist' => \@parameterlist,
1697	'purpose' => $declaration_purpose	1812	'parameterdescs' => \%parameterdescs,
1698	});	1813	'parametertypes' => \%parametertypes,
		1814	'sectionlist' => \@sectionlist,
		1815	'sections' => \%sections,
		1816	'purpose' => $declaration_purpose
		1817	});
		1818	} else {
		1819	output_declaration($declaration_name,
		1820	'function',
		1821	{'function' => $declaration_name,
		1822	'module' => $modulename,
		1823	'functiontype' => $return_type,
		1824	'parameterlist' => \@parameterlist,
		1825	'parameterdescs' => \%parameterdescs,
		1826	'parametertypes' => \%parametertypes,
		1827	'sectionlist' => \@sectionlist,
		1828	'sections' => \%sections,
		1829	'purpose' => $declaration_purpose
		1830	});
		1831	}
1699	}	1832	}
1700		1833
1701	sub reset_state {	1834	sub reset_state {
@@ -1873,6 +2006,7 @@ sub process_export_file($) { · 171 unmodified lines
1873		2006
1874	while (<IN>) {	2007	while (<IN>) {
1875	if (/$export_symbol/) {	2008	if (/$export_symbol/) {
		2009	next if (defined($nosymbol_table{$2}));
1876	$function_table{$2} = 1;	2010	$function_table{$2} = 1;
1877	}	2011	}
1878	}	2012	}
@@ -1904,7 +2038,7 @@ sub process_name($$) { · 25 unmodified lines
1904	if (/$doc_block/o) {	2038	if (/$doc_block/o) {
1905	$state = STATE_DOCBLOCK;	2039	$state = STATE_DOCBLOCK;
1906	$contents = "";	2040	$contents = "";
1907	$new_start_line = $. + 1;	2041	$new_start_line = $.;
1908		2042
1909	if ( $1 eq "" ) {	2043	if ( $1 eq "" ) {
1910	$section = $section_intro;	2044	$section = $section_intro;
@@ -1987,6 +2121,7 @@ sub process_body($$) { · 76 unmodified lines
1987	if ($state == STATE_BODY_WITH_BLANK_LINE && /^\s\\s?\S/) {	2121	if ($state == STATE_BODY_WITH_BLANK_LINE && /^\s\\s?\S/) {
1988	dump_section($file, $section, $contents);	2122	dump_section($file, $section, $contents);
1989	$section = $section_default;	2123	$section = $section_default;
		2124	$new_start_line = $.;
1990	$contents = "";	2125	$contents = "";
1991	}	2126	}
1992		2127
@@ -2042,6 +2177,7 @@ sub process_body($$) { · 49 unmodified lines
2042	$prototype = "";	2177	$prototype = "";
2043	$state = STATE_PROTO;	2178	$state = STATE_PROTO;
2044	$brcount = 0;	2179	$brcount = 0;
		2180	$new_start_line = $. + 1;
2045	} elsif (/$doc_content/) {	2181	} elsif (/$doc_content/) {
2046	if ($1 eq "") {	2182	if ($1 eq "") {
2047	if ($section eq $section_context) {	2183	if ($section eq $section_context) {
@@ -2189,7 +2325,7 @@ sub process_file($) { · 141 unmodified lines
2189		2325
2190	$file = map_filename($orig_file);	2326	$file = map_filename($orig_file);
2191		2327
2192	if (!open(IN,"<$file")) {	2328	if (!open(IN_FILE,"<$file")) {
2193	print STDERR "Error: Cannot open file $file\n";	2329	print STDERR "Error: Cannot open file $file\n";
2194	++$errors;	2330	++$errors;
2195	return;	2331	return;
@@ -2198,9 +2334,9 @@ sub process_file($) { · 2 unmodified lines
2198	$. = 1;	2334	$. = 1;
2199		2335
2200	$section_counter = 0;	2336	$section_counter = 0;
2201	while (<IN>) {	2337	while (<IN_FILE>) {
2202	while (s/\\\s*$//) {	2338	while (s/\\\s*$//) {
2203	$_ .= <IN>;	2339	$_ .= <IN_FILE>;
2204	}	2340	}
2205	# Replace tabs by spaces	2341	# Replace tabs by spaces
2206	while ($_ =~ s/\t+/' ' x (length($&) * 8 - length($`) % 8)/e) {};	2342	while ($_ =~ s/\t+/' ' x (length($&) * 8 - length($`) % 8)/e) {};
@@ -2232,9 +2368,14 @@ sub process_file($) { · 25 unmodified lines
2232	print STDERR "${file}:1: warning: no structured comments found\n";	2368	print STDERR "${file}:1: warning: no structured comments found\n";
2233	}	2369	}
2234	}	2370	}
		2371	close IN_FILE;
2235	}	2372	}
2236		2373
2237		2374
		2375	if ($output_mode eq "rst") {
		2376	get_sphinx_version() if (!$sphinx_major);
		2377	}
		2378
2238	$kernelversion = get_kernel_version();	2379	$kernelversion = get_kernel_version();
2239		2380
2240	# generate a sequence of code that will splice in highlighting information	2381	# generate a sequence of code that will splice in highlighting information

@@ -63,10 +63,10 @@ Software staging queues · 62 unmodified lines
63	~~~~~~~~~~~~~~~~~~~~~~~	63	~~~~~~~~~~~~~~~~~~~~~~~
64		64
65	The block IO subsystem adds requests in the software staging queues	65	The block IO subsystem adds requests in the software staging queues
66	(represented by struct :c:type:`blk_mq_ctx`) in case that they weren't sent	66	(represented by struct blk_mq_ctx) in case that they weren't sent
67	directly to the driver. A request is one or more BIOs. They arrived at the	67	directly to the driver. A request is one or more BIOs. They arrived at the
68	block layer through the data structure struct :c:type:`bio`. The block layer	68	block layer through the data structure struct bio. The block layer
69	will then build a new structure from it, the struct :c:type:`request` that will	69	will then build a new structure from it, the struct request that will
70	be used to communicate with the device driver. Each queue has its own lock and	70	be used to communicate with the device driver. Each queue has its own lock and
71	the number of queues is defined by a per-CPU or per-node basis.	71	the number of queues is defined by a per-CPU or per-node basis.
72		72
@@ -102,7 +102,7 @@ hardware queue will be drained in sequence according to their mapping. · 29 unmodified lines
102	Hardware dispatch queues	102	Hardware dispatch queues
103	~~~~~~~~~~~~~~~~~~~~~~~~	103	~~~~~~~~~~~~~~~~~~~~~~~~
104		104
105	The hardware queue (represented by struct :c:type:`blk_mq_hw_ctx`) is a struct	105	The hardware queue (represented by struct blk_mq_hw_ctx) is a struct
106	used by device drivers to map the device submission queues (or device DMA ring	106	used by device drivers to map the device submission queues (or device DMA ring
107	buffer), and are the last step of the block layer submission code before the	107	buffer), and are the last step of the block layer submission code before the
108	low level device driver taking ownership of the request. To run this queue, the	108	low level device driver taking ownership of the request. To run this queue, the
@@ -110,9 +110,9 @@ block layer removes requests from the associated software queues and tries to · 1 unmodified line
110	dispatch to the hardware.	110	dispatch to the hardware.
111		111
112	If it's not possible to send the requests directly to hardware, they will be	112	If it's not possible to send the requests directly to hardware, they will be
113	added to a linked list (:c:type:`hctx->dispatch`) of requests. Then,	113	added to a linked list (``hctx->dispatch``) of requests. Then,
114	next time the block layer runs a queue, it will send the requests laying at the	114	next time the block layer runs a queue, it will send the requests laying at the
115	:c:type:`dispatch` list first, to ensure a fairness dispatch with those	115	``dispatch`` list first, to ensure a fairness dispatch with those
116	requests that were ready to be sent first. The number of hardware queues	116	requests that were ready to be sent first. The number of hardware queues
117	depends on the number of hardware contexts supported by the hardware and its	117	depends on the number of hardware contexts supported by the hardware and its
118	device driver, but it will not be more than the number of cores of the system.	118	device driver, but it will not be more than the number of cores of the system.

@@ -52,7 +52,7 @@ Constraints and notes · 51 unmodified lines
52	Design	52	Design
53	======	53	======
54		54
55	We add a :c:type:`struct bio_crypt_ctx` to :c:type:`struct bio` that can	55	We add a struct bio_crypt_ctx to struct bio that can
56	represent an encryption context, because we need to be able to pass this	56	represent an encryption context, because we need to be able to pass this
57	encryption context from the upper layers (like the fs layer) to the	57	encryption context from the upper layers (like the fs layer) to the
58	device driver to act upon.	58	device driver to act upon.
@@ -85,7 +85,7 @@ blk-mq changes, other block layer changes and blk-crypto-fallback · 26 unmodified lines
85	=================================================================	85	=================================================================
86		86
87	We add a pointer to a ``bi_crypt_context`` and ``keyslot`` to	87	We add a pointer to a ``bi_crypt_context`` and ``keyslot`` to
88	:c:type:`struct request`. These will be referred to as the ``crypto fields``	88	struct request. These will be referred to as the ``crypto fields``
89	for the request. This ``keyslot`` is the keyslot into which the	89	for the request. This ``keyslot`` is the keyslot into which the
90	``bi_crypt_context`` has been programmed in the KSM of the ``request_queue``	90	``bi_crypt_context`` has been programmed in the KSM of the ``request_queue``
91	that this request is being sent to.	91	that this request is being sent to.
@@ -118,7 +118,7 @@ of the algorithm being used adheres to spec and functions correctly). · 26 unmodified lines
118	If a ``request queue``'s inline encryption hardware claimed to support the	118	If a ``request queue``'s inline encryption hardware claimed to support the
119	encryption context specified with a bio, then it will not be handled by the	119	encryption context specified with a bio, then it will not be handled by the
120	``blk-crypto-fallback``. We will eventually reach a point in blk-mq when a	120	``blk-crypto-fallback``. We will eventually reach a point in blk-mq when a
121	:c:type:`struct request` needs to be allocated for that bio. At that point,	121	struct request needs to be allocated for that bio. At that point,
122	blk-mq tries to program the encryption context into the ``request_queue``'s	122	blk-mq tries to program the encryption context into the ``request_queue``'s
123	keyslot_manager, and obtain a keyslot, which it stores in its newly added	123	keyslot_manager, and obtain a keyslot, which it stores in its newly added
124	``keyslot`` field. This keyslot is released when the request is completed.	124	``keyslot`` field. This keyslot is released when the request is completed.
@@ -188,7 +188,7 @@ keyslots supported by the hardware. · 63 unmodified lines
188	The device driver also needs to tell the KSM how to actually manipulate the	188	The device driver also needs to tell the KSM how to actually manipulate the
189	IE hardware in the device to do things like programming the crypto key into	189	IE hardware in the device to do things like programming the crypto key into
190	the IE hardware into a particular keyslot. All this is achieved through the	190	the IE hardware into a particular keyslot. All this is achieved through the
191	:c:type:`struct blk_ksm_ll_ops` field in the KSM that the device driver	191	struct blk_ksm_ll_ops field in the KSM that the device driver
192	must fill up after initing the ``blk_keyslot_manager``.	192	must fill up after initing the ``blk_keyslot_manager``.
193		193
194	The KSM also handles runtime power management for the device when applicable	194	The KSM also handles runtime power management for the device when applicable

@@ -726,7 +726,7 @@ The kernel debugger is organized into a number of components: · 725 unmodified lines
726	- contains an arch-specific trap catcher which invokes	726	- contains an arch-specific trap catcher which invokes
727	kgdb_handle_exception() to start kgdb about doing its work	727	kgdb_handle_exception() to start kgdb about doing its work
728		728
729	- translation to and from gdb specific packet format to :c:type:`pt_regs`	729	- translation to and from gdb specific packet format to struct pt_regs
730		730
731	- Registration and unregistration of architecture specific trap	731	- Registration and unregistration of architecture specific trap
732	hooks	732	hooks
@@ -846,7 +846,7 @@ invokes a callback in the serial core which in turn uses the callback in · 113 unmodified lines
846	the UART driver.	846	the UART driver.
847		847
848	When using kgdboc with a UART, the UART driver must implement two	848	When using kgdboc with a UART, the UART driver must implement two
849	callbacks in the :c:type:`struct uart_ops <uart_ops>`.	849	callbacks in the struct uart_ops.
850	Example from ``drivers/8250.c``::	850	Example from ``drivers/8250.c``::
851		851
852		852
@@ -875,7 +875,7 @@ kernel when ``CONFIG_KDB_KEYBOARD=y`` is set in the kernel configuration. · 22 unmodified lines
875	The core polled keyboard driver for PS/2 type keyboards is in	875	The core polled keyboard driver for PS/2 type keyboards is in
876	``drivers/char/kdb_keyboard.c``. This driver is hooked into the debug core	876	``drivers/char/kdb_keyboard.c``. This driver is hooked into the debug core
877	when kgdboc populates the callback in the array called	877	when kgdboc populates the callback in the array called
878	:c:type:`kdb_poll_funcs[]`. The kdb_get_kbd_char() is the top-level	878	:c:expr:`kdb_poll_funcs[]`. The kdb_get_kbd_char() is the top-level
879	function which polls hardware for single character input.	879	function which polls hardware for single character input.
880		880
881	kgdboc and kms	881	kgdboc and kms

@@ -45,7 +45,7 @@ An example of usage can be seen in the probe function of [#f2]_. · 44 unmodified lines
45	API to add a new FPGA region	45	API to add a new FPGA region
46	----------------------------	46	----------------------------
47		47
48	* struct :c:type:`fpga_region` — The FPGA region struct	48	* struct fpga_region — The FPGA region struct
49	* devm_fpga_region_create() — Allocate and init a region struct	49	* devm_fpga_region_create() — Allocate and init a region struct
50	* fpga_region_register() — Register an FPGA region	50	* fpga_region_register() — Register an FPGA region
51	* fpga_region_unregister() — Unregister an FPGA region	51	* fpga_region_unregister() — Unregister an FPGA region
@@ -61,9 +61,9 @@ during the region's probe function. · 9 unmodified lines
61		61
62	The FPGA region will need to specify which bridges to control while programming	62	The FPGA region will need to specify which bridges to control while programming
63	the FPGA. The region driver can build a list of bridges during probe time	63	the FPGA. The region driver can build a list of bridges during probe time
64	(:c:member:`fpga_region->bridge_list`) or it can have a function that creates	64	(:c:expr:`fpga_region->bridge_list`) or it can have a function that creates
65	the list of bridges to program just before programming	65	the list of bridges to program just before programming
66	(:c:member:`fpga_region->get_bridges`). The FPGA bridge framework supplies the	66	(:c:expr:`fpga_region->get_bridges`). The FPGA bridge framework supplies the
67	following APIs to handle building or tearing down that list.	67	following APIs to handle building or tearing down that list.
68		68
69	* fpga_bridge_get_to_list() — Get a ref of an FPGA bridge, add it to a	69	* fpga_bridge_get_to_list() — Get a ref of an FPGA bridge, add it to a

@@ -67,7 +67,7 @@ You should also set these fields of :c:type:`video_device`: · 66 unmodified lines
67	file operation is called this lock will be taken by the core and released	67	file operation is called this lock will be taken by the core and released
68	afterwards. See the next section for more details.	68	afterwards. See the next section for more details.
69		69
70	- :c:type:`video_device`->queue: a pointer to the struct :c:type:`vb2_queue`	70	- :c:type:`video_device`->queue: a pointer to the struct vb2_queue
71	associated with this device node.	71	associated with this device node.
72	If queue is not ``NULL``, and queue->lock is not ``NULL``, then queue->lock	72	If queue is not ``NULL``, and queue->lock is not ``NULL``, then queue->lock
73	is used for the queuing ioctls (``VIDIOC_REQBUFS``, ``CREATE_BUFS``,	73	is used for the queuing ioctls (``VIDIOC_REQBUFS``, ``CREATE_BUFS``,
@@ -81,7 +81,7 @@ You should also set these fields of :c:type:`video_device`: · 7 unmodified lines
81		81
82	- :c:type:`video_device`->prio: keeps track of the priorities. Used to	82	- :c:type:`video_device`->prio: keeps track of the priorities. Used to
83	implement ``VIDIOC_G_PRIORITY`` and ``VIDIOC_S_PRIORITY``.	83	implement ``VIDIOC_G_PRIORITY`` and ``VIDIOC_S_PRIORITY``.
84	If left to ``NULL``, then it will use the struct :c:type:`v4l2_prio_state`	84	If left to ``NULL``, then it will use the struct v4l2_prio_state
85	in :c:type:`v4l2_device`. If you want to have a separate priority state per	85	in :c:type:`v4l2_device`. If you want to have a separate priority state per
86	(group of) device node(s), then you can point it to your own struct	86	(group of) device node(s), then you can point it to your own struct
87	:c:type:`v4l2_prio_state`.	87	:c:type:`v4l2_prio_state`.
@@ -95,7 +95,7 @@ You should also set these fields of :c:type:`video_device`: · 7 unmodified lines
95	but it is used by both a raw video PCI device (cx8800) and a MPEG PCI device	95	but it is used by both a raw video PCI device (cx8800) and a MPEG PCI device
96	(cx8802). Since the :c:type:`v4l2_device` cannot be associated with two PCI	96	(cx8802). Since the :c:type:`v4l2_device` cannot be associated with two PCI
97	devices at the same time it is setup without a parent device. But when the	97	devices at the same time it is setup without a parent device. But when the
98	struct :c:type:`video_device` is initialized you do know which parent	98	struct video_device is initialized you do know which parent
99	PCI device to use and so you set ``dev_device`` to the correct PCI device.	99	PCI device to use and so you set ``dev_device`` to the correct PCI device.
100		100
101	If you use :c:type:`v4l2_ioctl_ops`, then you should set	101	If you use :c:type:`v4l2_ioctl_ops`, then you should set
@@ -138,7 +138,7 @@ ioctls and locking · 36 unmodified lines
138	------------------	138	------------------
139		139
140	The V4L core provides optional locking services. The main service is the	140	The V4L core provides optional locking services. The main service is the
141	lock field in struct :c:type:`video_device`, which is a pointer to a mutex.	141	lock field in struct video_device, which is a pointer to a mutex.
142	If you set this pointer, then that will be used by unlocked_ioctl to	142	If you set this pointer, then that will be used by unlocked_ioctl to
143	serialize all ioctls.	143	serialize all ioctls.
144		144

@@ -176,9 +176,9 @@ Kernel Mode Gadget API · 175 unmodified lines
176		176
177	Gadget drivers declare themselves through a struct	177	Gadget drivers declare themselves through a struct
178	:c:type:`usb_gadget_driver`, which is responsible for most parts of enumeration	178	:c:type:`usb_gadget_driver`, which is responsible for most parts of enumeration
179	for a struct :c:type:`usb_gadget`. The response to a set_configuration usually	179	for a struct usb_gadget. The response to a set_configuration usually
180	involves enabling one or more of the struct :c:type:`usb_ep` objects exposed by	180	involves enabling one or more of the struct usb_ep objects exposed by
181	the gadget, and submitting one or more struct :c:type:`usb_request` buffers to	181	the gadget, and submitting one or more struct usb_request buffers to
182	transfer data. Understand those four data types, and their operations,	182	transfer data. Understand those four data types, and their operations,
183	and you will understand how this API works.	183	and you will understand how this API works.
184		184
@@ -339,8 +339,8 @@ multi-configuration devices (also more than one function, but not · 154 unmodified lines
339	necessarily sharing a given configuration). There is however an optional	339	necessarily sharing a given configuration). There is however an optional
340	framework which makes it easier to reuse and combine functions.	340	framework which makes it easier to reuse and combine functions.
341		341
342	Devices using this framework provide a struct :c:type:`usb_composite_driver`,	342	Devices using this framework provide a struct usb_composite_driver,
343	which in turn provides one or more struct :c:type:`usb_configuration`	343	which in turn provides one or more struct usb_configuration
344	instances. Each such configuration includes at least one struct	344	instances. Each such configuration includes at least one struct
345	:c:type:`usb_function`, which packages a user visible role such as "network	345	:c:type:`usb_function`, which packages a user visible role such as "network
346	link" or "mass storage device". Management functions may also exist,	346	link" or "mass storage device". Management functions may also exist,

@@ -24,7 +24,7 @@ whether it is possible to manually override that default. · 23 unmodified lines
24	although it is still in use by several architectures.	24	although it is still in use by several architectures.
25		25
26	All the memory models track the status of physical page frames using	26	All the memory models track the status of physical page frames using
27	:c:type:`struct page` arranged in one or more arrays.	27	struct page arranged in one or more arrays.
28		28
29	Regardless of the selected memory model, there exists one-to-one	29	Regardless of the selected memory model, there exists one-to-one
30	mapping between the physical page frame number (PFN) and the	30	mapping between the physical page frame number (PFN) and the
@@ -111,7 +111,7 @@ maps for non-volatile memory devices and deferred initialization of · 80 unmodified lines
111	the memory map for larger systems.	111	the memory map for larger systems.
112		112
113	The SPARSEMEM model presents the physical memory as a collection of	113	The SPARSEMEM model presents the physical memory as a collection of
114	sections. A section is represented with :c:type:`struct mem_section`	114	sections. A section is represented with struct mem_section
115	that contains `section_mem_map` that is, logically, a pointer to an	115	that contains `section_mem_map` that is, logically, a pointer to an
116	array of struct pages. However, it is stored with some other magic	116	array of struct pages. However, it is stored with some other magic
117	that aids the sections management. The section size and maximal number	117	that aids the sections management. The section size and maximal number
@@ -172,7 +172,7 @@ management. · 54 unmodified lines
172		172
173	The virtually mapped memory map allows storing `struct page` objects	173	The virtually mapped memory map allows storing `struct page` objects
174	for persistent memory devices in pre-allocated storage on those	174	for persistent memory devices in pre-allocated storage on those
175	devices. This storage is represented with :c:type:`struct vmem_altmap`	175	devices. This storage is represented with struct vmem_altmap
176	that is eventually passed to vmemmap_populate() through a long chain	176	that is eventually passed to vmemmap_populate() through a long chain
177	of function calls. The vmemmap_populate() implementation may use the	177	of function calls. The vmemmap_populate() implementation may use the
178	`vmem_altmap` along with :c:func:`vmemmap_alloc_block_buf` helper to	178	`vmem_altmap` along with :c:func:`vmemmap_alloc_block_buf` helper to

@@ -28,7 +28,7 @@ static inline u64 div_u64_rem(u64 dividend, u32 divisor, u32 *remainder) · 27 unmodified lines
28	return dividend / divisor;	28	return dividend / divisor;
29	}	29	}
30		30
31	/**	31	/*
32	* div_s64_rem - signed 64bit divide with 32bit divisor with remainder	32	* div_s64_rem - signed 64bit divide with 32bit divisor with remainder
33	* @dividend: signed 64bit dividend	33	* @dividend: signed 64bit dividend
34	* @divisor: signed 32bit divisor	34	* @divisor: signed 32bit divisor
@@ -42,7 +42,7 @@ static inline s64 div_s64_rem(s64 dividend, s32 divisor, s32 *remainder) · 7 unmodified lines
42	return dividend / divisor;	42	return dividend / divisor;
43	}	43	}
44		44
45	/**	45	/*
46	* div64_u64_rem - unsigned 64bit divide with 64bit divisor and remainder	46	* div64_u64_rem - unsigned 64bit divide with 64bit divisor and remainder
47	* @dividend: unsigned 64bit dividend	47	* @dividend: unsigned 64bit dividend
48	* @divisor: unsigned 64bit divisor	48	* @divisor: unsigned 64bit divisor
@@ -56,7 +56,7 @@ static inline u64 div64_u64_rem(u64 dividend, u64 divisor, u64 *remainder) · 7 unmodified lines
56	return dividend / divisor;	56	return dividend / divisor;
57	}	57	}
58		58
59	/**	59	/*
60	* div64_u64 - unsigned 64bit divide with 64bit divisor	60	* div64_u64 - unsigned 64bit divide with 64bit divisor
61	* @dividend: unsigned 64bit dividend	61	* @dividend: unsigned 64bit dividend
62	* @divisor: unsigned 64bit divisor	62	* @divisor: unsigned 64bit divisor
@@ -68,7 +68,7 @@ static inline u64 div64_u64(u64 dividend, u64 divisor) · 5 unmodified lines
68	return dividend / divisor;	68	return dividend / divisor;
69	}	69	}
70		70
71	/**	71	/*
72	* div64_s64 - signed 64bit divide with 64bit divisor	72	* div64_s64 - signed 64bit divide with 64bit divisor
73	* @dividend: signed 64bit dividend	73	* @dividend: signed 64bit dividend
74	* @divisor: signed 64bit divisor	74	* @divisor: signed 64bit divisor