diff options
Diffstat (limited to 'Documentation/media')
-rw-r--r-- | Documentation/media/kapi/v4l2-common.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-controls.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-core.rst | 11 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-dev.rst | 12 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-device.rst | 8 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-dv-timings.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-event.rst | 5 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-fh.rst | 5 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-flash-led-class.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-intro.rst | 15 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-mc.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-mediabus.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-mem2mem.rst | 5 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-rect.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-subdev.rst | 12 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-tuner.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-tveeprom.rst | 4 | ||||
-rw-r--r-- | Documentation/media/kapi/v4l2-videobuf2.rst | 4 |
18 files changed, 51 insertions, 62 deletions
diff --git a/Documentation/media/kapi/v4l2-common.rst b/Documentation/media/kapi/v4l2-common.rst new file mode 100644 index 0000000..d1ea1c9 --- /dev/null +++ b/Documentation/media/kapi/v4l2-common.rst @@ -0,0 +1,4 @@ +V4L2 common functions and data structures +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. kernel-doc:: include/media/v4l2-common.h diff --git a/Documentation/media/kapi/v4l2-controls.rst b/Documentation/media/kapi/v4l2-controls.rst index 2d43330..07a179e 100644 --- a/Documentation/media/kapi/v4l2-controls.rst +++ b/Documentation/media/kapi/v4l2-controls.rst @@ -808,7 +808,7 @@ notify function is called. There can be only one notify function per control handler. Any attempt to set another notify function will cause a WARN_ON. -V4L2 control kAPI ------------------ +v4l2_ctrl functions and data structures +--------------------------------------- .. kernel-doc:: include/media/v4l2-ctrls.h diff --git a/Documentation/media/kapi/v4l2-core.rst b/Documentation/media/kapi/v4l2-core.rst index 6285c18..e967715 100644 --- a/Documentation/media/kapi/v4l2-core.rst +++ b/Documentation/media/kapi/v4l2-core.rst @@ -6,20 +6,21 @@ Video2Linux devices v4l2-intro v4l2-dev - v4l2-controls v4l2-device v4l2-fh + v4l2-subdev + v4l2-event + v4l2-controls + v4l2-videobuf + v4l2-videobuf2 v4l2-clocks v4l2-dv-timings - v4l2-event v4l2-flash-led-class v4l2-mc v4l2-mediabus v4l2-mem2mem v4l2-of v4l2-rect - v4l2-subdev v4l2-tuner + v4l2-common v4l2-tveeprom - v4l2-videobuf2 - v4l2-videobuf diff --git a/Documentation/media/kapi/v4l2-dev.rst b/Documentation/media/kapi/v4l2-dev.rst index 306306d..b03f9b3 100644 --- a/Documentation/media/kapi/v4l2-dev.rst +++ b/Documentation/media/kapi/v4l2-dev.rst @@ -1,5 +1,5 @@ -Video device creation -===================== +Video device' s internal representation +======================================= The actual device nodes in the ``/dev`` directory are created using the :c:type:`video_device` struct (``v4l2-dev.h``). This struct can either be @@ -309,8 +309,8 @@ it has been initialized: This can be done from the release callback. -video_device helper functions ------------------------------ +helper functions +---------------- There are a few useful helper functions: @@ -357,7 +357,7 @@ The name is used as a hint by userspace tools such as udev. The function should be used where possible instead of accessing the video_device::num and video_device::minor fields. -video_device kAPI ------------------ +video_device functions and data structures +------------------------------------------ .. kernel-doc:: include/media/v4l2-dev.h diff --git a/Documentation/media/kapi/v4l2-device.rst b/Documentation/media/kapi/v4l2-device.rst index 8e275d0..c9115bc 100644 --- a/Documentation/media/kapi/v4l2-device.rst +++ b/Documentation/media/kapi/v4l2-device.rst @@ -1,5 +1,5 @@ -V4L2 Device register logic --------------------------- +V4L2 device instance +-------------------- Each device instance is represented by a struct :c:type:`v4l2_device`. Very simple devices can just allocate this struct, but most of the time you @@ -138,7 +138,7 @@ Since the initial refcount is 1 you also need to call or in the ``remove()`` callback (for e.g. PCI devices), otherwise the refcount will never reach 0. -V4L2 device kAPI -^^^^^^^^^^^^^^^^ +v4l2_device functions and data structures +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. kernel-doc:: include/media/v4l2-device.h diff --git a/Documentation/media/kapi/v4l2-dv-timings.rst b/Documentation/media/kapi/v4l2-dv-timings.rst index 4b08a49..5527432 100644 --- a/Documentation/media/kapi/v4l2-dv-timings.rst +++ b/Documentation/media/kapi/v4l2-dv-timings.rst @@ -1,4 +1,4 @@ -V4L2 DV Timings kAPI -^^^^^^^^^^^^^^^^^^^^ +V4L2 DV Timings functions +^^^^^^^^^^^^^^^^^^^^^^^^^ .. kernel-doc:: include/media/v4l2-dv-timings.h diff --git a/Documentation/media/kapi/v4l2-event.rst b/Documentation/media/kapi/v4l2-event.rst index 0bab793..d81bbf2 100644 --- a/Documentation/media/kapi/v4l2-event.rst +++ b/Documentation/media/kapi/v4l2-event.rst @@ -130,7 +130,8 @@ function with ``V4L2_DEVICE_NOTIFY_EVENT``. This allows the bridge to map the subdev that sends the event to the video node(s) associated with the subdev that need to be informed about such an event. -V4L2 event kAPI -^^^^^^^^^^^^^^^ +V4L2 event functions and data structures +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. kernel-doc:: include/media/v4l2-event.h + diff --git a/Documentation/media/kapi/v4l2-fh.rst b/Documentation/media/kapi/v4l2-fh.rst index a212698..ef4ae04 100644 --- a/Documentation/media/kapi/v4l2-fh.rst +++ b/Documentation/media/kapi/v4l2-fh.rst @@ -133,6 +133,7 @@ associated device node: - Same, but it calls v4l2_fh_is_singular with filp->private_data. -V4L2 File Handler kAPI -^^^^^^^^^^^^^^^^^^^^^^ +V4L2 fh functions and data structures +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + .. kernel-doc:: include/media/v4l2-fh.h diff --git a/Documentation/media/kapi/v4l2-flash-led-class.rst b/Documentation/media/kapi/v4l2-flash-led-class.rst index 251ed6b..20798bd 100644 --- a/Documentation/media/kapi/v4l2-flash-led-class.rst +++ b/Documentation/media/kapi/v4l2-flash-led-class.rst @@ -1,4 +1,4 @@ -V4L2 Flash and LED class kAPI -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +V4L2 flash functions and data structures +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. kernel-doc:: include/media/v4l2-flash-led-class.h diff --git a/Documentation/media/kapi/v4l2-intro.rst b/Documentation/media/kapi/v4l2-intro.rst index 7f4f26e..e614d8d 100644 --- a/Documentation/media/kapi/v4l2-intro.rst +++ b/Documentation/media/kapi/v4l2-intro.rst @@ -1,10 +1,3 @@ -Overview of the V4L2 driver framework -===================================== - -This text documents the various structures provided by the V4L2 framework and -their relationships. - - Introduction ------------ @@ -39,8 +32,8 @@ source that is available in samples/v4l/. It is a skeleton driver for a PCI capture card, and demonstrates how to use the V4L2 driver framework. It can be used as a template for real PCI video capture driver. -Structure of a driver ---------------------- +Structure of a V4L driver +------------------------- All drivers have the following structure: @@ -68,8 +61,8 @@ This is a rough schematic of how it all relates: \-filehandle instances -Structure of the framework --------------------------- +Structure of the V4L2 framework +------------------------------- The framework closely resembles the driver structure: it has a v4l2_device struct for the device instance data, a v4l2_subdev struct to refer to diff --git a/Documentation/media/kapi/v4l2-mc.rst b/Documentation/media/kapi/v4l2-mc.rst index c94ce0f..8af3470 100644 --- a/Documentation/media/kapi/v4l2-mc.rst +++ b/Documentation/media/kapi/v4l2-mc.rst @@ -1,4 +1,4 @@ -V4L2 Media Controller kAPI -^^^^^^^^^^^^^^^^^^^^^^^^^^ +V4L2 Media Controller functions and data structures +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. kernel-doc:: include/media/v4l2-mc.h diff --git a/Documentation/media/kapi/v4l2-mediabus.rst b/Documentation/media/kapi/v4l2-mediabus.rst index b3c246b..e641319 100644 --- a/Documentation/media/kapi/v4l2-mediabus.rst +++ b/Documentation/media/kapi/v4l2-mediabus.rst @@ -1,4 +1,4 @@ -V4L2 Media Bus kAPI -^^^^^^^^^^^^^^^^^^^ +V4L2 Media Bus functions and data structures +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. kernel-doc:: include/media/v4l2-mediabus.h diff --git a/Documentation/media/kapi/v4l2-mem2mem.rst b/Documentation/media/kapi/v4l2-mem2mem.rst index 61f9923..5536b4a 100644 --- a/Documentation/media/kapi/v4l2-mem2mem.rst +++ b/Documentation/media/kapi/v4l2-mem2mem.rst @@ -1,3 +1,4 @@ -V4L2 Memory to Memory kAPI -^^^^^^^^^^^^^^^^^^^^^^^^^^ +V4L2 Memory to Memory functions and data structures +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + .. kernel-doc:: include/media/v4l2-mem2mem.h diff --git a/Documentation/media/kapi/v4l2-rect.rst b/Documentation/media/kapi/v4l2-rect.rst index bb86dcb..8df5067 100644 --- a/Documentation/media/kapi/v4l2-rect.rst +++ b/Documentation/media/kapi/v4l2-rect.rst @@ -1,4 +1,4 @@ -V4L2 rect kAPI -^^^^^^^^^^^^^^ +V4L2 rect helper functions +^^^^^^^^^^^^^^^^^^^^^^^^^^ .. kernel-doc:: include/media/v4l2-rect.h diff --git a/Documentation/media/kapi/v4l2-subdev.rst b/Documentation/media/kapi/v4l2-subdev.rst index 456fdec..7e45b23 100644 --- a/Documentation/media/kapi/v4l2-subdev.rst +++ b/Documentation/media/kapi/v4l2-subdev.rst @@ -440,18 +440,6 @@ well, but with irq set to 0 and platform_data set to ``NULL``. V4L2 sub-device functions and data structures --------------------------------------------- -V4L2 sub-device kAPI -^^^^^^^^^^^^^^^^^^^^ - .. kernel-doc:: include/media/v4l2-subdev.h -V4L2 sub-device asynchronous kAPI -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - .. kernel-doc:: include/media/v4l2-async.h - - -V4L2 common kAPI -^^^^^^^^^^^^^^^^ - -.. kernel-doc:: include/media/v4l2-common.h diff --git a/Documentation/media/kapi/v4l2-tuner.rst b/Documentation/media/kapi/v4l2-tuner.rst index 37b0ef3..86e8946 100644 --- a/Documentation/media/kapi/v4l2-tuner.rst +++ b/Documentation/media/kapi/v4l2-tuner.rst @@ -1,5 +1,5 @@ -Tuner kAPI -^^^^^^^^^^ +Tuner functions and data structures +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. kernel-doc:: include/media/tuner.h diff --git a/Documentation/media/kapi/v4l2-tveeprom.rst b/Documentation/media/kapi/v4l2-tveeprom.rst index f7ef717..33422cb 100644 --- a/Documentation/media/kapi/v4l2-tveeprom.rst +++ b/Documentation/media/kapi/v4l2-tveeprom.rst @@ -1,4 +1,4 @@ -Hauppauge TV EEPROM kAPI -^^^^^^^^^^^^^^^^^^^^^^^^ +Hauppauge TV EEPROM functions and data structures +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. kernel-doc:: include/media/tveeprom.h diff --git a/Documentation/media/kapi/v4l2-videobuf2.rst b/Documentation/media/kapi/v4l2-videobuf2.rst index bdb8b83..3c4cb1e 100644 --- a/Documentation/media/kapi/v4l2-videobuf2.rst +++ b/Documentation/media/kapi/v4l2-videobuf2.rst @@ -1,7 +1,7 @@ .. _vb2_framework: -V4L2 videobuf2 kAPI -^^^^^^^^^^^^^^^^^^^ +V4L2 videobuf2 functions and data structures +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. kernel-doc:: include/media/videobuf2-core.h |