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