pci_register_driver

最新推荐文章于 2025-09-29 16:11:24 发布

原创

最新推荐文章于 2025-09-29 16:11:24 发布 · 4.1k 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#linux #kernel #pci_register_driver

本文详细介绍了Linux内核中的pci_register_driver函数，用于注册PCI驱动。内容包括函数的作用、语法、参数说明，并通过分析Hamachi.c驱动程序的probe函数，揭示了在注册过程中内核如何调用驱动的细节。

pci_register_driver

Name
pci_register_driver -- register a new pci driver

Synopsis
    int pci_register_driver (struct pci_driver * drv);

Arguments
    drv
        the driver structure to register

Description
    Adds the driver structure to the list of registered drivers. Returns the number of pci devices which were claimed by the driver during registration. The driver remains registered even if the return value is zero.

以下内容是在http://blog.youkuaiyun.com/bi511304183/article/details/9832407的基础上完成：

大多数驱动程序都要实现一个probe函数，该函数在register时被调用，具体内核是如何实现的呢？

下面我们以LINUX内核中Hamachi.c为例子来分析一下：

    static struct pci_driver hamachi_driver = {  
        .name       = DRV_NAME,  
        .id_table   = hamachi_pci_tbl,  
        .probe      = hamachi_init_one,  
        .remove     = __devexit_p(hamachi_remove_one),  
    };  
      
    static int __init hamachi_init (void)  
    {  
    /* when a module, this is printed whether or not devices are found in probe */  
    #ifdef MODULE   
        printk(version);  
    #endif   
        return pci_register_driver(&hamachi_driver);  
    }  
      
    static void __exit hamachi_exit (void)  
    {  
        pci_unregister_driver(&hamachi_driver);  
    }  
      
      
    module_init(hamachi_init);  
    module_exit(hamachi_exit);

首先，实现了一个pci_driver结构体，名为hamachi_driver.

在hamachi_init函数中，直接调用pci_register_driver, 追踪该函数：

    /* 
     * pci_register_driver must be a macro so that KBUILD_MODNAME can be expanded 
     */  
    #define pci_register_driver(driver)     \   
        __pci_register_driver(driver, THIS_MODULE, KBUILD_MODNAME)

发现pci_register_driver实际上是一个macro，使用宏的目的是扩展参数，实际调用的是__pci_register_driver，继续追踪：

    /** 
     * __pci_register_driver - register a new pci driver 
     * @drv: the driver structure to register 
     * @owner: owner module of drv 
     * @mod_name: module name string 
     *  
     * Adds the driver structure to the list of registered drivers. 
     * Returns a negative value on error, otherwise 0.  
     * If no error occurred, the driver remains registered even if  
     * no device was claimed during registration. 
     */  
    int __pci_re