1 What: /sys/kernel/debug/cec/*/error- 1 What: /sys/kernel/debug/cec/*/error-inj
2 Date: March 2018 2 Date: March 2018
3 Contact: Hans Verkuil <hverkuil-cisco@xs 3 Contact: Hans Verkuil <hverkuil-cisco@xs4all.nl>
4 Description: 4 Description:
5 5
6 The CEC Framework allows for CEC error injecti 6 The CEC Framework allows for CEC error injection commands through
7 debugfs. Drivers that support this will create 7 debugfs. Drivers that support this will create an error-inj file
8 through which the error injection commands can 8 through which the error injection commands can be given.
9 9
10 The basic syntax is as follows: 10 The basic syntax is as follows:
11 11
12 Leading spaces/tabs are ignored. If the next c 12 Leading spaces/tabs are ignored. If the next character is a '#' or the
13 end of the line was reached, then the whole li 13 end of the line was reached, then the whole line is ignored. Otherwise
14 a command is expected. 14 a command is expected.
15 15
16 It is up to the driver to decide what commands 16 It is up to the driver to decide what commands to implement. The only
17 exception is that the command 'clear' without 17 exception is that the command 'clear' without any arguments must be
18 implemented and that it will remove all curren 18 implemented and that it will remove all current error injection
19 commands. 19 commands.
20 20
21 This ensures that you can always do 'echo clea 21 This ensures that you can always do 'echo clear >error-inj' to clear any
22 error injections without having to know the de 22 error injections without having to know the details of the driver-specific
23 commands. 23 commands.
24 24
25 Note that the output of 'error-inj' shall be v 25 Note that the output of 'error-inj' shall be valid as input to 'error-inj'.
26 So this must work:: 26 So this must work::
27 27
28 $ cat error-inj >einj.txt 28 $ cat error-inj >einj.txt
29 $ cat einj.txt >error-inj 29 $ cat einj.txt >error-inj
30 30
31 Other than these basic rules described above t 31 Other than these basic rules described above this ABI is not considered
32 stable and may change in the future. 32 stable and may change in the future.
33 33
34 Drivers that implement this functionality must 34 Drivers that implement this functionality must document the commands as
35 part of the CEC documentation and must keep th 35 part of the CEC documentation and must keep that documentation up to date
36 when changes are made. 36 when changes are made.
37 37
38 The following CEC error injection implementati 38 The following CEC error injection implementations exist:
39 39
40 - Documentation/userspace-api/media/cec/cec-pi 40 - Documentation/userspace-api/media/cec/cec-pin-error-inj.rst
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.