Linux 4.11-rc6
[linux/fpc-iii.git] / Documentation / media / uapi / rc / lirc-set-send-duty-cycle.rst
blob20d07c2a37a58882b71eb69dc292e1249c5f666e
1 .. -*- coding: utf-8; mode: rst -*-
3 .. _lirc_set_send_duty_cycle:
5 ******************************
6 ioctl LIRC_SET_SEND_DUTY_CYCLE
7 ******************************
9 Name
10 ====
12 LIRC_SET_SEND_DUTY_CYCLE - Set the duty cycle of the carrier signal for
13 IR transmit.
15 Synopsis
16 ========
18 .. c:function:: int ioctl( int fd, LIRC_SET_SEND_DUTY_CYCLE, __u32 *duty_cycle)
19     :name: LIRC_SET_SEND_DUTY_CYCLE
21 Arguments
22 =========
24 ``fd``
25     File descriptor returned by open().
27 ``duty_cycle``
28     Duty cicle, describing the pulse width in percent (from 1 to 99) of
29     the total cycle. Values 0 and 100 are reserved.
32 Description
33 ===========
35 Get/set the duty cycle of the carrier signal for IR transmit.
37 Currently, no special meaning is defined for 0 or 100, but this
38 could be used to switch off carrier generation in the future, so
39 these values should be reserved.
42 Return Value
43 ============
45 On success 0 is returned, on error -1 and the ``errno`` variable is set
46 appropriately. The generic error codes are described at the
47 :ref:`Generic Error Codes <gen-errors>` chapter.