网络设备之pci_driver

每个pci驱动都有一个pci_driver实例，用以描述驱动名称，支持的设备信息，以及对应的操作函数；

 /*
     描述一个pci设备，每个pci驱动必须创建一个pci_driver实例
 */
 struct pci_driver {
     struct list_head node;
     /* 驱动程序名，内核中所有pci驱动程序名都是唯一的 */
     const char *name;
     /* pci设备配置信息数组 */
     const struct pci_device_id *id_table;    /* must be non-NULL for probe to be called */
     /* 设备插入内核时调用 */
     int  (*probe)  (struct pci_dev *dev, const struct pci_device_id *id);    /* New device inserted */
     /* 设备从内核移除时调用 */
     void (*remove) (struct pci_dev *dev);    /* Device removed (NULL if not a hot-plug capable driver) */
     /* 设备被挂起时调用 */
     int  (*suspend) (struct pci_dev *dev, pm_message_t state);    /* Device suspended */
     int  (*suspend_late) (struct pci_dev *dev, pm_message_t state);
     int  (*resume_early) (struct pci_dev *dev);
     /* 设备被恢复时调用 */
     int  (*resume) (struct pci_dev *dev);                    /* Device woken up */
     /* 设备关闭时调用 */
     void (*shutdown) (struct pci_dev *dev);
     int (*sriov_configure) (struct pci_dev *dev, int num_vfs); /* PF pdev */
     /* 错误处理 */
     const struct pci_error_handlers *err_handler;
     struct device_driver    driver;
     struct pci_dynids dynids;
 };

以e100为例，在驱动初始化过程中，会调用pci_register_driver来注册pci_driver实例；

 static const struct pci_error_handlers e100_err_handler = {
     .error_detected = e100_io_error_detected,
     .slot_reset = e100_io_slot_reset,
     .resume = e100_io_resume,
 };

 static struct pci_driver e100_driver = {
     .name =         DRV_NAME,
     .id_table =     e100_id_table,
     .probe =        e100_probe,
     .remove =       e100_remove,
 #ifdef CONFIG_PM
     /* Power Management hooks */
     .suspend =      e100_suspend,
     .resume =       e100_resume,
 #endif
     .shutdown =     e100_shutdown,
     .err_handler = &e100_err_handler,
 };

 static int __init e100_init_module(void)
 {
     if ((( << debug) - ) & NETIF_MSG_DRV) {
         pr_info("%s, %s\n", DRV_DESCRIPTION, DRV_VERSION);
         pr_info("%s\n", DRV_COPYRIGHT);
     }
     return pci_register_driver(&e100_driver);
 }

 static void __exit e100_cleanup_module(void)
 {
     pci_unregister_driver(&e100_driver);
 }

 module_init(e100_init_module);
 module_exit(e100_cleanup_module);