Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

media: cec-ioc-receive.rst: document CEC_MSG_FL_RAW

Document this new cec_msg flag.

Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>

authored by

Hans Verkuil and committed by
Mauro Carvalho Chehab
eabe3bc2 aa50accf

+14 -1
+14 -1
Documentation/media/uapi/cec/cec-ioc-receive.rst
··· 223 223 result of the :ref:`ioctl CEC_TRANSMIT <CEC_TRANSMIT>`, and once via 224 224 :ref:`ioctl CEC_RECEIVE <CEC_RECEIVE>`. 225 225 226 + * .. _`CEC-MSG-FL-RAW`: 227 + 228 + - ``CEC_MSG_FL_RAW`` 229 + - 2 230 + - Normally CEC messages are validated before transmitting them. If this 231 + flag is set when :ref:`ioctl CEC_TRANSMIT <CEC_TRANSMIT>` is called, 232 + then no validation takes place and the message is transmitted as-is. 233 + This is useful when debugging CEC issues. 234 + This flag is only allowed if the process has the ``CAP_SYS_RAWIO`` 235 + capability. If that is not set, then the ``EPERM`` error code is 236 + returned. 237 + 226 238 227 239 .. tabularcolumns:: |p{5.6cm}|p{0.9cm}|p{11.0cm}| 228 240 ··· 370 358 371 359 EPERM 372 360 The CEC adapter is not configured, i.e. :ref:`ioctl CEC_ADAP_S_LOG_ADDRS <CEC_ADAP_S_LOG_ADDRS>` 373 - has never been called. 361 + has never been called, or ``CEC_MSG_FL_RAW`` was used from a process that 362 + did not have the ``CAP_SYS_RAWIO`` capability. 374 363 375 364 ENONET 376 365 The CEC adapter is not configured, i.e. :ref:`ioctl CEC_ADAP_S_LOG_ADDRS <CEC_ADAP_S_LOG_ADDRS>`