@@ -470,6 +470,52 @@ in a way which would break what would normally be considered uAPI.
470470new ``netdevsim `` features must be accompanied by selftests under
471471``tools/testing/selftests/ ``.
472472
473+ Supported status for drivers
474+ ----------------------------
475+
476+ .. note: The following requirements apply only to Ethernet NIC drivers.
477+
478+ Netdev defines additional requirements for drivers which want to acquire
479+ the ``Supported `` status in the MAINTAINERS file. ``Supported `` drivers must
480+ be running all upstream driver tests and reporting the results twice a day.
481+ Drivers which do not comply with this requirement should use the ``Maintained ``
482+ status. There is currently no difference in how ``Supported `` and ``Maintained ``
483+ drivers are treated upstream.
484+
485+ The exact rules a driver must follow to acquire the ``Supported `` status:
486+
487+ 1. Must run all tests under ``drivers/net `` and ``drivers/net/hw `` targets
488+ of Linux selftests. Running and reporting private / internal tests is
489+ also welcome, but upstream tests are a must.
490+
491+ 2. The minimum run frequency is once every 12 hours. Must test the
492+ designated branch from the selected branch feed. Note that branches
493+ are auto-constructed and exposed to intentional malicious patch posting,
494+ so the test systems must be isolated.
495+
496+ 3. Drivers supporting multiple generations of devices must test at
497+ least one device from each generation. A testbed manifest (exact
498+ format TBD) should describe the device models tested.
499+
500+ 4. The tests must run reliably, if multiple branches are skipped or tests
501+ are failing due to execution environment problems the ``Supported ``
502+ status will be withdrawn.
503+
504+ 5. Test failures due to bugs either in the driver or the test itself,
505+ or lack of support for the feature the test is targgeting are
506+ *not * a basis for losing the ``Supported `` status.
507+
508+ netdev CI will maintain an official page of supported devices, listing their
509+ recent test results.
510+
511+ The driver maintainer may arrange for someone else to run the test,
512+ there is no requirement for the person listed as maintainer (or their
513+ employer) to be responsible for running the tests. Collaboration between
514+ vendors, hosting GH CI, other repos under linux-netdev, etc. is most welcome.
515+
516+ See https://github.com/linux-netdev/nipa/wiki for more information about
517+ netdev CI. Feel free to reach out to maintainers or the list with any questions.
518+
473519Reviewer guidance
474520-----------------
475521
0 commit comments