1# OpenHarmony musl 现状 2 3## libc 4当前libc.so符号列表： 5https://gitee.com/openharmony/third_party_musl/blob/master/libc.map.txt 6 7## musl-libc面向应用开发者的C-API 8https://gitee.com/openharmony/interface_sdk_c/blob/master/third_party/musl/ndk_script/adapter/libc.ndk.json 9 10## 系统侧libc新的变化 11 122023/12/2 <unistd.h> 13- `getproctid`: 获取当前线程的全局id，即从init命名空间看到的id 14 152023/11/22 <unistd.h> 16- `getprocpid`: 获取当前进程的全局id，即从init命名空间看到的id 17 182023/11/20 <netdb.h> 19 20这些函数提供了在网络编程中操作和管理预定义主机设置的功能。通过这些函数，可以清除、移除、设置单个主机或多个主机的预定义主机设置 21- `predefined_host_clear_all_hosts`: 清除所有预定义主机的设置 22- `predefined_host_remove_host`: 移除指定的预定义主机设置 23- `predefined_host_set_host`: 设置指定主机的预定义主机设置 24- `predefined_host_set_hosts`: 设置多个主机的预定义主机设置 25- `predefined_host_lookup_ip`: 查询指定主机的预定义主机设置 26- `removednsresolvehook`: 移除 DNS 解析钩子(hook) 27- `setdnsresolvehook`: 设置 DNS 解析钩子(hook)，允许在网络解析过程中插入自定义逻辑来拦截和修改 DNS 解析请求 28 292023/11/20 <dlfcn.h> 30- `dlns_set_namespace_permitted_paths`: 设置动态链接命名空间的允许路径，指定在哪些路径下搜索动态链接库 31- `dlns_set_namespace_separated`: 设置动态链接命名空间的分隔标志，用于指定在动态链接库搜索路径中应用不同的分隔符规则 32 332023/11/15 <gwp_asan.h> 34- `libc_gwp_asan_unwind_fast`: 堆栈展开 35- `libc_gwp_asan_has_free_mem`: 检查 GWP-ASan 堆栈检测器是否有可用的空闲内存 36- `libc_gwp_asan_ptr_is_mine`: 检查指定的指针是否由 GWP-ASan 堆栈检测器所分配 37- `may_init_gwp_asan`: 在需要时初始化 GWP-ASan 堆栈检测器 38 39 402023/10/18 <execinfo.h> 41- `backtrace`: 获取堆栈地址列表 42- `backtrace_symbols`: 通过堆栈列表获取对应的符号 43- `backtrace_symbols_fd`: 通过堆栈列表获取对应的符号的同时将符号写入fd中 44- `backtrace_symbols_fmt`: 从`backtrace`函数获取的函数调用栈信息转换为格式化的可读字符串数组 45- `backtrace_symbols_fd_fmt`: 从`backtrace`函数获取的函数调用栈信息格式化输出到指定的文件描述符中。 46- `arc4random`: 生成伪随机数 47- `arc4random_buf`: 生成指定长度的随机字节序列，并将其存储在指定的缓冲区中 48- `arc4random_uniform`: 生成一个在指定范围内的随机整数 49 50 51 52 532023/10/26 <netdb.h> 54- `getaddrinfo_ext`：扩展版本的 getaddrinfo 函数，用于获取指定主机名或服务名的网络地址信息 55 562023/5/29 57- 隐藏`InitParameterClient`、`InitSharedMem`、`SystemReadParam`、`SystemFindParameter`、`SystemGetParameterCommitId`、`SystemGetParameterValue`、`GetSystemCommitId`、`TestParameterReaderPerformance`符号 58 592023/5/9 60- libc.map.txt规范化修改，详见 https://gitee.com/openharmony/third_party_musl/pulls/895/files 61 622023/5/4 63- fortify接口变更 64https://gitee.com/openharmony/third_party_musl/pulls/886 65 662023/4/26 67- 新增`SetThreadInfoCallback`符号 68 692023/3/14 70- 新增`add_special_handler_at_last`和`remove_all_special_handler`符号 71 722023/2/17 73- 隐藏`__mem_trace`符号，新增`memtrace`符号 74 752023/2/18 76- 隐藏`__mem_typeset`符号，新增`__mem_trace`符号 77 782023/1/13 79- 新增`add_special_signal_handler`和`remove_special_signal_handler`符号 80 812022/12/13 82- 新增`__lldb_mmap`符号 83 842022/11/11 85- libc去除符号版本信息 86 872022/10/27 88- 去掉隐藏符号 `pthread_cancel` 89 902022/10/12 91- 去掉隐藏符号 `pthread_setcancelstate` 92 93 94 95## 应用开发者目前还不能使用的C-API 96下列所展示的函数当前在应用开发中不能使用，在不同权限等级下可能会不一样 97 98### 内核拦截 99下列接口目前由于内核拦截还不能使用 100- shmget 101- shmat 102- shmdt 103- shmctl 104- semget 105- semctl 106- semop 107- semtimedop 108- name_to_handle_at 109- open_by_handle_at 110- seteuid 111- setegid 112 113下列接口目前由于`seccomp`还不能使用，`seccomp`会限制系统调用的访问权限 114- setfsgid 115- setfsuid 116- setuid 117- setgid 118- setreuid 119- setregid 120- setresgid 121- sethostname 122- setgroups 123- setdomainname 124- setxattr 125- clock_settime 126- chroot 127- quotactl 128- mknod 129- mknodat 130 131### 应用开发功能限制 132- <shm.h> 共享内存: 在进程退出时不能被回收，有安全风险 133 - shmget 函数用于创建或获取共享内存段的标识符。 134 - shmat 函数用于将共享内存段附加到进程的地址空间中。 135 - shmdt 函数用于将共享内存段从进程的地址空间中分离。 136 - shmctl 函数用于对共享内存段进行控制操作，如获取/设置共享内存的状态信息、删除共享内存段等。 137- <sem.h> 共享内存: 在进程退出时不能被回收，有安全风险 138 - semget 函数用于创建或获取信号量集的标识符。 139 - semctl 函数用于对信号量集进行控制操作，如获取/设置信号量的状态信息、删除信号量集等。 140 - semop 函数用于对信号量进行原子化操作，如增加或减少信号量的值。 141 - semtimedop 函数用于在指定的时间范围内进行对信号量的原子化操作，支持超时功能。 142- <fsuid.h> 文件系统用户标识和文件系统组标识: 会导致进程获取不该获取的权限，导致系统具有安全风险 143 - setfsgid 函数用于设置进程的文件系统组标识（File System Group Identifier）。 144 - setfsuid 函数用于设置进程的文件系统用户标识（File System User Identifier）。 145- 设置关于进程、文件系统的用户、组标识: 会导致进程获取不该获取的权限，导致系统具有安全风险 146 - setuid、setgid：用于设置进程的实际用户标识和实际组标识，以及有效用户标识和有效组标识。这些标识决定了进程对系统资源的访问权限。 147 - seteuid、setegid：用于设置进程的有效用户标识和有效组标识。这些标识用于权限检查和访问控制。 148 - setreuid、setregid：用于设置进程的实际用户标识和有效用户标识，或实际组标识和有效组标识。这些函数可以将实际标识和有效标识设置为不同的值。 149 - setfsgid、setfsuid：用于设置进程的文件系统组标识和文件系统用户标识。这些标识用于对文件系统资源的访问控制。 150 - setresgid：用于设置进程的实际组标识、有效组标识和保存的组标识。 151 - setresgid: 用于同时设置进程的实际用户标识、有效用户标识和保存的用户标识。 152 - setgroups: 用于设置进程的附加组标识列表。 153- 设置系统的主机名和域名: 修改主机名和域名，具有安全风险 154 - sethostname: 设置主机名 155 - setdomainname: 设置域名 156- 用于设置文件或目录的扩展属性: 写入文件系统的属性，具有安全风险 157 - setxattr 158- 文件句柄操作: 访问任意文件 159 - name_to_handle_at 函数用于将指定路径的文件名转换为持有文件句柄（file handle）的文件描述符。 160 - open_by_handle_at 函数用于根据给定的文件句柄（file handle）打开文件，并返回相应的文件描述符。 161- 系统时钟: 修改系统时间 162 - clock_settime 用于设置指定的系统时钟（clock）的时间值 163- 进程根路径: 当前进程访问到不该访问的文件路径 164 - chroot 设置当前进程执行的根路径 165- <quota.h> 管理磁盘配额相关函数 166 - quotactl: 管理磁盘配额（disk quota）的相关操作，包括获取、设置和检查磁盘配额信息 167- <stat.h> 168 - mknod: 创建一个特殊文件节点（special file node），可以用于创建设备文件、管道文件等 169 - mknodat: 类似于 mknod 的系统调用函数，但相对于指定的文件描述符所在的目录进行操作，可以更灵活地控制文件的创建位置 170 171### 不同设备形态可能会导致内核特性的使能方式有所不同 172这些接口需要 /dev/shm 路径 173影响：将会无法使用命名信号量的相关功能 174- sem_open 用于创建或打开一个具有指定名称的命名信号量。 175- sem_close 用于关闭一个已打开的信号量。 176- sem_unlink 用于从系统中删除一个命名信号量。 177 178这些接口需要内核使能 `FANOTIFY` 特性 179影响：无法使用 fanotify 机制进行文件系统事件的监控和规则添加 180- fanotify_init 用于初始化一个 fanotify 实例，用于监控文件系统事件。 181- fanotify_mark 用于向 fanotify 实例添加监控规则，以便捕获特定文件或目录的事件。 182 183### SELinux 限制 184这些接口需要特殊的设备文件，比如/dev/ptmx，但是当前这些特殊的设备文件由于SELinux的限制，无法打开 185影响：使用伪终端相关功能 186- forkpty 函数在创建子进程的同时创建一个伪终端（pty）并建立父子进程之间的连接。 187- ptsname 函数用于获取伪终端（pty）的设备文件名。 188- ptsname_r 函数用于线程安全地获取伪终端（pty）的设备文件名。 189- openpty 函数创建一个新的伪终端（pty）对，并返回其主从设备文件描述符。 190- posix_openpt 函数打开一个伪终端（pty）设备，并返回其文件描述符。 191- unlockpt 函数解锁伪终端（pty）的主设备文件，使其可用于打开。 192 193### 空实现或默认失败的函数 194这些接口通常用于登录日志管理和用户会话跟踪等系统级任务。它们提供了对 utmp 文件的访问和操作。在musl中这些函数功能并未实现，在OpenHarmony中也并未向开发者提供 195- setutent: 将文件指针重置到 utmp 文件的开头，以便重新开始读取 utmp 文件的记录 196- pututline: 将一个 struct utmp 结构体的内容写入 utmp 文件，用于记录用户登录和注销等系统事件 197- getutent: 从 utmp 文件中读取下一个记录，并返回一个指向 struct utmp 结构体的指针，以便获取记录中的信息 198- utmpname: 设置要在其中查找 utmp 文件的路径名。通过调用 utmpname 函数，可以更改默认的 utmp 文件路径 199