mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-10-02 07:04:24 +00:00
54f38fcae5
Since 2017, there is an space reserved for userspace API,
created by changeset 1d596dee38 ("docs: Create a user-space API guide").
As the media subsystem was one of the first subsystems to use
Sphinx, until this patch, we were keeping things on a separate
place.
Let's just use the new location, as having all uAPI altogether
will likely make things easier for developers.
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
40 lines
1.4 KiB
Text
40 lines
1.4 KiB
Text
What: /sys/kernel/debug/cec/*/error-inj
|
|
Date: March 2018
|
|
Contact: Hans Verkuil <hverkuil-cisco@xs4all.nl>
|
|
Description:
|
|
|
|
The CEC Framework allows for CEC error injection commands through
|
|
debugfs. Drivers that support this will create an error-inj file
|
|
through which the error injection commands can be given.
|
|
|
|
The basic syntax is as follows:
|
|
|
|
Leading spaces/tabs are ignored. If the next character is a '#' or the
|
|
end of the line was reached, then the whole line is ignored. Otherwise
|
|
a command is expected.
|
|
|
|
It is up to the driver to decide what commands to implement. The only
|
|
exception is that the command 'clear' without any arguments must be
|
|
implemented and that it will remove all current error injection
|
|
commands.
|
|
|
|
This ensures that you can always do 'echo clear >error-inj' to clear any
|
|
error injections without having to know the details of the driver-specific
|
|
commands.
|
|
|
|
Note that the output of 'error-inj' shall be valid as input to 'error-inj'.
|
|
So this must work:
|
|
|
|
$ cat error-inj >einj.txt
|
|
$ cat einj.txt >error-inj
|
|
|
|
Other than these basic rules described above this ABI is not considered
|
|
stable and may change in the future.
|
|
|
|
Drivers that implement this functionality must document the commands as
|
|
part of the CEC documentation and must keep that documentation up to date
|
|
when changes are made.
|
|
|
|
The following CEC error injection implementations exist:
|
|
|
|
- Documentation/userspace-api/media/cec/cec-pin-error-inj.rst
|