1.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later 2.. c:namespace:: RC 3 4.. _lirc_set_transmitter_mask: 5 6******************************* 7ioctl LIRC_SET_TRANSMITTER_MASK 8******************************* 9 10Name 11==== 12 13LIRC_SET_TRANSMITTER_MASK - Enables send codes on a given set of transmitters 14 15Synopsis 16======== 17 18.. c:macro:: LIRC_SET_TRANSMITTER_MASK 19 20``int ioctl(int fd, LIRC_SET_TRANSMITTER_MASK, __u32 *mask)`` 21 22Arguments 23========= 24 25``fd`` 26 File descriptor returned by open(). 27 28``mask`` 29 Mask with channels to enable tx. Channel 0 is the least significant bit. 30 31Description 32=========== 33 34Some IR TX devices have multiple output channels, in such case, 35:ref:`LIRC_CAN_SET_TRANSMITTER_MASK <LIRC-CAN-SET-TRANSMITTER-MASK>` is 36returned via :ref:`LIRC_GET_FEATURES` and this ioctl sets what channels will 37send IR codes. 38 39This ioctl enables the given set of transmitters. The first transmitter is 40encoded by the least significant bit and so on. 41 42When an invalid bit mask is given, i.e. a bit is set, even though the device 43does not have so many transitters, then this ioctl returns the number of 44available transitters and does nothing otherwise. 45 46Return Value 47============ 48 49On success 0 is returned, on error -1 and the ``errno`` variable is set 50appropriately. The generic error codes are described at the 51:ref:`Generic Error Codes <gen-errors>` chapter. 52