网络设备之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 (((1 << debug) - 1) & NETIF_MSG_DRV) {
        pr_info("%s, %s
", DRV_DESCRIPTION, DRV_VERSION);
        pr_info("%s
", 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);