[Bug] wrong impl of vsnprintf
维护者通常 2 天内回复
@luchenxu73 已经在做这个了。
开始于 2026年9月24日。
评估
这个 Issue 还没有评估数据。
描述
RT-Thread Version
5.x
Affected area
Kernel
Hardware/BSP vendor
Not applicable / Other
Architecture
Not applicable / Other
Board and hardware details
Any hardware
Develop Toolchain
GCC
Describe the bug
vsnprintf 实现缺陷
当前的 rt_vsnprintf 实现存在缺陷,尤其是tiny版本。
实现问题
对于当前的实现,%[width].[precision]s当前实现存在错误。
假定输入为 "abcdef":
| 格式化字符串 | 预期 | tiny 实际 | 备注 |
|---|---|---|---|
%3s |
"abcdef" |
"abc" |
3应当是最小宽度,不是最大宽度 |
%-3s |
"abcdef" |
"abc" |
左对齐同上 |
%*s |
"abcdef" |
"" |
宽度参数为 0;零宽度不应禁止输出 |
%.0s |
"" |
"abcdef" |
未处理零精度 |
%.s |
"" |
"abcdef" |
只有点号等价于精度为 0 |
%.*s |
"" |
"abcdef" |
精度参数为 0;动态零精度同样未生效 |
%5.0s |
"·····" |
"abcde" |
应只填充五个空格,实际输出了五个字符串字符 |
%3.5s |
"abcde" |
"abc" |
综合性问题,应由精度限制为五个字符,实际被宽度截成三个 |
%.3s |
"abc",不越界读取 |
越界读取,输出不确定 | 输入为 char src[3] = {'a','b','c'},没有终止符;原版先扫描,再应用精度 |
此外,tiny版本没有处理负数精度的场景,例如 "%.*s", -3, "abcdef",但是被前面的bug拦截住了,恰好正确。
%d的实现也有点问题:
| 格式化字符串 | 预期 | tiny 实际(修复前) | 备注 |
|---|---|---|---|
%.0d, 5 |
"5" |
"" |
精度 0 是"最少 0 位",数值仍应输出;修复前整个数字被吞 |
%.*d, -1, 5 |
"5" |
"" |
负精度应视为"未指定精度";修复前被当成精度 0,同样吞掉数字 |
%.0x, 255 |
"ff" |
"" |
与 %.0d 同一 bug,非零值被吞 |
以及,一种内存安全问题:
如果没有 \0 结尾,但是指定精度,其实是可以的。
char s[] = {'A', 'B', 'C'};
snprintf(buf, sizeof(buf), "%.3s", s);
当前的访问实现会越界读取,因为调用了 strnlen_s_来获取长度,但s可能根本不以 \0 结尾。glibc、musl等常见的libc是没问题的,嵌入式C库不确定,这个测试用例就不给三方库测了,就rtt自己加了测试用例。
测试用例
测试用例疑似有些场景被刻意绕过,例如下面的用例,显然是tiny版本实现错误,不应当与Stand版本区别对待。
SPRINTF_TEST_CASE(width)
{
char buffer[base_buffer_size];
// 为什么???
#ifdef RT_KLIBC_USING_VSNPRINTF_STANDARD
SPRINTF_CHECK("Hello testing", buffer, "%1s", "Hello testing");
#endif /* RT_KLIBC_USING_VSNPRINTF_STANDARD */
SPRINTF_CHECK("1024", buffer, "%1d", 1024);
}
还有一些用例设计的不太好,RT_KLIBC_USING_VSNPRINTF_DECIMAL_SPECIFIERS 宏是用于控制 %f和%F的,但里面包含了%s的用例,本来这些用例能够拦截tiny版本的实现问题,但这个宏仅在standard版本生效,因此用例被忽略,导致漏测:
SPRINTF_TEST_CASE(misc)
{
char buffer[base_buffer_size];
SPRINTF_CHECK("53000atest-20 bit", buffer, "%u%u%ctest%d %s", 5, 3000, 'a', -20, "bit");
#ifdef RT_KLIBC_USING_VSNPRINTF_DECIMAL_SPECIFIERS
SPRINTF_CHECK("0.33", buffer, "%.*f", 2, 0.33333333);
SPRINTF_CHECK("1", buffer, "%.*d", -1, 1);
// 例如这个用例不应该放在宏里面
SPRINTF_CHECK("foo", buffer, "%.3s", "foobar");
SPRINTF_CHECK(" ", buffer, "% .0d", 0);
SPRINTF_CHECK(" 00004", buffer, "%10.5d", 4);
SPRINTF_CHECK("hi x", buffer, "%*sx", -3, "hi");
SPRINTF_CHECK("00123 ", buffer, "%-20.5i", 123);
SPRINTF_CHECK("-67224.546875000000000000", buffer, "%.18f", -67224.546875);
#endif /* RT_KLIBC_USING_VSNPRINTF_DECIMAL_SPECIFIERS */
#ifdef RT_KLIBC_USING_VSNPRINTF_EXPONENTIAL_SPECIFIERS
SPRINTF_CHECK("0.33", buffer, "%.*g", 2, 0.33333333);
SPRINTF_CHECK("3.33e-01", buffer, "%.*e", 2, 0.33333333);
SPRINTF_CHECK("0.000000e+00", buffer, "%e", 0.0);
// SPRINTF_CHECK("-0.000000e+00", buffer, "%e", -0.0);
#endif /* RT_KLIBC_USING_VSNPRINTF_EXPONENTIAL_SPECIFIERS */
}
Other additional context
No response
- 主要语言
- C
- 星标
- 12.4k
- 派生
- 5.5k
- 平均合并
- 3 天 7 小时
- 30 天内合并 PR
- 79
环境准备
在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
RT-Thread/rt-thread 的其他 Issue
-
Arch: ARM/AArch64 Doc
难度 1/5 1 小时以内 新手友好度 90/100
RT-Thread/rt-thread#12082 · 1 条评论 ·
维护者通常 2 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 67/100
RT-Thread/rt-thread#11951 · 2 条评论 ·
维护者通常 2 天内回复
-
[Bug] [libc] timer_gettime 拆秒前将总纳秒截断为 uint32_t,剩余时间查询错误可能重新可做 @Yunlk 于 28 天前认领,目前没有进行中的 PR。 未关闭in progress
难度 2/5 1-3 小时 新手友好度 68/100
RT-Thread/rt-thread#11924 · 7 条评论 · 已指派 1 人 ·
维护者通常 2 天内回复
-
[Bug] dfs_v2 tmpfs: ftruncate(fd, 0) frees the file buffer but reports success — use-after-free read/write and double free from a legal POSIX call可能已有人在做 @remukisama 于 33 天前认领。 未关闭in progress
难度 2/5 1-3 小时 新手友好度 78/100
RT-Thread/rt-thread#11902 · 4 条评论 · 已指派 1 人 ·
维护者通常 2 天内回复
-
[bsp][stm32][bluepill] README「快速上手」缺少重新生成 MDK 工程这一步,按文档操作无法编译通过可能重新可做 @moment-NEW 于 50 天前认领,目前没有进行中的 PR。 未关闭in progress
难度 2/5 1-3 小时 新手友好度 75/100
RT-Thread/rt-thread#11818 · 4 条评论 · 已指派 1 人 ·
维护者通常 2 天内回复
查看 RT-Thread/rt-thread 的全部 Issue
相似的 Issue
-
Builder: a structure opened without calculation data shows the Diffraction (fibre) view by default未关闭bug
难度 2/5 1-3 小时 新手友好度 65/100
FriendsofECCE/ECCE#1245 · 1 条评论 ·
-
难度 2/5 1-3 小时 新手友好度 72/100
apache/nuttx-apps#4108 · 4 条评论 ·
维护者通常 1 天内回复
-
bug
难度 1/5 1 小时以内 新手友好度 84/100
VirtualBox/virtualbox#996 ·
维护者通常 6 天内回复
-
难度 1/5 1 小时以内 新手友好度 82/100
trezor/trezor-firmware#8357 ·
维护者通常 2 天内回复
-
难度 2/5 1-3 小时 新手友好度 76/100
维护者通常 1 天内回复