Skip to content

Commit 7d9df2b

Browse files
committed
tgupdate: merge t/DO-NOT-MERGE-mptcp-enabled-by-default into t/upstream base
2 parents c61194a + 3bf7cd5 commit 7d9df2b

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

92 files changed

+1253
-556
lines changed

Documentation/process/maintainer-netdev.rst

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -470,6 +470,52 @@ in a way which would break what would normally be considered uAPI.
470470
new ``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+
473519
Reviewer guidance
474520
-----------------
475521

0 commit comments

Comments
 (0)