6．Linux的连网
|
套接字缓冲区函数 |
函数名 |
功能 |
函数形成 |
参数 |
描述 |
|
skb_queue_empty |
检查队列是否为空 |
int skb_queue_empty (struct sk_buff_head * list) |
list为队列头 |
如果队列为空返回真，否则返回假 |
|
|
skb_get |
引用缓冲区 |
struct sk_buff * skb_get (struct sk_buff * skb) |
skb为要引用的缓冲区 |
对套接字缓冲区再引用一次，返回指向缓冲区的指针 |
|
|
kfree_skb |
释放一个sk_buff |
void kfree_skb (struct sk_buff * skb) |
sk为要释放的缓冲区 |
删除对一个缓冲区的引用，如果其引用计数变为0，则释放它 |
|
|
skb_cloned |
缓冲区是否是克隆的 |
int skb_cloned (struct sk_buff * skb) |
skb为要检查的缓冲区 |
如果以skb_clone标志来产生缓冲区，并且是缓冲区多个共享拷贝中的一个，则返回真。克隆的缓冲区具有共享数据，因此在正常情况下不必对其进行写。 |
|
|
skb_shared |
缓冲区是否是共享的 |
int skb_shared (struct sk_buff * skb) |
skb为要检查的缓冲区 |
如果有多于一个的人引用这个缓冲区就返回真。 |
|
|
skb_share_check |
检查缓冲区是否共享的，如果是就克隆它 |
struct sk_buff * skb_share_check (struct sk_buff * skb, int pri) |
skb为要检查的缓冲区，pri为内存分配的优先级 |
如果缓冲区是共享的，就克隆这个缓冲区，并把原来缓冲区的引用计数减1，返回新克隆的缓冲区。如果不是共享的，则返回原来的缓冲区。当从中断状态或全局锁调用该函数时，pri必须是GFP_ATOMIC。 内存分配失败则返回NULL。 |
|
|
skb_unshare |
产生一个共享缓冲区的拷贝 |
struct sk_buff * skb_unshare (struct sk_buff * skb, int pri); |
skb为要检查的缓冲区，pri为内存分配的优先级 |
如果套接字缓冲区是克隆的，那么这个函数就创建一个新的数据拷贝，并把原来缓冲区的引用计数减1，返回引用计数为1的新拷贝。如果不是克隆的，就返回原缓冲区。当从中断状态或全局锁调用该函数时，pri必须是GFP_ATOMIC。 内存分配失败则返回NULL。 |
|
|
skb_queue_len |
获得队列的长度 |
__u32 skb_queue_len (struct sk_buff_head * list_) |
list_为测量的链表 |
返回&sk_buff 队列的指针。 |
|
|
__skb_queue_head |
在链表首部对一个缓冲区排队 |
void __skb_queue_head (struct sk_buff_head * list, struct sk_buff * newsk) |
list为要使用的链表， newsk为要排队的缓冲区。 |
在链表首部对一个缓冲区进行排队。这个函数没有锁，因此在调用它之前必须持有必要的锁。一个缓冲区不能同时放在两个链表中。 |
|
|
skb_queue_head |
在链表首部对一个缓冲区排队 |
void skb_queue_head (struct sk_buff_head * list, struct sk_buff * newsk) |
list为要使用的链表， newsk为要排队的缓冲区。 |
在链表首部对一个缓冲区进行排队。这个函持有锁，因此可以安全地使用。一个缓冲区不能同时放在两个链表中。 |
|
|
__skb_queue_tail |
在链表尾部对一个缓冲区排队 |
void __skb_queue_tail (struct sk_buff_head * list, struct sk_buff * newsk) |
list为要使用的链表， newsk为要排队的缓冲区。 |
在链表尾部对一个缓冲区进行排队。这个函数没有锁，因此在调用它之前必须持有必要的锁。一个缓冲区不能同时放在两个链表中。 |
|
|
skb_queue_tail |
在链表尾部对一个缓冲区排队 |
void skb_queue_tail (struct sk_buff_head * list, struct sk_buff * newsk) |
list为要使用的链表， newsk为要排队的缓冲区。 |
在链表尾部对一个缓冲区进行排队。这个函持有锁，因此可以安全地使用。一个缓冲区不能同时放在两个链表中。 |
|
|
__skb_dequeue |
从队列的首部删除一个缓冲区 |
struct sk_buff * __skb_dequeue (struct sk_buff_head * list) |
list为要操作的队列 |
删除链表首部。这个函数不持有任何锁，因此使用时应当持有适当的锁。如果队链表为空则返回NULL，成功则返回首部元素。 |
|
|
skb_dequeue |
从队列的首部删除一个缓冲区 |
struct sk_buff * skb_dequeue (struct sk_buff_head * list) |
list为要操作的队列 |
删除链表首部，这个函数持有锁，因此可以安全地使用。如果队链表为空则返回NULL，成功则返回首部元素。 |
|
|
skb_insert |
插入一个缓冲区 |
void skb_insert (struct sk_buff * old, struct sk_buff * newsk) |
old为插入之前的缓冲区，newsk为要插入的缓冲区 |
把一个数据包放在链表中给定的包之前。该函数持有链表锁，并且是原子操作。一个缓冲区不能同时放在两个链表中。 |
|
|
skb_append |
追加一个缓冲区 |
void skb_append (struct sk_buff * old, struct sk_buff * newsk) |
old为插入之前的缓冲区，newsk为要插入的缓冲区 |
把一个数据包放在链表中给定的包之前。该函数持有链表锁，并且是原子操作。一个缓冲区不能同时放在两个链表中。 |
|
|
skb_unlink |
从链表删除一个缓冲区 |
void skb_unlink (struct sk_buff * skb); |
Skb为要删除的缓冲区 |
把一个数据包放在链表中给定的包之前。该函数持有链表锁，并且是原子操作。
|
|
|
_skb_dequeue_tail |
从队尾删除 |
struct sk_buff * __skb_dequeue_tail (struct sk_buff_head * list) |
List为要操作的链表 |
从链表尾部删除。这个函数不持有任何锁，因此必须持以合适的锁来使用。如果链表为空，则返回NULL，成功则返首部元素。 |
|
|
skb_dequeue_tail |
从队头删除 |
struct sk_buff * skb_dequeue_tail (struct sk_buff_head * list) |
List为要操作的链表 |
删除链表尾部，这个函数持有锁，因此可以安全地使用。如果队链表为空则返回NULL，成功则返回首部元素。 |
|
|
skb_put |
把数据加到缓冲区 |
unsigned char * skb_put (struct sk_buff * skb, unsigned int len) |
skb为要使用的缓冲区，len为要增加的数据长度 |
这个函数扩充缓冲区所使用的数据区。如果扩充后超过缓冲区总长度，内核会产生警告。函数返回的指针指向所扩充数据的第一个字节。 |
|
|
skb_push |
把数据加到缓冲区的开始 |
unsigned char * skb_push (struct sk_buff * skb, unsigned int len); |
skb为要使用的缓冲区，len为要增加的数据长度 |
这个函数扩充在缓冲区的开始处缓冲区所使用的数据区。如果扩充后超过缓冲区首部空间的总长度，内核会产生警告。函数返回的指针指向所扩充数据的第一个字节。 |
|
|
skb_pull |
从缓冲区的开始删除数据 |
unsigned char * skb_pull (struct sk_buff * skb, unsigned int len) |
skb为要使用的缓冲区，len为要删除的数据长度 |
这个函数从链表开始处删除数据，把腾出的内存归还给首部空间。把指向下一个缓冲区的指针返回。 |
|
|
skb_headroom |
缓冲区首部空闲空间的字节数 |
int skb_headroom (const struct sk_buff * skb) |
skb为要检查的缓冲区 |
返回&sk_buff首部空闲空间的字节数 |
|
|
skb_tailroom |
缓冲区尾部的空闲字节数 |
int skb_tailroom (const struct sk_buff * skb) |
skb为要检查的缓冲区 |
返回&sk_buff尾部空闲空间的字节数 |
|
|
skb_reserve |
调整头部的空间 |
void skb_reserve (struct sk_buff * skb, unsigned int len) |
skb为要改变的缓冲区，len为要删除的字节数 |
通过减少尾部空间，增加一个空&sk_buff的首部空间。这仅仅适用于空缓冲区。 |
|
|
skb_trim |
从缓冲区删除尾部 |
void skb_trim (struct sk_buff * skb, unsigned int len); |
skb为要改变的缓冲区，len为新的长度 |
通过从尾部删除数据，剪切缓冲区的长度。如果缓冲区已经处于指定的长度，则不用改变。 |
|
|
skb_orphan |
使一个缓冲区成为孤儿 |
void skb_orphan (struct sk_buff * skb); |
skb是要成为孤儿的缓冲区 |
如果一个缓冲区当前有一个拥有者，我们就调用拥有者的析构函数，使skb没有拥有者。该缓冲区继续存在，但以前的拥有者不再对其“负责”。 |
|
|
skb_queue_purge |
使一个链表空 |
void skb_queue_purge (struct sk_buff_head * list) |
list为要腾空的链表 |
删除在&sk_buff链表上的所有缓冲区。这个函数持有链表锁，并且是原子的。 |
|
|
__skb_queue_purge |
使一个链表空 |
void __skb_queue_purge (struct sk_buff_head * list); |
list为要腾空的链表 |
删除在&sk_buff链表上的所有缓冲区。这个函数不持有链表锁，调用者必须持有相关的锁来使用它。 |
|
|
dev_alloc_skb |
为发送分配一个skbuff |
struct sk_buff * dev_alloc_skb (unsigned int length) |
Length为要分配的长度 |
分配一个新的&sk_buff，并赋予它一个引用计数。这个缓冲区有未确定的头空间。用户应该分配自己需要的头空间。 如果没有空闲内存，则返回NULL。尽管这个函数是分配内存，但也可以从中断来调用。 |
|
|
skb_cow |
当需要时拷贝skb的首部 |
struct sk_buff * skb_cow (struct sk_buff * skb, unsigned int headroom) |
Skb为要拷贝的缓冲区，headroom为需要的头空间 |
如果传递过来的缓冲区缺乏足够的头空间或是克隆的，则该缓冲区被拷贝，并且附加的头空间变为可用。如果没有空闲的内存，则返回空。如果缓冲区拷贝成功，则返回新的缓冲区，否则返回已存在的缓冲区。 |
|
|
skb_over_panic |
私有函数 |
void skb_over_panic (struct sk_buff * skb, int sz, void * here) |
skb为缓冲区，sz为大小，here为地址。 |
用户不可调用。 |
|
|
skb_under_panic |
私有函数 |
void skb_under_panic (struct sk_buff * skb, int sz, void * here) |
skb为缓冲区，sz为大小，here为地址。 |
用户不可调用。 |
|
|
alloc_skb |
分配一个网络缓冲区 |
struct sk_buff * alloc_skb (unsigned int size, int gfp_mask) |
size为要分配的大小，gfp_mask为分配掩码 |
分配一个新的&sk_buff。返回的缓冲区没有size大小的头空间和尾空间。新缓冲区的引用计数为1。返回值为一缓冲区，如果失败则返回空。从中断分配缓冲区，掩码只能使用GFP_ATOMIC的gfp_mask。 |
|
|
__kfree_skb |
私有函数 |
void __kfree_skb (struct sk_buff * skb) |
skb为缓冲区 |
释放一个sk_buff。释放与该缓冲区相关的所有事情，清除状态。这是一个内部使用的函数，用户应当调用kfree_skb。 |
|
|
skb_clone |
复制一个sk_buff |
struct sk_buff * skb_clone (struct sk_buff * skb, int gfp_mask) |
skb为要克隆的缓冲区，gfp_mask为分配掩码。 |
复制一个&sk_buff。新缓冲区不是由套接字拥有。两个拷贝共享相同的数据包而不是结构。新缓冲区的引用计数为1。如果分配失败，函数返回NULL，否则返回新的缓冲区。如果从中断调用这个函数，掩码只能使用GFP_ATOMIC的gfp_mask。 |
|
|
skb_copy |
创建一个sk_buff的私有拷贝 |
struct sk_buff * skb_copy (const struct sk_buff * skb, int gfp_mask) |
skb为要拷贝的缓冲区，gfp_mask为分配优先级。 |
既拷贝&sk_buff也拷贝其数据。该函数用在调用者希望修改数据并需要数据的私有拷贝来进行改变时。失败返回NULL，成功返回指向缓冲区的指针。 返回的缓冲区其引用计数为1。如果从中断调用，则必须传递的优先级为GFP_ATOMIC。 |
|
|
skb_copy_expand |
拷贝并扩展sk_buff |
struct sk_buff * skb_copy_expand (const struct sk_buff * skb, int newheadroom, int newtailroom, int gfp_mask); |
skb为要拷贝的缓冲区，newheadroom为头部的新空闲字节数，newtailroom为尾部的新空闲字节数。 |
既拷贝&sk_buff也拷贝其数据，同时分配额外的空间。当调用者希望修改数据并需要对私有数据进行改变，以及给新的域更多的空间时调用该函数。失败返回NULL，成功返回指向缓冲区的指针。 返回的缓冲区其引用计数为1。如果从中断调用，则必须传递的优先级为GFP_ATOMIC。 |