1# 标准库支持 2 3 4## CMSIS支持 5 6 7### 基本概念 8 9[CMSIS](https://developer.arm.com/tools-and-software/embedded/cmsis)是Cortex Microcontroller Software Interface Standard（Cortex微控制器软件接口标准）的缩写，是对于那些基于ARM Cortex处理器的微控制器独立于供应商的硬件抽象层。它包含多个组件层，其中之一是RTOS层，该层定义了一套通用及标准化的RTOS API接口，减少了应用开发者对特定RTOS的依赖，方便用户软件的移植重用。该套API有2个版本，分别为版本1（CMSIS-RTOS v1）和版本2（CMSIS-RTOS v2），OpenHarmony LiteOS-M仅提供其版本2的实现。 10 11 12### 开发指导 13 14 15#### 接口说明 16 17CMSIS-RTOS v2提供下面几种功能，接口详细信息可以查看API参考。 18 19 **表1** 内核信息与控制 20 21| 接口名 | 接口描述 | 22| -------- | -------- | 23| osKernelGetInfo | 获取RTOS内核信息。 | 24| osKernelGetState | 获取当前的RTOS内核状态。 | 25| osKernelGetSysTimerCount | 获取RTOS内核系统计时器计数。 | 26| osKernelGetSysTimerFreq | 获取RTOS内核系统计时器频率。 | 27| osKernelInitialize | 初始化RTOS内核。 | 28| osKernelLock | 锁定RTOS内核调度程序。 | 29| osKernelUnlock | 解锁RTOS内核调度程序。 | 30| osKernelRestoreLock | 恢复RTOS内核调度程序锁定状态。 | 31| osKernelResume | 恢复RTOS内核调度程序。（暂未实现） | 32| osKernelStart | 启动RTOS内核调度程序。 | 33| osKernelSuspend | 挂起RTOS内核调度程序。（暂未实现） | 34| osKernelGetTickCount | 获取RTOS内核滴答计数。 | 35| osKernelGetTickFreq | 获取RTOS内核滴答频率。 | 36 37 **表2** 线程管理 38 39| 接口名 | 接口描述 | 40| -------- | -------- | 41| osThreadDetach | 分离线程（线程终止时可以回收线程存储）。（暂未实现） | 42| osThreadEnumerate | 枚举活动线程。（暂未实现） | 43| osThreadExit | 终止当前正在运行的线程的执行。 | 44| osThreadGetCount | 获取活动线程的数量。 | 45| osThreadGetId | 返回当前正在运行的线程的线程ID。 | 46| osThreadGetName | 获取线程的名称。 | 47| osThreadGetPriority | 获取线程的当前优先级。 | 48| osThreadGetStackSize | 获取线程的堆栈大小。 | 49| osThreadGetStackSpace | 根据执行期间的堆栈水印记录获取线程的可用堆栈空间。 | 50| osThreadGetState | 获取线程的当前线程状态。 | 51| osThreadJoin | 等待指定线程终止。（暂未实现） | 52| osThreadNew | 创建一个线程并将其添加到活动线程中。 | 53| osThreadResume | 恢复线程的执行。 | 54| osThreadSetPriority | 更改线程的优先级。 | 55| osThreadSuspend | 暂停执行线程。 | 56| osThreadTerminate | 终止线程的执行。 | 57| osThreadYield | 将控制权传递给处于就绪状态的下一个线程。 | 58 59 **表3** 线程标志 60 61| 接口名 | 接口描述 | 62| -------- | -------- | 63| osThreadFlagsSet | 设置线程的指定线程标志。（暂未实现） | 64| osThreadFlagsClear | 清除当前正在运行的线程的指定线程标志。（暂未实现） | 65| osThreadFlagsGet | 获取当前正在运行的线程的当前线程标志。（暂未实现） | 66| osThreadFlagsWait | 等待当前正在运行的线程的一个或多个线程标志发出信号。（暂未实现） | 67 68 **表4** 事件标志 69 70| 接口名 | 接口描述 | 71| -------- | -------- | 72| osEventFlagsGetName | 获取事件标志对象的名称。（暂未实现） | 73| osEventFlagsNew | 创建并初始化事件标志对象。 | 74| osEventFlagsDelete | 删除事件标志对象。 | 75| osEventFlagsSet | 设置指定的事件标志。 | 76| osEventFlagsClear | 清除指定的事件标志。 | 77| osEventFlagsGet | 获取当前事件标志。 | 78| osEventFlagsWait | 等待一个或多个事件标志被发出信号。 | 79 80 **表5** 通用等待函数 81 82| 接口名 | 接口描述 | 83| -------- | -------- | 84| osDelay | 等待超时（时间延迟）。 | 85| osDelayUntil | 等到指定时间。 | 86 87 **表6** 计时器管理 88 89| 接口名 | 接口描述 | 90| -------- | -------- | 91| osTimerDelete | 删除计时器。 | 92| osTimerGetName | 获取计时器的名称。（暂未实现） | 93| osTimerIsRunning | 检查计时器是否正在运行。 | 94| osTimerNew | 创建和初始化计时器。 | 95| osTimerStart | 启动或重新启动计时器。 | 96| osTimerStop | 停止计时器。 | 97 98 **表7** 互斥管理 99 100| 接口名 | 接口描述 | 101| -------- | -------- | 102| osMutexAcquire | 获取互斥或超时（如果已锁定）。 | 103| osMutexDelete | 删除互斥对象。 | 104| osMutexGetName | 获取互斥对象的名称。（暂未实现） | 105| osMutexGetOwner | 获取拥有互斥对象的线程。 | 106| osMutexNew | 创建并初始化Mutex对象。 | 107| osMutexRelease | 释放由osMutexAcquire获取的Mutex。 | 108 109 **表8** 信号量 110 111| 接口名 | 接口描述 | 112| -------- | -------- | 113| osSemaphoreAcquire | 获取信号量令牌或超时（如果没有可用的令牌）。 | 114| osSemaphoreDelete | 删除一个信号量对象。 | 115| osSemaphoreGetCount | 获取当前信号量令牌计数。 | 116| osSemaphoreGetName | 获取信号量对象的名称。（暂未实现） | 117| osSemaphoreNew | 创建并初始化一个信号量对象。 | 118| osSemaphoreRelease | 释放信号量令牌，直到初始最大计数。 | 119 120 **表9** 内存池 121 122| 接口名 | 接口描述 | 123| -------- | -------- | 124| osMemoryPoolAlloc | 从内存池分配一个内存块。 | 125| osMemoryPoolDelete | 删除内存池对象。 | 126| osMemoryPoolFree | 将分配的内存块返回到内存池。 | 127| osMemoryPoolGetBlockSize | 获取内存池中的内存块大小。 | 128| osMemoryPoolGetCapacity | 获取内存池中最大的内存块数。 | 129| osMemoryPoolGetCount | 获取内存池中使用的内存块数。 | 130| osMemoryPoolGetName | 获取内存池对象的名称。 | 131| osMemoryPoolGetSpace | 获取内存池中可用的内存块数。 | 132| osMemoryPoolNew | 创建并初始化一个内存池对象。 | 133 134 **表10** 消息队列 135 136| 接口名 | 接口描述 | 137| -------- | -------- | 138| osMessageQueueDelete | 删除消息队列对象。 | 139| osMessageQueueGet | 从队列获取消息，或者如果队列为空，则从超时获取消息。 | 140| osMessageQueueGetCapacity | 获取消息队列中的最大消息数。 | 141| osMessageQueueGetCount | 获取消息队列中排队的消息数。 | 142| osMessageQueueGetMsgSize | 获取内存池中的最大消息大小。 | 143| osMessageQueueGetName | 获取消息队列对象的名称。（暂未实现） | 144| osMessageQueueGetSpace | 获取消息队列中消息的可用插槽数。 | 145| osMessageQueueNew | 创建和初始化消息队列对象。 | 146| osMessageQueuePut | 如果队列已满，则将消息放入队列或超时。 | 147| osMessageQueueReset | 将消息队列重置为初始空状态。（暂未实现） | 148 149 150#### 开发流程 151 152CMSIS-RTOS2组件可以作为库或源代码提供（下图显示了库）。通过添加CMSIS-RTOS2组件（通常是一些配置文件），可以将基于CMSIS的应用程序扩展为具有RTOS功能。只需包含cmsis_os2.h头文件就可以访问RTOS API函数，这使用户应用程序能够处理RTOS内核相关事件，而在更换内核时无需重新编译源代码。 153 154静态对象分配需要访问RTOS对象控制块定义。特定于实现的头文件（下图中的os_xx .h）提供对此类控制块定义的访问。对于OpenHarmony LiteOS-M内核，由文件名以los_开头的头文件提供，这些文件包含OpenHarmony LiteOS-M内核的这些定义。 155 156 157 158 159#### 编程实例 160 161 162``` 163#include ... 164#include "cmsis_os2.h" 165 166/*---------------------------------------------------------------------------- 167 * 应用程序主线程 168 *---------------------------------------------------------------------------*/ 169void app_main (void *argument) { 170 // ... 171 for (;;) {} 172} 173 174int main (void) { 175 // 系统初始化 176 MySystemInit(); 177 // ... 178 179 osKernelInitialize(); // 初始化CMSIS-RTOS 180 osThreadNew(app_main, NULL, NULL); // 创建应用程序主线程 181 osKernelStart(); // 开始执行线程 182 for (;;) {} 183} 184``` 185 186## POSIX支持 187 188 189### 基本概念 190 191OpenHarmony内核使用**musl libc**库以及自研接口，支持部分标准POSIX接口，开发者可基于POSIX标准接口开发内核之上的组件及应用。 192 193 194### 开发指导 195 196 197#### 接口说明 198 199 **表1** process 200 201| 需要包含的头文件 | 接口名 | 描述 | 202| -------- | -------- | -------- | 203| \#include <stdlib.h> | void abort(void); | 中止线程执行 | 204| \#include <assert.h> | void assert(scalar expression); | 断言为假终止线程 | 205| \#include <pthread.h> | int pthread_cond_destroy(pthread_cond_t \*cond); | 销毁条件变量 | 206| \#include <pthread.h> | int pthread_cond_init(pthread_cond_t \*restrict co<br/>nd, const pthread_condattr_t \*restrict attr); | 初始化条件变量 | 207| \#include <pthread.h> | int pthread_cond_timedwait(pthread_cond_t \*restr<br/>ict cond, pthread_mutex_t \*restrict mutex, const struct timespec \*restrict abstime); | 等待条件 | 208| \#include <pthread.h> | int pthread_condattr_init(pthread_condattr_t \*attr); | 初始化条件变量属性对象 | 209| \#include <pthread.h> | int pthread_mutex_unlock(pthread_mutex_t \*mutex); | 解锁互斥锁 | 210| \#include <pthread.h> | int pthread_create(pthread_t \*thread, const pthread_<br/>attr_t \*attr, void \*(\*start_routine)(void \*), void \*arg); | 创建一个新的线程 | 211| \#include <pthread.h> | int pthread_join(pthread_t thread, void \*\*retval); | 等待指定的线程结束 | 212| \#include <pthread.h> | pthread_t pthread_self(void); | 获取当前线程的ID | 213| \#include <pthread.h> | int pthread_getschedparam(pthread_t thread, int \*<br/>policy, struct sched_param \*param); | 获取线程的调度策略和参数 | 214| \#include <pthread.h> | int pthread_setschedparam(pthread_t thread, int<br/>policy, const struct sched_param \*param); | 设置线程的调度策略和参数 | 215| \#include <pthread.h> | int pthread_mutex_init(pthread_mutex_t \*__restrict m<br/>, const pthread_mutexattr_t \*__restrict a); | 初始化互斥锁 | 216| \#include <pthread.h> | int pthread_mutex_lock(pthread_mutex_t \*m); | 互斥锁加锁操作 | 217| \#include <pthread.h> | int pthread_mutex_trylock(pthread_mutex_t \*m); | 互斥锁尝试加锁操作 | 218| \#include <pthread.h> | int pthread_mutex_destroy(pthread_mutex_t \*m); | 销毁互斥锁 | 219| \#include <pthread.h> | int pthread_attr_init(pthread_attr_t \*attr); | 初始化线程属性对象 | 220| \#include <pthread.h> | int pthread_attr_destroy(pthread_attr_t \*attr); | 销毁线程属性对象 | 221| \#include <pthread.h> | int pthread_attr_getstacksize(const pthread_attr<br/>_t \*attr, size_t \*stacksize); | 获取线程属性对象的堆栈大小 | 222| \#include <pthread.h> | int pthread_attr_setstacksize(pthread_attr_t \*attr<br/>, size_t stacksize); | 设置线程属性对象的堆栈大小 | 223| \#include <pthread.h> | int pthread_attr_getschedparam(const pthread_<br/>attr_t \*attr, struct sched_param \*param); | 获取线程属性对象的调度参数属性 | 224| \#include <pthread.h> | int pthread_attr_setschedparam(pthread_attr_t \*<br/>attr, const struct sched_param \*param); | 设置线程属性对象的调度参数属性 | 225| \#include <pthread.h> | int pthread_getname_np(pthread_t pthread, char<br/>\*name, size_t len); | 获取线程名称 | 226| \#include <pthread.h> | int pthread_setname_np(pthread_t pthread, const<br/>char \*name); | 设置线程名称 | 227| \#include <pthread.h> | int pthread_cond_broadcast(pthread_cond_t \*c); | 解除若干已被等待条件阻塞的线程 | 228| \#include <pthread.h> | int pthread_cond_signal(pthread_cond_t \*c); | 解除被阻塞的线程 | 229| \#include <pthread.h> | int pthread_cond_wait(pthread_cond_t \*__restrict<br/>c, pthread_mutex_t \*__restrict m); | 等待条件 | 230 231 **表2** fs 232 233| 需要包含的头文件 | 接口名 | 描述 | 234| -------- | -------- | -------- | 235| \#include <libgen.h> | char \*dirname(char \*path); | 获取目录名 | 236| \#include <dirent.h> | struct dirent \*readdir(DIR \*dirp); | 读目录 | 237| \#include <sys/stat.h> | int stat(const char \*restrict path, struct stat \*restrict buf); | 获取文件信息 | 238| \#include <unistd.h> | int unlink(const char \*pathname); | 删除文件 | 239| \#include <fcntl.h | int open(const char \*path, int oflags, ...); | 用于打开文件，如文件不存在，创建文件并打开 | 240| \#include <nistd.h> | int close(int fd); | 关闭文件 | 241| \#include <stdio.h> | int rename(const char \*oldpath, const char \*newpath); | 重命名指定的文件 | 242| \#include <dirent.h> | DIR \*opendir(const char \*dirname); | 打开指定目录 | 243| \#include <dirent.h> | int closedir(DIR \*dir); | 关闭指定目录 | 244| \#include <sys/mount.h> | int mount(const char \*source, const char \*target, con<br/>st char \*filesystemtype, unsigned long mountflags, c<br/>onst void \*data); | 挂载文件系统 | 245| \#include <sys/mount.h> | int umount(const char \*target); | 卸载文件系统 | 246| \#include <sys/mount.h> | int umount2(const char \*target, int flag); | 卸载文件系统 | 247| \#include <sys/stat.h> | int fsync(int fd); | 将与指定文件描述符关联的文件同步到存储设备 | 248| \#include <sys/stat.h> | int mkdir(const char \*pathname, mode_t mode); | 创建目录 | 249| \#include <unistd.h> | int rmdir(const char \*path); | 删除目录 | 250| \#include <sys/stat.h> | int fstat(int fd, struct stat \*buf); | 获取文件状态信息 | 251| \#include <sys/statfs.h> | int statfs(const char \*path, struct statfs \*buf); | 获取指定路径下文件的文件系统信息 | 252 253 **表3** time 254 255| 需要包含的头文件 | 接口名 | 描述 | 256| -------- | -------- | -------- | 257| \#include <sys/time.h> | int gettimeofday(struct timeval \*tv, struct timezone \*tz); | 获取时间。当前暂无时区概念,tz返回为空 | 258| \#include <time.h> | struct tm \*gmtime(const time_t \*timep); | 将日期和时间转换为细分时间或ASCII | 259| \#include <time.h> | struct tm \*localtime(const time_t \*timep); | 获取时间 | 260| \#include <time.h> | struct tm \*localtime_r(const time_t \*timep, struct tm \*result); | 获取时间 | 261| \#include <time.h> | time_t mktime(struct tm \*tm); | 将日期和时间转换为细分时间或ASCII | 262| \#include <time.h> | size_t strftime(char \*s, size_t max, const char \*<br/>format,const struct tm \*tm); | 格式化日期和时间字符串 | 263| \#include <time.h> | time_t time(time_t \*tloc); | 获得日历时间 | 264| \#include <sys/times.h> | clock_t times(struct tms \*buf); | 获取线程时间 | 265| \#include <unistd.h> | int usleep(useconds_t usec); | 休眠（微秒单位） | 266| \#include <time.h> | int nanosleep(const struct timespec \*tspec1, struct<br/>timespec \*tspec2); | 暂停当前线程直到指定的时间到达 | 267| \#include <time.h> | int clock_gettime(clockid_t id, struct timespec \*tspec); | 获取时钟的时间 | 268| \#include <time.h> | int timer_create(clockid_t id, struct sigevent \*__<br/>restrict evp, timer_t \*__restrict t); | 为线程创建计时器 | 269| \#include <time.h> | int timer_delete(timer_t t); | 为线程删除计时器 | 270| \#include <time.h> | int timer_settime(timer_t t, int flags, const struct<br/>itimerspec \*__restrict val, struct itimerspec \*__restrict old); | 为线程设置计时器 | 271| \#include <time.h> | time_t time (time_t \*t); | 获取时间 | 272| \#include <time.h> | char \*strptime(const char \*s, const char \*format, struct tm \*tm); | 将时间的字符串表示形式转换为时间tm结构 | 273 274 **表4** util 275 276| 需要包含的头文件 | 接口名 | 描述 | 277| -------- | -------- | -------- | 278| \#include <stdlib.h> | int atoi(const char \*nptr); | 字符串转换整型（int） | 279| \#include <stdlib.h> | long atol(const char \*nptr); | 字符串转换整型（long） | 280| \#include <stdlib.h> | long long atoll(const char \*nptr); | 字符串转换整型（long long） | 281| \#include <ctype.h> | int isalnum(int c); | 检查字母数字字符 | 282| \#include <ctype.h> | int isascii(int c); | 检查ASCII | 283| \#include <ctype.h> | int isdigit(int c); | 检查数字字符 | 284| \#include <ctype.h> | int islower(int c); | 检查小写字符 | 285| \#include <ctype.h> | int isprint(int c); | 检查任何可打印字符，包括空格 | 286| \#include <ctype.h> | int isspace(int c); | 检查空格字符 | 287| \#include <ctype.h> | int isupper(int c); | 检查所传的字符是否是大写字母 | 288| \#include <ctype.h> | int isxdigit(int c); | 判断字符是否为十六进制数 | 289| \#include <stdlib.h> | long int random (void); | 生成伪随机数 | 290| \#include <stdlib.h> | void srandom(unsigned int seed); | 初始化随机数生成器 | 291| \#include <ctype.h> | int tolower(int c); | 字母转换成小写 | 292| \#include <ctype.h> | int toupper(int c); | 字母转换成大写 | 293| \#include <stdarg.h> | type va_arg(va_list ap, type); | 获取可变参数的当前参数，返回指定类型并将指针指向下一参数 | 294| \#include <stdarg.h> | void va_copy(va_list dest, va_list src); | 复制参数 | 295| \#include <stdarg.h> | void va_end(va_list ap); | 清空va_list可变参数列表 | 296| \#include <stdarg.h> | void va_start(va_list ap, last); | 定义变长参数列表的起始位置 | 297| \#include <string.h> | char \*strchr(const char \*s, int c); | 在字符串中定位字符 | 298| \#include <string.h> | int strcmp(const char \*s1, const char \*s2); | 比较字符串 | 299| \#include <string.h> | size_t strcspn(const char \*s, const char \*reject); | 获取前缀子串的长度 | 300| \#include <string.h> | char \*strdup(const char \*s); | 字符串拷贝到新建的位置处 | 301| \#include <string.h> | size_t strlen(const char \*s); | 计算字符串长度 | 302| \#include <strings.h> | int strncasecmp(const char \*s1, const char \*s2, size_t n); | 比较固定长度字符串（忽略大小写） | 303| \#include <strings.h> | int strcasecmp(const char \*s1, const char \*s2); | 比较字符串（忽略大小写） | 304| \#include <string.h> | int strncmp(const char \*s1, const char \*s2, size_t n); | 比较字符串（指定长度） | 305| \#include <string.h> | char \*strrchr(const char \*s, int c); | 在字符串中定位字符 | 306| \#include <string.h> | char \*strstr(const char \*haystack, const char \*needle); | 寻找指定的子串 | 307| \#include <stdlib.h> | long int strtol(const char \*nptr, char \*\*endptr, int base); | 将字符串转换为long型整数 | 308| \#include <stdlib.h> | unsigned long int strtoul(const char \*nptr, char<br/>\*\*endptr, int base); | 将字符串转换为unsigned long型整数 | 309| \#include <stdlib.h> | unsigned long long int strtoull(const char \*nptr,<br/>char \*\*endptr,int base); | 将字符串转换为unsigned long long型整数 | 310| \#include <regex.h> | int regcomp(regex_t \*preg, const char \*regex,<br/>int cflags); | 编译正则表达式 | 311| \#include <regex.h> | int regexec(const regex_t \*preg, const char \*<br/>string, size_t nmatch,regmatch_t pmatch[], int eflags); | 匹配正则表达式 | 312| \#include <regex.h> | void regfree(regex_t \*preg); | 释放正则表达式 | 313| \#include <string.h> | char \*strerror(int errnum); | 返回描述错误号的字符串 | 314 315 **表5** math 316 317| 需要包含的头文件 | 接口名 | 描述 | 318| -------- | -------- | -------- | 319| \#include <stdlib.h> | int abs(int i); | 取绝对值 | 320| \#include <math.h> | double log(double x); | 自然对数函数 | 321| \#include <math.h> | double pow(double x, double y); | 求x的指数y次幂 | 322| \#include <math.h> | double round(double x); | 从零开始，舍入到最接近的整数 | 323| \#include <math.h> | double sqrt(double x); | 平方根 | 324 325 **表6** IO 326 327| 需要包含的头文件 | 接口名 | 描述 | 328| -------- | -------- | -------- | 329| \#include <stdio.h> | void clearerr(FILE \*stream); | 清除流的文件结尾和错误指示 | 330| \#include <stdio.h> | int fclose(FILE \*stream); | 关闭文件流 | 331| \#include <stdio.h> | FILE \*fdopen(int fd, const char \*mode); | 通过文件描述符打开文件流 | 332| \#include <stdio.h> | int feof(FILE \*stream); | 检测返回文件末尾指示位 | 333| \#include <stdio.h> | int fflush(FILE \*stream); | 刷新流 | 334| \#include <stdio.h> | char \*fgets(char \*s, int size, FILE \*stream); | 读取流的下一行 | 335| \#include <stdio.h> | int fileno(FILE \*stream); | 返回流的文件描述符 | 336| \#include <stdio.h> | FILE \*fopen(const char \*path, const char \*mode); | 打开流 | 337| \#include <stdio.h> | int fputs(const char \*s, FILE \*stream); | 向指定流写入一行 | 338| \#include <stdio.h> | size_t fread(void \*ptr, size_t size, size_t nmemb,<br/>FILE \*stream); | 读一个流 | 339| \#include <stdio.h> | int fseek(FILE \*stream, long offset, int whence); | 设置流指针的位置 | 340| \#include <stdio.h> | long ftell(FILE \*stream); | 获取流指针的位置 | 341| \#include <stdio.h> | size_t fwrite(const void \*ptr, size_t size, size_t<br/>nmemb,FILE \*stream); | 向流写入 | 342| \#include <stdio.h> | void perror(const char \*s); | 打印系统错误信息 | 343| \#include <stdio.h> | void rewind(FILE \*stream); | 重新定位流 | 344| \#include <unistd.h> | ssize_t write(int fd, const void \*buf, size_t size); | 写文件内容 | 345| \#include <unistd.h> | ssize_t read(int fd, void \*buf, size_t size); | 读文件内容 | 346 347 **表7** net 348 349| 需要包含的头文件 | 接口名 | 描述 | 350| -------- | -------- | -------- | 351| \#include <sys/socket.h> | void freeaddrinfo(struct addrinfo \*res); | 释放调用getaddrinfo所分配的动态内存 | 352| \#include <sys/socket.h> | int getaddrinfo(const char \*restrict nodename,const<br/>char \*restrict servname,const struct addrinfo \*restrict<br/>hints,struct addrinfo \*\*restrict res); | 网络地址和服务转换 | 353| \#include <sys/socket.h> | int getnameinfo(const struct sockaddr \*restrict sa,<br/>socklen_t salen,char \*restrict node, socklen_t nodelen<br/>, char \*restrict service,socklen_t servicelen, int flags); | 以协议无关的方式进行地址到名称的转换 | 354| \#include <net/if.h> | unsigned int if_nametoindex(const char \*ifname); | 通过网络接口名得到索引 | 355| \#include <arpa/inet.h> | in_addr_t inet_addr(const char \*cp); | 网络主机地址点分十进制形式转换位二进制形式 | 356| \#include <arpa/inet.h> | char \*inet_ntoa(struct in_addr in); | 网络主机地址二进制形式转换位点分十进制形式 | 357| \#include <arpa/inet.h> | const char \*inet_ntop(int af, const void \*src,char \*dst,<br/>socklen_t size); | 网络地址转换 | 358| \#include <arpa/inet.h> | int inet_pton(int af, const char \*src, void \*dst); | 网络地址转换 | 359| \#include <sys/socket.h> | int listen(int sockfd, int backlog); | 监听套接字 | 360| \#include <sys/socket.h> | ssize_t recvmsg(int sockfd, struct msghdr \*msg, int flags); | 从套接字接收消息.只支持iov大小为1的场景，且不支持ancillary消息 | 361| \#include <sys/socket.h> | ssize_t send(int sockfd, const void \*buf, size_t len, int flags); | 从socket发送消息 | 362| \#include <sys/socket.h> | ssize_t sendmsg(int sockfd, const struct msghdr \*msg, int flags); | 从socket发送消息。不支持ancillary消息 | 363| \#include <sys/socket.h> | ssize_t sendto(int sockfd, const void \*buf, size_t len, int<br/>flags,const struct sockaddr \*dest_addr, socklen_t addrlen); | 从socket发送消息 | 364| \#include <sys/socket.h> | int setsockopt(int sockfd, int level, int optname,const<br/>void \*optval, socklen_t optlen); | 设置与套接字关联的选项 | 365 366 **表8** mem 367 368| 需要包含的头文件 | 接口名 | 描述 | 369| -------- | -------- | -------- | 370| \#include <string.h> | int memcmp(const void \*s1, const void \*s2, size_t n); | 内存比较 | 371| \#include <string.h> | void \*memcpy(void \*dest, const void \*src, size_t n); | 内存拷贝 | 372| \#include <string.h> | void \*memset(void \*s, int c, size_t n); | 内存初始化 | 373| \#include <stdlib.h> | void \*realloc(void \*ptr, size_t size); | 重分配内存 | 374| \#include <stdlib.h> | void \*malloc(size_t size); | 动态分配内存块大小 | 375| \#include <stdlib.h> | void free(void \*ptr); | 释放ptr所指向的内存空间 | 376 377 **表9** IPC 378 379| 需要包含的头文件 | 接口名 | 描述 | 380| -------- | -------- | -------- | 381| \#include <semaphore.h> | int sem_timedwait(sem_t \*sem, const struct<br/> timespec \*abs_timeout); | 计时锁定信号量 | 382| \#include <semaphore.h> | int sem_destroy(sem_t \*sem); | 销毁指定的无名信号量 | 383| \#include <semaphore.h> | int sem_init(sem_t \*sem, int pshared<br/>, unsigned int value); | 创建并初始化一个无名信号量 | 384| \#include <semaphore.h> | int sem_post(sem_t \*sem); | 增加信号量计数 | 385| \#include <semaphore.h> | int sem_wait(sem_t \*sem); | 获取信号量 | 386| \#include <mqueue.h> | mqd_t mq_open(const char \*mqName,<br/> int openFlag, ...); | 此API用于打开一个具有指定名称的已有消息队列或创建一个新的消息队列 | 387| \#include <mqueue.h> | int mq_close(mqd_t personal); | 此API用于关闭具有指定描述符的消息队列 | 388| \#include <mqueue.h> | int mq_unlink(const char \*mqName); | 此API用于删除具有指定名称的消息队列 | 389| \#include <mqueue.h> | int mq_send(mqd_t personal, const<br/> char \*msg,size_t msgLen, unsigned int msgPrio); | 此API用于将具有指定内容和长度的消息放入具有指定描述符的消息队列中 | 390| \#include <mqueue.h> | ssize_t mq_receive(mqd_t personal, char \*msg,<br/>size_t msgLen, unsigned int \*msgPrio); | 此API用于从具有指定描述符的消息队列中删除最老的消息，并将其放入msg_ptr所指向的缓冲区中 | 391| \#include <mqueue.h> | int mq_timedsend(mqd_t personal, const char<br/>\*msg, size_t msgLen, unsigned int msgPrio, c<br/>onst struct timespec \*absTimeout) | 此API用于在预定时间将具有指定内容和长度的消息放入具有描述符的消息队列中 | 392| \#include <mqueue.h> | ssize_t mq_timedreceive(mqd_t personal, char<br/>\*msg, size_t msgLen, unsigned int \*msgPrio,<br/>const struct timespec \*absTimeout); | 此API用于从具有指定描述符的消息队列消息中获取具有指定消息内容和长度的消息 | 393| \#include <mqueue.h> | int mq_setattr(mqd_t mqdes, const struct mq_<br/>attr \*__restrict newattr, struct mq_attr \*__restrict oldattr); | 设置描述符指定的消息队列属性 | 394| \#include <libc.h> | const char \*libc_get_version_string(void); | 获取libc版本字符串 | 395| \#include <libc.h> | int libc_get_version(void); | 获取libc版本号 | 396 397 398#### 注意事项 399 400常用错误码对照表： 401 402| 错误码 | 值 | 描述 | 含义 | 403| -------- | -------- | -------- | -------- | 404| ENOERR | 0 | Success | 成功 | 405| EPERM | 1 | Operation not permitted | 操作不允许 | 406| ENOENT | 2 | No such file or directory | 没有这样的文件或目录 | 407| ESRCH | 3 | No such process | 没有这样的进程(暂不支持) | 408| EINTR | 4 | Interrupted system call | 系统调用被中断 | 409| EIO | 5 | I/O error | I/O错误 | 410| ENXIO | 6 | No such device or address | 没有这样的设备或地址 | 411| E2BIG | 7 | Arg list too long | 参数列表太长 | 412| ENOEXEC | 8 | Exec format error | 执行格式错误 | 413| EBADF | 9 | Bad file number | 坏的文件描述符 | 414| ECHILD | 10 | No child processes | 没有子进程(暂不支持) | 415| EAGAIN | 11 | Try again | 资源暂时不可用 | 416| ENOMEM | 12 | Out of memory | 内存溢出 | 417| EACCES | 13 | Permission denied | 拒绝许可 | 418| EFAULT | 14 | Bad address | 错误的地址 | 419| ENOTBLK | 15 | Block device required | 块设备请求 | 420| EBUSY | 16 | Device or resource busy | 设备或资源忙 | 421| EEXIST | 17 | File exists | 文件存在 | 422| EXDEV | 18 | Cross-device link | 无效的交叉链接 | 423| ENODEV | 19 | No such device | 设备不存在 | 424| ENOTDIR | 20 | Not a directory | 不是一个目录 | 425| EISDIR | 21 | Is a directory | 是一个目录 | 426| EINVAL | 22 | Invalid argument | 无效的参数 | 427| ENFILE\* | 23 | File table overflow | 打开太多的文件系统 | 428| EMFILE | 24 | Too many open files | 打开的文件过多 | 429| EFBIG | 27 | File too large | 文件太大 | 430| ENOSPC | 28 | No space left on device | 设备上没有空间 | 431| ESPIPE | 29 | Illegal seek | 非法移位 | 432| EROFS | 30 | Read-only file system | 只读文件系统 | 433| EMLINK | 31 | Too many links | 太多的链接 | 434| EDOM | 33 | Math argument out of domain | 数值结果超出范围 | 435| ERANGE | 34 | Math result not representable | 数值结果不具代表性 | 436| EDEADLK | 35 | Resource deadlock would occur | 资源死锁错误 | 437| ENAMETOOLONG | 36 | Filename too long | 文件名太长 | 438| ENOLCK | 37 | No record locks available | 没有可用锁 | 439| ENOSYS | 38 | Function not implemented | 功能没有实现 | 440| ENOTEMPTY | 39 | Directory not empty | 目录不空 | 441| ELOOP | 40 | Too many symbolic links encountered | 符号链接层次太多 | 442| ENOMSG | 42 | No message of desired type | 没有期望类型的消息 | 443| EIDRM | 43 | Identifier removed | 标识符删除 | 444| ELNRNG | 48 | Link number out of range | 链接数超出范围 | 445| EBADR | 53 | Invalid request descriptor | 请求描述符无效 | 446| EBADRQC | 56 | Invalid request code | 无效的请求代码 | 447| ENOSTR | 60 | Device not a stream | 设备不是字符流 | 448| ENODATA | 61 | No data available | 无可用数据 | 449| ETIME | 62 | Timer expired | 计时器过期 | 450| EPROTO | 71 | Protocol error | 协议错误 | 451| EBADMSG | 74 | Not a data message | 非数据消息 | 452| EOVERFLOW | 75 | Value too large for defined data type | 值太大,对于定义数据类型 | 453| EMSGSIZE | 90 | Message too long | 消息太长 | 454 455 456#### 编程实例 457 458demo功能： 459 460创建一个线程并将父线程中的信息传递给子线程，在子线程中打印传递过来的信息和自身线程id值。 461 462本演示代码在 ./kernel/liteos_m/testsuites/src/osTest.c 中编译验证，在TestTaskEntry中调用验证入口函数DemoForTest。 463 464 465``` 466#include <stdio.h> 467#include <pthread.h> 468 469pthread_t ntid; 470 471void *ThreadFn(void *arg) 472{ 473 pthread_t tid; 474 while(1) { 475 tid = pthread_self(); 476 printf("\n++++++++++++++ %s %s tid = %d ++++++++++++++\n", (char*)arg, __FUNCTION__, tid); 477 } 478 return ((void *)0); 479} 480 481void DemoForTest() 482{ 483 int err; 484 char* str = "Hello world"; 485 err = pthread_create(&ntid, NULL, ThreadFn, (void*)str); 486 if(err != 0) { 487 printf("can't create thread\n"); 488 } 489} 490 491``` 492 493执行DemoForTest运行结果如下： 494 495 496``` 497++++++++++++++ Hello world ThreadFn tid = 48 ++++++++++++++ 498 499++++++++++++++ Hello world ThreadFn tid = 48 ++++++++++++++ 500 501++++++++++++++ Hello world ThreadFn tid = 48 ++++++++++++++ 502``` 503
