一、EXPORT_SYMBOL 的作用
1.在一个模块中使用 EXPORT_SYMBOL(name)。name 表示函数或者变量等符号,它是对全部内核代码公开的,因此在您的内核模块中可以直接调用 name,即使用 EXPORT_SYMBOL 可以将一个函数以符号的方式导出给其他模块使用。
2.EXPORT_SYMBOL 的符号,是把这些符号和对应的地址保存起来,在内核运行的过程中,可以找到这些符号对应的地址。而模块在加载过程中,其本质就是能动态连接到内核。
3.如果在模块中引用了内核或其它模块的符号,就要 EXPORT_SYMBOL 这些符号,这样才能找到对应的地址连接。
二.EXPORT_SYMBOL 和 EXPORT_SYMBOL_GPL 的区别
EXPORT_SYMBOL(name);
EXPORT_SYMBOL_GPL(name);
这两个宏均用于将给定的符号导出到模块外, _GPL版本的宏定义只能使符号对GPL许可的模块可用。
三、EXPORT_SYMBOL 和 EXPORT_SYMBOL_GPL 使用方法
EXPORT_SYMBOL 使用方法:
在模块函数定义之后使用 EXPORT_SYMBOL(函数名);
在调用该函数的模块中使用 extern 对它声明,才可以开始调用函数;
首先加载(insmod mod1.ko)定义该函数的模块,再加载(insmod mod2.ko)调用该函数的模块;
举例简要说明:
在模块(mod1)中使用 EXPORT_SYMBOL(func1);
在模块(mod2)中声明 extern int func1();
如此就可以在(mod2)中调用 func1 了。
例如,在一个驱动中 drivers/net/ethernet/stmmac/tnkhw.c 定义了函数 tnkhw_bonding_setcurr_active_slave,然后在另外的.c文件中可以直接extern来使用:
void tnkhw_bonding_setcurr_active_slave(int curr_slave)
{uint32_t data;unsigned long flags;spin_lock_irqsave(&tnkhw_reg_lock, flags);data = readl(tnkhw_ioaddr + TNK_REG_TOE_BONDING_CTRL);if (curr_slave) {TNKBD_DBG("%s curr_slave = eth1\n", __func__);writel((0x00000004 | data),tnkhw_ioaddr + TNK_REG_TOE_BONDING_CTRL);} else {TNKBD_DBG("%s curr_slave = eth0\n", __func__);writel((0xfffffffb & data),tnkhw_ioaddr + TNK_REG_TOE_BONDING_CTRL);}spin_unlock_irqrestore(&tnkhw_reg_lock, flags);
}
EXPORT_SYMBOL(tnkhw_bonding_setcurr_active_slave);
使用 extern 来声明:
extern void tnkhw_bonding_setcurr_active_slave(int curr_slave);void bond_select_active_slave(struct bonding *bond)
{struct slave *best_slave;int rv;best_slave = bond_find_best_slave(bond);if (best_slave != bond->curr_active_slave) {bond_change_active_slave(bond, best_slave);
#ifdef TNK_BONDINGif (hitoe && bond->curr_active_slave) {int slave_dev_id = 0;/* set bond current active slave */slave_dev_id =select_slave_dev(bond->curr_active_slave->dev);TNKB_DBG(" %s bond->curr_active_dev->name = %s\n",__func__, bond->curr_active_slave->dev->name);TNKB_DBG("slave_dev_id = %d\n", slave_dev_id);tnkhw_bonding_setcurr_active_slave(slave_dev_id);}
#endifrv = bond_set_carrier(bond);if (!rv)return;if (netif_carrier_ok(bond->dev)) {pr_info("%s: first active interface up!\n",bond->dev->name);} else {pr_info("%s: now running without any active interface !\n",bond->dev->name);}}
}
EXPORT_SYMBOL_GPL 使用方法:
EXPORT_SYMBOL_GPL 使用方法基本与 EXPORT_SYMBOL 相同,但是也有差异。
在模块函数定义之后使用 EXPORT_SYMBOL_GPL(函数名);
在调用该函数的模块中使用 extern 对它声明,然后必须使用 MODULE_LICENSE(“GPL”) 或者 MODULE_LICENSE(“Dual BSD/GPL”),才可以开始调用函数(这是因为 EXPORT_SYMBOL_GPL 主要是给有GPL认证的模块使用的);
首先加载(insmod mod1.ko)定义该函数的模块,再加载(insmod mod2.ko)调用该函数的模块;
举例简要说明:
在模块(mod1)中使用 EXPORT_SYMBOL_GPL (func1);
在模块(mod2)中先声明 extern int func1(),然后使用宏 MODULE_LICENSE(“GPL”) ;
如此就可以在(mod2)中调用 func1 了。
例如,在一个驱动中 drivers/usb/core/urb.c 定义了函数 usb_scuttle_anchored_urbs,然后在另外的.c文件中可以直接extern来使用:
void usb_scuttle_anchored_urbs(struct usb_anchor *anchor)
{struct urb *victim;unsigned long flags;spin_lock_irqsave(&anchor->lock, flags);while (!list_empty(&anchor->urb_list)) {victim = list_entry(anchor->urb_list.prev, struct urb,anchor_list);__usb_unanchor_urb(victim, anchor);}spin_unlock_irqrestore(&anchor->lock, flags);
}EXPORT_SYMBOL_GPL(usb_scuttle_anchored_urbs);
使用 extern 来声明:
extern void usb_scuttle_anchored_urbs(struct usb_anchor *anchor);MODULE_LICENSE("GPL");static void carl9170_usb_cancel_urbs(struct ar9170 *ar)
{int err;carl9170_set_state(ar, CARL9170_UNKNOWN_STATE);err = carl9170_usb_flush(ar);if (err)dev_err(&ar->udev->dev, "stuck tx urbs!\n");usb_poison_anchored_urbs(&ar->tx_anch);carl9170_usb_handle_tx_err(ar);usb_poison_anchored_urbs(&ar->rx_anch);tasklet_kill(&ar->usb_tasklet);usb_scuttle_anchored_urbs(&ar->rx_work);usb_scuttle_anchored_urbs(&ar->rx_pool);usb_scuttle_anchored_urbs(&ar->tx_cmd);
}