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