git.oblomov.eu Git - linux-2.6/blob - Documentation/networking/multiqueue.txt

   1
   2                 HOWTO for multiqueue network device support
   3                 ===========================================
   4
   5 Section 1: Base driver requirements for implementing multiqueue support
   6
   7 Intro: Kernel support for multiqueue devices
   8 ---------------------------------------------------------
   9
  10 Kernel support for multiqueue devices is always present.
  11
  12 Section 1: Base driver requirements for implementing multiqueue support
  13 -----------------------------------------------------------------------
  14
  15 Base drivers are required to use the new alloc_etherdev_mq() or
  16 alloc_netdev_mq() functions to allocate the subqueues for the device.  The
  17 underlying kernel API will take care of the allocation and deallocation of
  18 the subqueue memory, as well as netdev configuration of where the queues
  19 exist in memory.
  20
  21 The base driver will also need to manage the queues as it does the global
  22 netdev->queue_lock today.  Therefore base drivers should use the
  23 netif_{start|stop|wake}_subqueue() functions to manage each queue while the
  24 device is still operational.  netdev->queue_lock is still used when the device
  25 comes online or when it's completely shut down (unregister_netdev(), etc.).
  26
  27 Author: Peter P. Waskiewicz Jr. <peter.p.waskiewicz.jr@intel.com>