diff options
author | Mauro Carvalho Chehab <mchehab@s-opensource.com> | 2016-07-11 11:36:29 (GMT) |
---|---|---|
committer | Mauro Carvalho Chehab <mchehab@s-opensource.com> | 2016-07-12 12:29:31 (GMT) |
commit | 76e23479f9b772f1419df691c30e2f5e4ac92cb0 (patch) | |
tree | 3a696a98d420184e44cb33cfb5d39b414ab4f5ea | |
parent | 978084b1939f5561a2e43cb49247485503ef4706 (diff) | |
download | linux-76e23479f9b772f1419df691c30e2f5e4ac92cb0.tar.xz |
[media] doc-rst: document LIRC_GET_*_TIMEOUT ioctls
Improve the documentation for those ioctls, adding them to
a separate file, in order to look like the rest of the
book, and to later allow to generate a man page for those
ioctls.
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
-rw-r--r-- | Documentation/media/uapi/rc/lirc-get-timeout.rst | 55 | ||||
-rw-r--r-- | Documentation/media/uapi/rc/lirc_device_interface.rst | 1 | ||||
-rw-r--r-- | Documentation/media/uapi/rc/lirc_ioctl.rst | 13 |
3 files changed, 56 insertions, 13 deletions
diff --git a/Documentation/media/uapi/rc/lirc-get-timeout.rst b/Documentation/media/uapi/rc/lirc-get-timeout.rst new file mode 100644 index 0000000..6b8238f --- /dev/null +++ b/Documentation/media/uapi/rc/lirc-get-timeout.rst @@ -0,0 +1,55 @@ +.. -*- coding: utf-8; mode: rst -*- + +.. _lirc_get_min_timeout: +.. _lirc_get_max_timeout: + +**************************************************** +ioctls LIRC_GET_MIN_TIMEOUT and LIRC_GET_MAX_TIMEOUT +**************************************************** + +Name +==== + +LIRC_GET_MIN_TIMEOUT / LIRC_GET_MAX_TIMEOUT - Obtain the possible timeout +range for IR receive. + +Synopsis +======== + +.. cpp:function:: int ioctl( int fd, int request, __u32 *timeout) + +Arguments +========= + +``fd`` + File descriptor returned by open(). + +``request`` + LIRC_GET_MIN_TIMEOUT or LIRC_GET_MAX_TIMEOUT + +``timeout`` + Timeout, in microseconds. + + +Description +=========== + +Some devices have internal timers that can be used to detect when +there's no IR activity for a long time. This can help lircd in +detecting that a IR signal is finished and can speed up the decoding +process. Returns an integer value with the minimum/maximum timeout +that can be set. + +.. note:: + + Some devices have a fixed timeout, in that case + both ioctls will return the same value even though the timeout + cannot be changed via :ref:`LIRC_SET_REC_TIMEOUT`. + + +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 <gen-errors>` chapter. diff --git a/Documentation/media/uapi/rc/lirc_device_interface.rst b/Documentation/media/uapi/rc/lirc_device_interface.rst index 56f2d61..197173f 100644 --- a/Documentation/media/uapi/rc/lirc_device_interface.rst +++ b/Documentation/media/uapi/rc/lirc_device_interface.rst @@ -17,4 +17,5 @@ LIRC Device Interface lirc-get-rec-mode lirc-get-rec-resolution lirc-set-send-duty-cycle + lirc-get-timeout lirc_ioctl diff --git a/Documentation/media/uapi/rc/lirc_ioctl.rst b/Documentation/media/uapi/rc/lirc_ioctl.rst index c486703..0a16659 100644 --- a/Documentation/media/uapi/rc/lirc_ioctl.rst +++ b/Documentation/media/uapi/rc/lirc_ioctl.rst @@ -49,19 +49,6 @@ device can rely on working with the default settings initially. I/O control requests ==================== -.. _LIRC_GET_MIN_TIMEOUT: -.. _LIRC_GET_MAX_TIMEOUT: - -``LIRC_GET_M{IN,AX}_TIMEOUT`` - - Some devices have internal timers that can be used to detect when - there's no IR activity for a long time. This can help lircd in - detecting that a IR signal is finished and can speed up the decoding - process. Returns an integer value with the minimum/maximum timeout - that can be set. Some devices have a fixed timeout, in that case - both ioctls will return the same value even though the timeout - cannot be changed. - .. _LIRC_GET_LENGTH: ``LIRC_GET_LENGTH`` |