OS Manuals

/usr/bin/cec-compliance

Linux media (V4L2/DVB/CEC/IR) utilities and libraries

From v4l-utils 1.32.0-r1 (enterprise-packages), captured 2026-11-08 by running cec-compliance --help (exit 0). permalink

Usage:
  -d, --device <dev>   Use device <dev> instead of /dev/cec0
                       If <dev> starts with a digit, then /dev/cec<dev> is used.
  -D, --driver <driver>    Use a cec device with this driver name
  -a, --adapter <adapter>  Use a cec device with this adapter name
  -r, --remote [<la>]  As initiator test the remote logical address or all LAs if no LA was given
  -R, --reply-threshold <timeout>
                       Warn if replies take longer than this threshold (default 1000ms)
  -i, --interactive    Interactive mode when doing remote tests
  -t, --timeout <secs> Set the standby/resume timeout to <secs>. Default is 60s.

  -A, --test-adapter                  Test the CEC adapter API
  -F, --test-fuzzing                  Test by fuzzing CEC messages
  --test-core                         Test the core functionality

By changing --test to --skip-test in the following options you can skip tests
instead of enabling them.

  --test-audio-rate-control           Test the Audio Rate Control feature
  --test-audio-return-channel-control Test the Audio Return Channel Control feature
  --test-capability-discovery-and-control Test the Capability Discovery and Control feature
  --test-deck-control                 Test the Deck Control feature
  --test-device-menu-control          Test the Device Menu Control feature
  --test-device-osd-transfer          Test the Device OSD Transfer feature
  --test-dynamic-auto-lipsync         Test the Dynamic Auto Lipsync feature
  --test-osd-display                  Test the OSD Display feature
  --test-one-touch-play               Test the One Touch Play feature
  --test-one-touch-record             Test the One Touch Record feature
  --test-power-status                 Test the Power Status feature
  --test-remote-control-passthrough   Test the Remote Control Passthrough feature
  --test-routing-control              Test the Routing Control feature
  --test-system-audio-control         Test the System Audio Control feature
  --test-system-information           Test the System Information feature
  --test-timer-programming            Test the Timer Programming feature
  --test-tuner-control                Test the Tuner Control feature
  --test-vendor-specific-commands     Test the Vendor Specific Commands feature
  --test-standby-resume               Test standby and resume functionality. This will activate
                                      testing of Standby, Give Device Power Status and One Touch Play.

  -E, --exit-on-fail Exit on the first fail.
  -l, --list-tests   List all tests.
  -e, --expect <test>=<result>
                     Fail if the test gave a different result.
  -n, --expect-with-no-warnings <test>=<result>
                     Fail if the test gave a different result or if the test generated warnings.
  -h, --help         Display this help message
  -C, --color <when> Highlight OK/warn/fail/FAIL strings with colors
                     <when> can be set to always, never, or auto (the default)
  -N, --no-warnings  Turn off warning messages
  -s, --skip-info    Skip Driver Info output
  -T, --trace        Trace all called ioctls
  -v, --verbose      Turn on verbose reporting
  --version          Show version information
  -w, --wall-clock   Show timestamps as wall-clock time
  -S, --show-timestamp Show timestamp of the start of each test
  -W, --exit-on-warn Exit on the first warning.
Options (44)
OptionDescriptionSource
-d, --device devUse device <dev> instead of /dev/cec0 If <dev> starts with a digit, then /dev/cec<dev> is used.help + man
-D, --driver driverUse a cec device that has driver name <drv>, as returned by the CEC_ADAP_G_CAPS ioctl.help + man
-a, --adapter adapterUse a cec device that has adapter name <adap-name>, as returned by the CEC_ADAP_G_CAPS ioctl.help + man
-r, --remote laAs initiator test the remote logical address <la> or all LAs if no LA was given.help + man
-R, --reply-threshold timeoutWarn if replies take longer than this threshold (default 1000ms).help + man
-i, --interactiveInteractive mode when doing remote tests.help + man
-A, --test-adapterTest the CEC adapter APIhelp + man
-F, --test-fuzzingTest the remote CEC adapter by randomly creating CEC messages.help + man
--test-coreTest the core functionalityhelp + man
--test-audio-rate-controlTest the Audio Rate Control featurehelp + man
--test-deck-controlTest the Deck Control featurehelp + man
--test-device-menu-controlTest the Device Menu Control featurehelp + man
--test-device-osd-transferTest the Device OSD Transfer featurehelp + man
--test-dynamic-auto-lipsyncTest the Dynamic Auto Lipsync featurehelp
--test-osd-displayTest the OSD Display featurehelp + man
--test-one-touch-playTest the One Touch Play featurehelp + man
--test-one-touch-recordTest the One Touch Record featurehelp + man
--test-power-statusTest the Power Status featurehelp + man
--test-remote-control-passthroughTest the Remote Control Passthrough featurehelp + man
--test-routing-controlTest the Routing Control featurehelp + man
--test-system-audio-controlTest the System Audio Control featurehelp + man
--test-system-informationTest the System Information featurehelp + man
--test-timer-programmingTest the Timer Programming featurehelp + man
--test-tuner-controlTest the Tuner Control featurehelp + man
--test-vendor-specific-commandsTest the Vendor Specific Commands featurehelp + man
--test-standby-resumeTest standby and resume functionality.help + man
-l, --list-testsList all tests and the possible test results.help + man
-e, --expect test>=<resultFail if the test gave a different result.help + man
-n, --expect-with-no-warnings test>=<resultFail if the test gave a different result or if the test generated warnings.help
-h, --helpDisplay this help messagehelp + man
-N, --no-warningsTurn off warning messages.help + man
-s, --skip-infoSkip the Driver Info output section.help + man
-T, --traceTrace all called ioctls.help + man
-v, --verboseTurn on verbose reporting.help + man
--versionShow version information.help + man
-w, --wall-clockShow timestamps as wall-clock time.help + man
-E, --exit-on-failExit this application when the first failure occurs instead of continuing with a possible inconsistent state. (in the manual page but not in --help)man
-S, --show-timestampFor each test, show the timestamp of when the test started. (in the manual page but not in --help)man
-W, --exit-on-warnExit this application when the first warning occurs instead of continuing. (in the manual page but not in --help)man
-C, --color whenHighlight OK/warn/fail/FAIL strings with colors. (in the manual page but not in --help)man
-t, --timeout secsSet the standby/resume timeout to the given number of seconds. (in the manual page but not in --help)man
--test-audio-return-channel-controlTest the Audio Return Channel Control feature (in the manual page but not in --help)man
--test-capability-discovery-and-controlTest the Capability Discovery and Control feature (in the manual page but not in --help)man
--test-dynamic-audio-lipsyncTest the Dynamic Audio Lipsync feature (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.