diff --git a/Documentation/linux_tv/media/dvb/FE_DISHNETWORK_SEND_LEGACY_CMD.rst b/Documentation/linux_tv/media/dvb/FE_DISHNETWORK_SEND_LEGACY_CMD.rst index ff94ac9122d03d9d40d2f9511a758d11042685a1..9435f45f58c3f225d0de75a4d5b7d2ca71b2085e 100644 --- a/Documentation/linux_tv/media/dvb/FE_DISHNETWORK_SEND_LEGACY_CMD.rst +++ b/Documentation/linux_tv/media/dvb/FE_DISHNETWORK_SEND_LEGACY_CMD.rst @@ -6,27 +6,19 @@ FE_DISHNETWORK_SEND_LEGACY_CMD ****************************** -Description ------------ +NAME +==== -WARNING: This is a very obscure legacy command, used only at stv0299 -driver. Should not be used on newer drivers. - -It provides a non-standard method for selecting Diseqc voltage on the -frontend, for Dish Network legacy switches. - -As support for this ioctl were added in 2004, this means that such -dishes were already legacy in 2004. +FE_DISHNETWORK_SEND_LEGACY_CMD -Synopsis --------- +SYNOPSIS +======== .. c:function:: int ioctl(int fd, int request = FE_DISHNETWORK_SEND_LEGACY_CMD, unsigned long cmd) -Arguments ----------- - +ARGUMENTS +========= .. flat-table:: :header-rows: 0 @@ -40,8 +32,21 @@ Arguments - sends the specified raw cmd to the dish via DISEqC. -Return Value ------------- +DESCRIPTION +=========== + +WARNING: This is a very obscure legacy command, used only at stv0299 +driver. Should not be used on newer drivers. + +It provides a non-standard method for selecting Diseqc voltage on the +frontend, for Dish Network legacy switches. + +As support for this ioctl were added in 2004, this means that such +dishes were already legacy in 2004. + + +RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/FE_GET_EVENT.rst b/Documentation/linux_tv/media/dvb/FE_GET_EVENT.rst index 24352b26a201c67bf99dcbd00fb97c60dc22e01f..3d858107b6f9466512ccfef519ec82e069249b2c 100644 --- a/Documentation/linux_tv/media/dvb/FE_GET_EVENT.rst +++ b/Documentation/linux_tv/media/dvb/FE_GET_EVENT.rst @@ -6,24 +6,19 @@ FE_GET_EVENT ************ -Description ------------ +NAME +==== -This ioctl call returns a frontend event if available. If an event is -not available, the behavior depends on whether the device is in blocking -or non-blocking mode. In the latter case, the call fails immediately -with errno set to ``EWOULDBLOCK``. In the former case, the call blocks until -an event becomes available. +FE_GET_EVENT -Synopsis --------- +SYNOPSIS +======== .. c:function:: int ioctl(int fd, int request = QPSK_GET_EVENT, struct dvb_frontend_event *ev) -Arguments ----------- - +ARGUMENTS +========= .. flat-table:: :header-rows: 0 @@ -54,8 +49,18 @@ Arguments - if any, is to be stored. -Return Value ------------- +DESCRIPTION +=========== + +This ioctl call returns a frontend event if available. If an event is +not available, the behavior depends on whether the device is in blocking +or non-blocking mode. In the latter case, the call fails immediately +with errno set to ``EWOULDBLOCK``. In the former case, the call blocks until +an event becomes available. + + +RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/FE_GET_FRONTEND.rst b/Documentation/linux_tv/media/dvb/FE_GET_FRONTEND.rst index d8dbcc7741d4379d4fcb3813676ff8f3ffca15f3..7084070bfe77203031554127267ed0c29c8cf43f 100644 --- a/Documentation/linux_tv/media/dvb/FE_GET_FRONTEND.rst +++ b/Documentation/linux_tv/media/dvb/FE_GET_FRONTEND.rst @@ -6,21 +6,19 @@ FE_GET_FRONTEND *************** -Description ------------ +NAME +==== -This ioctl call queries the currently effective frontend parameters. For -this command, read-only access to the device is sufficient. +FE_GET_FRONTEND -Synopsis --------- +SYNOPSIS +======== .. c:function:: int ioctl(int fd, int request = FE_GET_FRONTEND, struct dvb_frontend_parameters *p) -Arguments ----------- - +ARGUMENTS +========= .. flat-table:: :header-rows: 0 @@ -47,8 +45,15 @@ Arguments - Points to parameters for tuning operation. -Return Value ------------- +DESCRIPTION +=========== + +This ioctl call queries the currently effective frontend parameters. For +this command, read-only access to the device is sufficient. + + +RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/FE_READ_SIGNAL_STRENGTH.rst b/Documentation/linux_tv/media/dvb/FE_READ_SIGNAL_STRENGTH.rst index 4adea9274d37948212017afa8d22717a9f3466dd..7f6f47f4d30e63369ce692e75fdfb8b559995dc6 100644 --- a/Documentation/linux_tv/media/dvb/FE_READ_SIGNAL_STRENGTH.rst +++ b/Documentation/linux_tv/media/dvb/FE_READ_SIGNAL_STRENGTH.rst @@ -6,22 +6,19 @@ FE_READ_SIGNAL_STRENGTH *********************** -Description ------------ +NAME +==== -This ioctl call returns the signal strength value for the signal -currently received by the front-end. For this command, read-only access -to the device is sufficient. +FE_READ_SIGNAL_STRENGTH -Synopsis --------- +SYNOPSIS +======== .. c:function:: int ioctl( int fd, int request = FE_READ_SIGNAL_STRENGTH, uint16_t *strength) -Arguments ----------- - +ARGUMENTS +========= .. flat-table:: :header-rows: 0 @@ -49,8 +46,16 @@ Arguments - The signal strength value is stored into \*strength. -Return Value ------------- +DESCRIPTION +=========== + +This ioctl call returns the signal strength value for the signal +currently received by the front-end. For this command, read-only access +to the device is sufficient. + + +RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/FE_READ_SNR.rst b/Documentation/linux_tv/media/dvb/FE_READ_SNR.rst index 11b4f72d684e6e1a2f9c0437c769b0ddcf7fbac4..3ecaeb8007f4dbafcd01486f4a2c8214b2e6e9ca 100644 --- a/Documentation/linux_tv/media/dvb/FE_READ_SNR.rst +++ b/Documentation/linux_tv/media/dvb/FE_READ_SNR.rst @@ -6,22 +6,19 @@ FE_READ_SNR *********** -Description ------------ +NAME +==== -This ioctl call returns the signal-to-noise ratio for the signal -currently received by the front-end. For this command, read-only access -to the device is sufficient. +FE_READ_SNR -Synopsis --------- +SYNOPSIS +======== .. c:function:: int ioctl(int fd, int request = FE_READ_SNR, int16_t *snr) -Arguments ----------- - +ARGUMENTS +========= .. flat-table:: :header-rows: 0 @@ -47,8 +44,16 @@ Arguments - The signal-to-noise ratio is stored into \*snr. -Return Value ------------- +DESCRIPTION +=========== + +This ioctl call returns the signal-to-noise ratio for the signal +currently received by the front-end. For this command, read-only access +to the device is sufficient. + + +RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/FE_READ_UNCORRECTED_BLOCKS.rst b/Documentation/linux_tv/media/dvb/FE_READ_UNCORRECTED_BLOCKS.rst index cb35a416b1e47d45f21e7df23c814f32baba09c8..31ec4c35dd51a7f550e5c25c951e8b3fd6d43c1b 100644 --- a/Documentation/linux_tv/media/dvb/FE_READ_UNCORRECTED_BLOCKS.rst +++ b/Documentation/linux_tv/media/dvb/FE_READ_UNCORRECTED_BLOCKS.rst @@ -6,24 +6,19 @@ FE_READ_UNCORRECTED_BLOCKS ************************** -Description ------------ +NAME +==== -This ioctl call returns the number of uncorrected blocks detected by the -device driver during its lifetime. For meaningful measurements, the -increment in block count during a specific time interval should be -calculated. For this command, read-only access to the device is -sufficient. +FE_READ_UNCORRECTED_BLOCKS -Synopsis --------- +SYNOPSIS +======== .. c:function:: int ioctl( int fd, int request =FE_READ_UNCORRECTED_BLOCKS, uint32_t *ublocks) -Arguments ----------- - +ARGUMENTS +========= .. flat-table:: :header-rows: 0 @@ -51,8 +46,18 @@ Arguments - The total number of uncorrected blocks seen by the driver so far. -Return Value ------------- +DESCRIPTION +=========== + +This ioctl call returns the number of uncorrected blocks detected by the +device driver during its lifetime. For meaningful measurements, the +increment in block count during a specific time interval should be +calculated. For this command, read-only access to the device is +sufficient. + + +RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/FE_SET_FRONTEND.rst b/Documentation/linux_tv/media/dvb/FE_SET_FRONTEND.rst index 98970961da7ba4e3f2815ded6bb7fbd83f7557bb..0cce39666773d8c4fb61c0f7c388b44ccde8ab10 100644 --- a/Documentation/linux_tv/media/dvb/FE_SET_FRONTEND.rst +++ b/Documentation/linux_tv/media/dvb/FE_SET_FRONTEND.rst @@ -6,28 +6,19 @@ FE_SET_FRONTEND *************** -Description ------------ +NAME +==== -This ioctl call starts a tuning operation using specified parameters. -The result of this call will be successful if the parameters were valid -and the tuning could be initiated. The result of the tuning operation in -itself, however, will arrive asynchronously as an event (see -documentation for :ref:`FE_GET_EVENT` and -FrontendEvent.) If a new :ref:`FE_SET_FRONTEND` -operation is initiated before the previous one was completed, the -previous operation will be aborted in favor of the new one. This command -requires read/write access to the device. +FE_SET_FRONTEND -Synopsis --------- +SYNOPSIS +======== .. c:function:: int ioctl(int fd, int request = FE_SET_FRONTEND, struct dvb_frontend_parameters *p) -Arguments ----------- - +ARGUMENTS +========= .. flat-table:: :header-rows: 0 @@ -54,8 +45,22 @@ Arguments - Points to parameters for tuning operation. -Return Value ------------- +DESCRIPTION +=========== + +This ioctl call starts a tuning operation using specified parameters. +The result of this call will be successful if the parameters were valid +and the tuning could be initiated. The result of the tuning operation in +itself, however, will arrive asynchronously as an event (see +documentation for :ref:`FE_GET_EVENT` and +FrontendEvent.) If a new :ref:`FE_SET_FRONTEND` +operation is initiated before the previous one was completed, the +previous operation will be aborted in favor of the new one. This command +requires read/write access to the device. + + +RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/audio-bilingual-channel-select.rst b/Documentation/linux_tv/media/dvb/audio-bilingual-channel-select.rst index b965932fe20cfdf4bcd77656645c9c22e5355133..dda1695e28a9ee16178f76aa6d09db36318609e4 100644 --- a/Documentation/linux_tv/media/dvb/audio-bilingual-channel-select.rst +++ b/Documentation/linux_tv/media/dvb/audio-bilingual-channel-select.rst @@ -2,28 +2,23 @@ .. _AUDIO_BILINGUAL_CHANNEL_SELECT: +============================== AUDIO_BILINGUAL_CHANNEL_SELECT ============================== -Description ------------ - -This ioctl is obsolete. Do not use in new drivers. It has been replaced -by the V4L2 ``V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK`` control -for MPEG decoders controlled through V4L2. +NAME +---- -This ioctl call asks the Audio Device to select the requested channel -for bilingual streams if possible. +AUDIO_BILINGUAL_CHANNEL_SELECT -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_BILINGUAL_CHANNEL_SELECT, audio_channel_select_t) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -49,11 +44,20 @@ Arguments - Select the output format of the audio (mono left/right, stereo). -Return Value +DESCRIPTION +----------- + +This ioctl is obsolete. Do not use in new drivers. It has been replaced +by the V4L2 ``V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK`` control +for MPEG decoders controlled through V4L2. + +This ioctl call asks the Audio Device to select the requested channel +for bilingual streams if possible. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/audio-channel-select.rst b/Documentation/linux_tv/media/dvb/audio-channel-select.rst index d570ff1f7d3a38962cfa4b8b835d5972ee916bbc..f7f9766d39020967b8d59db4b5feaba3192328c0 100644 --- a/Documentation/linux_tv/media/dvb/audio-channel-select.rst +++ b/Documentation/linux_tv/media/dvb/audio-channel-select.rst @@ -2,27 +2,23 @@ .. _AUDIO_CHANNEL_SELECT: +==================== AUDIO_CHANNEL_SELECT ==================== -Description ------------ - -This ioctl is for DVB devices only. To control a V4L2 decoder use the -V4L2 ``V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK`` control instead. +NAME +---- -This ioctl call asks the Audio Device to select the requested channel if -possible. +AUDIO_CHANNEL_SELECT -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_CHANNEL_SELECT, audio_channel_select_t) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -48,11 +44,19 @@ Arguments - Select the output format of the audio (mono left/right, stereo). -Return Value +DESCRIPTION +----------- + +This ioctl is for DVB devices only. To control a V4L2 decoder use the +V4L2 ``V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK`` control instead. + +This ioctl call asks the Audio Device to select the requested channel if +possible. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/audio-clear-buffer.rst b/Documentation/linux_tv/media/dvb/audio-clear-buffer.rst index 6c94cc7402a97429cf5eb03d81105bb3106565fa..97cb3d98f20d96d90592f95ece6b7ec69b874d99 100644 --- a/Documentation/linux_tv/media/dvb/audio-clear-buffer.rst +++ b/Documentation/linux_tv/media/dvb/audio-clear-buffer.rst @@ -2,24 +2,23 @@ .. _AUDIO_CLEAR_BUFFER: +================== AUDIO_CLEAR_BUFFER ================== -Description ------------ +NAME +---- -This ioctl call asks the Audio Device to clear all software and hardware -buffers of the audio decoder device. +AUDIO_CLEAR_BUFFER -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_CLEAR_BUFFER) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -39,11 +38,16 @@ Arguments - Equals AUDIO_CLEAR_BUFFER for this command. -Return Value +DESCRIPTION +----------- + +This ioctl call asks the Audio Device to clear all software and hardware +buffers of the audio decoder device. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/audio-continue.rst b/Documentation/linux_tv/media/dvb/audio-continue.rst index 8b91cf95076520c338cb42a56c27dbbbc966bc82..1f3d5c35b7ce8b96103fbe2c30d3f46205614e25 100644 --- a/Documentation/linux_tv/media/dvb/audio-continue.rst +++ b/Documentation/linux_tv/media/dvb/audio-continue.rst @@ -2,24 +2,23 @@ .. _AUDIO_CONTINUE: +============== AUDIO_CONTINUE ============== -Description ------------ +NAME +---- -This ioctl restarts the decoding and playing process previously paused -with AUDIO_PAUSE command. +AUDIO_CONTINUE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_CONTINUE) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -39,11 +38,16 @@ Arguments - Equals AUDIO_CONTINUE for this command. -Return Value +DESCRIPTION +----------- + +This ioctl restarts the decoding and playing process previously paused +with AUDIO_PAUSE command. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/audio-fclose.rst b/Documentation/linux_tv/media/dvb/audio-fclose.rst index fb855dd9cbcb02a05b036eb19e70d7f627ca26bf..80d9cde4c92675d07b9bc14929bf24be846536eb 100644 --- a/Documentation/linux_tv/media/dvb/audio-fclose.rst +++ b/Documentation/linux_tv/media/dvb/audio-fclose.rst @@ -2,23 +2,23 @@ .. _audio_fclose: +================= DVB audio close() ================= -Description ------------ +NAME +---- -This system call closes a previously opened audio device. +DVB audio close() -Synopsis +SYNOPSIS -------- .. c:function:: int close(int fd) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -32,10 +32,14 @@ Arguments - File descriptor returned by a previous call to open(). -Return Value ------------- +DESCRIPTION +----------- + +This system call closes a previously opened audio device. +RETURN VALUE +------------ .. flat-table:: :header-rows: 0 @@ -47,6 +51,3 @@ Return Value - ``EBADF`` - fd is not a valid open file descriptor. - - - diff --git a/Documentation/linux_tv/media/dvb/audio-fopen.rst b/Documentation/linux_tv/media/dvb/audio-fopen.rst index 5d3d7d941567f73803475aab82637fbdd11f89c5..6596d6427c1fae3dbeada49bb3e8790463a4fcb0 100644 --- a/Documentation/linux_tv/media/dvb/audio-fopen.rst +++ b/Documentation/linux_tv/media/dvb/audio-fopen.rst @@ -2,35 +2,23 @@ .. _audio_fopen: +================ DVB audio open() ================ -Description ------------ +NAME +---- -This system call opens a named audio device (e.g. -/dev/dvb/adapter0/audio0) for subsequent use. When an open() call has -succeeded, the device will be ready for use. The significance of -blocking or non-blocking mode is described in the documentation for -functions where there is a difference. It does not affect the semantics -of the open() call itself. A device opened in blocking mode can later be -put into non-blocking mode (and vice versa) using the F_SETFL command -of the fcntl system call. This is a standard system call, documented in -the Linux manual page for fcntl. Only one user can open the Audio Device -in O_RDWR mode. All other attempts to open the device in this mode will -fail, and an error code will be returned. If the Audio Device is opened -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. +DVB audio open() -Synopsis +SYNOPSIS -------- .. c:function:: int open(const char *deviceName, int flags) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -70,11 +58,27 @@ Arguments - (blocking mode is the default) -Return Value ------------- +DESCRIPTION +----------- +This system call opens a named audio device (e.g. +/dev/dvb/adapter0/audio0) for subsequent use. When an open() call has +succeeded, the device will be ready for use. The significance of +blocking or non-blocking mode is described in the documentation for +functions where there is a difference. It does not affect the semantics +of the open() call itself. A device opened in blocking mode can later be +put into non-blocking mode (and vice versa) using the F_SETFL command +of the fcntl system call. This is a standard system call, documented in +the Linux manual page for fcntl. Only one user can open the Audio Device +in O_RDWR mode. All other attempts to open the device in this mode will +fail, and an error code will be returned. If the Audio Device is opened +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 +------------ + .. flat-table:: :header-rows: 0 :stub-columns: 0 @@ -97,6 +101,3 @@ Return Value - ``EINVAL`` - Invalid argument. - - - diff --git a/Documentation/linux_tv/media/dvb/audio-fwrite.rst b/Documentation/linux_tv/media/dvb/audio-fwrite.rst index 9921f3a16d45c524f0114f753a46e7ce7bc6b8bb..9aa9583a3267316bb47a883cfdb55b1ba543cadf 100644 --- a/Documentation/linux_tv/media/dvb/audio-fwrite.rst +++ b/Documentation/linux_tv/media/dvb/audio-fwrite.rst @@ -2,27 +2,23 @@ .. _audio_fwrite: +================= DVB audio write() ================= -Description ------------ +NAME +---- -This system call can only be used if AUDIO_SOURCE_MEMORY is selected -in the ioctl call AUDIO_SELECT_SOURCE. The data provided shall be in -PES format. If O_NONBLOCK is not specified the function will block -until buffer space is available. The amount of data to be transferred is -implied by count. +DVB audio write() -Synopsis +SYNOPSIS -------- .. c:function:: size_t write(int fd, const void *buf, size_t count) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -48,11 +44,19 @@ Arguments - Size of buf. -Return Value ------------- +DESCRIPTION +----------- +This system call can only be used if AUDIO_SOURCE_MEMORY is selected +in the ioctl call AUDIO_SELECT_SOURCE. The data provided shall be in +PES format. If O_NONBLOCK 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 +------------ + .. flat-table:: :header-rows: 0 :stub-columns: 0 @@ -75,6 +79,3 @@ Return Value - ``EBADF`` - fd is not a valid open file descriptor. - - - diff --git a/Documentation/linux_tv/media/dvb/audio-get-capabilities.rst b/Documentation/linux_tv/media/dvb/audio-get-capabilities.rst index 84b9f073344b77ac6b2031d88a9e2b4dcdcc67de..32e55bbc4d03f230b8007dc540397c166d4cc352 100644 --- a/Documentation/linux_tv/media/dvb/audio-get-capabilities.rst +++ b/Documentation/linux_tv/media/dvb/audio-get-capabilities.rst @@ -2,24 +2,23 @@ .. _AUDIO_GET_CAPABILITIES: +====================== AUDIO_GET_CAPABILITIES ====================== -Description ------------ +NAME +---- -This ioctl call asks the Audio Device to tell us about the decoding -capabilities of the audio hardware. +AUDIO_GET_CAPABILITIES -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_GET_CAPABILITIES, unsigned int *cap) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -45,11 +44,16 @@ Arguments - Returns a bit array of supported sound formats. -Return Value +DESCRIPTION +----------- + +This ioctl call asks the Audio Device to tell us about the decoding +capabilities of the audio hardware. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/audio-get-pts.rst b/Documentation/linux_tv/media/dvb/audio-get-pts.rst index 3cd31741e7288c0d01f4a4dfe35421dc2a88e5d0..a8e2ef5a107d20845518777c0dd9a1231f6a24dd 100644 --- a/Documentation/linux_tv/media/dvb/audio-get-pts.rst +++ b/Documentation/linux_tv/media/dvb/audio-get-pts.rst @@ -2,28 +2,23 @@ .. _AUDIO_GET_PTS: +============= AUDIO_GET_PTS ============= -Description ------------ - -This ioctl is obsolete. Do not use in new drivers. If you need this -functionality, then please contact the linux-media mailing list -(`https://linuxtv.org/lists.php `__). +NAME +---- -This ioctl call asks the Audio Device to return the current PTS -timestamp. +AUDIO_GET_PTS -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_GET_PTS, __u64 *pts) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -54,11 +49,20 @@ Arguments decoded frame or the last PTS extracted by the PES parser. -Return Value +DESCRIPTION +----------- + +This ioctl is obsolete. Do not use in new drivers. If you need this +functionality, then please contact the linux-media mailing list +(`https://linuxtv.org/lists.php `__). + +This ioctl call asks the Audio Device to return the current PTS +timestamp. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/audio-get-status.rst b/Documentation/linux_tv/media/dvb/audio-get-status.rst index be0937fbff0cd49f894d9214c256a6b08e20b061..b9a2850b577ad6550a4c1fa2e7981a97ade97131 100644 --- a/Documentation/linux_tv/media/dvb/audio-get-status.rst +++ b/Documentation/linux_tv/media/dvb/audio-get-status.rst @@ -2,24 +2,23 @@ .. _AUDIO_GET_STATUS: +================ AUDIO_GET_STATUS ================ -Description ------------ +NAME +---- -This ioctl call asks the Audio Device to return the current state of the -Audio Device. +AUDIO_GET_STATUS -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_GET_STATUS, struct audio_status *status) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -45,11 +44,16 @@ Arguments - Returns the current state of Audio Device. -Return Value +DESCRIPTION +----------- + +This ioctl call asks the Audio Device to return the current state of the +Audio Device. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/audio-pause.rst b/Documentation/linux_tv/media/dvb/audio-pause.rst index 2d1c7e880ad091434e9ed95fa7a05b48af79fa31..8b1517b5427282a7b17a1d01a3e05ee61ce609da 100644 --- a/Documentation/linux_tv/media/dvb/audio-pause.rst +++ b/Documentation/linux_tv/media/dvb/audio-pause.rst @@ -2,25 +2,23 @@ .. _AUDIO_PAUSE: +=========== AUDIO_PAUSE =========== -Description ------------ +NAME +---- -This ioctl call suspends the audio stream being played. Decoding and -playing are paused. It is then possible to restart again decoding and -playing process of the audio stream using AUDIO_CONTINUE command. +AUDIO_PAUSE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_PAUSE) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -40,11 +38,17 @@ Arguments - Equals AUDIO_PAUSE for this command. -Return Value +DESCRIPTION +----------- + +This ioctl call suspends the audio stream being played. Decoding and +playing are paused. It is then possible to restart again decoding and +playing process of the audio stream using AUDIO_CONTINUE command. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/audio-play.rst b/Documentation/linux_tv/media/dvb/audio-play.rst index 116cc27be82c77554ba97efc2ca0f27ccc75aac6..22bd35007b256e1756e573d3489c6f115ea6489e 100644 --- a/Documentation/linux_tv/media/dvb/audio-play.rst +++ b/Documentation/linux_tv/media/dvb/audio-play.rst @@ -2,24 +2,23 @@ .. _AUDIO_PLAY: +========== AUDIO_PLAY ========== -Description ------------ +NAME +---- -This ioctl call asks the Audio Device to start playing an audio stream -from the selected source. +AUDIO_PLAY -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_PLAY) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -39,11 +38,16 @@ Arguments - Equals AUDIO_PLAY for this command. -Return Value +DESCRIPTION +----------- + +This ioctl call asks the Audio Device to start playing an audio stream +from the selected source. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/audio-select-source.rst b/Documentation/linux_tv/media/dvb/audio-select-source.rst index 9d6367e7ff6fa7e952fec1ee0662319085ecf2dd..2242e6f0b6ad116161a9066cab77510dc71d7f52 100644 --- a/Documentation/linux_tv/media/dvb/audio-select-source.rst +++ b/Documentation/linux_tv/media/dvb/audio-select-source.rst @@ -2,26 +2,23 @@ .. _AUDIO_SELECT_SOURCE: +=================== AUDIO_SELECT_SOURCE =================== -Description ------------ +NAME +---- -This ioctl call informs the audio device which source shall be used for -the input data. The possible sources are demux or memory. If -AUDIO_SOURCE_MEMORY is selected, the data is fed to the Audio Device -through the write command. +AUDIO_SELECT_SOURCE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_SELECT_SOURCE, audio_stream_source_t source) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -47,11 +44,18 @@ Arguments - Indicates the source that shall be used for the Audio stream. -Return Value +DESCRIPTION +----------- + +This ioctl call informs the audio device which source shall be used for +the input data. The possible sources are demux or memory. If +AUDIO_SOURCE_MEMORY is selected, the data is fed to the Audio Device +through the write command. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/audio-set-attributes.rst b/Documentation/linux_tv/media/dvb/audio-set-attributes.rst index a03774015b40432c1e3953cdb32a0a07dad7ed55..ea08cea6aa78967a6360c1de897899f20a8adefc 100644 --- a/Documentation/linux_tv/media/dvb/audio-set-attributes.rst +++ b/Documentation/linux_tv/media/dvb/audio-set-attributes.rst @@ -2,24 +2,23 @@ .. _AUDIO_SET_ATTRIBUTES: +==================== AUDIO_SET_ATTRIBUTES ==================== -Description ------------ +NAME +---- -This ioctl is intended for DVD playback and allows you to set certain -information about the audio stream. +AUDIO_SET_ATTRIBUTES -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = AUDIO_SET_ATTRIBUTES, audio_attributes_t attr ) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -45,7 +44,14 @@ Arguments - audio attributes according to section ?? -Return Value +DESCRIPTION +----------- + +This ioctl is intended for DVD playback and allows you to set certain +information about the audio stream. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -64,6 +70,3 @@ appropriately. The generic error codes are described at the - ``EINVAL`` - attr is not a valid or supported attribute setting. - - - diff --git a/Documentation/linux_tv/media/dvb/audio-set-av-sync.rst b/Documentation/linux_tv/media/dvb/audio-set-av-sync.rst index 7aa27ab34d91718e0e1df03db9e6d1c5d835ff1e..3f5ac9a87bc81183853fec6b6bc398b2bcc33522 100644 --- a/Documentation/linux_tv/media/dvb/audio-set-av-sync.rst +++ b/Documentation/linux_tv/media/dvb/audio-set-av-sync.rst @@ -2,24 +2,23 @@ .. _AUDIO_SET_AV_SYNC: +================= AUDIO_SET_AV_SYNC ================= -Description ------------ +NAME +---- -This ioctl call asks the Audio Device to turn ON or OFF A/V -synchronization. +AUDIO_SET_AV_SYNC -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_SET_AV_SYNC, boolean state) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -55,11 +54,16 @@ Arguments - FALSE AV-sync OFF -Return Value +DESCRIPTION +----------- + +This ioctl call asks the Audio Device to turn ON or OFF A/V +synchronization. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/audio-set-bypass-mode.rst b/Documentation/linux_tv/media/dvb/audio-set-bypass-mode.rst index 3a0c21a667fa47ec8e4b97df622f46c88650d75e..9377342c646d5aeb431878c4ae020ee51b554eaf 100644 --- a/Documentation/linux_tv/media/dvb/audio-set-bypass-mode.rst +++ b/Documentation/linux_tv/media/dvb/audio-set-bypass-mode.rst @@ -2,27 +2,23 @@ .. _AUDIO_SET_BYPASS_MODE: +===================== AUDIO_SET_BYPASS_MODE ===================== -Description ------------ +NAME +---- -This ioctl call asks the Audio Device to bypass the Audio decoder and -forward the stream without decoding. This mode shall be used if streams -that can’t be handled by the DVB system shall be decoded. Dolby -DigitalTM streams are automatically forwarded by the DVB subsystem if -the hardware can handle it. +AUDIO_SET_BYPASS_MODE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_SET_BYPASS_MODE, boolean mode) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -59,11 +55,19 @@ Arguments - FALSE Bypass is enabled -Return Value +DESCRIPTION +----------- + +This ioctl call asks the Audio Device to bypass the Audio decoder and +forward the stream without decoding. This mode shall be used if streams +that can’t be handled by the DVB system shall be decoded. Dolby +DigitalTM streams are automatically forwarded by the DVB subsystem if +the hardware can handle it. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/audio-set-ext-id.rst b/Documentation/linux_tv/media/dvb/audio-set-ext-id.rst index bda4c92df27f20e32167e5271c3376a7b637bee4..456b05267f29ac07c618b8d7523abac399e48498 100644 --- a/Documentation/linux_tv/media/dvb/audio-set-ext-id.rst +++ b/Documentation/linux_tv/media/dvb/audio-set-ext-id.rst @@ -2,24 +2,23 @@ .. _AUDIO_SET_EXT_ID: +================ AUDIO_SET_EXT_ID ================ -Description ------------ +NAME +---- -This ioctl can be used to set the extension id for MPEG streams in DVD -playback. Only the first 3 bits are recognized. +AUDIO_SET_EXT_ID -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = AUDIO_SET_EXT_ID, int id) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -45,7 +44,14 @@ Arguments - audio sub_stream_id -Return Value +DESCRIPTION +----------- + +This ioctl can be used to set the extension id for MPEG streams in DVD +playback. Only the first 3 bits are recognized. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -64,6 +70,3 @@ appropriately. The generic error codes are described at the - ``EINVAL`` - id is not a valid id. - - - diff --git a/Documentation/linux_tv/media/dvb/audio-set-id.rst b/Documentation/linux_tv/media/dvb/audio-set-id.rst index e545f9dad4070edb4e4d32666c56efd9eed87695..60eeee07d24425bfacca82d8bc93889432319323 100644 --- a/Documentation/linux_tv/media/dvb/audio-set-id.rst +++ b/Documentation/linux_tv/media/dvb/audio-set-id.rst @@ -2,29 +2,23 @@ .. _AUDIO_SET_ID: +============ AUDIO_SET_ID ============ -Description ------------ +NAME +---- -This ioctl selects which sub-stream is to be decoded if a program or -system stream is sent to the video device. If no audio stream type is -set the id has to be in [0xC0,0xDF] for MPEG sound, in [0x80,0x87] for -AC3 and in [0xA0,0xA7] for LPCM. More specifications may follow for -other stream types. If the stream type is set the id just specifies the -substream id of the audio stream and only the first 5 bits are -recognized. +AUDIO_SET_ID -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_SET_ID, int id) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -50,11 +44,21 @@ Arguments - audio sub-stream id -Return Value +DESCRIPTION +----------- + +This ioctl selects which sub-stream is to be decoded if a program or +system stream is sent to the video device. If no audio stream type is +set the id has to be in [0xC0,0xDF] for MPEG sound, in [0x80,0x87] for +AC3 and in [0xA0,0xA7] for LPCM. More specifications may follow for +other stream types. If the stream type is set the id just specifies the +substream id of the audio stream and only the first 5 bits are +recognized. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/audio-set-karaoke.rst b/Documentation/linux_tv/media/dvb/audio-set-karaoke.rst index 75a02e4db0a1879474b72202100f7663f17f09fb..07453ceae40f68424ea5959c9dda6e8548de866a 100644 --- a/Documentation/linux_tv/media/dvb/audio-set-karaoke.rst +++ b/Documentation/linux_tv/media/dvb/audio-set-karaoke.rst @@ -2,23 +2,23 @@ .. _AUDIO_SET_KARAOKE: +================= AUDIO_SET_KARAOKE ================= -Description ------------ +NAME +---- -This ioctl allows one to set the mixer settings for a karaoke DVD. +AUDIO_SET_KARAOKE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = AUDIO_SET_KARAOKE, audio_karaoke_t *karaoke) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -44,7 +44,13 @@ Arguments - karaoke settings according to section ??. -Return Value +DESCRIPTION +----------- + +This ioctl allows one to set the mixer settings for a karaoke DVD. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/dvb/audio-set-mixer.rst b/Documentation/linux_tv/media/dvb/audio-set-mixer.rst index 9360d20e759ea345d0ee3b5f3df8e80cb1417335..8d5a6f3754196fa118d4715999d8bf0a5219abd1 100644 --- a/Documentation/linux_tv/media/dvb/audio-set-mixer.rst +++ b/Documentation/linux_tv/media/dvb/audio-set-mixer.rst @@ -2,23 +2,23 @@ .. _AUDIO_SET_MIXER: +=============== AUDIO_SET_MIXER =============== -Description ------------ +NAME +---- -This ioctl lets you adjust the mixer settings of the audio decoder. +AUDIO_SET_MIXER -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_SET_MIXER, audio_mixer_t *mix) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -44,11 +44,15 @@ Arguments - mixer settings. -Return Value +DESCRIPTION +----------- + +This ioctl lets you adjust the mixer settings of the audio decoder. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/audio-set-mute.rst b/Documentation/linux_tv/media/dvb/audio-set-mute.rst index eb6622b63e2b3810626805c23b3ac1fa3dc6f576..a002d0d7128dc1fc0134a7fba3d9a65e4a521ee8 100644 --- a/Documentation/linux_tv/media/dvb/audio-set-mute.rst +++ b/Documentation/linux_tv/media/dvb/audio-set-mute.rst @@ -2,28 +2,23 @@ .. _AUDIO_SET_MUTE: +============== AUDIO_SET_MUTE ============== -Description ------------ - -This ioctl is for DVB devices only. To control a V4L2 decoder use the -V4L2 :ref:`VIDIOC_DECODER_CMD` with the -``V4L2_DEC_CMD_START_MUTE_AUDIO`` flag instead. +NAME +---- -This ioctl call asks the audio device to mute the stream that is -currently being played. +AUDIO_SET_MUTE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_SET_MUTE, boolean state) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -59,11 +54,20 @@ Arguments - FALSE Audio Un-mute -Return Value +DESCRIPTION +----------- + +This ioctl is for DVB devices only. To control a V4L2 decoder use the +V4L2 :ref:`VIDIOC_DECODER_CMD` with the +``V4L2_DEC_CMD_START_MUTE_AUDIO`` flag instead. + +This ioctl call asks the audio device to mute the stream that is +currently being played. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/audio-set-streamtype.rst b/Documentation/linux_tv/media/dvb/audio-set-streamtype.rst index 6fc7c8dfccf835a7f6a8d927a07b4996f9917907..a971d43e01cc25203ebec9ebb917f0727ee6be6e 100644 --- a/Documentation/linux_tv/media/dvb/audio-set-streamtype.rst +++ b/Documentation/linux_tv/media/dvb/audio-set-streamtype.rst @@ -2,25 +2,23 @@ .. _AUDIO_SET_STREAMTYPE: +==================== AUDIO_SET_STREAMTYPE ==================== -Description ------------ +NAME +---- -This ioctl tells the driver which kind of audio stream to expect. This -is useful if the stream offers several audio sub-streams like LPCM and -AC3. +AUDIO_SET_STREAMTYPE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = AUDIO_SET_STREAMTYPE, int type) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -46,7 +44,15 @@ Arguments - stream type -Return Value +DESCRIPTION +----------- + +This ioctl tells the driver which kind of audio stream to expect. This +is useful if the stream offers several audio sub-streams like LPCM and +AC3. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -65,6 +71,3 @@ appropriately. The generic error codes are described at the - ``EINVAL`` - type is not a valid or supported stream type. - - - diff --git a/Documentation/linux_tv/media/dvb/audio-stop.rst b/Documentation/linux_tv/media/dvb/audio-stop.rst index 57e95c453350a8bc0cf05831914284c8fc3cf7a9..558ff2b1effbe9708e92a947babed4cd38ee60d2 100644 --- a/Documentation/linux_tv/media/dvb/audio-stop.rst +++ b/Documentation/linux_tv/media/dvb/audio-stop.rst @@ -2,24 +2,23 @@ .. _AUDIO_STOP: +========== AUDIO_STOP ========== -Description ------------ +NAME +---- -This ioctl call asks the Audio Device to stop playing the current -stream. +AUDIO_STOP -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = AUDIO_STOP) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -39,11 +38,16 @@ Arguments - Equals AUDIO_STOP for this command. -Return Value +DESCRIPTION +----------- + +This ioctl call asks the Audio Device to stop playing the current +stream. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/ca-fclose.rst b/Documentation/linux_tv/media/dvb/ca-fclose.rst index c7797c726c6bc53db1a79198a393e2f242a21130..a093e8dd3182a34c29b497bcaff290078404dd29 100644 --- a/Documentation/linux_tv/media/dvb/ca-fclose.rst +++ b/Documentation/linux_tv/media/dvb/ca-fclose.rst @@ -2,23 +2,23 @@ .. _ca_fclose: +============== DVB CA close() ============== -Description ------------ +NAME +---- -This system call closes a previously opened audio device. +DVB CA close() -Synopsis +SYNOPSIS -------- .. cpp:function:: int close(int fd) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -32,10 +32,14 @@ Arguments - File descriptor returned by a previous call to open(). -Return Value ------------- +DESCRIPTION +----------- + +This system call closes a previously opened audio device. +RETURN VALUE +------------ .. flat-table:: :header-rows: 0 @@ -47,6 +51,3 @@ Return Value - ``EBADF`` - fd is not a valid open file descriptor. - - - diff --git a/Documentation/linux_tv/media/dvb/ca-fopen.rst b/Documentation/linux_tv/media/dvb/ca-fopen.rst index 316209439f88751f569905c5d58d51dc6af028fa..a9bf45a921e9780183d744c225b609b19f787f97 100644 --- a/Documentation/linux_tv/media/dvb/ca-fopen.rst +++ b/Documentation/linux_tv/media/dvb/ca-fopen.rst @@ -2,34 +2,23 @@ .. _ca_fopen: +============= DVB CA open() ============= -Description ------------ - -This system call opens a named ca device (e.g. /dev/ost/ca) for -subsequent use. +NAME +---- -When an open() call has succeeded, the device will be ready for use. The -significance of blocking or non-blocking mode is described in the -documentation for functions where there is a difference. It does not -affect the semantics of the open() call itself. A device opened in -blocking mode can later be put into non-blocking mode (and vice versa) -using the F_SETFL command of the fcntl system call. This is a standard -system call, documented in the Linux manual page for fcntl. Only one -user can open the CA Device in O_RDWR mode. All other attempts to open -the device in this mode will fail, and an error code will be returned. +DVB CA open() -Synopsis +SYNOPSIS -------- .. cpp:function:: int open(const char *deviceName, int flags) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -69,10 +58,25 @@ Arguments - (blocking mode is the default) -Return Value ------------- +DESCRIPTION +----------- +This system call opens a named ca device (e.g. /dev/ost/ca) for +subsequent use. +When an open() call has succeeded, the device will be ready for use. The +significance of blocking or non-blocking mode is described in the +documentation for functions where there is a difference. It does not +affect the semantics of the open() call itself. A device opened in +blocking mode can later be put into non-blocking mode (and vice versa) +using the F_SETFL command of the fcntl system call. This is a standard +system call, documented in the Linux manual page for fcntl. Only one +user can open the CA Device in O_RDWR mode. All other attempts to open +the device in this mode will fail, and an error code will be returned. + + +RETURN VALUE +------------ .. flat-table:: :header-rows: 0 @@ -102,6 +106,3 @@ Return Value - ``EINVAL`` - Invalid argument. - - - diff --git a/Documentation/linux_tv/media/dvb/ca-get-cap.rst b/Documentation/linux_tv/media/dvb/ca-get-cap.rst index 9155e0b445ff077132434375b4e5ebc2a103c64e..b026d4769730c74d2164726186f74e3ab34cd0d0 100644 --- a/Documentation/linux_tv/media/dvb/ca-get-cap.rst +++ b/Documentation/linux_tv/media/dvb/ca-get-cap.rst @@ -2,23 +2,23 @@ .. _CA_GET_CAP: +========== CA_GET_CAP ========== -Description ------------ +NAME +---- -This ioctl is undocumented. Documentation is welcome. +CA_GET_CAP -Synopsis +SYNOPSIS -------- .. cpp:function:: int ioctl(fd, int request = CA_GET_CAP, ca_caps_t *) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -44,11 +44,15 @@ Arguments - Undocumented. -Return Value +DESCRIPTION +----------- + +This ioctl is undocumented. Documentation is welcome. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/ca-get-descr-info.rst b/Documentation/linux_tv/media/dvb/ca-get-descr-info.rst index cf5e3b1d83584b403b1c73d9f8bd09c2b07f3ee5..446afe89af8268aab83e7842d0b76ce4a46a5a10 100644 --- a/Documentation/linux_tv/media/dvb/ca-get-descr-info.rst +++ b/Documentation/linux_tv/media/dvb/ca-get-descr-info.rst @@ -2,23 +2,23 @@ .. _CA_GET_DESCR_INFO: +================= CA_GET_DESCR_INFO ================= -Description ------------ +NAME +---- -This ioctl is undocumented. Documentation is welcome. +CA_GET_DESCR_INFO -Synopsis +SYNOPSIS -------- .. cpp:function:: int ioctl(fd, int request = CA_GET_DESCR_INFO, ca_descr_info_t *) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -44,11 +44,15 @@ Arguments - Undocumented. -Return Value +DESCRIPTION +----------- + +This ioctl is undocumented. Documentation is welcome. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/ca-get-msg.rst b/Documentation/linux_tv/media/dvb/ca-get-msg.rst index 994d73a59992820cc64e980cc4753a8580eaefe2..44c944a700c00847f4bc8ccf03d84a4abeefc12b 100644 --- a/Documentation/linux_tv/media/dvb/ca-get-msg.rst +++ b/Documentation/linux_tv/media/dvb/ca-get-msg.rst @@ -2,23 +2,23 @@ .. _CA_GET_MSG: +========== CA_GET_MSG ========== -Description ------------ +NAME +---- -This ioctl is undocumented. Documentation is welcome. +CA_GET_MSG -Synopsis +SYNOPSIS -------- .. cpp:function:: int ioctl(fd, int request = CA_GET_MSG, ca_msg_t *) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -44,11 +44,15 @@ Arguments - Undocumented. -Return Value +DESCRIPTION +----------- + +This ioctl is undocumented. Documentation is welcome. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/ca-get-slot-info.rst b/Documentation/linux_tv/media/dvb/ca-get-slot-info.rst index 8c123aaf5538758e19a1f2da4617c67ab383107e..e1e580341dadf34106f68c5381e40fa3b6c6f26d 100644 --- a/Documentation/linux_tv/media/dvb/ca-get-slot-info.rst +++ b/Documentation/linux_tv/media/dvb/ca-get-slot-info.rst @@ -2,23 +2,23 @@ .. _CA_GET_SLOT_INFO: +================ CA_GET_SLOT_INFO ================ -Description ------------ +NAME +---- -This ioctl is undocumented. Documentation is welcome. +CA_GET_SLOT_INFO -Synopsis +SYNOPSIS -------- .. cpp:function:: int ioctl(fd, int request = CA_GET_SLOT_INFO, ca_slot_info_t *) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -44,11 +44,15 @@ Arguments - Undocumented. -Return Value +DESCRIPTION +----------- + +This ioctl is undocumented. Documentation is welcome. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/ca-reset.rst b/Documentation/linux_tv/media/dvb/ca-reset.rst index 4fa2597ea98324a32145093c5fa2e6d5532ddf57..ff58c62fb0a5f59bc8fc7fd23dba92d47431a676 100644 --- a/Documentation/linux_tv/media/dvb/ca-reset.rst +++ b/Documentation/linux_tv/media/dvb/ca-reset.rst @@ -2,23 +2,23 @@ .. _CA_RESET: +======== CA_RESET ======== -Description ------------ +NAME +---- -This ioctl is undocumented. Documentation is welcome. +CA_RESET -Synopsis +SYNOPSIS -------- .. cpp:function:: int ioctl(fd, int request = CA_RESET) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -38,11 +38,15 @@ Arguments - Equals CA_RESET for this command. -Return Value +DESCRIPTION +----------- + +This ioctl is undocumented. Documentation is welcome. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/ca-send-msg.rst b/Documentation/linux_tv/media/dvb/ca-send-msg.rst index cb9249561d8aed42783df04195de9c8b62ad46ba..9d9b8d2520c15100f1cbdd048967ab4d0bc0da13 100644 --- a/Documentation/linux_tv/media/dvb/ca-send-msg.rst +++ b/Documentation/linux_tv/media/dvb/ca-send-msg.rst @@ -2,23 +2,23 @@ .. _CA_SEND_MSG: +=========== CA_SEND_MSG =========== -Description ------------ +NAME +---- -This ioctl is undocumented. Documentation is welcome. +CA_SEND_MSG -Synopsis +SYNOPSIS -------- .. cpp:function:: int ioctl(fd, int request = CA_SEND_MSG, ca_msg_t *) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -44,11 +44,15 @@ Arguments - Undocumented. -Return Value +DESCRIPTION +----------- + +This ioctl is undocumented. Documentation is welcome. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/ca-set-descr.rst b/Documentation/linux_tv/media/dvb/ca-set-descr.rst index 5b56e414da24c76acce61edfebd7725785428844..e992dd52432df8272ab0160a1de43681f4f8fda4 100644 --- a/Documentation/linux_tv/media/dvb/ca-set-descr.rst +++ b/Documentation/linux_tv/media/dvb/ca-set-descr.rst @@ -2,23 +2,23 @@ .. _CA_SET_DESCR: +============ CA_SET_DESCR ============ -Description ------------ +NAME +---- -This ioctl is undocumented. Documentation is welcome. +CA_SET_DESCR -Synopsis +SYNOPSIS -------- .. cpp:function:: int ioctl(fd, int request = CA_SET_DESCR, ca_descr_t *) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -44,11 +44,15 @@ Arguments - Undocumented. -Return Value +DESCRIPTION +----------- + +This ioctl is undocumented. Documentation is welcome. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/ca-set-pid.rst b/Documentation/linux_tv/media/dvb/ca-set-pid.rst index 3d4b7e823c153ea93aa9ede61b6d9e12f2225850..e7e3891fa65e28ee6436f383b78ae4d006991bb6 100644 --- a/Documentation/linux_tv/media/dvb/ca-set-pid.rst +++ b/Documentation/linux_tv/media/dvb/ca-set-pid.rst @@ -2,23 +2,23 @@ .. _CA_SET_PID: +========== CA_SET_PID ========== -Description ------------ +NAME +---- -This ioctl is undocumented. Documentation is welcome. +CA_SET_PID -Synopsis +SYNOPSIS -------- .. cpp:function:: int ioctl(fd, int request = CA_SET_PID, ca_pid_t *) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -44,7 +44,13 @@ Arguments - Undocumented. -Return Value +DESCRIPTION +----------- + +This ioctl is undocumented. Documentation is welcome. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/dvb/dmx-add-pid.rst b/Documentation/linux_tv/media/dvb/dmx-add-pid.rst index d6fd0a351a51756a5900c7417e39ff7922c89ebe..36bca4f9317c3e28cabc1b279f28de10b307aeda 100644 --- a/Documentation/linux_tv/media/dvb/dmx-add-pid.rst +++ b/Documentation/linux_tv/media/dvb/dmx-add-pid.rst @@ -2,25 +2,23 @@ .. _DMX_ADD_PID: +=========== DMX_ADD_PID =========== -Description ------------ +NAME +---- -This ioctl call allows to add multiple PIDs to a transport stream filter -previously set up with DMX_SET_PES_FILTER and output equal to -DMX_OUT_TSDEMUX_TAP. +DMX_ADD_PID -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = DMX_ADD_PID, __u16 *) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -46,11 +44,17 @@ Arguments - PID number to be filtered. -Return Value +DESCRIPTION +----------- + +This ioctl call allows to add multiple PIDs to a transport stream filter +previously set up with DMX_SET_PES_FILTER and output equal to +DMX_OUT_TSDEMUX_TAP. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/dmx-fclose.rst b/Documentation/linux_tv/media/dvb/dmx-fclose.rst index 079e944b8fc8bafa21013e70c1e3a7eb6ad72c44..7889d0b76f7d4d71b7bf5e4c48daa9e74d8936da 100644 --- a/Documentation/linux_tv/media/dvb/dmx-fclose.rst +++ b/Documentation/linux_tv/media/dvb/dmx-fclose.rst @@ -2,24 +2,23 @@ .. _dmx_fclose: +================= DVB demux close() ================= -Description ------------ +NAME +---- -This system call deactivates and deallocates a filter that was -previously allocated via the open() call. +DVB demux close() -Synopsis +SYNOPSIS -------- .. c:function:: int close(int fd) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -33,11 +32,16 @@ Arguments - File descriptor returned by a previous call to open(). -Return Value ------------- +DESCRIPTION +----------- +This system call deactivates and deallocates a filter that was +previously allocated via the open() call. +RETURN VALUE +------------ + .. flat-table:: :header-rows: 0 :stub-columns: 0 @@ -48,6 +52,3 @@ Return Value - ``EBADF`` - fd is not a valid open file descriptor. - - - diff --git a/Documentation/linux_tv/media/dvb/dmx-fopen.rst b/Documentation/linux_tv/media/dvb/dmx-fopen.rst index 9d6d84d7b608c0c33448d7569f48b51d03d2cf05..1e1dbc57c64d75a7bca44174b7c19b56e98d608f 100644 --- a/Documentation/linux_tv/media/dvb/dmx-fopen.rst +++ b/Documentation/linux_tv/media/dvb/dmx-fopen.rst @@ -2,38 +2,23 @@ .. _dmx_fopen: +================ DVB demux open() ================ -Description ------------ - -This system call, used with a device name of /dev/dvb/adapter0/demux0, -allocates a new filter and returns a handle which can be used for -subsequent control of that filter. This call has to be made for each -filter to be used, i.e. every returned file descriptor is a reference to -a single filter. /dev/dvb/adapter0/dvr0 is a logical device to be used -for retrieving Transport Streams for digital video recording. When -reading from this device a transport stream containing the packets from -all PES filters set in the corresponding demux device -(/dev/dvb/adapter0/demux0) having the output set to DMX_OUT_TS_TAP. A -recorded Transport Stream is replayed by writing to this device. +NAME +---- -The significance of blocking or non-blocking mode is described in the -documentation for functions where there is a difference. It does not -affect the semantics of the open() call itself. A device opened in -blocking mode can later be put into non-blocking mode (and vice versa) -using the F_SETFL command of the fcntl system call. +DVB demux open() -Synopsis +SYNOPSIS -------- .. c:function:: int open(const char *deviceName, int flags) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -68,11 +53,30 @@ Arguments - (blocking mode is the default) -Return Value ------------- +DESCRIPTION +----------- +This system call, used with a device name of /dev/dvb/adapter0/demux0, +allocates a new filter and returns a handle which can be used for +subsequent control of that filter. This call has to be made for each +filter to be used, i.e. every returned file descriptor is a reference to +a single filter. /dev/dvb/adapter0/dvr0 is a logical device to be used +for retrieving Transport Streams for digital video recording. When +reading from this device a transport stream containing the packets from +all PES filters set in the corresponding demux device +(/dev/dvb/adapter0/demux0) having the output set to DMX_OUT_TS_TAP. A +recorded Transport Stream is replayed by writing to this device. + +The significance of blocking or non-blocking mode is described in the +documentation for functions where there is a difference. It does not +affect the semantics of the open() call itself. A device opened 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 +------------ + .. flat-table:: :header-rows: 0 :stub-columns: 0 @@ -101,6 +105,3 @@ Return Value - ``ENOMEM`` - The driver failed to allocate enough memory. - - - diff --git a/Documentation/linux_tv/media/dvb/dmx-fread.rst b/Documentation/linux_tv/media/dvb/dmx-fread.rst index 66811dbe6dacd18cf3a514760c0bb009d32399a3..55d9bc7f424dc8c4b3d6f72b0fad549a05b6a452 100644 --- a/Documentation/linux_tv/media/dvb/dmx-fread.rst +++ b/Documentation/linux_tv/media/dvb/dmx-fread.rst @@ -2,26 +2,23 @@ .. _dmx_fread: +================ DVB demux read() ================ -Description ------------ +NAME +---- -This system call returns filtered data, which might be section or PES -data. The filtered data is transferred from the driver’s internal -circular buffer to buf. The maximum amount of data to be transferred is -implied by count. +DVB demux read() -Synopsis +SYNOPSIS -------- .. c:function:: size_t read(int fd, void *buf, size_t count) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -47,11 +44,18 @@ Arguments - Size of buf. -Return Value ------------- +DESCRIPTION +----------- +This system call returns filtered data, which might be section or PES +data. The filtered data is transferred from the driver’s internal +circular buffer to buf. The maximum amount of data to be transferred is +implied by count. +RETURN VALUE +------------ + .. flat-table:: :header-rows: 0 :stub-columns: 0 @@ -101,6 +105,3 @@ Return Value - The driver failed to write to the callers buffer due to an invalid \*buf pointer. - - - diff --git a/Documentation/linux_tv/media/dvb/dmx-fwrite.rst b/Documentation/linux_tv/media/dvb/dmx-fwrite.rst index 57aef82c77b27f810a643d2697d9b55997099cd9..f3974368496639756dc19ec2b454231164a6256d 100644 --- a/Documentation/linux_tv/media/dvb/dmx-fwrite.rst +++ b/Documentation/linux_tv/media/dvb/dmx-fwrite.rst @@ -2,28 +2,23 @@ .. _dmx_fwrite: +================= DVB demux write() ================= -Description ------------ +NAME +---- -This system call is only provided by the logical device -/dev/dvb/adapter0/dvr0, associated with the physical demux device that -provides the actual DVR functionality. It is used for replay of a -digitally recorded Transport Stream. Matching filters have to be defined -in the corresponding physical demux device, /dev/dvb/adapter0/demux0. -The amount of data to be transferred is implied by count. +DVB demux write() -Synopsis +SYNOPSIS -------- .. c:function:: ssize_t write(int fd, const void *buf, size_t count) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -49,11 +44,20 @@ Arguments - Size of buf. -Return Value ------------- +DESCRIPTION +----------- +This system call is only provided by the logical device +/dev/dvb/adapter0/dvr0, associated with the physical demux device that +provides the actual DVR functionality. It is used for replay of a +digitally recorded Transport Stream. Matching filters have to be defined +in the corresponding physical demux device, /dev/dvb/adapter0/demux0. +The amount of data to be transferred is implied by count. +RETURN VALUE +------------ + .. flat-table:: :header-rows: 0 :stub-columns: 0 @@ -82,6 +86,3 @@ Return Value - ``EBADF`` - fd is not a valid open file descriptor. - - - diff --git a/Documentation/linux_tv/media/dvb/dmx-get-caps.rst b/Documentation/linux_tv/media/dvb/dmx-get-caps.rst index 56bba7b3fc6c6f0aecab421acd4d89aeacb880b3..8c8ae48a93da48aeffc7414f2a3ae69531626cdb 100644 --- a/Documentation/linux_tv/media/dvb/dmx-get-caps.rst +++ b/Documentation/linux_tv/media/dvb/dmx-get-caps.rst @@ -2,23 +2,23 @@ .. _DMX_GET_CAPS: +============ DMX_GET_CAPS ============ -Description ------------ +NAME +---- -This ioctl is undocumented. Documentation is welcome. +DMX_GET_CAPS -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = DMX_GET_CAPS, dmx_caps_t *) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -44,11 +44,15 @@ Arguments - Undocumented. -Return Value +DESCRIPTION +----------- + +This ioctl is undocumented. Documentation is welcome. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/dmx-get-event.rst b/Documentation/linux_tv/media/dvb/dmx-get-event.rst index 8664d43f4334921cc4b0513317d4728c22cb28d1..ab2ab2ed3bedc04f25a65fb94c1f6efb63a60c78 100644 --- a/Documentation/linux_tv/media/dvb/dmx-get-event.rst +++ b/Documentation/linux_tv/media/dvb/dmx-get-event.rst @@ -2,27 +2,23 @@ .. _DMX_GET_EVENT: +============= DMX_GET_EVENT ============= -Description ------------ +NAME +---- -This ioctl call returns an event if available. If an event is not -available, the behavior depends on whether the device is in blocking or -non-blocking mode. In the latter case, the call fails immediately with -errno set to ``EWOULDBLOCK``. In the former case, the call blocks until an -event becomes available. +DMX_GET_EVENT -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl( int fd, int request = DMX_GET_EVENT, struct dmx_event *ev) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -48,7 +44,17 @@ Arguments - Pointer to the location where the event is to be stored. -Return Value +DESCRIPTION +----------- + +This ioctl call returns an event if available. If an event is not +available, the behavior depends on whether the device is in blocking or +non-blocking mode. In the latter case, the call fails immediately with +errno set to ``EWOULDBLOCK``. In the former case, the call blocks until an +event becomes available. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -67,6 +73,3 @@ appropriately. The generic error codes are described at the - ``EWOULDBLOCK`` - There is no event pending, and the device is in non-blocking mode. - - - diff --git a/Documentation/linux_tv/media/dvb/dmx-get-pes-pids.rst b/Documentation/linux_tv/media/dvb/dmx-get-pes-pids.rst index 39d6ae6db6200256db96902f3ecd78f9b5b1c5fb..cf0d8a6463fbfd30338fc396a02072fbe001e236 100644 --- a/Documentation/linux_tv/media/dvb/dmx-get-pes-pids.rst +++ b/Documentation/linux_tv/media/dvb/dmx-get-pes-pids.rst @@ -2,23 +2,23 @@ .. _DMX_GET_PES_PIDS: +================ DMX_GET_PES_PIDS ================ -Description ------------ +NAME +---- -This ioctl is undocumented. Documentation is welcome. +DMX_GET_PES_PIDS -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = DMX_GET_PES_PIDS, __u16[5]) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -44,11 +44,15 @@ Arguments - Undocumented. -Return Value +DESCRIPTION +----------- + +This ioctl is undocumented. Documentation is welcome. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/dmx-get-stc.rst b/Documentation/linux_tv/media/dvb/dmx-get-stc.rst index 6081d959b4ade92f405bdb2829aedd9cc0b116a4..35dd691dee097b2d61c38175ebde0db3937cb2bc 100644 --- a/Documentation/linux_tv/media/dvb/dmx-get-stc.rst +++ b/Documentation/linux_tv/media/dvb/dmx-get-stc.rst @@ -2,28 +2,23 @@ .. _DMX_GET_STC: +=========== DMX_GET_STC =========== -Description ------------ +NAME +---- -This ioctl call returns the current value of the system time counter -(which is driven by a PES filter of type DMX_PES_PCR). Some hardware -supports more than one STC, so you must specify which one by setting the -num field of stc before the ioctl (range 0...n). The result is returned -in form of a ratio with a 64 bit numerator and a 32 bit denominator, so -the real 90kHz STC value is stc->stc / stc->base . +DMX_GET_STC -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl( int fd, int request = DMX_GET_STC, struct dmx_stc *stc) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -49,7 +44,18 @@ Arguments - Pointer to the location where the stc is to be stored. -Return Value +DESCRIPTION +----------- + +This ioctl call returns the current value of the system time counter +(which is driven by a PES filter of type DMX_PES_PCR). Some hardware +supports more than one STC, so you must specify which one by setting the +num field of stc before the ioctl (range 0...n). The result is returned +in form of a ratio with a 64 bit numerator and a 32 bit denominator, so +the real 90kHz STC value is stc->stc / stc->base . + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -68,6 +74,3 @@ appropriately. The generic error codes are described at the - ``EINVAL`` - Invalid stc number. - - - diff --git a/Documentation/linux_tv/media/dvb/dmx-remove-pid.rst b/Documentation/linux_tv/media/dvb/dmx-remove-pid.rst index 9e38eb8db6f830bae90b591c2e197784c22df970..859e1a14de549f87ae12d0c18921c56e7830ec73 100644 --- a/Documentation/linux_tv/media/dvb/dmx-remove-pid.rst +++ b/Documentation/linux_tv/media/dvb/dmx-remove-pid.rst @@ -2,26 +2,23 @@ .. _DMX_REMOVE_PID: +============== DMX_REMOVE_PID ============== -Description ------------ +NAME +---- -This ioctl call allows to remove a PID when multiple PIDs are set on a -transport stream filter, e. g. a filter previously set up with output -equal to DMX_OUT_TSDEMUX_TAP, created via either -DMX_SET_PES_FILTER or DMX_ADD_PID. +DMX_REMOVE_PID -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = DMX_REMOVE_PID, __u16 *) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -47,7 +44,16 @@ Arguments - PID of the PES filter to be removed. -Return Value +DESCRIPTION +----------- + +This ioctl call allows to remove a PID when multiple PIDs are set on a +transport stream filter, e. g. a filter previously set up with output +equal to DMX_OUT_TSDEMUX_TAP, created via either +DMX_SET_PES_FILTER or DMX_ADD_PID. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/dvb/dmx-set-buffer-size.rst b/Documentation/linux_tv/media/dvb/dmx-set-buffer-size.rst index a5074a6ac48ec8f52c62749c9a13a1710043a728..cf6b32f4e3610ce70b923ff929ef54689f585910 100644 --- a/Documentation/linux_tv/media/dvb/dmx-set-buffer-size.rst +++ b/Documentation/linux_tv/media/dvb/dmx-set-buffer-size.rst @@ -2,26 +2,23 @@ .. _DMX_SET_BUFFER_SIZE: +=================== DMX_SET_BUFFER_SIZE =================== -Description ------------ +NAME +---- -This ioctl call is used to set the size of the circular buffer used for -filtered data. The default size is two maximum sized sections, i.e. if -this function is not called a buffer size of 2 \* 4096 bytes will be -used. +DMX_SET_BUFFER_SIZE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl( int fd, int request = DMX_SET_BUFFER_SIZE, unsigned long size) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -47,11 +44,18 @@ Arguments - Size of circular buffer. -Return Value +DESCRIPTION +----------- + +This ioctl call is used to set the size of the circular buffer used for +filtered data. The default size is two maximum sized sections, i.e. if +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 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/dmx-set-filter.rst b/Documentation/linux_tv/media/dvb/dmx-set-filter.rst index 548af600d63504d14e5f4bab3d48457a6b338c8d..0aad102f3151c76cc74c2c34f62e1fe8486f6267 100644 --- a/Documentation/linux_tv/media/dvb/dmx-set-filter.rst +++ b/Documentation/linux_tv/media/dvb/dmx-set-filter.rst @@ -2,32 +2,23 @@ .. _DMX_SET_FILTER: +============== DMX_SET_FILTER ============== -Description ------------ +NAME +---- -This ioctl call sets up a filter according to the filter and mask -parameters provided. A timeout may be defined stating number of seconds -to wait for a section to be loaded. A value of 0 means that no timeout -should be applied. Finally there is a flag field where it is possible to -state whether a section should be CRC-checked, whether the filter should -be a ”one-shot” filter, i.e. if the filtering operation should be -stopped after the first section is received, and whether the filtering -operation should be started immediately (without waiting for a -DMX_START ioctl call). If a filter was previously set-up, this filter -will be canceled, and the receive buffer will be flushed. +DMX_SET_FILTER -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl( int fd, int request = DMX_SET_FILTER, struct dmx_sct_filter_params *params) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -53,11 +44,24 @@ Arguments - Pointer to structure containing filter parameters. -Return Value +DESCRIPTION +----------- + +This ioctl call sets up a filter according to the filter and mask +parameters provided. A timeout may be defined stating number of seconds +to wait for a section to be loaded. A value of 0 means that no timeout +should be applied. Finally there is a flag field where it is possible to +state whether a section should be CRC-checked, whether the filter should +be a ”one-shot” filter, i.e. if the filtering operation should be +stopped after the first section is received, and whether the filtering +operation should be started immediately (without waiting for a +DMX_START ioctl call). If a filter was previously set-up, this filter +will be canceled, and the receive buffer will be flushed. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/dmx-set-pes-filter.rst b/Documentation/linux_tv/media/dvb/dmx-set-pes-filter.rst index 7d9b6dabc772d803ade08d7dde50f451d71178a8..3dccd7cd0a646fd7de31fa62e49cad402d8f1b5a 100644 --- a/Documentation/linux_tv/media/dvb/dmx-set-pes-filter.rst +++ b/Documentation/linux_tv/media/dvb/dmx-set-pes-filter.rst @@ -2,26 +2,23 @@ .. _DMX_SET_PES_FILTER: +================== DMX_SET_PES_FILTER ================== -Description ------------ +NAME +---- -This ioctl call sets up a PES filter according to the parameters -provided. By a PES filter is meant a filter that is based just on the -packet identifier (PID), i.e. no PES header or payload filtering -capability is supported. +DMX_SET_PES_FILTER -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl( int fd, int request = DMX_SET_PES_FILTER, struct dmx_pes_filter_params *params) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -47,7 +44,16 @@ Arguments - Pointer to structure containing filter parameters. -Return Value +DESCRIPTION +----------- + +This ioctl call sets up a PES filter according to the parameters +provided. By a PES filter is meant a filter that is based just on the +packet identifier (PID), i.e. no PES header or payload filtering +capability is supported. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -69,6 +75,3 @@ appropriately. The generic error codes are described at the There are active filters filtering data from another input source. Make sure that these filters are stopped before starting this filter. - - - diff --git a/Documentation/linux_tv/media/dvb/dmx-set-source.rst b/Documentation/linux_tv/media/dvb/dmx-set-source.rst index e97b1c962ed6de304f3aaef19b2413efb30a9c74..13045327857f630946f309d4ec2f47f0e8e27e55 100644 --- a/Documentation/linux_tv/media/dvb/dmx-set-source.rst +++ b/Documentation/linux_tv/media/dvb/dmx-set-source.rst @@ -2,23 +2,23 @@ .. _DMX_SET_SOURCE: +============== DMX_SET_SOURCE ============== -Description ------------ +NAME +---- -This ioctl is undocumented. Documentation is welcome. +DMX_SET_SOURCE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = DMX_SET_SOURCE, dmx_source_t *) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -44,11 +44,15 @@ Arguments - Undocumented. -Return Value +DESCRIPTION +----------- + +This ioctl is undocumented. Documentation is welcome. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/dmx-start.rst b/Documentation/linux_tv/media/dvb/dmx-start.rst index dd446da18f97ab0379a27ece6b410543fbf93ff9..c62e2ad17a6aa6d18beb08e9fdd651ef4d608a40 100644 --- a/Documentation/linux_tv/media/dvb/dmx-start.rst +++ b/Documentation/linux_tv/media/dvb/dmx-start.rst @@ -2,24 +2,23 @@ .. _DMX_START: +========= DMX_START ========= -Description ------------ +NAME +---- -This ioctl call is used to start the actual filtering operation defined -via the ioctl calls DMX_SET_FILTER or DMX_SET_PES_FILTER. +DMX_START -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl( int fd, int request = DMX_START) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -39,7 +38,14 @@ Arguments - Equals DMX_START for this command. -Return Value +DESCRIPTION +----------- + +This ioctl call is used to start the actual filtering operation defined +via the ioctl calls DMX_SET_FILTER or DMX_SET_PES_FILTER. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -68,6 +74,3 @@ appropriately. The generic error codes are described at the There are active filters filtering data from another input source. Make sure that these filters are stopped before starting this filter. - - - diff --git a/Documentation/linux_tv/media/dvb/dmx-stop.rst b/Documentation/linux_tv/media/dvb/dmx-stop.rst index 150c9f79b55ff3cab2b2801b5b081b161045efb1..ff9df400f71f1951113eb8afcb1612c1ebbda285 100644 --- a/Documentation/linux_tv/media/dvb/dmx-stop.rst +++ b/Documentation/linux_tv/media/dvb/dmx-stop.rst @@ -2,25 +2,23 @@ .. _DMX_STOP: +======== DMX_STOP ======== -Description ------------ +NAME +---- -This ioctl call is used to stop the actual filtering operation defined -via the ioctl calls DMX_SET_FILTER or DMX_SET_PES_FILTER and -started via the DMX_START command. +DMX_STOP -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl( int fd, int request = DMX_STOP) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -40,11 +38,17 @@ Arguments - Equals DMX_STOP for this command. -Return Value +DESCRIPTION +----------- + +This ioctl call is used to stop the actual filtering operation defined +via the ioctl calls DMX_SET_FILTER or DMX_SET_PES_FILTER and +started via the DMX_START command. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/fe-diseqc-recv-slave-reply.rst b/Documentation/linux_tv/media/dvb/fe-diseqc-recv-slave-reply.rst index 67e53787cc1e26f6b5cf63eab79de79bd83c2a7f..60241c6e68a82fe58bbd58e810075de0bbff6738 100644 --- a/Documentation/linux_tv/media/dvb/fe-diseqc-recv-slave-reply.rst +++ b/Documentation/linux_tv/media/dvb/fe-diseqc-recv-slave-reply.rst @@ -6,17 +6,18 @@ ioctl FE_DISEQC_RECV_SLAVE_REPLY ******************************** -*man FE_DISEQC_RECV_SLAVE_REPLY(2)* +NAME +==== -Receives reply from a DiSEqC 2.0 command +FE_DISEQC_RECV_SLAVE_REPLY - Receives reply from a DiSEqC 2.0 command - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct dvb_diseqc_slave_reply *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -30,12 +31,14 @@ Arguments :ref:`dvb_diseqc_slave_reply ` -Description +DESCRIPTION =========== Receives reply from a DiSEqC 2.0 command. + RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/fe-diseqc-reset-overload.rst b/Documentation/linux_tv/media/dvb/fe-diseqc-reset-overload.rst index 2c64eab598b890bf3431c485919c53ef2251de56..236c25c9f7bd285b0272246ea60d18660787eb00 100644 --- a/Documentation/linux_tv/media/dvb/fe-diseqc-reset-overload.rst +++ b/Documentation/linux_tv/media/dvb/fe-diseqc-reset-overload.rst @@ -6,18 +6,18 @@ ioctl FE_DISEQC_RESET_OVERLOAD ****************************** -*man FE_DISEQC_RESET_OVERLOAD(2)* +NAME +==== -Restores the power to the antenna subsystem, if it was powered off due -to power overload. +FE_DISEQC_RESET_OVERLOAD - Restores the power to the antenna subsystem, if it was powered off due - to power overload. - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, NULL ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -27,7 +27,7 @@ Arguments FE_DISEQC_RESET_OVERLOAD -Description +DESCRIPTION =========== If the bus has been automatically powered off due to power overload, @@ -35,7 +35,9 @@ this ioctl call restores the power to the bus. The call requires read/write access to the device. This call has no effect if the device is manually powered off. Not all DVB adapters support this ioctl. + RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/fe-diseqc-send-burst.rst b/Documentation/linux_tv/media/dvb/fe-diseqc-send-burst.rst index 35de0278a06467f94891cd815150f04d13b3d53f..dea9cdff0469d9c534e4dce3f2d2a8d1a55aefe3 100644 --- a/Documentation/linux_tv/media/dvb/fe-diseqc-send-burst.rst +++ b/Documentation/linux_tv/media/dvb/fe-diseqc-send-burst.rst @@ -6,17 +6,18 @@ ioctl FE_DISEQC_SEND_BURST ************************** -*man FE_DISEQC_SEND_BURST(2)* +NAME +==== -Sends a 22KHz tone burst for 2x1 mini DiSEqC satellite selection. +FE_DISEQC_SEND_BURST - Sends a 22KHz tone burst for 2x1 mini DiSEqC satellite selection. - -Synopsis +SYNOPSIS ======== .. c:function:: int ioctl( int fd, int request, enum fe_sec_mini_cmd *tone ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +30,7 @@ Arguments pointer to enum :ref:`fe_sec_mini_cmd ` -Description +DESCRIPTION =========== This ioctl is used to set the generation of a 22kHz tone burst for mini @@ -39,7 +40,9 @@ read/write permissions. It provides support for what's specified at `Digital Satellite Equipment Control (DiSEqC) - Simple "ToneBurst" Detection Circuit specification. `__ + RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/fe-diseqc-send-master-cmd.rst b/Documentation/linux_tv/media/dvb/fe-diseqc-send-master-cmd.rst index 04c6cc8ae070c1b4e45be249853d12d925b037c5..519e91bd47fd7d37d79c938abdbdd00f1fcd4d64 100644 --- a/Documentation/linux_tv/media/dvb/fe-diseqc-send-master-cmd.rst +++ b/Documentation/linux_tv/media/dvb/fe-diseqc-send-master-cmd.rst @@ -6,17 +6,18 @@ ioctl FE_DISEQC_SEND_MASTER_CMD ******************************* -*man FE_DISEQC_SEND_MASTER_CMD(2)* +NAME +==== -Sends a DiSEqC command +FE_DISEQC_SEND_MASTER_CMD - Sends a DiSEqC command - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct dvb_diseqc_master_cmd *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -30,12 +31,14 @@ Arguments :ref:`dvb_diseqc_master_cmd ` -Description +DESCRIPTION =========== Sends a DiSEqC command to the antenna subsystem. + RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/fe-enable-high-lnb-voltage.rst b/Documentation/linux_tv/media/dvb/fe-enable-high-lnb-voltage.rst index 669dbd6e79b87454adf27edde357908b498b8920..27f49823e67d086dda799638d258eff96e0fa41a 100644 --- a/Documentation/linux_tv/media/dvb/fe-enable-high-lnb-voltage.rst +++ b/Documentation/linux_tv/media/dvb/fe-enable-high-lnb-voltage.rst @@ -6,18 +6,18 @@ ioctl FE_ENABLE_HIGH_LNB_VOLTAGE ******************************** -*man FE_ENABLE_HIGH_LNB_VOLTAGE(2)* - -Select output DC level between normal LNBf voltages or higher LNBf -voltages. +NAME +==== +FE_ENABLE_HIGH_LNB_VOLTAGE - Select output DC level between normal LNBf voltages or higher LNBf - voltages. -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, unsigned int high ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -35,14 +35,16 @@ Arguments to compensate for long antenna cables. -Description +DESCRIPTION =========== Select output DC level between normal LNBf voltages or higher LNBf voltages between 0 (normal) or a value grater than 0 for higher voltages. + RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/fe-get-info.rst b/Documentation/linux_tv/media/dvb/fe-get-info.rst index 97743d9418ace74c8708955d56bf7726af7752d6..d97218805851247a877595cb6ba087434e17c09a 100644 --- a/Documentation/linux_tv/media/dvb/fe-get-info.rst +++ b/Documentation/linux_tv/media/dvb/fe-get-info.rst @@ -6,18 +6,18 @@ ioctl FE_GET_INFO ***************** -*man FE_GET_INFO(2)* +NAME +==== -Query DVB frontend capabilities and returns information about the -front-end. This call only requires read-only access to the device +FE_GET_INFO - Query DVB frontend capabilities and returns information about the - front-end. This call only requires read-only access to the device - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct dvb_frontend_info *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +31,7 @@ Arguments :ref:`dvb_frontend_info ` -Description +DESCRIPTION =========== All DVB frontend devices support the ``FE_GET_INFO`` ioctl. It is used @@ -41,7 +41,9 @@ takes a pointer to dvb_frontend_info which is filled by the driver. When the driver is not compatible with this specification the ioctl returns an error. + RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/fe-get-property.rst b/Documentation/linux_tv/media/dvb/fe-get-property.rst index 0edc9291fc704415c40b99a775609d87db9e757f..c470105dcd1571a19d2c78350db21681b86b6cfd 100644 --- a/Documentation/linux_tv/media/dvb/fe-get-property.rst +++ b/Documentation/linux_tv/media/dvb/fe-get-property.rst @@ -6,19 +6,18 @@ ioctl FE_SET_PROPERTY, FE_GET_PROPERTY ************************************** -*man FE_SET_PROPERTY(2)* +NAME +==== -FE_GET_PROPERTY -FE_SET_PROPERTY sets one or more frontend properties. -FE_GET_PROPERTY returns one or more frontend properties. +FE_SET_PROPERTY - FE_GET_PROPERTY - FE_SET_PROPERTY sets one or more frontend properties. - FE_GET_PROPERTY returns one or more frontend properties. - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct dtv_properties *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +30,7 @@ Arguments pointer to struct :ref:`dtv_properties ` -Description +DESCRIPTION =========== All DVB frontend devices support the ``FE_SET_PROPERTY`` and @@ -59,7 +58,9 @@ depends on the delivery system and on the device: - This call only requires read-only access to the device. + RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/fe-read-status.rst b/Documentation/linux_tv/media/dvb/fe-read-status.rst index 56347eed3703243b598f4fa8cf00a40b8673f2b7..ac6f2386953045f8ddc93f22f1cd66ff01f8ce84 100644 --- a/Documentation/linux_tv/media/dvb/fe-read-status.rst +++ b/Documentation/linux_tv/media/dvb/fe-read-status.rst @@ -6,18 +6,18 @@ ioctl FE_READ_STATUS ******************** -*man FE_READ_STATUS(2)* +NAME +==== -Returns status information about the front-end. This call only requires -read-only access to the device +FE_READ_STATUS - Returns status information about the front-end. This call only requires - read-only access to the device - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, unsigned int *status ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +31,7 @@ Arguments :ref:`fe_status `. -Description +DESCRIPTION =========== All DVB frontend devices support the ``FE_READ_STATUS`` ioctl. It is @@ -43,7 +43,9 @@ NOTE: the size of status is actually sizeof(enum fe_status), with varies according with the architecture. This needs to be fixed in the future. + RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/fe-set-frontend-tune-mode.rst b/Documentation/linux_tv/media/dvb/fe-set-frontend-tune-mode.rst index aeecb947fa7017255261ced0e893fae2065ccbc9..1db22c426b8ca87e6eec8870bb47b25fbce8cd47 100644 --- a/Documentation/linux_tv/media/dvb/fe-set-frontend-tune-mode.rst +++ b/Documentation/linux_tv/media/dvb/fe-set-frontend-tune-mode.rst @@ -6,17 +6,18 @@ ioctl FE_SET_FRONTEND_TUNE_MODE ******************************* -*man FE_SET_FRONTEND_TUNE_MODE(2)* +NAME +==== -Allow setting tuner mode flags to the frontend. +FE_SET_FRONTEND_TUNE_MODE - Allow setting tuner mode flags to the frontend. - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, unsigned int flags ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -38,13 +39,15 @@ Arguments device is reopened read-write. -Description +DESCRIPTION =========== Allow setting tuner mode flags to the frontend, between 0 (normal) or FE_TUNE_MODE_ONESHOT mode + RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/fe-set-tone.rst b/Documentation/linux_tv/media/dvb/fe-set-tone.rst index 5e80ee9988b03f2b468e3e0855c2c740befbfeb6..afe8b750fca685d94efe2577f4c7adc760709080 100644 --- a/Documentation/linux_tv/media/dvb/fe-set-tone.rst +++ b/Documentation/linux_tv/media/dvb/fe-set-tone.rst @@ -6,17 +6,18 @@ ioctl FE_SET_TONE ***************** -*man FE_SET_TONE(2)* +NAME +==== -Sets/resets the generation of the continuous 22kHz tone. +FE_SET_TONE - Sets/resets the generation of the continuous 22kHz tone. - -Synopsis +SYNOPSIS ======== .. c:function:: int ioctl( int fd, int request, enum fe_sec_tone_mode *tone ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +30,7 @@ Arguments pointer to enum :ref:`fe_sec_tone_mode ` -Description +DESCRIPTION =========== This ioctl is used to set the generation of the continuous 22kHz tone. @@ -45,7 +46,9 @@ a tone may interfere on other devices, as they may lose the 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 +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/fe-set-voltage.rst b/Documentation/linux_tv/media/dvb/fe-set-voltage.rst index 63c5f401e808a39f603844f1c429dd642c5deeb7..4fd30ee53f5b01d845a5e38a3fb7e8c9253008df 100644 --- a/Documentation/linux_tv/media/dvb/fe-set-voltage.rst +++ b/Documentation/linux_tv/media/dvb/fe-set-voltage.rst @@ -6,17 +6,18 @@ ioctl FE_SET_VOLTAGE ******************** -*man FE_SET_VOLTAGE(2)* +NAME +==== -Allow setting the DC level sent to the antenna subsystem. +FE_SET_VOLTAGE - Allow setting the DC level sent to the antenna subsystem. - -Synopsis +SYNOPSIS ======== .. c:function:: int ioctl( int fd, int request, enum fe_sec_voltage *voltage ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -32,7 +33,7 @@ Arguments :ref:`fe_sec_voltage `. -Description +DESCRIPTION =========== This ioctl allows to set the DC voltage level sent through the antenna @@ -52,7 +53,9 @@ capability of setting polarization or IF. So, on those cases, setting the voltage to SEC_VOLTAGE_OFF while the device is not is used is recommended. + RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/frontend_f_close.rst b/Documentation/linux_tv/media/dvb/frontend_f_close.rst index 8ca7f723ffc3b0644aa37017a4f728a7064ccac6..7946673d071ae65e344c1965ea6606bfb2ec7faa 100644 --- a/Documentation/linux_tv/media/dvb/frontend_f_close.rst +++ b/Documentation/linux_tv/media/dvb/frontend_f_close.rst @@ -6,12 +6,12 @@ DVB frontend close() ******************** -*man fe-close(2)* +NAME +==== -Close a frontend device +fe-close - Close a frontend 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() `. -Description +DESCRIPTION =========== This system call closes a previously opened front-end device. After @@ -36,7 +37,7 @@ closing a front-end device, its corresponding hardware might be powered down automatically. -Return Value +RETURN VALUE ============ The function returns 0 on success, -1 on failure and the ``errno`` is diff --git a/Documentation/linux_tv/media/dvb/frontend_f_open.rst b/Documentation/linux_tv/media/dvb/frontend_f_open.rst index d28c64514433911dcbaae7e6730dcf4c438c3795..97ca34b94d05c37bd016e23dc1c3814edf63fe42 100644 --- a/Documentation/linux_tv/media/dvb/frontend_f_open.rst +++ b/Documentation/linux_tv/media/dvb/frontend_f_open.rst @@ -6,12 +6,12 @@ DVB frontend open() ******************* -*man fe-open(2)* +NAME +==== -Open a frontend device +fe-open - Open a frontend 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`` @@ -43,7 +44,7 @@ Arguments Other flags have no effect. -Description +DESCRIPTION =========== This system call opens a named frontend device @@ -69,7 +70,7 @@ powered up, and that other front-ends may have been powered down to make that possible. -Return Value +RETURN VALUE ============ On success :ref:`open() ` returns the new file descriptor. diff --git a/Documentation/linux_tv/media/dvb/net-add-if.rst b/Documentation/linux_tv/media/dvb/net-add-if.rst index da0e7870c5d91f68a37a324912ea8b51fca71e07..dc9735d871ee5601e892dc48052bca9b25698bc8 100644 --- a/Documentation/linux_tv/media/dvb/net-add-if.rst +++ b/Documentation/linux_tv/media/dvb/net-add-if.rst @@ -6,17 +6,18 @@ ioctl NET_ADD_IF **************** -*man NET_ADD_IF(2)* +NAME +==== -Creates a new network interface for a given Packet ID. +NET_ADD_IF - Creates a new network interface for a given Packet ID. - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct dvb_net_if *net_if ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,7 +30,7 @@ Arguments pointer to struct :ref:`dvb_net_if ` -Description +DESCRIPTION =========== The NET_ADD_IF ioctl system call selects the Packet ID (PID) that @@ -80,7 +81,9 @@ struct dvb_net_if description ``DVB_NET_FEEDTYPE_MPE`` for MPE encoding or ``DVB_NET_FEEDTYPE_ULE`` for ULE encoding. + RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/net-get-if.rst b/Documentation/linux_tv/media/dvb/net-get-if.rst index 4581763b920ebaf6dbb3924590ed63d75e661d8e..16dfe78eb77f67be4e3aeaf1c406a828f3ab34fc 100644 --- a/Documentation/linux_tv/media/dvb/net-get-if.rst +++ b/Documentation/linux_tv/media/dvb/net-get-if.rst @@ -1,24 +1,23 @@ .. -*- coding: utf-8; mode: rst -*- - .. _NET_GET_IF: **************** ioctl NET_GET_IF **************** -*man NET_GET_IF(2)* - -Read the configuration data of an interface created via -:ref:`NET_ADD_IF `. +NAME +==== +NET_GET_IF - Read the configuration data of an interface created via - :ref:`NET_ADD_IF `. -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct dvb_net_if *net_if ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -31,7 +30,7 @@ Arguments pointer to struct :ref:`dvb_net_if ` -Description +DESCRIPTION =========== The NET_GET_IF ioctl uses the interface number given by the struct @@ -41,7 +40,9 @@ encapsulation type used on such interface. If the interface was not created yet with :ref:`NET_ADD_IF `, it will return -1 and fill the ``errno`` with ``EINVAL`` error code. + RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/net-remove-if.rst b/Documentation/linux_tv/media/dvb/net-remove-if.rst index 15a5d49f7a80ec6d4b723b13e61432e3a7f84cda..c4177833ecf6baa92951d7e7e588e369cc7d1a7c 100644 --- a/Documentation/linux_tv/media/dvb/net-remove-if.rst +++ b/Documentation/linux_tv/media/dvb/net-remove-if.rst @@ -6,17 +6,18 @@ ioctl NET_REMOVE_IF ******************* -*man NET_REMOVE_IF(2)* +NAME +==== -Removes a network interface. +NET_REMOVE_IF - Removes a network interface. - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, int ifnum ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -29,13 +30,15 @@ Arguments number of the interface to be removed -Description +DESCRIPTION =========== The NET_REMOVE_IF ioctl deletes an interface previously created via :ref:`NET_ADD_IF `. + RETURN VALUE +============ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the diff --git a/Documentation/linux_tv/media/dvb/video-clear-buffer.rst b/Documentation/linux_tv/media/dvb/video-clear-buffer.rst index 65efef3cc0fcb7a2e5ceab410d15dbb4f7508466..e6d2825f4c9b417dac00808da999b4b9bc4a7011 100644 --- a/Documentation/linux_tv/media/dvb/video-clear-buffer.rst +++ b/Documentation/linux_tv/media/dvb/video-clear-buffer.rst @@ -2,24 +2,23 @@ .. _VIDEO_CLEAR_BUFFER: +================== VIDEO_CLEAR_BUFFER ================== -Description ------------ +NAME +---- -This ioctl call clears all video buffers in the driver and in the -decoder hardware. +VIDEO_CLEAR_BUFFER -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_CLEAR_BUFFER) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -39,11 +38,16 @@ Arguments - Equals VIDEO_CLEAR_BUFFER for this command. -Return Value +DESCRIPTION +----------- + +This ioctl call clears all video buffers in the driver and in the +decoder hardware. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-command.rst b/Documentation/linux_tv/media/dvb/video-command.rst index 855a646a0f93b92d00553407b4b4a86721a0b015..1743f40145ff123da9edac5744ce57357c5b6f04 100644 --- a/Documentation/linux_tv/media/dvb/video-command.rst +++ b/Documentation/linux_tv/media/dvb/video-command.rst @@ -2,30 +2,23 @@ .. _VIDEO_COMMAND: +============= VIDEO_COMMAND ============= -Description ------------ +NAME +---- -This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders -this ioctl has been replaced by the -:ref:`VIDIOC_DECODER_CMD` ioctl. - -This ioctl commands the decoder. The ``video_command`` struct is a -subset of the ``v4l2_decoder_cmd`` struct, so refer to the -:ref:`VIDIOC_DECODER_CMD` documentation for -more information. +VIDEO_COMMAND -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = VIDEO_COMMAND, struct video_command *cmd) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -51,11 +44,22 @@ Arguments - Commands the decoder. -Return Value +DESCRIPTION +----------- + +This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders +this ioctl has been replaced by the +:ref:`VIDIOC_DECODER_CMD` ioctl. + +This ioctl commands the decoder. The ``video_command`` struct is a +subset of the ``v4l2_decoder_cmd`` struct, so refer to the +:ref:`VIDIOC_DECODER_CMD` documentation for +more information. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-continue.rst b/Documentation/linux_tv/media/dvb/video-continue.rst index 9d0f70b7c340707f584dfd433f779092fc3bf76d..453a87dfb40d968ccae2c3003e4fb406cdef43db 100644 --- a/Documentation/linux_tv/media/dvb/video-continue.rst +++ b/Documentation/linux_tv/media/dvb/video-continue.rst @@ -2,27 +2,23 @@ .. _VIDEO_CONTINUE: +============== VIDEO_CONTINUE ============== -Description ------------ - -This ioctl is for DVB devices only. To control a V4L2 decoder use the -V4L2 :ref:`VIDIOC_DECODER_CMD` instead. +NAME +---- -This ioctl call restarts decoding and playing processes of the video -stream which was played before a call to VIDEO_FREEZE was made. +VIDEO_CONTINUE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_CONTINUE) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -42,11 +38,19 @@ Arguments - Equals VIDEO_CONTINUE for this command. -Return Value +DESCRIPTION +----------- + +This ioctl is for DVB devices only. To control a V4L2 decoder use the +V4L2 :ref:`VIDIOC_DECODER_CMD` instead. + +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 ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-fast-forward.rst b/Documentation/linux_tv/media/dvb/video-fast-forward.rst index 3cf7d2d9d817d7c54c447bc4988ba3c7ebcf8f5a..586a23bb5cfd5a4f4fae3583197218ebb3058efe 100644 --- a/Documentation/linux_tv/media/dvb/video-fast-forward.rst +++ b/Documentation/linux_tv/media/dvb/video-fast-forward.rst @@ -2,25 +2,23 @@ .. _VIDEO_FAST_FORWARD: +================== VIDEO_FAST_FORWARD ================== -Description ------------ +NAME +---- -This ioctl call asks the Video Device to skip decoding of N number of -I-frames. This call can only be used if VIDEO_SOURCE_MEMORY is -selected. +VIDEO_FAST_FORWARD -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_FAST_FORWARD, int nFrames) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -46,7 +44,15 @@ Arguments - The number of frames to skip. -Return Value +DESCRIPTION +----------- + +This ioctl call asks the Video Device to skip decoding of N number of +I-frames. This call can only be used if VIDEO_SOURCE_MEMORY is +selected. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -65,6 +71,3 @@ appropriately. The generic error codes are described at the - ``EPERM`` - Mode VIDEO_SOURCE_MEMORY not selected. - - - diff --git a/Documentation/linux_tv/media/dvb/video-fclose.rst b/Documentation/linux_tv/media/dvb/video-fclose.rst index c9fc6560cb43f9585f3a28d9c8c4162dc5379c55..e98673768d2bfc990af2f8cb9ca814b31440f5cd 100644 --- a/Documentation/linux_tv/media/dvb/video-fclose.rst +++ b/Documentation/linux_tv/media/dvb/video-fclose.rst @@ -2,23 +2,23 @@ .. _video_fclose: +================= dvb video close() ================= -Description ------------ +NAME +---- -This system call closes a previously opened video device. +dvb video close() -Synopsis +SYNOPSIS -------- .. c:function:: int close(int fd) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -32,10 +32,14 @@ Arguments - File descriptor returned by a previous call to open(). -Return Value ------------- +DESCRIPTION +----------- + +This system call closes a previously opened video device. +RETURN VALUE +------------ .. flat-table:: :header-rows: 0 @@ -47,6 +51,3 @@ Return Value - ``EBADF`` - fd is not a valid open file descriptor. - - - diff --git a/Documentation/linux_tv/media/dvb/video-fopen.rst b/Documentation/linux_tv/media/dvb/video-fopen.rst index 9de94d4f69dd23263fdbf9e3b42fedd19b79c6b2..3c30fef2aab6346e64c3648b0a091a1773f18fb6 100644 --- a/Documentation/linux_tv/media/dvb/video-fopen.rst +++ b/Documentation/linux_tv/media/dvb/video-fopen.rst @@ -2,35 +2,23 @@ .. _video_fopen: +================ dvb video open() ================ -Description ------------ - -This system call opens a named video device (e.g. -/dev/dvb/adapter0/video0) for subsequent use. +NAME +---- -When an open() call has succeeded, the device will be ready for use. The -significance of blocking or non-blocking mode is described in the -documentation for functions where there is a difference. It does not -affect the semantics of the open() call itself. A device opened in -blocking mode can later be put into non-blocking mode (and vice versa) -using the F_SETFL command of the fcntl system call. This is a standard -system call, documented in the Linux manual page for fcntl. Only one -user can open the Video Device in O_RDWR mode. All other attempts to -open the device in this mode will fail, and an error-code will be -returned. If the Video Device is opened in O_RDONLY mode, the only -ioctl call that can be used is VIDEO_GET_STATUS. All other call will -return an error code. +dvb video open() -Synopsis +SYNOPSIS -------- .. c:function:: int open(const char *deviceName, int flags) -Arguments ----------- + +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -70,11 +58,29 @@ Arguments - (blocking mode is the default) -Return Value ------------- +DESCRIPTION +----------- +This system call opens a named video device (e.g. +/dev/dvb/adapter0/video0) for subsequent use. + +When an open() call has succeeded, the device will be ready for use. The +significance of blocking or non-blocking mode is described in the +documentation for functions where there is a difference. It does not +affect the semantics of the open() call itself. A device opened in +blocking mode can later be put into non-blocking mode (and vice versa) +using the F_SETFL command of the fcntl system call. This is a standard +system call, documented in the Linux manual page for fcntl. Only one +user can open the Video Device in O_RDWR mode. All other attempts to +open the device in this mode will fail, and an error-code will be +returned. If the Video Device is opened in O_RDONLY mode, the only +ioctl call that can be used is VIDEO_GET_STATUS. All other call will +return an error code. +RETURN VALUE +------------ + .. flat-table:: :header-rows: 0 :stub-columns: 0 @@ -103,6 +109,3 @@ Return Value - ``EINVAL`` - Invalid argument. - - - diff --git a/Documentation/linux_tv/media/dvb/video-freeze.rst b/Documentation/linux_tv/media/dvb/video-freeze.rst index d384e329b6619d099e6b3db29b7e9a3aef3875a5..8fbc7835382c1cdcf82f94b5bbe0ae4a4e187bd9 100644 --- a/Documentation/linux_tv/media/dvb/video-freeze.rst +++ b/Documentation/linux_tv/media/dvb/video-freeze.rst @@ -2,31 +2,23 @@ .. _VIDEO_FREEZE: +============ VIDEO_FREEZE ============ -Description ------------ +NAME +---- -This ioctl is for DVB devices only. To control a V4L2 decoder use the -V4L2 :ref:`VIDIOC_DECODER_CMD` instead. - -This ioctl call suspends the live video stream being played. Decoding -and playing are frozen. It is then possible to restart the decoding and -playing process of the video stream using the VIDEO_CONTINUE command. -If VIDEO_SOURCE_MEMORY is selected in the ioctl call -VIDEO_SELECT_SOURCE, the DVB subsystem will not decode any more data -until the ioctl call VIDEO_CONTINUE or VIDEO_PLAY is performed. +VIDEO_FREEZE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_FREEZE) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -46,11 +38,23 @@ Arguments - Equals VIDEO_FREEZE for this command. -Return Value +DESCRIPTION +----------- + +This ioctl is for DVB devices only. To control a V4L2 decoder use the +V4L2 :ref:`VIDIOC_DECODER_CMD` instead. + +This ioctl call suspends the live video stream being played. Decoding +and playing are frozen. It is then possible to restart the decoding and +playing process of the video stream using the VIDEO_CONTINUE command. +If VIDEO_SOURCE_MEMORY is selected in the ioctl call +VIDEO_SELECT_SOURCE, the DVB subsystem will not decode any more data +until the ioctl call VIDEO_CONTINUE or VIDEO_PLAY is performed. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-fwrite.rst b/Documentation/linux_tv/media/dvb/video-fwrite.rst index 398bbeaeaf8bbefb293f8aad872795806ea1a506..f56c89caef32086d0a480a0f27ab4c6afaa9694f 100644 --- a/Documentation/linux_tv/media/dvb/video-fwrite.rst +++ b/Documentation/linux_tv/media/dvb/video-fwrite.rst @@ -2,27 +2,23 @@ .. _video_fwrite: +================= dvb video write() ================= -Description ------------ +NAME +---- -This system call can only be used if VIDEO_SOURCE_MEMORY is selected -in the ioctl call VIDEO_SELECT_SOURCE. The data provided shall be in -PES format, unless the capability allows other formats. If O_NONBLOCK -is not specified the function will block until buffer space is -available. The amount of data to be transferred is implied by count. +dvb video write() -Synopsis +SYNOPSIS -------- .. c:function:: size_t write(int fd, const void *buf, size_t count) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -48,11 +44,19 @@ Arguments - Size of buf. -Return Value ------------- +DESCRIPTION +----------- +This system call can only be used if VIDEO_SOURCE_MEMORY is selected +in the ioctl call VIDEO_SELECT_SOURCE. The data provided shall be in +PES format, unless the capability allows other formats. If O_NONBLOCK +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 +------------ + .. flat-table:: :header-rows: 0 :stub-columns: 0 @@ -75,6 +79,3 @@ Return Value - ``EBADF`` - fd is not a valid open file descriptor. - - - diff --git a/Documentation/linux_tv/media/dvb/video-get-capabilities.rst b/Documentation/linux_tv/media/dvb/video-get-capabilities.rst index 7b5dcc523a6924b74783fcbf13a81f34d96b10dd..5666ae7f20c0a591f542b05ecf02db37698cb1e9 100644 --- a/Documentation/linux_tv/media/dvb/video-get-capabilities.rst +++ b/Documentation/linux_tv/media/dvb/video-get-capabilities.rst @@ -2,25 +2,23 @@ .. _VIDEO_GET_CAPABILITIES: +====================== VIDEO_GET_CAPABILITIES ====================== -Description ------------ +NAME +---- -This ioctl call asks the video device about its decoding capabilities. -On success it returns and integer which has bits set according to the -defines in section ??. +VIDEO_GET_CAPABILITIES -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_GET_CAPABILITIES, unsigned int *cap) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -46,11 +44,17 @@ Arguments - Pointer to a location where to store the capability information. -Return Value +DESCRIPTION +----------- + +This ioctl call asks the video device about its decoding capabilities. +On success it returns and integer which has bits set according to the +defines in section ??. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-get-event.rst b/Documentation/linux_tv/media/dvb/video-get-event.rst index b958652cac7baf8f1c2069663847bb6aeb595eb5..3240cd6da6f61be62c4380355d0f0ac614a69a27 100644 --- a/Documentation/linux_tv/media/dvb/video-get-event.rst +++ b/Documentation/linux_tv/media/dvb/video-get-event.rst @@ -2,35 +2,23 @@ .. _VIDEO_GET_EVENT: +=============== VIDEO_GET_EVENT =============== -Description ------------ - -This ioctl is for DVB devices only. To get events from a V4L2 decoder -use the V4L2 :ref:`VIDIOC_DQEVENT` ioctl instead. +NAME +---- -This ioctl call returns an event of type video_event if available. If -an event is not available, the behavior depends on whether the device is -in blocking or non-blocking mode. In the latter case, the call fails -immediately with errno set to ``EWOULDBLOCK``. In the former case, the call -blocks until an event becomes available. The standard Linux poll() -and/or select() system calls can be used with the device file descriptor -to watch for new events. For select(), the file descriptor should be -included in the exceptfds argument, and for poll(), POLLPRI should be -specified as the wake-up condition. Read-only permissions are sufficient -for this ioctl call. +VIDEO_GET_EVENT -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_GET_EVENT, struct video_event *ev) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -56,7 +44,25 @@ Arguments - Points to the location where the event, if any, is to be stored. -Return Value +DESCRIPTION +----------- + +This ioctl is for DVB devices only. To get events from a V4L2 decoder +use the V4L2 :ref:`VIDIOC_DQEVENT` ioctl instead. + +This ioctl call returns an event of type video_event if available. If +an event is not available, the behavior depends on whether the device is +in blocking or non-blocking mode. In the latter case, the call fails +immediately with errno set to ``EWOULDBLOCK``. In the former case, the call +blocks until an event becomes available. The standard Linux poll() +and/or select() system calls can be used with the device file descriptor +to watch for new events. For select(), the file descriptor should be +included in the exceptfds argument, and for poll(), POLLPRI should be +specified as the wake-up condition. Read-only permissions are sufficient +for this ioctl call. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -81,6 +87,3 @@ appropriately. The generic error codes are described at the - ``EOVERFLOW`` - Overflow in event queue - one or more events were lost. - - - diff --git a/Documentation/linux_tv/media/dvb/video-get-frame-count.rst b/Documentation/linux_tv/media/dvb/video-get-frame-count.rst index c7c140f2467af9f0739d81e882d624c4e0675bd5..97ec0581015443c1cc0642b80d5a8218048a168e 100644 --- a/Documentation/linux_tv/media/dvb/video-get-frame-count.rst +++ b/Documentation/linux_tv/media/dvb/video-get-frame-count.rst @@ -2,28 +2,23 @@ .. _VIDEO_GET_FRAME_COUNT: +===================== VIDEO_GET_FRAME_COUNT ===================== -Description ------------ - -This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders -this ioctl has been replaced by the ``V4L2_CID_MPEG_VIDEO_DEC_FRAME`` -control. +NAME +---- -This ioctl call asks the Video Device to return the number of displayed -frames since the decoder was started. +VIDEO_GET_FRAME_COUNT -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = VIDEO_GET_FRAME_COUNT, __u64 *pts) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -50,11 +45,20 @@ Arguments started. -Return Value +DESCRIPTION +----------- + +This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders +this ioctl has been replaced by the ``V4L2_CID_MPEG_VIDEO_DEC_FRAME`` +control. + +This ioctl call asks the Video Device to return the number of displayed +frames since the decoder was started. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-get-frame-rate.rst b/Documentation/linux_tv/media/dvb/video-get-frame-rate.rst index bfd09385cb31033a25805fc80b11f55097b8d91e..62a85be537ab68bab0a8d401149392ec1249d1f9 100644 --- a/Documentation/linux_tv/media/dvb/video-get-frame-rate.rst +++ b/Documentation/linux_tv/media/dvb/video-get-frame-rate.rst @@ -2,23 +2,23 @@ .. _VIDEO_GET_FRAME_RATE: +==================== VIDEO_GET_FRAME_RATE ==================== -Description ------------ +NAME +---- -This ioctl call asks the Video Device to return the current framerate. +VIDEO_GET_FRAME_RATE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = VIDEO_GET_FRAME_RATE, unsigned int *rate) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -44,11 +44,15 @@ Arguments - Returns the framerate in number of frames per 1000 seconds. -Return Value +DESCRIPTION +----------- + +This ioctl call asks the Video Device to return the current framerate. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-get-navi.rst b/Documentation/linux_tv/media/dvb/video-get-navi.rst index 62451fc03924f84e036b250a4afe5c55e17640e5..95dea513bc4833838b69be0f9dd05f81f5052876 100644 --- a/Documentation/linux_tv/media/dvb/video-get-navi.rst +++ b/Documentation/linux_tv/media/dvb/video-get-navi.rst @@ -2,25 +2,23 @@ .. _VIDEO_GET_NAVI: +============== VIDEO_GET_NAVI ============== -Description ------------ +NAME +---- -This ioctl returns navigational information from the DVD stream. This is -especially needed if an encoded stream has to be decoded by the -hardware. +VIDEO_GET_NAVI -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_GET_NAVI , video_navi_pack_t *navipack) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -46,7 +44,15 @@ Arguments - PCI or DSI pack (private stream 2) according to section ??. -Return Value +DESCRIPTION +----------- + +This ioctl returns navigational information from the DVD stream. This is +especially needed if an encoded stream has to be decoded by the +hardware. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -65,6 +71,3 @@ appropriately. The generic error codes are described at the - ``EFAULT`` - driver is not able to return navigational information - - - diff --git a/Documentation/linux_tv/media/dvb/video-get-pts.rst b/Documentation/linux_tv/media/dvb/video-get-pts.rst index 67b9297539636995dd4e5b454435d17d6e082b6d..f56e02a1f4479bf27e3cb79178e2ed3eedbae6a1 100644 --- a/Documentation/linux_tv/media/dvb/video-get-pts.rst +++ b/Documentation/linux_tv/media/dvb/video-get-pts.rst @@ -2,28 +2,23 @@ .. _VIDEO_GET_PTS: +============= VIDEO_GET_PTS ============= -Description ------------ - -This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders -this ioctl has been replaced by the ``V4L2_CID_MPEG_VIDEO_DEC_PTS`` -control. +NAME +---- -This ioctl call asks the Video Device to return the current PTS -timestamp. +VIDEO_GET_PTS -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = VIDEO_GET_PTS, __u64 *pts) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -54,11 +49,20 @@ Arguments decoded frame or the last PTS extracted by the PES parser. -Return Value +DESCRIPTION +----------- + +This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders +this ioctl has been replaced by the ``V4L2_CID_MPEG_VIDEO_DEC_PTS`` +control. + +This ioctl call asks the Video Device to return the current PTS +timestamp. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-get-size.rst b/Documentation/linux_tv/media/dvb/video-get-size.rst index 0e16d91838acf76b98af2b5a69f96ea2e516f19b..cbdf976223e5a87908c8c010d33d43f9c1f354df 100644 --- a/Documentation/linux_tv/media/dvb/video-get-size.rst +++ b/Documentation/linux_tv/media/dvb/video-get-size.rst @@ -2,23 +2,23 @@ .. _VIDEO_GET_SIZE: +============== VIDEO_GET_SIZE ============== -Description ------------ +NAME +---- -This ioctl returns the size and aspect ratio. +VIDEO_GET_SIZE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = VIDEO_GET_SIZE, video_size_t *size) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -44,11 +44,15 @@ Arguments - Returns the size and aspect ratio. -Return Value +DESCRIPTION +----------- + +This ioctl returns the size and aspect ratio. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-get-status.rst b/Documentation/linux_tv/media/dvb/video-get-status.rst index fd9e591de5dff7f5e0c1df718d016235cac20b7d..25344bf0ea7bd58f1fd4153c86fd37390de9478a 100644 --- a/Documentation/linux_tv/media/dvb/video-get-status.rst +++ b/Documentation/linux_tv/media/dvb/video-get-status.rst @@ -2,24 +2,23 @@ .. _VIDEO_GET_STATUS: +================ VIDEO_GET_STATUS ================ -Description ------------ +NAME +---- -This ioctl call asks the Video Device to return the current status of -the device. +VIDEO_GET_STATUS -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_GET_STATUS, struct video_status *status) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -45,11 +44,16 @@ Arguments - Returns the current status of the Video Device. -Return Value +DESCRIPTION +----------- + +This ioctl call asks the Video Device to return the current status of +the device. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-play.rst b/Documentation/linux_tv/media/dvb/video-play.rst index da328ed2b4a0137d3f7e7bbc1d1afc618ad16955..18252d9d2ce6a367f9ec4ca5a82a651a3aaeaeeb 100644 --- a/Documentation/linux_tv/media/dvb/video-play.rst +++ b/Documentation/linux_tv/media/dvb/video-play.rst @@ -2,27 +2,23 @@ .. _VIDEO_PLAY: +========== VIDEO_PLAY ========== -Description ------------ - -This ioctl is for DVB devices only. To control a V4L2 decoder use the -V4L2 :ref:`VIDIOC_DECODER_CMD` instead. +NAME +---- -This ioctl call asks the Video Device to start playing a video stream -from the selected source. +VIDEO_PLAY -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_PLAY) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -42,11 +38,19 @@ Arguments - Equals VIDEO_PLAY for this command. -Return Value +DESCRIPTION +----------- + +This ioctl is for DVB devices only. To control a V4L2 decoder use the +V4L2 :ref:`VIDIOC_DECODER_CMD` instead. + +This ioctl call asks the Video Device to start playing a video stream +from the selected source. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-select-source.rst b/Documentation/linux_tv/media/dvb/video-select-source.rst index 41fc728508c0a407916c528e5609b6ec185a4244..2e76af3d468b10b8072165f5469fe954a3a82838 100644 --- a/Documentation/linux_tv/media/dvb/video-select-source.rst +++ b/Documentation/linux_tv/media/dvb/video-select-source.rst @@ -2,29 +2,23 @@ .. _VIDEO_SELECT_SOURCE: +=================== VIDEO_SELECT_SOURCE =================== -Description ------------ - -This ioctl is for DVB devices only. This ioctl was also supported by the -V4L2 ivtv driver, but that has been replaced by the ivtv-specific -``IVTV_IOC_PASSTHROUGH_MODE`` ioctl. +NAME +---- -This ioctl call informs the video device which source shall be used for -the input data. The possible sources are demux or memory. If memory is -selected, the data is fed to the video device through the write command. +VIDEO_SELECT_SOURCE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_SELECT_SOURCE, video_stream_source_t source) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -50,11 +44,21 @@ Arguments - Indicates which source shall be used for the Video stream. -Return Value +DESCRIPTION +----------- + +This ioctl is for DVB devices only. This ioctl was also supported by the +V4L2 ivtv driver, but that has been replaced by the ivtv-specific +``IVTV_IOC_PASSTHROUGH_MODE`` ioctl. + +This ioctl call informs the video device which source shall be used for +the input data. The possible sources are demux or memory. If memory is +selected, the data is fed to the video device through the write command. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-set-attributes.rst b/Documentation/linux_tv/media/dvb/video-set-attributes.rst index 255efe0872d181832d6d05e7faac74a116c87d35..6de9378ce1c76576237202decfaec8454e05649b 100644 --- a/Documentation/linux_tv/media/dvb/video-set-attributes.rst +++ b/Documentation/linux_tv/media/dvb/video-set-attributes.rst @@ -2,26 +2,23 @@ .. _VIDEO_SET_ATTRIBUTES: +==================== VIDEO_SET_ATTRIBUTES ==================== -Description ------------ +NAME +---- -This ioctl is intended for DVD playback and allows you to set certain -information about the stream. Some hardware may not need this -information, but the call also tells the hardware to prepare for DVD -playback. +VIDEO_SET_ATTRIBUTES -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_SET_ATTRIBUTE ,video_attributes_t vattr) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -47,7 +44,16 @@ Arguments - video attributes according to section ??. -Return Value +DESCRIPTION +----------- + +This ioctl is intended for DVD playback and allows you to set certain +information about the stream. Some hardware may not need this +information, but the call also tells the hardware to prepare for DVD +playback. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set diff --git a/Documentation/linux_tv/media/dvb/video-set-blank.rst b/Documentation/linux_tv/media/dvb/video-set-blank.rst index 0ed2afdf4b72e497437272129df560c18602eeca..62b46b8b2d027acdc5feab4cbcdddcb7ddb6b3ad 100644 --- a/Documentation/linux_tv/media/dvb/video-set-blank.rst +++ b/Documentation/linux_tv/media/dvb/video-set-blank.rst @@ -2,23 +2,23 @@ .. _VIDEO_SET_BLANK: +=============== VIDEO_SET_BLANK =============== -Description ------------ +NAME +---- -This ioctl call asks the Video Device to blank out the picture. +VIDEO_SET_BLANK -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_SET_BLANK, boolean mode) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -49,11 +49,15 @@ Arguments - FALSE: Show last decoded frame. -Return Value +DESCRIPTION +----------- + +This ioctl call asks the Video Device to blank out the picture. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-set-display-format.rst b/Documentation/linux_tv/media/dvb/video-set-display-format.rst index af55cefbd3c0a4ba5ff6b34372b7e18747c23cbd..7aec080638dec54be42f9d90ef65135eb1a161ea 100644 --- a/Documentation/linux_tv/media/dvb/video-set-display-format.rst +++ b/Documentation/linux_tv/media/dvb/video-set-display-format.rst @@ -2,24 +2,23 @@ .. _VIDEO_SET_DISPLAY_FORMAT: +======================== VIDEO_SET_DISPLAY_FORMAT ======================== -Description ------------ +NAME +---- -This ioctl call asks the Video Device to select the video format to be -applied by the MPEG chip on the video. +VIDEO_SET_DISPLAY_FORMAT -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_SET_DISPLAY_FORMAT, video_display_format_t format) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -45,11 +44,16 @@ Arguments - Selects the video format to be used. -Return Value +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 ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-set-format.rst b/Documentation/linux_tv/media/dvb/video-set-format.rst index aea4d913c760a76b7b393e41d41db2cb23740758..af126d2de8c3e5e5f594b79bb19157618d94fe87 100644 --- a/Documentation/linux_tv/media/dvb/video-set-format.rst +++ b/Documentation/linux_tv/media/dvb/video-set-format.rst @@ -2,25 +2,23 @@ .. _VIDEO_SET_FORMAT: +================ VIDEO_SET_FORMAT ================ -Description ------------ +NAME +---- -This ioctl sets the screen format (aspect ratio) of the connected output -device (TV) so that the output of the decoder can be adjusted -accordingly. +VIDEO_SET_FORMAT -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_SET_FORMAT, video_format_t format) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -46,7 +44,15 @@ Arguments - video format of TV as defined in section ??. -Return Value +DESCRIPTION +----------- + +This ioctl sets the screen format (aspect ratio) of the connected output +device (TV) so that the output of the decoder can be adjusted +accordingly. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -65,6 +71,3 @@ appropriately. The generic error codes are described at the - ``EINVAL`` - format is not a valid video format. - - - diff --git a/Documentation/linux_tv/media/dvb/video-set-highlight.rst b/Documentation/linux_tv/media/dvb/video-set-highlight.rst index e92b7ac28f2365adc35f0fabc0e94d2ad0a25d16..d8628d2827403414cd5930ff81bed4023340e6e1 100644 --- a/Documentation/linux_tv/media/dvb/video-set-highlight.rst +++ b/Documentation/linux_tv/media/dvb/video-set-highlight.rst @@ -2,24 +2,23 @@ .. _VIDEO_SET_HIGHLIGHT: +=================== VIDEO_SET_HIGHLIGHT =================== -Description ------------ +NAME +---- -This ioctl sets the SPU highlight information for the menu access of a -DVD. +VIDEO_SET_HIGHLIGHT -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_SET_HIGHLIGHT ,video_highlight_t *vhilite) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -45,11 +44,16 @@ Arguments - SPU Highlight information according to section ??. -Return Value +DESCRIPTION +----------- + +This ioctl sets the SPU highlight information for the menu access of a +DVD. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-set-id.rst b/Documentation/linux_tv/media/dvb/video-set-id.rst index 5a58405fba42187ebf3ada3fa05ae8e731e61793..31ca41f8b6af0b641e5c034b6fc9439de0ca40ab 100644 --- a/Documentation/linux_tv/media/dvb/video-set-id.rst +++ b/Documentation/linux_tv/media/dvb/video-set-id.rst @@ -2,24 +2,23 @@ .. _VIDEO_SET_ID: +============ VIDEO_SET_ID ============ -Description ------------ +NAME +---- -This ioctl selects which sub-stream is to be decoded if a program or -system stream is sent to the video device. +VIDEO_SET_ID -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = VIDEO_SET_ID, int id) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -45,7 +44,14 @@ Arguments - video sub-stream id -Return Value +DESCRIPTION +----------- + +This ioctl selects which sub-stream is to be decoded if a program or +system stream is sent to the video device. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -64,6 +70,3 @@ appropriately. The generic error codes are described at the - ``EINVAL`` - Invalid sub-stream id. - - - diff --git a/Documentation/linux_tv/media/dvb/video-set-spu-palette.rst b/Documentation/linux_tv/media/dvb/video-set-spu-palette.rst index 3fb338ee74208b4bb4b1010592974fa29a905359..b3b727fec64bf8d2f54d2394b953765b4888ea67 100644 --- a/Documentation/linux_tv/media/dvb/video-set-spu-palette.rst +++ b/Documentation/linux_tv/media/dvb/video-set-spu-palette.rst @@ -2,23 +2,23 @@ .. _VIDEO_SET_SPU_PALETTE: +===================== VIDEO_SET_SPU_PALETTE ===================== -Description ------------ +NAME +---- -This ioctl sets the SPU color palette. +VIDEO_SET_SPU_PALETTE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_SET_SPU_PALETTE, video_spu_palette_t *palette ) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -44,7 +44,13 @@ Arguments - SPU palette according to section ??. -Return Value +DESCRIPTION +----------- + +This ioctl sets the SPU color palette. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -63,6 +69,3 @@ appropriately. The generic error codes are described at the - ``EINVAL`` - input is not a valid palette or driver doesn’t handle SPU. - - - diff --git a/Documentation/linux_tv/media/dvb/video-set-spu.rst b/Documentation/linux_tv/media/dvb/video-set-spu.rst index 863c6248fab955e9af219ddc944c1bd8c3bb1b40..d00d0b5272d7e51412e08e2675cb49214cd0b444 100644 --- a/Documentation/linux_tv/media/dvb/video-set-spu.rst +++ b/Documentation/linux_tv/media/dvb/video-set-spu.rst @@ -2,24 +2,23 @@ .. _VIDEO_SET_SPU: +============= VIDEO_SET_SPU ============= -Description ------------ +NAME +---- -This ioctl activates or deactivates SPU decoding in a DVD input stream. -It can only be used, if the driver is able to handle a DVD stream. +VIDEO_SET_SPU -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_SET_SPU , video_spu_t *spu) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -46,7 +45,14 @@ Arguments ??. -Return Value +DESCRIPTION +----------- + +This ioctl activates or deactivates SPU decoding in a DVD input stream. +It can only be used, if the driver is able to handle a DVD stream. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -65,6 +71,3 @@ appropriately. The generic error codes are described at the - ``EINVAL`` - input is not a valid spu setting or driver cannot handle SPU. - - - diff --git a/Documentation/linux_tv/media/dvb/video-set-streamtype.rst b/Documentation/linux_tv/media/dvb/video-set-streamtype.rst index c412051cc07386800b35cf00e8b3063ca8c0fd00..6875ff8db77e3effd84035483083d41f29b5bcd6 100644 --- a/Documentation/linux_tv/media/dvb/video-set-streamtype.rst +++ b/Documentation/linux_tv/media/dvb/video-set-streamtype.rst @@ -2,25 +2,23 @@ .. _VIDEO_SET_STREAMTYPE: +==================== VIDEO_SET_STREAMTYPE ==================== -Description ------------ +NAME +---- -This ioctl tells the driver which kind of stream to expect being written -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. +VIDEO_SET_STREAMTYPE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_SET_STREAMTYPE, int type) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -46,11 +44,17 @@ Arguments - stream type -Return Value +DESCRIPTION +----------- + +This ioctl tells the driver which kind of stream to expect being written +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 ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-set-system.rst b/Documentation/linux_tv/media/dvb/video-set-system.rst index 70bff8a1c53ad90a6e86f20dae578fd564177fbe..7fcd1a1fb78b72c4b12e28f7b781bc3be4e14de7 100644 --- a/Documentation/linux_tv/media/dvb/video-set-system.rst +++ b/Documentation/linux_tv/media/dvb/video-set-system.rst @@ -2,26 +2,23 @@ .. _VIDEO_SET_SYSTEM: +================ VIDEO_SET_SYSTEM ================ -Description ------------ +NAME +---- -This ioctl sets the television output format. The format (see section -??) may vary from the color format of the displayed MPEG stream. If the -hardware is not able to display the requested format the call will -return an error. +VIDEO_SET_SYSTEM -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_SET_SYSTEM , video_system_t system) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -47,7 +44,16 @@ Arguments - video system of TV output. -Return Value +DESCRIPTION +----------- + +This ioctl sets the television output format. The format (see section +??) may vary from the color format of the displayed MPEG stream. If the +hardware is not able to display the requested format the call will +return an error. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -66,6 +72,3 @@ appropriately. The generic error codes are described at the - ``EINVAL`` - system is not a valid or supported video system. - - - diff --git a/Documentation/linux_tv/media/dvb/video-slowmotion.rst b/Documentation/linux_tv/media/dvb/video-slowmotion.rst index e04ad5776683bc10ae38e8129f84423d0c070a91..6472abb1e42d83baa3f998dd46ae5aa0858f2488 100644 --- a/Documentation/linux_tv/media/dvb/video-slowmotion.rst +++ b/Documentation/linux_tv/media/dvb/video-slowmotion.rst @@ -2,25 +2,23 @@ .. _VIDEO_SLOWMOTION: +================ VIDEO_SLOWMOTION ================ -Description ------------ +NAME +---- -This ioctl call asks the video device to repeat decoding frames N number -of times. This call can only be used if VIDEO_SOURCE_MEMORY is -selected. +VIDEO_SLOWMOTION -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_SLOWMOTION, int nFrames) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -46,7 +44,15 @@ Arguments - The number of times to repeat each frame. -Return Value +DESCRIPTION +----------- + +This ioctl call asks the video device to repeat decoding frames N number +of times. This call can only be used if VIDEO_SOURCE_MEMORY is +selected. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set @@ -65,6 +71,3 @@ appropriately. The generic error codes are described at the - ``EPERM`` - Mode VIDEO_SOURCE_MEMORY not selected. - - - diff --git a/Documentation/linux_tv/media/dvb/video-stillpicture.rst b/Documentation/linux_tv/media/dvb/video-stillpicture.rst index 94ae66c1d97bf140784d947b56efdc0d61a0a6d8..93c9c30bcdd338efcc7f7b1ad452bea5afa83365 100644 --- a/Documentation/linux_tv/media/dvb/video-stillpicture.rst +++ b/Documentation/linux_tv/media/dvb/video-stillpicture.rst @@ -2,25 +2,23 @@ .. _VIDEO_STILLPICTURE: +================== VIDEO_STILLPICTURE ================== -Description ------------ +NAME +---- -This ioctl call asks the Video Device to display a still picture -(I-frame). The input data shall contain an I-frame. If the pointer is -NULL, then the current displayed still picture is blanked. +VIDEO_STILLPICTURE -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_STILLPICTURE, struct video_still_picture *sp) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -46,11 +44,17 @@ Arguments - Pointer to a location where an I-frame and size is stored. -Return Value +DESCRIPTION +----------- + +This ioctl call asks the Video Device to display a still picture +(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 ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-stop.rst b/Documentation/linux_tv/media/dvb/video-stop.rst index fd5288727911012b35100fe24800a1f24411b10b..2dbf464d85bbd1e37ec2677d51f04b9832bd4564 100644 --- a/Documentation/linux_tv/media/dvb/video-stop.rst +++ b/Documentation/linux_tv/media/dvb/video-stop.rst @@ -2,28 +2,23 @@ .. _VIDEO_STOP: +========== VIDEO_STOP ========== -Description ------------ - -This ioctl is for DVB devices only. To control a V4L2 decoder use the -V4L2 :ref:`VIDIOC_DECODER_CMD` instead. +NAME +---- -This ioctl call asks the Video Device to stop playing the current -stream. Depending on the input parameter, the screen can be blanked out -or displaying the last decoded frame. +VIDEO_STOP -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(fd, int request = VIDEO_STOP, boolean mode) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -59,11 +54,20 @@ Arguments - FALSE: Show last decoded frame. -Return Value +DESCRIPTION +----------- + +This ioctl is for DVB devices only. To control a V4L2 decoder use the +V4L2 :ref:`VIDIOC_DECODER_CMD` instead. + +This ioctl call asks the Video Device to stop playing the current +stream. Depending on the input parameter, the screen can be blanked out +or displaying the last decoded frame. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/dvb/video-try-command.rst b/Documentation/linux_tv/media/dvb/video-try-command.rst index 57eff3daf7bd03b2a4046136e1667def08aa291c..b30cfcd05682aebdaf6df72720bdefe87c3caa49 100644 --- a/Documentation/linux_tv/media/dvb/video-try-command.rst +++ b/Documentation/linux_tv/media/dvb/video-try-command.rst @@ -2,30 +2,23 @@ .. _VIDEO_TRY_COMMAND: +================= VIDEO_TRY_COMMAND ================= -Description ------------ +NAME +---- -This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders -this ioctl has been replaced by the -:ref:`VIDIOC_TRY_DECODER_CMD ` ioctl. - -This ioctl tries a decoder command. The ``video_command`` struct is a -subset of the ``v4l2_decoder_cmd`` struct, so refer to the -:ref:`VIDIOC_TRY_DECODER_CMD ` documentation -for more information. +VIDEO_TRY_COMMAND -Synopsis +SYNOPSIS -------- .. c:function:: int ioctl(int fd, int request = VIDEO_TRY_COMMAND, struct video_command *cmd) -Arguments ----------- - +ARGUMENTS +--------- .. flat-table:: :header-rows: 0 @@ -51,11 +44,22 @@ Arguments - Try a decoder command. -Return Value +DESCRIPTION +----------- + +This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders +this ioctl has been replaced by the +:ref:`VIDIOC_TRY_DECODER_CMD ` ioctl. + +This ioctl tries a decoder command. The ``video_command`` struct is a +subset of the ``v4l2_decoder_cmd`` struct, so refer to the +:ref:`VIDIOC_TRY_DECODER_CMD ` documentation +for more information. + + +RETURN VALUE ------------ On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter. - - diff --git a/Documentation/linux_tv/media/mediactl/media-func-close.rst b/Documentation/linux_tv/media/mediactl/media-func-close.rst index 109b831e40479cfc7d843e4a32e867798628d9e1..7ec0baa83482874d2567472ec8c38b5b8607d409 100644 --- a/Documentation/linux_tv/media/mediactl/media-func-close.rst +++ b/Documentation/linux_tv/media/mediactl/media-func-close.rst @@ -6,12 +6,12 @@ media close() ************* -*man media-close(2)* +NAME +==== -Close a media device +media-close - Close a media device - -Synopsis +SYNOPSIS ======== .. code-block:: c @@ -21,21 +21,22 @@ Synopsis .. cpp:function:: int close( int fd ) -Arguments + +ARGUMENTS ========= ``fd`` File descriptor returned by :ref:`open() `. -Description +DESCRIPTION =========== Closes the media device. Resources associated with the file descriptor are freed. The device configuration remain unchanged. -Return Value +RETURN VALUE ============ :ref:`close() ` returns 0 on success. On error, -1 is returned, and diff --git a/Documentation/linux_tv/media/mediactl/media-func-ioctl.rst b/Documentation/linux_tv/media/mediactl/media-func-ioctl.rst index c56ccb9c9b391f1bc80990b249ba291c2d4850a0..0d8f706b7e743088076f4b7fa4a7126a310637dd 100644 --- a/Documentation/linux_tv/media/mediactl/media-func-ioctl.rst +++ b/Documentation/linux_tv/media/mediactl/media-func-ioctl.rst @@ -6,12 +6,12 @@ media ioctl() ************* -*man media-ioctl(2)* +NAME +==== -Control a media device +media-ioctl - Control a media 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 request-specific structure. -Description +DESCRIPTION =========== The :ref:`ioctl() ` function manipulates media device parameters. @@ -51,7 +52,7 @@ requests, their respective function and parameters are specified in :ref:`media-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/mediactl/media-func-open.rst b/Documentation/linux_tv/media/mediactl/media-func-open.rst index 627860b33ae27dd49ded369ba3a0ecbefdd489a0..353114fcb7caaa259e20f2eacd56aa4ca6c4554b 100644 --- a/Documentation/linux_tv/media/mediactl/media-func-open.rst +++ b/Documentation/linux_tv/media/mediactl/media-func-open.rst @@ -6,12 +6,12 @@ media open() ************ -*man media-open(2)* +NAME +==== -Open a media device +media-open - Open a media 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`` @@ -32,7 +33,7 @@ Arguments Other flags have no effect. -Description +DESCRIPTION =========== To open a media device applications call :ref:`open() ` with the @@ -44,7 +45,7 @@ configuration will result in an error, and ``errno`` will be set to EBADF. -Return Value +RETURN VALUE ============ :ref:`open() ` returns the new file descriptor on success. On error, diff --git a/Documentation/linux_tv/media/mediactl/media-ioc-device-info.rst b/Documentation/linux_tv/media/mediactl/media-ioc-device-info.rst index 8339e193ba8be8a945bfbc74353045031efb160d..52fe981a4036d720cc3c312ea9d3990f7de4e986 100644 --- a/Documentation/linux_tv/media/mediactl/media-ioc-device-info.rst +++ b/Documentation/linux_tv/media/mediactl/media-ioc-device-info.rst @@ -6,17 +6,18 @@ ioctl MEDIA_IOC_DEVICE_INFO *************************** -*man MEDIA_IOC_DEVICE_INFO(2)* +NAME +==== -Query device information +MEDIA_IOC_DEVICE_INFO - Query device information - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct media_device_info *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== All media devices must support the ``MEDIA_IOC_DEVICE_INFO`` ioctl. To @@ -132,7 +133,7 @@ used instead. The ``bus_info`` field is guaranteed to be unique, but can vary across reboots or device unplug/replug. -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/mediactl/media-ioc-enum-entities.rst b/Documentation/linux_tv/media/mediactl/media-ioc-enum-entities.rst index 6e0a0c27ba2fecf39d6fcd9d98e8445507a3cf36..5d11572d48488afe3373916c7a916ff78020bcdf 100644 --- a/Documentation/linux_tv/media/mediactl/media-ioc-enum-entities.rst +++ b/Documentation/linux_tv/media/mediactl/media-ioc-enum-entities.rst @@ -6,17 +6,18 @@ ioctl MEDIA_IOC_ENUM_ENTITIES ***************************** -*man MEDIA_IOC_ENUM_ENTITIES(2)* +NAME +==== -Enumerate entities and their properties +MEDIA_IOC_ENUM_ENTITIES - Enumerate entities and their properties - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct media_entity_desc *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To query the attributes of an entity, applications set the id field of a @@ -182,8 +183,7 @@ id's until they get an error. - - -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/mediactl/media-ioc-enum-links.rst b/Documentation/linux_tv/media/mediactl/media-ioc-enum-links.rst index 30dd7e2a7051f4fe10b9b813f291248fa8093900..88bf10b35ff0a6f2d9b9a6280df7a456c3095515 100644 --- a/Documentation/linux_tv/media/mediactl/media-ioc-enum-links.rst +++ b/Documentation/linux_tv/media/mediactl/media-ioc-enum-links.rst @@ -6,17 +6,18 @@ ioctl MEDIA_IOC_ENUM_LINKS ************************** -*man MEDIA_IOC_ENUM_LINKS(2)* +NAME +==== -Enumerate all pads and links for a given entity +MEDIA_IOC_ENUM_LINKS - Enumerate all pads and links for a given entity - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct media_links_enum *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To enumerate pads and/or links for a given entity, applications set the @@ -158,8 +159,7 @@ returned during the enumeration process. - Link flags, see :ref:`media-link-flag` for more details. - -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/mediactl/media-ioc-g-topology.rst b/Documentation/linux_tv/media/mediactl/media-ioc-g-topology.rst index 1c360bf7c9b0ab8f8b46ca76e2633286e82759a4..34d46010c9711f5d45f92e2ff659c5870ef16c77 100644 --- a/Documentation/linux_tv/media/mediactl/media-ioc-g-topology.rst +++ b/Documentation/linux_tv/media/mediactl/media-ioc-g-topology.rst @@ -6,17 +6,18 @@ ioctl MEDIA_IOC_G_TOPOLOGY ************************** -*man MEDIA_IOC_G_TOPOLOGY(2)* +NAME +==== -Enumerate the graph topology and graph element properties +MEDIA_IOC_G_TOPOLOGY - Enumerate the graph topology and graph element properties - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct media_v2_topology *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== The typical usage of this ioctl is to call it twice. On the first call, @@ -409,8 +410,7 @@ desired arrays with the media graph elements. this 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/mediactl/media-ioc-setup-link.rst b/Documentation/linux_tv/media/mediactl/media-ioc-setup-link.rst index 135fa782dcd25a69294317e4a6b5cf579584b756..f02edbcd3048e6bac58211396d6054115ac56cec 100644 --- a/Documentation/linux_tv/media/mediactl/media-ioc-setup-link.rst +++ b/Documentation/linux_tv/media/mediactl/media-ioc-setup-link.rst @@ -6,17 +6,18 @@ ioctl MEDIA_IOC_SETUP_LINK ************************** -*man MEDIA_IOC_SETUP_LINK(2)* +NAME +==== -Modify the properties of a link +MEDIA_IOC_SETUP_LINK - Modify the properties of a link - -Synopsis +SYNOPSIS ======== .. cpp:function:: int ioctl( int fd, int request, struct media_link_desc *argp ) -Arguments + +ARGUMENTS ========= ``fd`` @@ -28,7 +29,7 @@ Arguments ``argp`` -Description +DESCRIPTION =========== To change link properties applications fill a struct @@ -53,7 +54,7 @@ If the specified link can't be found the driver returns with an ``EINVAL`` error code. -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-close.rst b/Documentation/linux_tv/media/v4l/func-close.rst index fac5ec14a8e6f1a6e6f672cdc4ee82aefba278e2..81401cd26d1231b8c4ce2b456c59150dc92593ba 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() `. -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 fafec5f56a36596f3852da4a2d9d7b4fca4cbca9..91917e976dd0b4fa303a87652f1efa1c6502b300 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() ` 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 345ac3005c8f5004fce68db36978918353ded69a..01a45e2172655725643f3ba09564d4095b1f8981 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() ` function asks to map ``length`` bytes starting at @@ -105,7 +106,7 @@ before they can be queried. To unmap buffers the :ref:`munmap() ` function is used. -Return Value +RETURN VALUE ============ On success :ref:`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 f87eb387f499d008e8a39e11bc674f9575c2dc2f..a6e7a6def558fcdb7ca6009f85b603086b3232fe 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() ` function mapped buffer and frees it, if possible. -Return Value +RETURN VALUE ============ On success :ref:`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 705175be80e6c9467381ebb465c213d6ebe3c7c4..152174e6f646755b9652224d7c86ccc144a04e65 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() ` 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() ` 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 27f381d75de18c75a1d24b162f5adf8b7302dfc5..8632e05ff5b2ba8fe1df3a26f97bb7ac8af87924 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() ` function applications can suspend execution @@ -84,7 +90,7 @@ function. For more details see the :ref:`poll() ` manual page. -Return Value +RETURN VALUE ============ On success, :ref:`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 75985f664da7079e5b33b6ccfeb972decd4f433b..c4f0e8ab9e14c59d8952b98475f8a8095ad62998 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() ` 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 57089f5cc6cd9dadcf7e16c8433a0f20c3548352..34ade67d0f685ff23aeedc2e146a46db4107886a 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() ` function applications can suspend @@ -65,7 +71,7 @@ function. For more details see the :ref:`select() ` manual page. -Return Value +RETURN VALUE ============ On success, :ref:`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 a4b093ba15c37cf635806b1f33f229e14b88a9dc..6609f191af76244f7871eff2751efc4418be32fd 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() ` 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 5ba95ac0a5ce06b19cda0a6b8308d72674f96038..fe179197536d48f64f4718f0ca7574f1e1f9fde4 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 ` @@ -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 2e2a24f652a333c1b1ab911a06c24b44e52487ef..17ae3aa738b094e0adcf01ca150e70297b0259f4 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 7cc3bd42ccd47ffcfa07f5dac88672085fc6fcea..913c6d47d8210e67578538c5c754a0797d4d5910 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 f83a83b48cd6aa2089a7ce1536c4a5f4e035d234..185a011a117c33b7a391e809d98ae6dfd99ecd1d 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 c1d82336a60a96fbe1ed9ecc446981bdc88cf20a..bb6d9b8cf12234d6dc4b5b9f42b85a992232211a 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 4d813a90369399cfa5814e5e2d7da14e667e450a..850cb5ed00153de79e8d8a4966f232579e556729 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 475dbb75aef3510637ad49b5fd8a618af74fc7b1..61fef531363cdd48b62b4a6be611fc3e22cabeeb 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 78c014ded43b832fba2b4d2b224d3748208a0f84..1991014fd6b525a9de7c3008adacf63f1a9fb570 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 5aa2db9076a038c711e0e46a5ac9a53eb5b3b74c..41fa4313c1c29c199dfa854493ac7cd05195a69c 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 5cc97ce281ef4774906f2d9cd53d0ced013520f8..3b935b07837a4519a5672683af01c86020888fb1 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 29cf2fa5ba8786cd798d5eb34642ec8dc371d47a..3336a166b878a047e1214415cc9e241b01f97f7e 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 396cdcf44c7e2e20408143fd79b48fd49197612f..d01fffaeda04f20cb8c47612f3f80f57c959885e 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 da3bda140965f048e84281334c00432726222efb..7fdde4be282c7115c2af67115144580703b254cb 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 9573e54271fc3740d7481924f8254cc473eb1c43..f833e581f7c33910ea9f3bfada1c96827baf1374 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 ` for a description of struct :ref:`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 82ffb3194ed34c9298e44578bb24cde4b837b7f3..f2caf6c71f4463d659ed6a4447d6e3c1200320dd 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 ` for a description of struct :ref:`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 d27556c112bb63971e0ff79e631a01f7c850f359..01a1cadc71d2a69556f74ae400e3d08c3791c549 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 a0a9a375ef3f9203ef63811ee86c3f20cd4ebd04..99c70e54c4d6adbf316ad6fff68682261daaccbd 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 718b29510eebf877a2029a751d9eed93aa1812c5..e74514ea44375d8f531666d434953987b1189bfc 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 548b15a841c3d341779f927ea7e8947cb6cd9245..2c08a349ab454f7b7fd500bddcfa1c5c61ae1f38 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 ` 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 d0bdc2d36734797d50b024c0cd960b8eff5aecb5..02db00a317222d45bd32a2295fef93977049c284 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 7f13b6fbb73d6e5708c25773072c35497c991e01..9265be57d0f9c1e7eeca07fdc6616360c215db4b 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 a368636b305d6f9d2b645a5bdfd27f0df768c95e..206fdd5f825f44bafa91cbc3f26c34f24e0e6e21 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 ` ``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 db1e7b252147e3daf5887bf617432ab422be3c28..50fddb14028846a6b6832fc37eb5fae4782b70b3 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 8c72b2d461d33a748c276d914dedd7a15d9293e3..f6e7fd261ebcb1f2510ed407648b8fc7c1b23603 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 cbed4805f017e5aad115d77c51262262ee5fb757..1414026f5740564058e0ae61df1af91b31ffddc0 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 0ae21890dd616895863dbfb54695bf2678c11825..16f0e81359523fdd7d772218b66a6041baaca59b 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 ` 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 9a2cc1b98c4350e53915a71124e747fe6585dba5..2f69b1cf804bc6be4f3c79d593f0947a30e33dba 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 05a477f4925cba099ccfcc9e6517303488dcf1f6..4d07994144202edce9d9e0661996978832024bd8 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 ` and :ref:`VIDIOC_S_FBUF ` ioctl @@ -477,8 +477,7 @@ destructive video overlay. :ref:`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 4e56ff72ddcb7bc5e6038ba5c331ca8cc6f9432e..aede100b668b8ba0ef6fe4d4842ea9f5d62b7aa9 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 ` 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 e5c49033b5a139a9a8153d5a680b929d8788422b..2b921cda2e4db0f4befdaa8eada0c84af3665517 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 aae135ea2a77748a2ef71d94835e401556e6ed8d..e069ba3952ea59a5a1110edd05b29a99ea402283 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 cea36cf3af179cdb8bfacaf1e0ddf4895af54a65..c8d3a3b53a51c65f823c446c1bb2e006b665ec45 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 7fe25631968262cc99a6943ab95b079b4a17b0d4..21b9fea34b8c41d87b8aadfbf4327e094eb63b17 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 cd0646eb753959649e78003ee688d08951166ca3..c9fb075ec5d1ecf2700fc89028c0487377ddff37 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 7dbf1b5e918ec895e97981095a30c6261ddfce9c..964e3b8ce275e2798aca5e4dabc42b89d53d54b4 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() ` 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 1551f3139899a3950a134243703b294396a6dbec..8255f2469cd92e6f18a1f2a999f6d0179e98ebaa 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 609510a03cde8d8bee2efb9caf3e2e96f79b759f..c4164eaafca88d06468cb70deff6e23abe2ebcb9 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 39d29783682436f724439c32f5f7e319d7ba4160..466760241fdbc553d2855e5a59d38c4af64ca904 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 e1e3bb7fa726242173d7b46068c6ca6c629afb51..4fbc9e9bfeb8a3c7a11b6fd7a0a719098556768d 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 eee4acfcf3cf4cc462c5b83414c09f9511feb94f..fe904db57597a322e900197ac10f18636835cf29 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 afff82efe392e479eeb05224bbbd8f894b1c714e..d96d5e4f242a1b98c921e60e7860cd5ff00ac3a8 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 41ddeea5537f14845b00f2a9c050c43db81823ac..cd58a34a7ee8ea968e2ce721526eca10c7b099d6 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 ` 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 2c88d3cedecf978da21cf8f714c58cff2caa19a3..0f51082f8c93a67ec4b6f4d7ccf67184fc8cd3de 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 ` 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 88179f8019fadd1f61f59f4899a462e5bd25f001..bf41f30cf9c482765c9545fc3430245312478585 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 ` 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 6a37b6503399d337db6e6568f340e9466db1435c..38295fd5f1ad01441700df1377df2f54e475a222 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 2fae7021b511bcfc191c4d5b39882db8aa7946a6..6454c302644d156292919ef965f64784276b3ea1 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 ` I/O method. It can @@ -67,7 +68,7 @@ The :ref:`struct 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 0051c483a3232ef8f437f8a700f247a44386667c..406c5eb3403455b708129556c57044327f01a2b2 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 93e524c7e38d28d6964878e001ed46ecd4b3f3ce..4e0eb7b04fd26cd38d9304ee7e8b0f68b25aa56e 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 8d6769f2b5c65b75abff0991e40c73e22ea4fa9d..fe540f80ef608d15b0b1be8a7efd012332fa65fd 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 6803f21c8f4fa9ee8fbd716b0ea244fc9bd392e0..2e27708fd7a6379e4a9cab938ee1ca10ef03c297 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 `, @@ -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 efa5e930b3bb124c3303cc311e9aac178b390c3d..068a67e8a523296a81070dd807a7fb3dce0b996f 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 c3ea38c6cb5b0573e11288cc004b0c70e4149df1..0e6b750f871813c7302c1451cb1af5f8c521b706 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 d22926a6257b6361c57b1e8776dd3527e450b125..0d2b690cf8bcff02b5a5c9bafdcaebb7761c8fba 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 91738510b122ebff05578cf1da83a4fbbd381cab..c52a02df5b16667d0594416c8ad3e676521dab38 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 da0d0407346c3eba973277d866002f5e0bdb06ed..1ff173e502f760bebea7e13b20a65ab38bb1615d 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 eb13718a46546969705d2f8d63b1fb49314ef11d..94bffa78c486387c3210ec17df1afa6c151c26ba 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 9de901ad7cdd72740207a70311e7063adaeba09d..13615c0d03923fb0665fa7f6a5f6df2a0f52741c 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 947fbf0f9a232b74ed2bbb74c23c84f1b8aad900..05f5bfb3f1ca13f02236b90f5d68f8b0aca1308a 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 fa6dcccd0a2b571d814c092bc2099341e2f1a5c1..dd0dab7d7e427de9c38f9e944c770ffa48a22a7d 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 8beba56d62b95185ab7a14fdb3d8b4ccc9276fda..2ecce157f852c6efc3c4a61f4b5573343c85ea5e 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