CNA-VGAP-004: The Linux evdev controller-mapping reader is tested only on hand-written entries in CI; the real-database test always skips
Evidence basis: source-verified at the pinned commit; tests exist (not executed for this page). Claims on this page were checked by reading the CNA source at commit 009d40f5; unless a sentence says otherwise, nothing here was built or executed. Nothing on this page was executed unless the Evidence section says so.
LinuxEvdevMapping.EveryEntryOfADatabaseFileIsRead skips unless CNA_TEST_GAMECONTROLLERDB names a file, no workflow sets it, and mapped-pad behaviour with physical generic HID pads has no recorded evidence.
- Identifier
CNA-VGAP-004- Category
- Verification gap
- Subsystem
- Input
- Status
- Open
- Verified against
- CNA
009d40f5(009d40f5dd085c4e674d3479675fac84b12b3e0a) - Evidence basis
- Source-verified: read at TARGET, not executed
- Tests touching this area
- Yes: see Current tests
- Affected contract
- CNA_GAMECONTROLLERCONFIG_FILE / CNA_GAMECONTROLLERCONFIG on the X11 and Wayland evdev gamepad hub
Expected behaviour
The community gamecontrollerdb format the backend accepts is exercised against a real database in CI.
Actual behaviour at TARGET
LinuxEvdevMappingTests.cpp reads CNA_TEST_GAMECONTROLLERDB and calls GTEST_SKIP when it is unset; no workflow sets it. EvdevMapping.cpp (ControllerMappingDatabase::FromEnvironment) is otherwise exercised on hand-written entries.
Source locations
modules/platform/tests/CNA/Platform/LinuxEvdevMappingTests.cpp— EveryEntryOfADatabaseFileIsRead and its skipmodules/platform/src/Linux/EvdevMapping.cpp— ControllerMappingDatabase::FromEnvironment
Evidence
Checked by reading at 009d40f5; not executed.
Focused reproduction
No focused reproduction is known. Nothing has been invented here; the evidence above is what exists.
Current tests
Hand-written mapping entries; the real-database test skips in CI.
Regression test
Vendor or download a pinned gamecontrollerdb.txt in CI and set CNA_TEST_GAMECONTROLLERDB.
Blast radius
Generic HID pads on the native X11 and Wayland platforms.
Workaround
No workaround is known.
Related pages
The same subject is explained at several altitudes. These are the neighbouring pages at each one.
- User guide
- Input: gamepad
- Deep dives
- Gamepads: evdev controller mappings
- Known issues
- Verification gap index