• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# libc标准库
2
3## 简介
4C标准函数库在C语言程序设计中,提供符合标准的头文件,以及常用的库函数实现(如I/O输入输出和字符串控制)。
5
6OpenHarmony采用musl作为C标准库,musl库是一个轻量,快速,简单,免费的开源libc库,详细介绍参考[musl官方参考手册](http://musl.libc.org/manual.html)7
8musl与glibc的差异点请参考[musl与glibc功能对比](https://wiki.musl-libc.org/functional-differences-from-glibc.html)9
10## 标准C库组件介绍
11
12[libc、libm、libdl](https://zh.cppreference.com/w/c/header)组合实现C11标准C库。
13
14libc:包含线程相关接口,以及大部分标准接口。
15
16libm:数学库函数接口,当前在OpenHarmony中是一个链接,实际都在libc中定义。
17
18libdl:dlopen等动态链接器接口,当前在OpenHarmony中是一个链接,实际都在libc中定义。
19
20## musl版本号
21
221.2.0
23
24从OpenHarmony4.0开始,版本升级到1.2.3
25
26## 支持的能力
27提供兼容C99,C11,POSIX标准的头文件,以及库函数接口,但不是完全兼容;支持armv7a,arm64, x86_64三种架构的支持;
28
29为了更好的适配OpenHarmony设备的高性能,低内存,高安全,轻量化,支持多种形态设备的基本特征;在musl开源库的基础上进行了优化,增强,对不适用嵌入式设备的接口进行了裁剪。
30
31### 新增能力
321. 动态加载器支持命名空间隔离能力,应用可以dlopen加载的动态库受系统命名空间限制(比如,无法打开系统侧动态库)。
332. 支持dlclose真实卸载动态库能力,musl的开源版本不支持。
343. 支持symbol-versioning功能。
354. dlopen支持直接加载zip包中未压缩的文件。
36
37### 调试能力
38libc提供了动态使能维测log功能(默认关闭),供开发者需要的时候查看libc库异常。使用libc提供的动态使能维测log功能,不需要重新编译libc库,只需设置param属性即可。在正式发布版本中,不建议使能,会影响运行性能。
39
40#### 1. musl.log功能
41设置musl.log.enable属性为true,打开musl维测log打印。打印其他日志,需先打开此开关。
42```
43param set musl.log.enable true
44```
45
46#### 2. 加载器log功能
47加载器是libc中负责程序引导,dlopen,dlclose等动态链接程序,如需要查看动态加载过程异常,可以打开加载器log。用法如下:
48* 使能全部应用的加载器log,log量比较大,请谨慎使用。
49```
50param set musl.log.ld.app true
51```
52* 使能指定应用的加载器log,{app_name}需要替换成真实需要打印log的应用名字。
53```
54param set musl.log.ld.all false
55param set musl.log.ld.app.{app_name} true
56```
57* 打印全部应用除指定名字应用外的加载器日志。
58```
59param set musl.log.ld.all true
60param set musl.log.ld.app.{app_name} false
61```
62
63## musl不支持接口列表。
64
65[native api中没有导出的符号列表](musl-peculiar-symbol.md)
66
67[native api由于权限管控可能调用失败的符号列表](musl-permission-control-symbol.md)
68
69
70<!--no_check-->