diff options
| author | Mauro Carvalho Chehab | 2016-07-05 12:58:48 +0200 |
|---|---|---|
| committer | Mauro Carvalho Chehab | 2016-07-05 15:53:13 +0200 |
| commit | 586027cefac593d1a17f86e2236694357ebc6670 (patch) | |
| tree | e84d6cedfe2496b4b3c4ba4c2c2eb2640cd342fa /Documentation/linux_tv/media/v4l | |
| parent | doc-rst: linux_tv: split DVB function call documentation (diff) | |
| download | kernel-qcow2-linux-586027cefac593d1a17f86e2236694357ebc6670.tar.gz kernel-qcow2-linux-586027cefac593d1a17f86e2236694357ebc6670.tar.xz kernel-qcow2-linux-586027cefac593d1a17f86e2236694357ebc6670.zip | |
doc-rst: linux_tv: reformat all syscall pages
The syscall pages are written to be used also as man-pages.
However, they don't match the format used by kernel-doc
generated pages from DocBook. Rewrite them to match it.
One side effect is that now all such pages at the book
will have the same format, reducing the format differences
between DVB and the other parts of the book.
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Diffstat (limited to 'Documentation/linux_tv/media/v4l')
69 files changed, 564 insertions, 565 deletions
diff --git a/Documentation/linux_tv/media/v4l/func-close.rst b/Documentation/linux_tv/media/v4l/func-close.rst index fac5ec14a8e6..81401cd26d12 100644 --- a/Documentation/linux_tv/media/v4l/func-close.rst +++ b/Documentation/linux_tv/media/v4l/func-close.rst @@ -6,12 +6,12 @@ V4L2 close() ************ -*man v4l2-close(2)* +NAME +==== -Close a V4L2 device +v4l2-close - Close a V4L2 device - -Synopsis +SYNOPSIS ======== .. code-block:: c @@ -21,14 +21,15 @@ Synopsis .. cpp:function:: int close( int fd ) -Arguments + +ARGUMENTS ========= ``fd`` File descriptor returned by :ref:`open() <func-open>`. -Description +DESCRIPTION =========== Closes the device. Any I/O in progress is terminated and resources @@ -37,7 +38,7 @@ parameters, current input or output, control values or other properties remain unchanged. -Return Value +RETURN VALUE ============ The function returns 0 on success, -1 on failure and the ``errno`` is diff --git a/Documentation/linux_tv/media/v4l/func-ioctl.rst b/Documentation/linux_tv/media/v4l/func-ioctl.rst index fafec5f56a36..91917e976dd0 100644 --- a/Documentation/linux_tv/media/v4l/func-ioctl.rst +++ b/Documentation/linux_tv/media/v4l/func-ioctl.rst @@ -6,12 +6,12 @@ V4L2 ioctl() ************ -*man v4l2-ioctl(2)* +NAME +==== -Program a V4L2 device +v4l2-ioctl - Program a V4L2 device - -Synopsis +SYNOPSIS ======== .. code-block:: c @@ -21,7 +21,8 @@ Synopsis .. cpp:function:: int ioctl( int fd, int request, void *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -35,7 +36,7 @@ Arguments Pointer to a function parameter, usually a structure. -Description +DESCRIPTION =========== The :ref:`ioctl() <func-ioctl>` function is used to program V4L2 devices. The @@ -49,7 +50,7 @@ All V4L2 ioctl requests, their respective function and parameters are specified in :ref:`user-func`. -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/func-mmap.rst b/Documentation/linux_tv/media/v4l/func-mmap.rst index 345ac3005c8f..01a45e217265 100644 --- a/Documentation/linux_tv/media/v4l/func-mmap.rst +++ b/Documentation/linux_tv/media/v4l/func-mmap.rst @@ -6,12 +6,12 @@ V4L2 mmap() *********** -*man v4l2-mmap(2)* +NAME +==== -Map device memory into application address space +v4l2-mmap - Map device memory into application address space - -Synopsis +SYNOPSIS ======== .. code-block:: c @@ -22,7 +22,8 @@ Synopsis .. cpp:function:: void *mmap( void *start, size_t length, int prot, int flags, int fd, off_t offset ) -Arguments + +ARGUMENTS ========= ``start`` @@ -89,7 +90,7 @@ Arguments ``mem_offset`` field for the multi-planar API. -Description +DESCRIPTION =========== The :ref:`mmap() <func-mmap>` function asks to map ``length`` bytes starting at @@ -105,7 +106,7 @@ before they can be queried. To unmap buffers the :ref:`munmap() <func-munmap>` function is used. -Return Value +RETURN VALUE ============ On success :ref:`mmap() <func-mmap>` returns a pointer to the mapped buffer. On diff --git a/Documentation/linux_tv/media/v4l/func-munmap.rst b/Documentation/linux_tv/media/v4l/func-munmap.rst index f87eb387f499..a6e7a6def558 100644 --- a/Documentation/linux_tv/media/v4l/func-munmap.rst +++ b/Documentation/linux_tv/media/v4l/func-munmap.rst @@ -6,12 +6,12 @@ V4L2 munmap() ************* -*man v4l2-munmap(2)* +NAME +==== -Unmap device memory +v4l2-munmap - Unmap device memory - -Synopsis +SYNOPSIS ======== .. code-block:: c @@ -22,7 +22,8 @@ Synopsis .. cpp:function:: int munmap( void *start, size_t length ) -Arguments + +ARGUMENTS ========= ``start`` @@ -38,14 +39,14 @@ Arguments multi-planar API. -Description +DESCRIPTION =========== Unmaps a previously with the :ref:`mmap() <func-mmap>` function mapped buffer and frees it, if possible. -Return Value +RETURN VALUE ============ On success :ref:`munmap() <func-munmap>` returns 0, on failure -1 and the diff --git a/Documentation/linux_tv/media/v4l/func-open.rst b/Documentation/linux_tv/media/v4l/func-open.rst index 705175be80e6..152174e6f646 100644 --- a/Documentation/linux_tv/media/v4l/func-open.rst +++ b/Documentation/linux_tv/media/v4l/func-open.rst @@ -6,12 +6,12 @@ V4L2 open() *********** -*man v4l2-open(2)* +NAME +==== -Open a V4L2 device +v4l2-open - Open a V4L2 device - -Synopsis +SYNOPSIS ======== .. code-block:: c @@ -21,7 +21,8 @@ Synopsis .. cpp:function:: int open( const char *device_name, int flags ) -Arguments + +ARGUMENTS ========= ``device_name`` @@ -42,7 +43,7 @@ Arguments Other flags have no effect. -Description +DESCRIPTION =========== To open a V4L2 device applications call :ref:`open() <func-open>` with the @@ -53,7 +54,7 @@ driver they will be reset to default values, drivers are never in an undefined state. -Return Value +RETURN VALUE ============ On success :ref:`open() <func-open>` returns the new file descriptor. On error diff --git a/Documentation/linux_tv/media/v4l/func-poll.rst b/Documentation/linux_tv/media/v4l/func-poll.rst index 27f381d75de1..8632e05ff5b2 100644 --- a/Documentation/linux_tv/media/v4l/func-poll.rst +++ b/Documentation/linux_tv/media/v4l/func-poll.rst @@ -6,12 +6,12 @@ V4L2 poll() *********** -*man v4l2-poll(2)* +NAME +==== -Wait for some event on a file descriptor +v4l2-poll - Wait for some event on a file descriptor - -Synopsis +SYNOPSIS ======== .. code-block:: c @@ -21,7 +21,13 @@ Synopsis .. cpp:function:: int poll( struct pollfd *ufds, unsigned int nfds, int timeout ) -Description + +ARGUMENTS +========= + + + +DESCRIPTION =========== With the :ref:`poll() <func-poll>` function applications can suspend execution @@ -84,7 +90,7 @@ function. For more details see the :ref:`poll() <func-poll>` manual page. -Return Value +RETURN VALUE ============ On success, :ref:`poll() <func-poll>` returns the number structures which have diff --git a/Documentation/linux_tv/media/v4l/func-read.rst b/Documentation/linux_tv/media/v4l/func-read.rst index 75985f664da7..c4f0e8ab9e14 100644 --- a/Documentation/linux_tv/media/v4l/func-read.rst +++ b/Documentation/linux_tv/media/v4l/func-read.rst @@ -6,12 +6,12 @@ V4L2 read() *********** -*man v4l2-read(2)* +NAME +==== -Read from a V4L2 device +v4l2-read - Read from a V4L2 device - -Synopsis +SYNOPSIS ======== .. code-block:: c @@ -21,7 +21,8 @@ Synopsis .. cpp:function:: ssize_t read( int fd, void *buf, size_t count ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +32,7 @@ Arguments ``count`` -Description +DESCRIPTION =========== :ref:`read() <func-read>` attempts to read up to ``count`` bytes from file @@ -91,7 +92,7 @@ however. The discarding policy is not reported and cannot be changed. For minimum requirements see :ref:`devices`. -Return Value +RETURN VALUE ============ On success, the number of bytes read is returned. It is not an error if diff --git a/Documentation/linux_tv/media/v4l/func-select.rst b/Documentation/linux_tv/media/v4l/func-select.rst index 57089f5cc6cd..34ade67d0f68 100644 --- a/Documentation/linux_tv/media/v4l/func-select.rst +++ b/Documentation/linux_tv/media/v4l/func-select.rst @@ -6,12 +6,12 @@ V4L2 select() ************* -*man v4l2-select(2)* +NAME +==== -Synchronous I/O multiplexing +v4l2-select - Synchronous I/O multiplexing - -Synopsis +SYNOPSIS ======== .. code-block:: c @@ -23,7 +23,13 @@ Synopsis .. cpp:function:: int select( int nfds, fd_set *readfds, fd_set *writefds, fd_set *exceptfds, struct timeval *timeout ) -Description + +ARGUMENTS +========= + + + +DESCRIPTION =========== With the :ref:`select() <func-select>` function applications can suspend @@ -65,7 +71,7 @@ function. For more details see the :ref:`select() <func-select>` manual page. -Return Value +RETURN VALUE ============ On success, :ref:`select() <func-select>` returns the number of descriptors diff --git a/Documentation/linux_tv/media/v4l/func-write.rst b/Documentation/linux_tv/media/v4l/func-write.rst index a4b093ba15c3..6609f191af76 100644 --- a/Documentation/linux_tv/media/v4l/func-write.rst +++ b/Documentation/linux_tv/media/v4l/func-write.rst @@ -6,12 +6,12 @@ V4L2 write() ************ -*man v4l2-write(2)* +NAME +==== -Write to a V4L2 device +v4l2-write - Write to a V4L2 device - -Synopsis +SYNOPSIS ======== .. code-block:: c @@ -21,7 +21,8 @@ Synopsis .. cpp:function:: ssize_t write( int fd, void *buf, size_t count ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +32,7 @@ Arguments ``count`` -Description +DESCRIPTION =========== :ref:`write() <func-write>` writes up to ``count`` bytes to the device @@ -46,7 +47,7 @@ Sliced Teletext or Closed Caption data is not repeated, the driver inserts a blank line instead. -Return Value +RETURN VALUE ============ On success, the number of bytes written are returned. Zero indicates diff --git a/Documentation/linux_tv/media/v4l/vidioc-create-bufs.rst b/Documentation/linux_tv/media/v4l/vidioc-create-bufs.rst index 5ba95ac0a5ce..fe179197536d 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-create-bufs.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-create-bufs.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_CREATE_BUFS ************************ -*man VIDIOC_CREATE_BUFS(2)* +NAME +==== -Create buffers for Memory Mapped or User Pointer or DMA Buffer I/O +VIDIOC_CREATE_BUFS - Create buffers for Memory Mapped or User Pointer or DMA Buffer I/O - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_create_buffers *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== This ioctl is used to create buffers for :ref:`memory mapped <mmap>` @@ -129,8 +130,7 @@ than the number requested. must set the array to zero. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-cropcap.rst b/Documentation/linux_tv/media/v4l/vidioc-cropcap.rst index 2e2a24f652a3..17ae3aa738b0 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-cropcap.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-cropcap.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_CROPCAP ******************** -*man VIDIOC_CROPCAP(2)* +NAME +==== -Information about the video cropping and scaling abilities +VIDIOC_CROPCAP - Information about the video cropping and scaling abilities - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_cropcap *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== Applications use this function to query the cropping limits, the pixel @@ -153,8 +154,7 @@ overlay devices. - Height of the rectangle, in pixels. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-dbg-g-chip-info.rst b/Documentation/linux_tv/media/v4l/vidioc-dbg-g-chip-info.rst index 7cc3bd42ccd4..913c6d47d821 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-dbg-g-chip-info.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-dbg-g-chip-info.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_DBG_G_CHIP_INFO **************************** -*man VIDIOC_DBG_G_CHIP_INFO(2)* +NAME +==== -Identify the chips on a TV card +VIDIOC_DBG_G_CHIP_INFO - Identify the chips on a TV card - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_dbg_chip_info *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== **Note** @@ -191,8 +192,7 @@ instructions. - Match the nth sub-device. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-dbg-g-register.rst b/Documentation/linux_tv/media/v4l/vidioc-dbg-g-register.rst index f83a83b48cd6..185a011a117c 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-dbg-g-register.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-dbg-g-register.rst @@ -6,20 +6,20 @@ ioctl VIDIOC_DBG_G_REGISTER, VIDIOC_DBG_S_REGISTER ************************************************** -*man VIDIOC_DBG_G_REGISTER(2)* +NAME +==== -VIDIOC_DBG_S_REGISTER -Read or write hardware registers +VIDIOC_DBG_G_REGISTER - VIDIOC_DBG_S_REGISTER - Read or write hardware registers - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_dbg_register *argp ) .. cpp:function:: int ioctl( int fd, int request, const struct v4l2_dbg_register *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +31,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== **Note** @@ -196,8 +196,7 @@ instructions. - Match the nth sub-device. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-decoder-cmd.rst b/Documentation/linux_tv/media/v4l/vidioc-decoder-cmd.rst index c1d82336a60a..bb6d9b8cf122 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-decoder-cmd.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-decoder-cmd.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_DECODER_CMD, VIDIOC_TRY_DECODER_CMD ************************************************ -*man VIDIOC_DECODER_CMD(2)* +NAME +==== -VIDIOC_TRY_DECODER_CMD -Execute an decoder command +VIDIOC_DECODER_CMD - VIDIOC_TRY_DECODER_CMD - Execute an decoder command - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_decoder_cmd *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== These ioctls control an audio/video (usually MPEG-) decoder. @@ -255,8 +255,7 @@ introduced in Linux 3.3. flags are defined for this command. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-dqevent.rst b/Documentation/linux_tv/media/v4l/vidioc-dqevent.rst index 4d813a903693..850cb5ed0015 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-dqevent.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-dqevent.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_DQEVENT ******************** -*man VIDIOC_DQEVENT(2)* +NAME +==== -Dequeue event +VIDIOC_DQEVENT - Dequeue event - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_event *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== Dequeue an event from a video device. No input is required for this @@ -563,8 +564,7 @@ call. decoder. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-dv-timings-cap.rst b/Documentation/linux_tv/media/v4l/vidioc-dv-timings-cap.rst index 475dbb75aef3..61fef531363c 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-dv-timings-cap.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-dv-timings-cap.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_DV_TIMINGS_CAP, VIDIOC_SUBDEV_DV_TIMINGS_CAP ********************************************************* -*man VIDIOC_DV_TIMINGS_CAP(2)* +NAME +==== -VIDIOC_SUBDEV_DV_TIMINGS_CAP -The capabilities of the Digital Video receiver/transmitter +VIDIOC_DV_TIMINGS_CAP - VIDIOC_SUBDEV_DV_TIMINGS_CAP - The capabilities of the Digital Video receiver/transmitter - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_dv_timings_cap *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query the capabilities of the DV receiver/transmitter applications @@ -241,8 +241,7 @@ that doesn't support them will return an ``EINVAL`` error code. the standards set in the ``standards`` field. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-encoder-cmd.rst b/Documentation/linux_tv/media/v4l/vidioc-encoder-cmd.rst index 78c014ded43b..1991014fd6b5 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-encoder-cmd.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-encoder-cmd.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_ENCODER_CMD, VIDIOC_TRY_ENCODER_CMD ************************************************ -*man VIDIOC_ENCODER_CMD(2)* +NAME +==== -VIDIOC_TRY_ENCODER_CMD -Execute an encoder command +VIDIOC_ENCODER_CMD - VIDIOC_TRY_ENCODER_CMD - Execute an encoder command - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_encoder_cmd *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== These ioctls control an audio/video (usually MPEG-) encoder. @@ -179,8 +179,7 @@ introduced in Linux 2.6.21. rather than immediately. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-enum-dv-timings.rst b/Documentation/linux_tv/media/v4l/vidioc-enum-dv-timings.rst index 5aa2db9076a0..41fa4313c1c2 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-enum-dv-timings.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-enum-dv-timings.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_ENUM_DV_TIMINGS, VIDIOC_SUBDEV_ENUM_DV_TIMINGS *********************************************************** -*man VIDIOC_ENUM_DV_TIMINGS(2)* +NAME +==== -VIDIOC_SUBDEV_ENUM_DV_TIMINGS -Enumerate supported Digital Video timings +VIDIOC_ENUM_DV_TIMINGS - VIDIOC_SUBDEV_ENUM_DV_TIMINGS - Enumerate supported Digital Video timings - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_enum_dv_timings *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== While some DV receivers or transmitters support a wide range of timings, @@ -103,8 +103,7 @@ return an ``EINVAL`` error code. - The timings. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-enum-fmt.rst b/Documentation/linux_tv/media/v4l/vidioc-enum-fmt.rst index 5cc97ce281ef..3b935b07837a 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-enum-fmt.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-enum-fmt.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_ENUM_FMT ********************* -*man VIDIOC_ENUM_FMT(2)* +NAME +==== -Enumerate image formats +VIDIOC_ENUM_FMT - Enumerate image formats - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_fmtdesc *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To enumerate image formats applications initialize the ``type`` and @@ -150,8 +151,7 @@ formats may be different. format instead for better performance. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-enum-frameintervals.rst b/Documentation/linux_tv/media/v4l/vidioc-enum-frameintervals.rst index 29cf2fa5ba87..3336a166b878 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-enum-frameintervals.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-enum-frameintervals.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_ENUM_FRAMEINTERVALS ******************************** -*man VIDIOC_ENUM_FRAMEINTERVALS(2)* +NAME +==== -Enumerate frame intervals +VIDIOC_ENUM_FRAMEINTERVALS - Enumerate frame intervals - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_frmivalenum *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +32,7 @@ Arguments interval. -Description +DESCRIPTION =========== This ioctl allows applications to enumerate all frame intervals that the @@ -264,8 +265,7 @@ Enums - Step-wise defined frame interval. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-enum-framesizes.rst b/Documentation/linux_tv/media/v4l/vidioc-enum-framesizes.rst index 396cdcf44c7e..d01fffaeda04 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-enum-framesizes.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-enum-framesizes.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_ENUM_FRAMESIZES **************************** -*man VIDIOC_ENUM_FRAMESIZES(2)* +NAME +==== -Enumerate frame sizes +VIDIOC_ENUM_FRAMESIZES - Enumerate frame sizes - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_frmsizeenum *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +32,7 @@ Arguments and height. -Description +DESCRIPTION =========== This ioctl allows applications to enumerate all frame sizes (i. e. width @@ -281,8 +282,7 @@ Enums - Step-wise defined frame size. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-enum-freq-bands.rst b/Documentation/linux_tv/media/v4l/vidioc-enum-freq-bands.rst index da3bda140965..7fdde4be282c 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-enum-freq-bands.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-enum-freq-bands.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_ENUM_FREQ_BANDS **************************** -*man VIDIOC_ENUM_FREQ_BANDS(2)* +NAME +==== -Enumerate supported frequency bands +VIDIOC_ENUM_FREQ_BANDS - Enumerate supported frequency bands - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_frequency_band *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== Enumerates the frequency bands that a tuner or modulator supports. To do @@ -176,8 +177,7 @@ of the corresponding tuner/modulator is set. - Amplitude Modulation, commonly used for analog radio. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-enumaudio.rst b/Documentation/linux_tv/media/v4l/vidioc-enumaudio.rst index 9573e54271fc..f833e581f7c3 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-enumaudio.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-enumaudio.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_ENUMAUDIO ********************** -*man VIDIOC_ENUMAUDIO(2)* +NAME +==== -Enumerate audio inputs +VIDIOC_ENUMAUDIO - Enumerate audio inputs - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_audio *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query the attributes of an audio input applications initialize the @@ -43,7 +44,7 @@ See :ref:`VIDIOC_G_AUDIO <VIDIOC_G_AUDIO>` for a description of struct :ref:`v4l2_audio <v4l2-audio>`. -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-enumaudioout.rst b/Documentation/linux_tv/media/v4l/vidioc-enumaudioout.rst index 82ffb3194ed3..f2caf6c71f44 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-enumaudioout.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-enumaudioout.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_ENUMAUDOUT *********************** -*man VIDIOC_ENUMAUDOUT(2)* +NAME +==== -Enumerate audio outputs +VIDIOC_ENUMAUDOUT - Enumerate audio outputs - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_audioout *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query the attributes of an audio output applications initialize the @@ -46,7 +47,7 @@ See :ref:`VIDIOC_G_AUDIOout <VIDIOC_G_AUDIOout>` for a description of struct :ref:`v4l2_audioout <v4l2-audioout>`. -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-enuminput.rst b/Documentation/linux_tv/media/v4l/vidioc-enuminput.rst index d27556c112bb..01a1cadc71d2 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-enuminput.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-enuminput.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_ENUMINPUT ********************** -*man VIDIOC_ENUMINPUT(2)* +NAME +==== -Enumerate video inputs +VIDIOC_ENUMINPUT - Enumerate video inputs - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_input *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query the attributes of a video input applications initialize the @@ -353,8 +354,7 @@ at index zero, incrementing by one until the driver returns ``EINVAL``. :ref:`v4l2-selections-common`. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-enumoutput.rst b/Documentation/linux_tv/media/v4l/vidioc-enumoutput.rst index a0a9a375ef3f..99c70e54c4d6 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-enumoutput.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-enumoutput.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_ENUMOUTPUT *********************** -*man VIDIOC_ENUMOUTPUT(2)* +NAME +==== -Enumerate video outputs +VIDIOC_ENUMOUTPUT - Enumerate video outputs - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_output *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query the attributes of a video outputs applications initialize the @@ -208,8 +209,7 @@ EINVAL. :ref:`v4l2-selections-common`. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-enumstd.rst b/Documentation/linux_tv/media/v4l/vidioc-enumstd.rst index 718b29510eeb..e74514ea4437 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-enumstd.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-enumstd.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_ENUMSTD ******************** -*man VIDIOC_ENUMSTD(2)* +NAME +==== -Enumerate supported video standards +VIDIOC_ENUMSTD - Enumerate supported video standards - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_standard *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query the attributes of a video standard, especially a custom (driver @@ -384,8 +385,7 @@ support digital TV. See also the Linux DVB API at - + 6.5 [8]_ - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-expbuf.rst b/Documentation/linux_tv/media/v4l/vidioc-expbuf.rst index 548b15a841c3..2c08a349ab45 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-expbuf.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-expbuf.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_EXPBUF ******************* -*man VIDIOC_EXPBUF(2)* +NAME +==== -Export a buffer as a DMABUF file descriptor. +VIDIOC_EXPBUF - Export a buffer as a DMABUF file descriptor. - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_exportbuffer *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== This ioctl is an extension to the :ref:`memory mapping <mmap>` I/O @@ -183,8 +184,7 @@ Examples the array to zero. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-audio.rst b/Documentation/linux_tv/media/v4l/vidioc-g-audio.rst index d0bdc2d36734..02db00a31722 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-audio.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-audio.rst @@ -6,20 +6,20 @@ ioctl VIDIOC_G_AUDIO, VIDIOC_S_AUDIO ************************************ -*man VIDIOC_G_AUDIO(2)* +NAME +==== -VIDIOC_S_AUDIO -Query or select the current audio input and its attributes +VIDIOC_G_AUDIO - VIDIOC_S_AUDIO - Query or select the current audio input and its attributes - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_audio *argp ) .. cpp:function:: int ioctl( int fd, int request, const struct v4l2_audio *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +31,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query the current audio input applications zero out the ``reserved`` @@ -149,8 +149,7 @@ return the actual new audio mode. - AVL mode is on. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-audioout.rst b/Documentation/linux_tv/media/v4l/vidioc-g-audioout.rst index 7f13b6fbb73d..9265be57d0f9 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-audioout.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-audioout.rst @@ -6,20 +6,20 @@ ioctl VIDIOC_G_AUDOUT, VIDIOC_S_AUDOUT ************************************** -*man VIDIOC_G_AUDOUT(2)* +NAME +==== -VIDIOC_S_AUDOUT -Query or select the current audio output +VIDIOC_G_AUDOUT - VIDIOC_S_AUDOUT - Query or select the current audio output - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_audioout *argp ) .. cpp:function:: int ioctl( int fd, int request, const struct v4l2_audioout *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +31,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query the current audio output applications zero out the ``reserved`` @@ -108,8 +108,7 @@ sound card are not audio outputs in this sense. the array to zero. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-crop.rst b/Documentation/linux_tv/media/v4l/vidioc-g-crop.rst index a368636b305d..206fdd5f825f 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-crop.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-crop.rst @@ -6,20 +6,20 @@ ioctl VIDIOC_G_CROP, VIDIOC_S_CROP ********************************** -*man VIDIOC_G_CROP(2)* +NAME +==== -VIDIOC_S_CROP -Get or set the current cropping rectangle +VIDIOC_G_CROP - VIDIOC_S_CROP - Get or set the current cropping rectangle - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_crop *argp ) .. cpp:function:: int ioctl( int fd, int request, const struct v4l2_crop *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +31,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query the cropping rectangle size and position applications set the @@ -104,8 +104,7 @@ When cropping is not supported then no parameters are changed and :ref:`v4l2_cropcap <v4l2-cropcap>` ``bounds`` is used. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-ctrl.rst b/Documentation/linux_tv/media/v4l/vidioc-g-ctrl.rst index db1e7b252147..50fddb140288 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-ctrl.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-ctrl.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_G_CTRL, VIDIOC_S_CTRL ********************************** -*man VIDIOC_G_CTRL(2)* +NAME +==== -VIDIOC_S_CTRL -Get or set the value of a control +VIDIOC_G_CTRL - VIDIOC_S_CTRL - Get or set the value of a control - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_control *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To get the current value of a control applications initialize the ``id`` @@ -78,8 +78,7 @@ These ioctls work only with user controls. For other control classes the - New value or current value. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-dv-timings.rst b/Documentation/linux_tv/media/v4l/vidioc-g-dv-timings.rst index 8c72b2d461d3..f6e7fd261ebc 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-dv-timings.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-dv-timings.rst @@ -6,20 +6,18 @@ ioctl VIDIOC_G_DV_TIMINGS, VIDIOC_S_DV_TIMINGS ********************************************** -*man VIDIOC_G_DV_TIMINGS(2)* +NAME +==== -VIDIOC_S_DV_TIMINGS -VIDIOC_SUBDEV_G_DV_TIMINGS -VIDIOC_SUBDEV_S_DV_TIMINGS -Get or set DV timings for input or output +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 - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_dv_timings *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -32,7 +30,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To set DV timings for the input or output, applications use the @@ -51,7 +49,7 @@ the current input or output does not support DV timings (e.g. if ``V4L2_IN_CAP_DV_TIMINGS`` flag), then ``ENODATA`` error code is returned. -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-edid.rst b/Documentation/linux_tv/media/v4l/vidioc-g-edid.rst index cbed4805f017..1414026f5740 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-edid.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-edid.rst @@ -6,20 +6,18 @@ ioctl VIDIOC_G_EDID, VIDIOC_S_EDID, VIDIOC_SUBDEV_G_EDID, VIDIOC_SUBDEV_S_EDID ****************************************************************************** -*man VIDIOC_G_EDID(2)* +NAME +==== -VIDIOC_S_EDID -VIDIOC_SUBDEV_G_EDID -VIDIOC_SUBDEV_S_EDID -Get or set the EDID of a video receiver/transmitter +VIDIOC_G_EDID - VIDIOC_S_EDID - VIDIOC_SUBDEV_G_EDID - VIDIOC_SUBDEV_S_EDID - Get or set the EDID of a video receiver/transmitter - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_edid *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -32,7 +30,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== These ioctls can be used to get or set an EDID associated with an input @@ -145,8 +143,7 @@ EDID is no longer available. ``blocks`` * 128. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-enc-index.rst b/Documentation/linux_tv/media/v4l/vidioc-g-enc-index.rst index 0ae21890dd61..16f0e8135952 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-enc-index.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-enc-index.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_G_ENC_INDEX ************************ -*man VIDIOC_G_ENC_INDEX(2)* +NAME +==== -Get meta data about a compressed video stream +VIDIOC_G_ENC_INDEX - Get meta data about a compressed video stream - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_enc_idx *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== The :ref:`VIDIOC_G_ENC_INDEX <VIDIOC_G_ENC_INDEX>` ioctl provides meta data about a compressed @@ -200,8 +201,7 @@ video elementary streams. type. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-ext-ctrls.rst b/Documentation/linux_tv/media/v4l/vidioc-g-ext-ctrls.rst index 9a2cc1b98c43..2f69b1cf804b 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-ext-ctrls.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-ext-ctrls.rst @@ -6,19 +6,18 @@ ioctl VIDIOC_G_EXT_CTRLS, VIDIOC_S_EXT_CTRLS, VIDIOC_TRY_EXT_CTRLS ****************************************************************** -*man VIDIOC_G_EXT_CTRLS(2)* +NAME +==== -VIDIOC_S_EXT_CTRLS -VIDIOC_TRY_EXT_CTRLS -Get or set the value of several controls, try control values +VIDIOC_G_EXT_CTRLS - VIDIOC_S_EXT_CTRLS - VIDIOC_TRY_EXT_CTRLS - Get or set the value of several controls, try control values - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_ext_controls *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +30,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== These ioctls allow the caller to get or set multiple controls @@ -452,8 +451,7 @@ still cause this situation. described in :ref:`rf-tuner-controls`. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-fbuf.rst b/Documentation/linux_tv/media/v4l/vidioc-g-fbuf.rst index 05a477f4925c..4d0799414420 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-fbuf.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-fbuf.rst @@ -6,20 +6,20 @@ ioctl VIDIOC_G_FBUF, VIDIOC_S_FBUF ********************************** -*man VIDIOC_G_FBUF(2)* +NAME +==== -VIDIOC_S_FBUF -Get or set frame buffer overlay parameters +VIDIOC_G_FBUF - VIDIOC_S_FBUF - Get or set frame buffer overlay parameters - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_framebuffer *argp ) .. cpp:function:: int ioctl( int fd, int request, const struct v4l2_framebuffer *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +31,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== Applications can use the :ref:`VIDIOC_G_FBUF <VIDIOC_G_FBUF>` and :ref:`VIDIOC_S_FBUF <VIDIOC_G_FBUF>` ioctl @@ -477,8 +477,7 @@ destructive video overlay. :ref:`v4l2_window <v4l2-window>` is being used. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-fmt.rst b/Documentation/linux_tv/media/v4l/vidioc-g-fmt.rst index 4e56ff72ddcb..aede100b668b 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-fmt.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-fmt.rst @@ -6,19 +6,18 @@ ioctl VIDIOC_G_FMT, VIDIOC_S_FMT, VIDIOC_TRY_FMT ************************************************ -*man VIDIOC_G_FMT(2)* +NAME +==== -VIDIOC_S_FMT -VIDIOC_TRY_FMT -Get or set the data format, try a format +VIDIOC_G_FMT - VIDIOC_S_FMT - VIDIOC_TRY_FMT - Get or set the data format, try a format - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_format *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -30,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== These ioctls are used to negotiate the format of data (typically image @@ -176,8 +175,7 @@ The format as returned by :ref:`VIDIOC_TRY_FMT <VIDIOC_G_FMT>` must be identical - Place holder for future extensions. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-frequency.rst b/Documentation/linux_tv/media/v4l/vidioc-g-frequency.rst index e5c49033b5a1..2b921cda2e4d 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-frequency.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-frequency.rst @@ -6,20 +6,20 @@ ioctl VIDIOC_G_FREQUENCY, VIDIOC_S_FREQUENCY ******************************************** -*man VIDIOC_G_FREQUENCY(2)* +NAME +==== -VIDIOC_S_FREQUENCY -Get or set tuner or modulator radio frequency +VIDIOC_G_FREQUENCY - VIDIOC_S_FREQUENCY - Get or set tuner or modulator radio frequency - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_frequency *argp ) .. cpp:function:: int ioctl( int fd, int request, const struct v4l2_frequency *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +31,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To get the current tuner or modulator radio frequency applications set @@ -107,8 +107,7 @@ write-only ioctl, it does not return the actual new frequency. the array to zero. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-input.rst b/Documentation/linux_tv/media/v4l/vidioc-g-input.rst index aae135ea2a77..e069ba3952ea 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-input.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-input.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_G_INPUT, VIDIOC_S_INPUT ************************************ -*man VIDIOC_G_INPUT(2)* +NAME +==== -VIDIOC_S_INPUT -Query or select the current video input +VIDIOC_G_INPUT - VIDIOC_S_INPUT - Query or select the current video input - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, int *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query the current video input applications call the @@ -50,7 +50,7 @@ Information about video inputs is available using the :ref:`VIDIOC_ENUMINPUT` ioctl. -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-jpegcomp.rst b/Documentation/linux_tv/media/v4l/vidioc-g-jpegcomp.rst index cea36cf3af17..c8d3a3b53a51 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-jpegcomp.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-jpegcomp.rst @@ -6,18 +6,20 @@ ioctl VIDIOC_G_JPEGCOMP, VIDIOC_S_JPEGCOMP ****************************************** -*man VIDIOC_G_JPEGCOMP(2)* +NAME +==== -VIDIOC_S_JPEGCOMP +VIDIOC_G_JPEGCOMP - VIDIOC_S_JPEGCOMP -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, v4l2_jpegcompression *argp ) .. cpp:function:: int ioctl( int fd, int request, const v4l2_jpegcompression *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +31,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== These ioctls are **deprecated**. New drivers and applications should use @@ -173,8 +175,7 @@ encoding. You usually do want to add them. - App segment, driver will always use APP0 - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-modulator.rst b/Documentation/linux_tv/media/v4l/vidioc-g-modulator.rst index 7fe256319682..21b9fea34b8c 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-modulator.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-modulator.rst @@ -6,20 +6,20 @@ ioctl VIDIOC_G_MODULATOR, VIDIOC_S_MODULATOR ******************************************** -*man VIDIOC_G_MODULATOR(2)* +NAME +==== -VIDIOC_S_MODULATOR -Get or set modulator attributes +VIDIOC_G_MODULATOR - VIDIOC_S_MODULATOR - Get or set modulator attributes - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_modulator *argp ) .. cpp:function:: int ioctl( int fd, int request, const struct v4l2_modulator *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +31,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query the attributes of a modulator applications initialize the @@ -242,8 +242,7 @@ To change the radio frequency the - Enable the RDS encoder for a radio FM transmitter. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-output.rst b/Documentation/linux_tv/media/v4l/vidioc-g-output.rst index cd0646eb7539..c9fb075ec5d1 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-output.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-output.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_G_OUTPUT, VIDIOC_S_OUTPUT ************************************** -*man VIDIOC_G_OUTPUT(2)* +NAME +==== -VIDIOC_S_OUTPUT -Query or select the current video output +VIDIOC_G_OUTPUT - VIDIOC_S_OUTPUT - Query or select the current video output - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, int *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query the current video output applications call the @@ -51,7 +51,7 @@ Information about video outputs is available using the :ref:`VIDIOC_ENUMOUTPUT` ioctl. -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-parm.rst b/Documentation/linux_tv/media/v4l/vidioc-g-parm.rst index 7dbf1b5e918e..964e3b8ce275 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-parm.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-parm.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_G_PARM, VIDIOC_S_PARM ********************************** -*man VIDIOC_G_PARM(2)* +NAME +==== -VIDIOC_S_PARM -Get or set streaming parameters +VIDIOC_G_PARM - VIDIOC_S_PARM - Get or set streaming parameters - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, v4l2_streamparm *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== The current video standard determines a nominal number of frames per @@ -340,8 +340,7 @@ union holding separate parameters for input and output devices. - Capture might only work through the :ref:`read() <func-read>` call. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-priority.rst b/Documentation/linux_tv/media/v4l/vidioc-g-priority.rst index 1551f3139899..8255f2469cd9 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-priority.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-priority.rst @@ -6,20 +6,20 @@ ioctl VIDIOC_G_PRIORITY, VIDIOC_S_PRIORITY ****************************************** -*man VIDIOC_G_PRIORITY(2)* +NAME +==== -VIDIOC_S_PRIORITY -Query or request the access priority associated with a file descriptor +VIDIOC_G_PRIORITY - VIDIOC_S_PRIORITY - Query or request the access priority associated with a file descriptor - -Synopsis +SYNOPSIS ======== .. c:function:: int ioctl( int fd, int request, enum v4l2_priority *argp ) .. c:function:: int ioctl( int fd, int request, const enum v4l2_priority *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -32,7 +32,7 @@ Arguments Pointer to an enum v4l2_priority type. -Description +DESCRIPTION =========== To query the current access priority applications call the @@ -102,8 +102,7 @@ with a pointer to this variable. applications which must not be interrupted, like video recording. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-selection.rst b/Documentation/linux_tv/media/v4l/vidioc-g-selection.rst index 609510a03cde..c4164eaafca8 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-selection.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-selection.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_G_SELECTION, VIDIOC_S_SELECTION ******************************************** -*man VIDIOC_G_SELECTION(2)* +NAME +==== -VIDIOC_S_SELECTION -Get or set one of the selection rectangles +VIDIOC_G_SELECTION - VIDIOC_S_SELECTION - Get or set one of the selection rectangles - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_selection *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== The ioctls are used to query and configure selection rectangles. @@ -187,8 +187,7 @@ Selection targets and flags are documented in this array. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-sliced-vbi-cap.rst b/Documentation/linux_tv/media/v4l/vidioc-g-sliced-vbi-cap.rst index 39d297836824..466760241fdb 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-sliced-vbi-cap.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-sliced-vbi-cap.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_G_SLICED_VBI_CAP ***************************** -*man VIDIOC_G_SLICED_VBI_CAP(2)* +NAME +==== -Query sliced VBI capabilities +VIDIOC_G_SLICED_VBI_CAP - Query sliced VBI capabilities - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_sliced_vbi_cap *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To find out which data services are supported by a sliced VBI capture or @@ -263,8 +264,7 @@ to write-read, in Linux 2.6.19. - :cspan:`2` Set of services applicable to 625 line systems. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-std.rst b/Documentation/linux_tv/media/v4l/vidioc-g-std.rst index e1e3bb7fa726..4fbc9e9bfeb8 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-std.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-std.rst @@ -6,20 +6,20 @@ ioctl VIDIOC_G_STD, VIDIOC_S_STD ******************************** -*man VIDIOC_G_STD(2)* +NAME +==== -VIDIOC_S_STD -Query or select the video standard of the current input +VIDIOC_G_STD - VIDIOC_S_STD - Query or select the video standard of the current input - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, v4l2_std_id *argp ) .. cpp:function:: int ioctl( int fd, int request, const v4l2_std_id *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +31,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query and select the current video standard applications use the @@ -53,7 +53,7 @@ does not set the ``V4L2_IN_CAP_STD`` flag), then ``ENODATA`` error code is returned. -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-tuner.rst b/Documentation/linux_tv/media/v4l/vidioc-g-tuner.rst index eee4acfcf3cf..fe904db57597 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-g-tuner.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-g-tuner.rst @@ -6,20 +6,20 @@ ioctl VIDIOC_G_TUNER, VIDIOC_S_TUNER ************************************ -*man VIDIOC_G_TUNER(2)* +NAME +==== -VIDIOC_S_TUNER -Get or set tuner attributes +VIDIOC_G_TUNER - VIDIOC_S_TUNER - Get or set tuner attributes - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_tuner *argp ) .. cpp:function:: int ioctl( int fd, int request, const struct v4l2_tuner *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +31,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query the attributes of a tuner applications initialize the ``index`` @@ -692,8 +692,7 @@ To change the radio frequency the - Lang1/Lang2 (preferred) or Lang1/Lang1 - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-log-status.rst b/Documentation/linux_tv/media/v4l/vidioc-log-status.rst index afff82efe392..d96d5e4f242a 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-log-status.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-log-status.rst @@ -6,17 +6,23 @@ ioctl VIDIOC_LOG_STATUS *********************** -*man VIDIOC_LOG_STATUS(2)* +NAME +==== -Log driver status information +VIDIOC_LOG_STATUS - Log driver status information - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request ) -Description + +ARGUMENTS +========= + + + +DESCRIPTION =========== As the video/audio devices become more complicated it becomes harder to @@ -31,7 +37,7 @@ This ioctl is optional and not all drivers support it. It was introduced in Linux 2.6.15. -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-overlay.rst b/Documentation/linux_tv/media/v4l/vidioc-overlay.rst index 41ddeea5537f..cd58a34a7ee8 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-overlay.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-overlay.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_OVERLAY ******************** -*man VIDIOC_OVERLAY(2)* +NAME +==== -Start or stop video overlay +VIDIOC_OVERLAY - Start or stop video overlay - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, const int *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== This ioctl is part of the :ref:`video overlay <overlay>` I/O method. @@ -41,7 +42,7 @@ Drivers do not support :ref:`VIDIOC_STREAMON` or ``V4L2_BUF_TYPE_VIDEO_OVERLAY``. -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-prepare-buf.rst b/Documentation/linux_tv/media/v4l/vidioc-prepare-buf.rst index 2c88d3cedecf..0f51082f8c93 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-prepare-buf.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-prepare-buf.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_PREPARE_BUF ************************ -*man VIDIOC_PREPARE_BUF(2)* +NAME +==== -Prepare a buffer for I/O +VIDIOC_PREPARE_BUF - Prepare a buffer for I/O - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_buffer *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== Applications can optionally call the :ref:`VIDIOC_PREPARE_BUF` ioctl to @@ -44,7 +45,7 @@ The :ref:`struct v4l2_buffer <v4l2-buffer>` structure is specified in :ref:`buffer`. -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-qbuf.rst b/Documentation/linux_tv/media/v4l/vidioc-qbuf.rst index 88179f8019fa..bf41f30cf9c4 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-qbuf.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-qbuf.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_QBUF, VIDIOC_DQBUF ******************************* -*man VIDIOC_QBUF(2)* +NAME +==== -VIDIOC_DQBUF -Exchange a buffer with the driver +VIDIOC_QBUF - VIDIOC_DQBUF - Exchange a buffer with the driver - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_buffer *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== Applications call the ``VIDIOC_QBUF`` ioctl to enqueue an empty @@ -116,7 +116,7 @@ The :ref:`struct v4l2_buffer <v4l2-buffer>` structure is specified in :ref:`buffer`. -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-query-dv-timings.rst b/Documentation/linux_tv/media/v4l/vidioc-query-dv-timings.rst index 6a37b6503399..38295fd5f1ad 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-query-dv-timings.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-query-dv-timings.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_QUERY_DV_TIMINGS ***************************** -*man VIDIOC_QUERY_DV_TIMINGS(2)* +NAME +==== -VIDIOC_SUBDEV_QUERY_DV_TIMINGS -Sense the DV preset received by the current input +VIDIOC_QUERY_DV_TIMINGS - VIDIOC_SUBDEV_QUERY_DV_TIMINGS - Sense the DV preset received by the current input - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_dv_timings *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== The hardware may be able to detect the current DV timings automatically, @@ -61,7 +61,7 @@ found timings with the hardware's capabilities in order to give more precise feedback to the user. -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-querybuf.rst b/Documentation/linux_tv/media/v4l/vidioc-querybuf.rst index 2fae7021b511..6454c302644d 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-querybuf.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-querybuf.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_QUERYBUF ********************* -*man VIDIOC_QUERYBUF(2)* +NAME +==== -Query the status of a buffer +VIDIOC_QUERYBUF - Query the status of a buffer - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_buffer *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== This ioctl is part of the :ref:`streaming <mmap>` I/O method. It can @@ -67,7 +68,7 @@ The :ref:`struct v4l2_buffer <v4l2-buffer>` structure is specified in :ref:`buffer`. -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-querycap.rst b/Documentation/linux_tv/media/v4l/vidioc-querycap.rst index 0051c483a323..406c5eb34034 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-querycap.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-querycap.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_QUERYCAP ********************* -*man VIDIOC_QUERYCAP(2)* +NAME +==== -Query device capabilities +VIDIOC_QUERYCAP - Query device capabilities - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_capability *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== All V4L2 devices support the ``VIDIOC_QUERYCAP`` ioctl. It is used to @@ -419,8 +420,7 @@ specification the ioctl returns an ``EINVAL`` error code. ``device_caps`` field. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-queryctrl.rst b/Documentation/linux_tv/media/v4l/vidioc-queryctrl.rst index 93e524c7e38d..4e0eb7b04fd2 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-queryctrl.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-queryctrl.rst @@ -6,14 +6,12 @@ ioctls VIDIOC_QUERYCTRL, VIDIOC_QUERY_EXT_CTRL and VIDIOC_QUERYMENU ******************************************************************* -*man VIDIOC_QUERYCTRL(2)* +NAME +==== -VIDIOC_QUERY_EXT_CTRL -VIDIOC_QUERYMENU -Enumerate controls and menu control items +VIDIOC_QUERYCTRL - VIDIOC_QUERY_EXT_CTRL - VIDIOC_QUERYMENU - Enumerate controls and menu control items - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_queryctrl *argp ) @@ -22,7 +20,8 @@ Synopsis .. cpp:function:: int ioctl( int fd, int request, struct v4l2_querymenu *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -34,7 +33,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query the attributes of a control applications set the ``id`` field @@ -754,8 +753,7 @@ See also the examples in :ref:`control`. ``V4L2_CTRL_TYPE_BUTTON`` have this flag set. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-querystd.rst b/Documentation/linux_tv/media/v4l/vidioc-querystd.rst index 8d6769f2b5c6..fe540f80ef60 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-querystd.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-querystd.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_QUERYSTD ********************* -*man VIDIOC_QUERYSTD(2)* +NAME +==== -Sense the video standard received by the current input +VIDIOC_QUERYSTD - Sense the video standard received by the current input - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, v4l2_std_id *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== The hardware may be able to detect the current video standard @@ -53,7 +54,7 @@ standard is valid they will have to stop streaming, set the new standard, allocate new buffers and start streaming again. -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-reqbufs.rst b/Documentation/linux_tv/media/v4l/vidioc-reqbufs.rst index 6803f21c8f4f..2e27708fd7a6 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-reqbufs.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-reqbufs.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_REQBUFS ******************** -*man VIDIOC_REQBUFS(2)* +NAME +==== -Initiate Memory Mapping or User Pointer I/O +VIDIOC_REQBUFS - Initiate Memory Mapping or User Pointer I/O - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_requestbuffers *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== This ioctl is used to initiate :ref:`memory mapped <mmap>`, @@ -111,8 +112,7 @@ any DMA in progress, an implicit must set the array to zero. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-s-hw-freq-seek.rst b/Documentation/linux_tv/media/v4l/vidioc-s-hw-freq-seek.rst index efa5e930b3bb..068a67e8a523 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-s-hw-freq-seek.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-s-hw-freq-seek.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_S_HW_FREQ_SEEK *************************** -*man VIDIOC_S_HW_FREQ_SEEK(2)* +NAME +==== -Perform a hardware frequency seek +VIDIOC_S_HW_FREQ_SEEK - Perform a hardware frequency seek - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_hw_freq_seek *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== Start a hardware frequency seek from the current frequency. To do this @@ -154,8 +155,7 @@ error code is returned and no seek takes place. zero. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-streamon.rst b/Documentation/linux_tv/media/v4l/vidioc-streamon.rst index c3ea38c6cb5b..0e6b750f8718 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-streamon.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-streamon.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_STREAMON, VIDIOC_STREAMOFF *************************************** -*man VIDIOC_STREAMON(2)* +NAME +==== -VIDIOC_STREAMOFF -Start or stop streaming I/O +VIDIOC_STREAMON - VIDIOC_STREAMOFF - Start or stop streaming I/O - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, const int *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== The ``VIDIOC_STREAMON`` and ``VIDIOC_STREAMOFF`` ioctl start and stop @@ -81,7 +81,7 @@ no notion of starting or stopping "now". Buffer timestamps can be used to synchronize with other events. -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-interval.rst b/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-interval.rst index d22926a6257b..0d2b690cf8bc 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-interval.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-interval.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL *************************************** -*man VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL(2)* +NAME +==== -Enumerate frame intervals +VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL - Enumerate frame intervals - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_subdev_frame_interval_enum * argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== This ioctl lets applications enumerate available frame intervals on a @@ -136,8 +137,7 @@ multiple pads of the same sub-device is not defined. the array to zero. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-size.rst b/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-size.rst index 91738510b122..c52a02df5b16 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-size.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-size.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_SUBDEV_ENUM_FRAME_SIZE *********************************** -*man VIDIOC_SUBDEV_ENUM_FRAME_SIZE(2)* +NAME +==== -Enumerate media bus frame sizes +VIDIOC_SUBDEV_ENUM_FRAME_SIZE - Enumerate media bus frame sizes - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_subdev_frame_size_enum * argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== This ioctl allows applications to enumerate all frame sizes supported by @@ -146,8 +147,7 @@ information about try formats. the array to zero. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-mbus-code.rst b/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-mbus-code.rst index da0d0407346c..1ff173e502f7 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-mbus-code.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-mbus-code.rst @@ -6,17 +6,18 @@ ioctl VIDIOC_SUBDEV_ENUM_MBUS_CODE ********************************** -*man VIDIOC_SUBDEV_ENUM_MBUS_CODE(2)* +NAME +==== -Enumerate media bus formats +VIDIOC_SUBDEV_ENUM_MBUS_CODE - Enumerate media bus formats - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_subdev_mbus_code_enum * argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To enumerate media bus formats available at a given sub-device pad @@ -99,8 +100,7 @@ information about the try formats. the array to zero. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-subdev-g-crop.rst b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-crop.rst index eb13718a4654..94bffa78c486 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-subdev-g-crop.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-crop.rst @@ -6,20 +6,20 @@ ioctl VIDIOC_SUBDEV_G_CROP, VIDIOC_SUBDEV_S_CROP ************************************************ -*man VIDIOC_SUBDEV_G_CROP(2)* +NAME +==== -VIDIOC_SUBDEV_S_CROP -Get or set the crop rectangle on a subdev pad +VIDIOC_SUBDEV_G_CROP - VIDIOC_SUBDEV_S_CROP - Get or set the crop rectangle on a subdev pad - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_subdev_crop *argp ) .. cpp:function:: int ioctl( int fd, int request, const struct v4l2_subdev_crop *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +31,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== **Note** @@ -114,8 +114,7 @@ modified format should be as close as possible to the original request. the array to zero. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-subdev-g-fmt.rst b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-fmt.rst index 9de901ad7cdd..13615c0d0392 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-subdev-g-fmt.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-fmt.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_SUBDEV_G_FMT, VIDIOC_SUBDEV_S_FMT ********************************************** -*man VIDIOC_SUBDEV_G_FMT(2)* +NAME +==== -VIDIOC_SUBDEV_S_FMT -Get or set the data format on a subdev pad +VIDIOC_SUBDEV_G_FMT - VIDIOC_SUBDEV_S_FMT - Get or set the data format on a subdev pad - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_subdev_format *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== These ioctls are used to negotiate the frame format at specific subdev @@ -144,8 +144,7 @@ should be as close as possible to the original request. - Active formats, applied to the hardware. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -164,7 +163,6 @@ EINVAL references a non-existing format. -Return Value ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-subdev-g-frame-interval.rst b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-frame-interval.rst index 947fbf0f9a23..05f5bfb3f1ca 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-subdev-g-frame-interval.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-frame-interval.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_SUBDEV_G_FRAME_INTERVAL, VIDIOC_SUBDEV_S_FRAME_INTERVAL ******************************************************************** -*man VIDIOC_SUBDEV_G_FRAME_INTERVAL(2)* +NAME +==== -VIDIOC_SUBDEV_S_FRAME_INTERVAL -Get or set the frame interval on a subdev pad +VIDIOC_SUBDEV_G_FRAME_INTERVAL - VIDIOC_SUBDEV_S_FRAME_INTERVAL - Get or set the frame interval on a subdev pad - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_subdev_frame_interval *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -30,7 +30,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== These ioctls are used to get and set the frame interval at specific @@ -100,8 +100,7 @@ the same sub-device is not defined. the array to zero. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-subdev-g-selection.rst b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-selection.rst index fa6dcccd0a2b..dd0dab7d7e42 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-subdev-g-selection.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-selection.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_SUBDEV_G_SELECTION, VIDIOC_SUBDEV_S_SELECTION ********************************************************** -*man VIDIOC_SUBDEV_G_SELECTION(2)* +NAME +==== -VIDIOC_SUBDEV_S_SELECTION -Get or set selection rectangles on a subdev pad +VIDIOC_SUBDEV_G_SELECTION - VIDIOC_SUBDEV_S_SELECTION - Get or set selection rectangles on a subdev pad - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_subdev_selection *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== The selections are used to configure various image processing @@ -122,8 +122,7 @@ Selection targets and flags are documented in the array to zero. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/v4l/vidioc-subscribe-event.rst b/Documentation/linux_tv/media/v4l/vidioc-subscribe-event.rst index 8beba56d62b9..2ecce157f852 100644 --- a/Documentation/linux_tv/media/v4l/vidioc-subscribe-event.rst +++ b/Documentation/linux_tv/media/v4l/vidioc-subscribe-event.rst @@ -6,18 +6,18 @@ ioctl VIDIOC_SUBSCRIBE_EVENT, VIDIOC_UNSUBSCRIBE_EVENT ****************************************************** -*man VIDIOC_SUBSCRIBE_EVENT(2)* +NAME +==== -VIDIOC_UNSUBSCRIBE_EVENT -Subscribe or unsubscribe event +VIDIOC_SUBSCRIBE_EVENT - VIDIOC_UNSUBSCRIBE_EVENT - Subscribe or unsubscribe event - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct v4l2_event_subscription *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== Subscribe or unsubscribe V4L2 event. Subscribed events are dequeued by @@ -126,8 +126,7 @@ using the :ref:`VIDIOC_DQEVENT` ioctl. situations like that. - -Return Value +RETURN VALUE ============ On success 0 is returned, on error -1 and the ``errno`` variable is set |