内核源码API

双向循环链表的操作

函数名

功能

函数形成

参数

描述

list_add

增加一个新元素

void list_add (struct list_head * new, struct list_head * head)

new为要增加的新元素,head为增加以后的链表头

在指定的头元素后插入一个新元素,用于栈的操作。

list_add_tail

增加一个新元素

void list_add_tail (struct list_head * new, struct list_head * head);

new为要增加的新元素,head为增加以前的链表头

在指定的头元素之前插入一个新元素,用于队列的操作。

list_del

从链表中删除一个元素

void list_del (struct list_head * entry);

entry为要从链表中删除的元素

list_del_init

从链表删除一个元素,并重新初始化链表

void list_del_init (struct list_head * entry)

entry为要从链表中删除的元素

list_empty

测试一个链表是否为空

int list_empty (struct list_head * head)

head为要测试的链表

list_splice

把两个链表合并在一起

void list_splice (struct list_head * list, struct list_head * head)

list为新加入的链表,head为第一个链表

list_entry

获得链表中元素的结构

list_entry ( ptr, type, member)

ptr为指向list_head的指针,type为一个结构体,而member为结构type中的一个域,其类型为list_head。

list_for_each

扫描链表

list_for_each ( pos, head)

pos为指向list_head的指针,用于循环计数,head为链表头。


基本C库函数

当编写驱动程序时,一般情况下不能使用C标准库的函数。Linux内核也提供了与标准库函数功能相同的一些函数,但二者还是稍有差别。

符串操作

strcpy

拷贝一个以NUL结束的字符串

char * strcpy (char * dest, const char * src)

dest为目的字符串的位置, src为源字符串的位置。

strncpy

拷贝一个定长的、以NUL结束的字符串

char * strncpy (char * dest, const char * src, size_t count)

dest为目的字符串的位置, src为源字符串的位置,count为要拷贝的最大字节数

与用户空间的strncpy不同,这个函数并不用NUL填充缓冲区,如果与源串超过count,则结果以非NUL结束

strcat

把一个以NUL结束的字符串添加到另一个串的末尾

char * strcat (char * dest, const char * src)

dest为要添加的字符串, src为源字符串。

strncat

把一个定长的、以NUL结束的字符串添加到另一个串的末尾

char * strncat (char * dest, const char * src, size_t count)

dest为要添加的字符串, src为源字符串,count为要拷贝的最大字节数

注意,与strncpy,形成对照, strncat正常结束。

strchr

在一个字符串中查找第一次出现的某个字符

char * strchr (const char * s, int c)

s为被搜索的字符串,c为待搜索的字符。

strrchr

在一个字符串中查找最后一次出现的某个字符

char * strrchr (const char * s, int c)

s为被搜索的字符串,c为待搜索的字符。

strlen

给出一个字符串的长度

size_t strlen (const char * s)

s为给定的字符串

strnlen

给出给定长度字符串的长度

size_t strnlen (const char * s, size_t count)

s为给定的字符串

strpbrk

在一个字符串中查找第一次出现的一组字符

char * strpbrk (const char * cs, const char * ct)

cs为被搜索的字符串,ct为待搜索的一组字符

strtok

把一个字符串分割为子串

char * strtok (char * s, const char * ct)

s为被搜索的字符串,ct为待搜索的子串

注意,一般不提倡用这个函数,而应当用strsep

memset

用给定的值填充内存区

void * memset (void * s, int c, size_t count)

s为指向内存区起始的指针,c为 要填充的内容,count为内存区的大小

I/O空间的访问不能使用memset,而应当使用memset_io。

bcopy

把内存的一个区域拷贝到另一个区域

char * bcopy (const char * src, char * dest, int count)

src为源字符串,dest为目的字符串,而count为内存区的大小

注意,这个函数的功能与memcpy相同,这是从BSD遗留下来的,对I/O空间的访问应当用memcpy_toio或 memcpy_fromio

memcpy

把内存的一个区域拷贝到另一个区域

void * memcpy (void * dest, const void * src, size_t count)

dest为目的字符串,Src为源字符串,而count为内存区的大小

对I/O空间的访问应当用memcpy_toio或 memcpy_fromio

memmove

把内存的一个区域拷贝到另一个区域

void * memmove (void * dest, const void * src, size_t count)

dest为目的字符串,Src为源字符串,而count为内存区的大小

memcpy和memmove处理重叠的区域,而该函数不处理。

memcmp

比较内存的两个区域

int memcmp (const void * cs, const void * ct, size_t count)

cs为一个内存区,ct为另一个内存区,而count为内存区的大小

memscan

在一个内存区中查找一个字符

void * memscan (void * addr, int c, size_t size)

addr为内存区,c为要搜索的字符,而size为内存区的大小

返回c第一次出现的地址,如果没有找到c,则向该内存区传递一个字节。

strstr

在以NUL结束的串中查找第一个出现的子串

char * strstr (const char * s1, const char * s2)

s1为被搜索的串,s2为待搜索的串。

memchr

在一个内存区中查找一个字符

void * memchr (const void * s, int c, size_t n)

s为内存区,为待搜索的字符,n为内存的大小

返回c第一次出现的位置,如果没有找到c,则返回空。

类别

函数名

功能

函数形成

参数

描述

字符串转换

simple_strtol

把一个字符串转换为一个有符号长整数

long simple_strtol (const char * cp, char ** endp, unsigned int base)

cp指向字符串的开始,endp为指向要分析的字符串末尾处的位置,base为要用的基数。

simple_strtoll

把一个字符串转换为一个有符号长长整数

long long simple_strtoll (const char * cp, char ** endp, unsigned int base)

cp指向字符串的开始,endp为指向要分析的字符串末尾处的位置,base为要用的基数。

simple_strtoul

把一个字符串转换为一个无符号长整数

long long simple_strtoul (const char * cp, char ** endp, unsigned int base)

cp指向字符串的开始,endp为指向要分析的字符串末尾处的位置,base为要用的基数。

simple_strtoull

把一个字符串转换为一个无符号长长整数

long long simple_strtoull (const char * cp, char ** endp, unsigned int base)

cp指向字符串的开始,endp为指向要分析的字符串末尾处的位置,base为要用的基数。

vsnprintf

格式化一个字符串,并把它放在缓存中。

int vsnprintf (char * buf, size_t size, const char * fmt, va_list args)

buf为存放结果的缓冲区, size为缓冲区的大小,fmt为要使用的格式化字符串,args为格式化字符串的参数。

snprintf

格式化一个字符串,并把它放在缓存中。

int snprintf (char * buf, size_t size, const char * fmt, ... ...)

buf为存放结果的缓冲区, size为缓冲区的大小,fmt为格式化字符串,使用@…来对格式化字符串进行格式化,…为可变参数。

vsprintf

格式化一个字符串,并把它放在缓存中。

int vsprintf (char * buf, const char * fmt, va_list args)

buf为存放结果的缓冲区, size为缓冲区的大小,fmt为要使用的格式化字符串,args为格式化字符串的参数。

sprintf

格式化一个字符串,并把它放在缓存中。

int sprintf (char * buf, const char * fmt, ... ...)

buf为存放结果的缓冲区, size为缓冲区的大小,fmt为格式化字符串,使用@…来对格式化字符串进行格式化,…为可变参数。

你可能感兴趣的:(c,struct,api,list,each,linux内核)