On 22/03/2023 07:38, Jakub Kicinski wrote: > Add basic documentation about NAPI. We can stop linking to the ancient > doc on the LF wiki. > > Signed-off-by: Jakub Kicinski <kuba@xxxxxxxxxx> > Link: https://lore.kernel.org/all/20230315223044.471002-1-kuba@xxxxxxxxxx/ > Reviewed-by: Bagas Sanjaya <bagasdotme@xxxxxxxxx> > Reviewed-by: Toke Høiland-Jørgensen <toke@xxxxxxxxxx> > Acked-by: Pavel Pisa <pisa@xxxxxxxxxxxxxxxx> # for ctucanfd-driver.rst > Reviewed-by: Tony Nguyen <anthony.l.nguyen@xxxxxxxxx> > Reviewed-by: Florian Fainelli <f.fainelli@xxxxxxxxx> > --- > v3: rebase on net-next (to avoid ixgb conflict) > fold in grammar fixes from Stephen > v2: https://lore.kernel.org/all/20230321050334.1036870-1-kuba@xxxxxxxxxx/ > remove the links in CAN and in ICE as well > improve the start of the threaded NAPI section > name footnote > internal links from the intro to sections > various clarifications from Florian and Stephen > > CC: corbet@xxxxxxx > CC: jesse.brandeburg@xxxxxxxxx > CC: anthony.l.nguyen@xxxxxxxxx > CC: pisa@xxxxxxxxxxxxxxxx > CC: mkl@xxxxxxxxxxxxxx > CC: linux-doc@xxxxxxxxxxxxxxx > CC: f.fainelli@xxxxxxxxx > CC: stephen@xxxxxxxxxxxxxxxxxx > CC: romieu@xxxxxxxxxxxxx > --- > .../can/ctu/ctucanfd-driver.rst | 3 +- > .../device_drivers/ethernet/intel/e100.rst | 3 +- > .../device_drivers/ethernet/intel/i40e.rst | 4 +- > .../device_drivers/ethernet/intel/ice.rst | 4 +- > Documentation/networking/index.rst | 1 + > Documentation/networking/napi.rst | 251 ++++++++++++++++++ > include/linux/netdevice.h | 13 +- > 7 files changed, 266 insertions(+), 13 deletions(-) > create mode 100644 Documentation/networking/napi.rst > [snip] > +Threaded NAPI > +------------- > + > +Threaded NAPI is an operating mode that uses dedicated kernel > +threads rather than software IRQ context for NAPI processing. > +The configuration is per netdevice and will affect all > +NAPI instances of that device. Each NAPI instance will spawn a separate > +thread (called ``napi/${ifc-name}-${napi-id}``). > + > +It is recommended to pin each kernel thread to a single CPU, the same > +CPU as services the interrupt. Note that the mapping between IRQs and "... the same CPU as services the interrupt ...", should it be "the same CPU that services the interrupt" ? > +NAPI instances may not be trivial (and is driver dependent). > +The NAPI instance IDs will be assigned in the opposite order > +than the process IDs of the kernel threads. > + > +Threaded NAPI is controlled by writing 0/1 to the ``threaded`` file in > +netdev's sysfs directory. > + > +.. rubric:: Footnotes > + > +.. [#] NAPI was originally referred to as New API in 2.4 Linux. Very nice! Other than the above looks good to me. Cheers, Nik
