1
linux/Documentation/DocBook
Stephen Hemminger bea3348eef [NET]: Make NAPI polling independent of struct net_device objects.
Several devices have multiple independant RX queues per net
device, and some have a single interrupt doorbell for several
queues.

In either case, it's easier to support layouts like that if the
structure representing the poll is independant from the net
device itself.

The signature of the ->poll() call back goes from:

	int foo_poll(struct net_device *dev, int *budget)

to

	int foo_poll(struct napi_struct *napi, int budget)

The caller is returned the number of RX packets processed (or
the number of "NAPI credits" consumed if you want to get
abstract).  The callee no longer messes around bumping
dev->quota, *budget, etc. because that is all handled in the
caller upon return.

The napi_struct is to be embedded in the device driver private data
structures.

Furthermore, it is the driver's responsibility to disable all NAPI
instances in it's ->stop() device close handler.  Since the
napi_struct is privatized into the driver's private data structures,
only the driver knows how to get at all of the napi_struct instances
it may have per-device.

With lots of help and suggestions from Rusty Russell, Roland Dreier,
Michael Chan, Jeff Garzik, and Jamal Hadi Salim.

Bug fixes from Thomas Graf, Roland Dreier, Peter Zijlstra,
Joseph Fannin, Scott Wood, Hans J. Koch, and Michael Chan.

[ Ported to current tree and all drivers converted.  Integrated
  Stephen's follow-on kerneldoc additions, and restored poll_list
  handling to the old style to fix mutual exclusion issues.  -DaveM ]

Signed-off-by: Stephen Hemminger <shemminger@linux-foundation.org>
Signed-off-by: David S. Miller <davem@davemloft.net>
2007-10-10 16:47:45 -07:00
..
.gitignore
deviceiobook.tmpl PCI: Document pci_iomap() 2007-08-22 14:48:40 -07:00
filesystems.tmpl
gadget.tmpl
genericirq.tmpl
kernel-api.tmpl [NET]: Make NAPI polling independent of struct net_device objects. 2007-10-10 16:47:45 -07:00
kernel-hacking.tmpl
kernel-locking.tmpl DocBook: Change a headline in kernel-locking to list all three main types of locking. 2007-07-22 11:49:53 -07:00
libata.tmpl [SCSI] libsas: fix scr_read/write users and update the libata documentation 2007-07-20 15:52:08 -05:00
librs.tmpl
lsm.tmpl
Makefile kernel-doc: add tools doc in Makefile 2007-07-19 10:04:45 -07:00
mcabook.tmpl
mtdnand.tmpl
procfs_example.c
procfs-guide.tmpl
rapidio.tmpl
stylesheet.xsl
uio-howto.tmpl remove dubious legal statment from uio-howto 2007-08-09 08:40:21 -07:00
usb.tmpl
videobook.tmpl
wanbook.tmpl
writing_usb_driver.tmpl
z8530book.tmpl