0001 What: /sys/kernel/debug/cec/*/error-inj
0002 Date: March 2018
0003 Contact: Hans Verkuil <hverkuil-cisco@xs4all.nl>
0004 Description:
0005
0006 The CEC Framework allows for CEC error injection commands through
0007 debugfs. Drivers that support this will create an error-inj file
0008 through which the error injection commands can be given.
0009
0010 The basic syntax is as follows:
0011
0012 Leading spaces/tabs are ignored. If the next character is a '#' or the
0013 end of the line was reached, then the whole line is ignored. Otherwise
0014 a command is expected.
0015
0016 It is up to the driver to decide what commands to implement. The only
0017 exception is that the command 'clear' without any arguments must be
0018 implemented and that it will remove all current error injection
0019 commands.
0020
0021 This ensures that you can always do 'echo clear >error-inj' to clear any
0022 error injections without having to know the details of the driver-specific
0023 commands.
0024
0025 Note that the output of 'error-inj' shall be valid as input to 'error-inj'.
0026 So this must work::
0027
0028 $ cat error-inj >einj.txt
0029 $ cat einj.txt >error-inj
0030
0031 Other than these basic rules described above this ABI is not considered
0032 stable and may change in the future.
0033
0034 Drivers that implement this functionality must document the commands as
0035 part of the CEC documentation and must keep that documentation up to date
0036 when changes are made.
0037
0038 The following CEC error injection implementations exist:
0039
0040 - Documentation/userspace-api/media/cec/cec-pin-error-inj.rst
