网络驱动移植之解析Linux网络驱动的基本框架

    内核源码：linux-2.6.38.8.tar.bz2

 

    概括而言，编写Linux网络驱动其实只要完成两件事即可，一是分配并初始化网络设备，二是注册网络设备。

    1、分配并初始化网络设备

    动态分配网络设备（从C语言角度来看，其实就是定义了一个struct net_device结构体变量，并对这个结构体变量的某些成员进行了初始化而已）及其私有数据的大致过程如下图（以以太网设备为例）：

 

    下面将结合linux-2.6.38.8中的代码详细分析网络设备的分配和初始化过程。 

/* linux-2.6.38.8/include/linux/etherdevice.h */
#define alloc_etherdev(sizeof_priv) alloc_etherdev_mq(sizeof_priv, 1)
#define alloc_etherdev_mq(sizeof_priv, count) alloc_etherdev_mqs(sizeof_priv, count, count)

/* linux-2.6.38.8/net/ethernet/eth.c */
struct net_device *alloc_etherdev_mqs(int sizeof_priv, unsigned int txqs,
				      unsigned int rxqs)
{
	return alloc_netdev_mqs(sizeof_priv, "eth%d", ether_setup, txqs, rxqs);
}

void ether_setup(struct net_device *dev)
{
	dev->header_ops		= &eth_header_ops;
	dev->type		= ARPHRD_ETHER;
	dev->hard_header_len 	= ETH_HLEN;
	dev->mtu		= ETH_DATA_LEN;
	dev->addr_len		= ETH_ALEN;
	dev->tx_queue_len	= 1000;	/* Ethernet wants good queues */
	dev->flags		= IFF_BROADCAST|IFF_MULTICAST;

	memset(dev->broadcast, 0xFF, ETH_ALEN);

}

    以前各类网络设备的分配函数（如以太网设备的alloc_etherdev）都只是alloc_netdev函数的封装而已，但对于linux-2.6.38.8而言已经不是这样了。 

/* linux-2.6.38.8/include/linux/netdevice.h */
#define alloc_netdev(sizeof_priv, name, setup) \
	alloc_netdev_mqs(sizeof_priv, name, setup, 1, 1)

    alloc_netdev_mqs函数的五个参数分别为私有数据大小、设备名称、默认初始化函数、发送队列数目和接收队列数目。

    以太网设备的名称设为eth%d，默认初始化函数设为ether_setup，发送和接收队列数目都设为1。

    函数alloc_netdev_mqs定义在linux-2.6.38.8/net/core/dev.c文件中，大概会完成以下各种操作：

    （1）、为struct net_device和私有数据分配内存空间 

	alloc_size = sizeof(struct net_device);
	if (sizeof_priv) {
		alloc_size = ALIGN(alloc_size, NETDEV_ALIGN);  //#define NETDEV_ALIGN 32
		alloc_size += sizeof_priv;
	}
	alloc_size += NETDEV_ALIGN - 1;

	p = kzalloc(alloc_size, GFP_KERNEL);
	if (!p) {
		printk(KERN_ERR "alloc_netdev: Unable to allocate device.\n");
		return NULL;
	}

	dev = PTR_ALIGN(p, NETDEV_ALIGN);
	dev->padded = (char *)dev - (char *)p;

    对齐操作相关宏： 

/* linux-2.6.38.8/include/linux/kernel.h */
#define ALIGN(x, a)		__ALIGN_KERNEL((x), (a))
#define __ALIGN_KERNEL(x, a)		__ALIGN_KERNEL_MASK(x, (typeof(x))(a) - 1)
#define __ALIGN_KERNEL_MASK(x, mask)	(((x) + (mask)) & ~(mask))
	
#define PTR_ALIGN(p, a)		((typeof(p))ALIGN((unsigned long)(p), (a)))

    （2）、动态分配per-CPU变量 

	dev->pcpu_refcnt = alloc_percpu(int);
	if (!dev->pcpu_refcnt)
		goto free_p;

    （3）、初始化硬件地址链表dev->dev_addrs，并把首元素赋给dev->dev_addr 

	if (dev_addr_init(dev))
		goto free_pcpu;

    （4）、初始化组播和单播地址链表 

	dev_mc_init(dev);
	dev_uc_init(dev);

    （5）、设置网络命名空间 

	dev_net_set(dev, &init_net);

    （6）、设置GSO最大值 

	dev->gso_max_size = GSO_MAX_SIZE;

    （7）、初始化各种链表 

	INIT_LIST_HEAD(&dev->ethtool_ntuple_list.list);
	dev->ethtool_ntuple_list.count = 0;
	INIT_LIST_HEAD(&dev->napi_list);
	INIT_LIST_HEAD(&dev->unreg_list);
	INIT_LIST_HEAD(&dev->link_watch_list);

    （8）、设置priv_flags值 

	dev->priv_flags = IFF_XMIT_DST_RELEASE;

    （9）、执行默认初始化函数（以太网设备默认为ether_setup） 

	setup(dev);

    （10）、初始化数据包发送队列 

	dev->num_tx_queues = txqs;
	dev->real_num_tx_queues = txqs;
	if (netif_alloc_netdev_queues(dev))
		goto free_all;

    （11）、初始化数据包接收队列 

	dev->num_rx_queues = rxqs;
	dev->real_num_rx_queues = rxqs;
	if (netif_alloc_rx_queues(dev))
		goto free_all;

    （12）、设置网络设备名称 

	strcpy(dev->name, name);

    2、注册网络设备

    通过register_netdev函数把已完成部分初始化的net_device结构体变量（即某个网络设备实例）注册到Linux内核中，大致过程如下图：

 

    下面将结合linux-2.6.38.8中的代码详细分析网络设备的注册过程。

    （1）、获得rtnl信号量 

	rtnl_lock();

    （2）、分配网络设备名（即%d对应的数字） 

	if (strchr(dev->name, '%')) {
		err = dev_alloc_name(dev, dev->name);
		if (err < 0)
			goto out;
	}

    （3）、调用实际注册函数 

	err = register_netdevice(dev);

    3.1、初始化dev->addr_list_lock自旋锁并根据dev->type设置其类别 

	spin_lock_init(&dev->addr_list_lock);
	netdev_set_addr_lockdep_class(dev);

    3.2、调用init函数 

	if (dev->netdev_ops->ndo_init) {
		ret = dev->netdev_ops->ndo_init(dev);
		if (ret) {
			if (ret > 0)
				ret = -EIO;
			goto out;
		}
	}

    3.3、检测网络设备名是否有效 

	ret = dev_get_valid_name(dev, dev->name, 0);
	if (ret)
		goto err_uninit;

    3.4、为网络设备分配唯一的索引号 

	dev->ifindex = dev_new_index(net);
	if (dev->iflink == -1)
		dev->iflink = dev->ifindex;

    3.5、设置网络设备特性（dev->features） 

	if ((dev->features & NETIF_F_HW_CSUM) &&
	    (dev->features & (NETIF_F_IP_CSUM|NETIF_F_IPV6_CSUM))) {
		printk(KERN_NOTICE "%s: mixed HW and IP checksum settings.\n",
		       dev->name);
		dev->features &= ~(NETIF_F_IP_CSUM|NETIF_F_IPV6_CSUM);
	}

	if ((dev->features & NETIF_F_NO_CSUM) &&
	    (dev->features & (NETIF_F_HW_CSUM|NETIF_F_IP_CSUM|NETIF_F_IPV6_CSUM))) {
		printk(KERN_NOTICE "%s: mixed no checksumming and other settings.\n",
		       dev->name);
		dev->features &= ~(NETIF_F_IP_CSUM|NETIF_F_IPV6_CSUM|NETIF_F_HW_CSUM);
	}

	dev->features = netdev_fix_features(dev->features, dev->name);


	if (dev->features & NETIF_F_SG)
		dev->features |= NETIF_F_GSO;


	dev->vlan_features |= (NETIF_F_GRO | NETIF_F_HIGHDMA);

    3.6、通过通知链告知内核其他子系统某种事件的发生（如注册网络设备） 

	ret = call_netdevice_notifiers(NETDEV_POST_INIT, dev);
	ret = notifier_to_errno(ret);
	if (ret)
		goto err_uninit;

	ret = call_netdevice_notifiers(NETDEV_REGISTER, dev);
	ret = notifier_to_errno(ret);
	if (ret) {
		rollback_registered(dev);
		dev->reg_state = NETREG_UNREGISTERED;
	}

    3.7、创建网络设备在sysfs文件系统中的入口 

	ret = netdev_register_kobject(dev);
	if (ret)
		goto err_uninit;

    3.8、设置网络设备为已注册状态 

	dev->reg_state = NETREG_REGISTERED;

    3.9、设置网络设备状态为可用 

	set_bit(__LINK_STATE_PRESENT, &dev->state);

    3.10、初始化网络设备的队列规则 

	dev_init_scheduler(dev);

    3.11、增加网络设备的引用计数 

	dev_hold(dev);

    3.12、加入到设备链表（如dev->dev_list、dev->name_hlist、dev->index_hlist） 

	list_netdevice(dev);

    3.13、发送netlink（RFC 3549协议）信息

	if (!dev->rtnl_link_ops ||
	    dev->rtnl_link_state == RTNL_LINK_INITIALIZED)
		rtmsg_ifinfo(RTM_NEWLINK, dev, ~0U);