1## libc-test脚本使用说明 2 3### 一、编译 4 5编译命令，仅编译libc-test测试用例 6``` 7./build.sh --product-name rk3568 --build-target libctest 8``` 9用例可执行文件生成的目录位于 `out/rk3568/musl/libc-test` 10以及相关的动态库位于 `out/rk3568/musl/libc-test-lib` 11 12### 二、执行测试 13 141. 将HDC(Windows版)工具hdc.exe加入到windows环境变量。连接上开发板，保证HDC工具可以连接。 15 162. 进入musl/scripts，并根据实际环境，修改runtest_Windows.bat中测试用例生成目录完整路径（必要） 17 ```bat 18 @REM 本地OpenHarmony源码目录,需根据实际环境修改 19 set LOCAL=\\wsl$\ubuntu-20.04\home\code\OpenHarmony 20 @REM 本地编译out目录 21 set OUTDIR=out\rk3568 22 ``` 23 243. 将bat脚本复制到windows环境下使用！windows端双击运行runtest_Windows.bat，执行完毕会将详细错误结果信息REPORT返回到当前bat所在目录，并对结果进行统计生成FileList.txt（本次测试执行用例列表）与Summary.txt（统计报告），内容如下： 25 $\color{red}{提交PR需在提交里附上对应统计报告！}$ 26 ``` 27 SUMMARY 28 All: 1177 | Run: 1147 | Skip: 30 29 Pass: [1083/1147] 30 Fail: [64/1147] 31 Check REPORT for more details. 32 33 [Failed List]: 34 FAIL __fwritable [signal Segmentation fault] 35 FAIL __fwriting [signal Segmentation fault] 36 FAIL a_stack_chk_fail [status 255] 37 FAIL asctime [status 1] 38 ... 39 40 [Skip List]: 41 trace_stresstest 42 fatal_message 43 tgkill_ext 44 ... 45 ``` 46 47 注：此bat文件是从WSL映射目录传输文件到单板目录下，由于WSL无法直接访问windows端口，所以在WSL目录中使用可能无法传输用例。 48 494. 若要单独执行测试用例，将编译结果目录下的`runtest`与需要执行的用例传输到单板 50 51 单板执行 `./runtest -w '' {filename}`，例如： 52 53 测试成功，无报错信息 54 ``` 55 # ./runtest -w '' memmem 56 ``` 57 58 测试失败，提示FAIL+用例名+错误码 59 ``` 60 # ./runtest -w '' pthread_atfork-errno-clobber 61 ../../third_party/musl/libc-test/src/regression/pthread_atfork-errno-clobber.c:23: (pid = fork()) == -1 failed: fork succeeded despite rlimit 62 FAIL pthread_atfork-errno-clobber [status 1] 63 ``` 64 65### 三、增加用例 66 67举例：在functional目录中新增用例new_test 68 691. 在libc-test/src/functional目录下新建`new_test.c` 70 712. 编辑libc-test/src/functional目录下的`test_src_functional.gni`，并在`functional_list`末尾添加`"new_test",` 72 733. （可选）利用模板添加编译选项，修改`libc-test/test_template.gni`中编译选项内容或针对指定的用例添加，例如： 74 ``` 75 if (target_name == "tls_init") { 76 cflags += [ "-Wno-literal-range" ] 77 ldflags += [ "-Wl,-rpath=./" ] 78 libs += [ "//${root_out_dir}/${test_lib_dir}/libtls_init_dso.so" ] 79 } 80 ``` 81 823. 执行步骤一（编译）中的编译命令，即可生成对应可执行文件。 83