Files
scc/libs/sccf/include/sccf.h
zzy 02a6c684f1 feat(ast2ir): 添加左值标识支持以改善表达式处理
- 在 scc_ast2ir_expr 函数中添加 is_lvalue 参数来区分左值和右值表达式
- 更新二元表达式处理逻辑,特别是赋值操作符的处理
- 改进标识符表达式的处理,根据是否为左值决定返回存储位置还是加载值
- 修复哈希比较函数的实现
- 移除调试相关的注释代码

refactor(parser): 优化语法分析器错误处理和控制流

- 移除不必要的错误恢复辅助注释
- 修改表达式解析的控制流程,将直接返回改为使用 break 语句
- 添加语义分析回调,在解析完成后进行标识符查找和验证

refactor(sema): 增强语义分析阶段的符号表管理

- 改进标识符查找逻辑,增加对非变量标识符的检查
- 扩展声明处理范围,包括变量和参数声明的符号表注册
- 为函数声明添加作用域管理

fix(parser): 修正单元测试中的类型定义

- 将 long long 类型定义改为 int 类型,解决测试兼容性问题

refactor(sccf): 重构文件格式定义和构建器实现

- 重命名符号类型枚举值 OBJECT 为 EXTERN
- 重命名段类型枚举值 RELOC 为 RELOCS
- 修正结构体字段命名的一致性问题
- 重新设计 SCCF 构建器的数据结构和API
- 添加符号表、字符串表和重定位表的构建支持

refactor(target): 重命名Windows PE相关类型定义

- 将 scc_winpe_* 类型重命名为 scc_pe_* 以保持命名一致性

chore: 添加 sccf2target 模块用于格式转换

- 创建新的库模块用于 SCCF 到目标格式的转换
- 实现 PE 格式转换的基本功能
- 添加示例程序演示格式转换过程
2026-03-19 12:11:57 +08:00

158 lines
5.0 KiB
C

/**
* @file sccf.h
* @brief scc format (sccf) 头文件
*
* SCCF是一个极简的可执行可链接文件格式, 专注于内部链接处理,
* 同时提供外部符号导入/导出的抽象接口。
*/
#ifndef __SCC_FORMAT_H__
#define __SCC_FORMAT_H__
#include <stdint.h>
#define sccf_byte_t uint8_t
#define sccf_enum_t uint32_t
#define sccf_size_t uint64_t
#define sccf_isize_t int64_t
/** SCCF魔数 */
#define SCCF_MAGIC "SCCFmt\0\0"
/** SCCF版本号 */
#define SCCF_VERSION 1
/** 架构类型 */
typedef enum {
SCCF_ARCH_UNKNOWN = 0, ///< 未知占位符架构
SCCF_ARCH_RISCV32 = 1, ///< RISC-V 32位 小端
SCCF_ARCH_RISCV64 = 2, ///< RISC-V 64位 小端
SCCF_ARCH_X86 = 3, ///< x86 小端
SCCF_ARCH_AMD64 = 4, ///< AMD64 小端
} sccf_arch_t;
/** 文件标志位 */
typedef enum {
SCCF_TYPE_FLAG_EXECUTABLE = 0x01, ///< 可执行文件
SCCF_TYPE_FLAG_RELOCATABLE = 0x02, ///< 可重定位文件
SCCF_TYPE_FLAG_EXE_RELOC = 0x03, ///< 内部链接后的可执行文件
} sccf_type_flags_t;
/** 符号类型 */
typedef enum {
SCCF_SYM_TYPE_UNDEF = 0, ///< 未定义
SCCF_SYM_TYPE_FUNC = 1, ///< 函数
SCCF_SYM_TYPE_DATA = 2, ///< 数据
SCCF_SYM_TYPE_EXTERN = 3, ///< 外部符号
} sccf_sym_type_t;
/** 符号绑定类型 */
typedef enum {
SCCF_SYM_BIND_LOCAL = 0, ///< 局部符号
SCCF_SYM_BIND_GLOBAL = 1, ///< 全局符号
SCCF_SYM_BIND_WEAK = 2, ///< 弱引用
} sccf_sym_bind_t;
/** 符号可见性 */
typedef enum {
SCCF_SYM_VIS_DEFAULT = 0, ///< 默认可见性
SCCF_SYM_VIS_HIDDEN = 1, ///< 隐藏
SCCF_SYM_VIS_PROTECTED = 2, ///< 受保护
} sccf_sym_vis_t;
/** 段类型 */
typedef enum {
SCCF_SECT_NONE = 0, ///< 无
SCCF_SECT_CODE = 1, ///< 代码段
SCCF_SECT_DATA = 2, ///< 数据段
SCCF_SECT_RODATA = 3, ///< 只读数据段
SCCF_SECT_UNINIT_DATA = 4, ///< BSS段(未初始化数据)
SCCF_SECT_SYMTAB = 5, ///< 符号表
SCCF_SECT_STRTAB = 6, ///< 字符串表
SCCF_SECT_RELOCS = 7, ///< 重定位表
} sccf_sect_type_t;
/** 重定位类型 */
typedef enum {
SCCF_RELOC_ABS = 1, ///< 绝对地址
SCCF_RELOC_REL = 2, ///< 相对地址
} sccf_reloc_type_t;
/**
* @brief SCCF文件头
*/
typedef struct sccf_header {
sccf_byte_t magic[8]; ///< 魔数: "SCCFmt\0\0"
sccf_enum_t type; ///< 类型
sccf_enum_t version; ///< 版本号
sccf_enum_t arch; ///< 架构
sccf_size_t entry_point; ///< 入口点在代码段的相对地址
sccf_size_t sect_header_num; ///< 节头数量
sccf_size_t reserved[4]; ///< 保留字段, 可置零
} sccf_header_t;
/**
* @brief SCCF段
*/
typedef struct {
sccf_byte_t name[8]; ///< 段名称 仅供展示 eg. emoji or ".text"
sccf_enum_t sccf_sect_type; ///< 段类型 (内部实际区分的方式)
sccf_size_t size; ///< 段数据实际的大小
sccf_size_t data_size; ///< 段数据的有效数据大小
sccf_size_t addralign; ///< 内存对齐要求 (字节对齐, 如 1,2,4,8,...)
sccf_size_t info; ///< 段信息 (如条目数,链接索引等)
sccf_size_t reserved[2]; ///< 保留
} sccf_sect_header_t;
/**
* @brief SCCF符号表
*/
typedef struct {
sccf_size_t name_offset; ///< 符号名称在字符串表中的偏移量
sccf_enum_t sccf_sym_type; ///< 符号类型
sccf_enum_t sccf_sym_bind; ///< 符号绑定类型
sccf_enum_t sccf_sym_vis; ///< 符号可见性
sccf_enum_t sccf_sect_type; ///< 该符号的段类型
sccf_size_t sccf_sect_offset; ///< 该符号在段中的偏移量
sccf_size_t sccf_sym_size; ///< 该符号选中的大小
} sccf_sym_t;
/**
* @brief SCCF重定向条目
*/
typedef struct {
sccf_enum_t type; ///< 重定位类型
sccf_enum_t sect_type; ///< 需要重定位的段类型(代码段/数据段)
sccf_size_t sym_idx; ///< 符号索引(重定向指向的符号)
sccf_size_t offset; ///< 在段中的偏移量(用于重定向的地址)
sccf_isize_t addend; ///< 加数(用于获取相对位置时PC的额外值)
} sccf_reloc_t;
/**
* @brief sccf 格式结构(可选 填充到某种自定义的对齐
* 默认启用sect_datas的64bytes对齐规则)
*
* @warning 其中sccf_sect_header_t的顺序必须和sccf_sect_data_t一致,
* 但是不规定sect_headers内部的顺序下面顺序仅供参考
*
* sccf_header_t header;
* sccf_sect_header_t sect_headers[header.sect_header_num] = {
* [0] = text_section,
* [1] = data_section,
* [2] = strtab_section,
* [3] = symtab_section,
* [4] = reloc_section,
* [5-...] = other_section,
* };
* sccf_sect_data_t sect_datas[header.sect_header_num][...] = {
* [0] = text_section_data,
* [1] = data_section_data,
* [2] = strtab_section_data,
* [3] = symtab_section_data,
* [4] = reloc_section_data,
* [5-...] = other_section_data,
* };
*/
#endif /* __SCC_FORMAT_H__ */