libc_core/arch/
mod.rs

1//! This module provides the `libc` types for each architecture.
2
3#[cfg(target_arch = "aarch64")]
4pub mod aarch64;
5#[cfg(target_arch = "aarch64")]
6pub use aarch64::{MContext, UContext};
7#[cfg(target_arch = "loongarch64")]
8pub mod loongarch64;
9#[cfg(target_arch = "loongarch64")]
10pub use loongarch64::{MContext, UContext};
11#[cfg(target_arch = "riscv64")]
12pub mod riscv64;
13#[cfg(target_arch = "riscv64")]
14pub use riscv64::{MContext, UContext};
15#[cfg(target_arch = "x86_64")]
16pub mod x86_64;
17#[cfg(target_arch = "x86_64")]
18pub use x86_64::{MContext, UContext};
19
20use crate::types::TimeSpec;
21
22bitflags! {
23    /// 信号处理栈的标志位，控制备用信号栈（alternate signal stack）的行为。
24    #[derive(Debug, Clone)]
25    pub struct SignalStackFlags: u32 {
26        /// 当前正在备用信号栈上执行（内核设置此位，用户态只读）。
27        const ONSTACK = 1;
28        /// 禁用备用信号栈（不会在该栈上调用信号处理函数）。
29        const DISABLE = 2;
30        /// 当信号处理程序在备用栈上返回时自动禁用备用栈（Linux 特有）。
31        const AUTODISARM = 0x80000000;
32    }
33}
34
35/// 备用信号栈（alternate signal stack）
36///
37/// MUSL: <https://github.com/bminor/musl/blob/c47ad25ea3b484e10326f933e927c0bc8cded3da/arch/x86_64/bits/signal.h#L91>
38#[repr(C)]
39#[derive(Debug, Clone)]
40pub struct UStack {
41    /// 栈顶指针（备用信号栈的栈顶地址，通常是向下增长的内存区域）。
42    /// 对应 C 中的 void *ss_sp;
43    pub sp: usize,
44    /// 标志位，表示备用栈的状态，比如是否启用、是否正在使用等。
45    /// 对应 C 中的 int ss_flags;
46    pub flags: SignalStackFlags,
47    /// 栈的大小（以字节为单位），表示备用信号栈的长度。
48    /// 对应 C 中的 size_t ss_size;
49    pub size: usize,
50}
51
52bitflags! {
53    /// 文件的状态信息，类似于 Linux 中的 `stat` 结构体。
54    #[derive(Debug, Default, PartialEq)]
55    pub struct StatMode: u32 {
56        /// Null
57        const NULL  = 0;
58        /// Type
59        const TYPE_MASK = 0o170000;
60        /// FIFO
61        const FIFO  = 0o010000;
62        /// character device
63        const CHAR  = 0o020000;
64        /// directory
65        const DIR   = 0o040000;
66        /// block device
67        const BLOCK = 0o060000;
68        /// ordinary regular file
69        const FILE  = 0o100000;
70        /// symbolic link
71        const LINK  = 0o120000;
72        /// socket
73        const SOCKET = 0o140000;
74
75        /// Set-user-ID on execution.
76        const SET_UID = 0o4000;
77        /// Set-group-ID on execution.
78        const SET_GID = 0o2000;
79
80        /// Read, write, execute/search by owner.
81        const OWNER_MASK = 0o700;
82        /// Read permission, owner.
83        const OWNER_READ = 0o400;
84        /// Write permission, owner.
85        const OWNER_WRITE = 0o200;
86        /// Execute/search permission, owner.
87        const OWNER_EXEC = 0o100;
88
89        /// Read, write, execute/search by group.
90        const GROUP_MASK = 0o70;
91        /// Read permission, group.
92        const GROUP_READ = 0o40;
93        /// Write permission, group.
94        const GROUP_WRITE = 0o20;
95        /// Execute/search permission, group.
96        const GROUP_EXEC = 0o10;
97
98        /// Read, write, execute/search by others.
99        const OTHER_MASK = 0o7;
100        /// Read permission, others.
101        const OTHER_READ = 0o4;
102        /// Write permission, others.
103        const OTHER_WRITE = 0o2;
104        /// Execute/search permission, others.
105        const OTHER_EXEC = 0o1;
106    }
107}
108
109#[repr(C)]
110#[derive(Debug, Default)]
111#[cfg(not(target_arch = "x86_64"))]
112/// MUSL: <https://github.com/bminor/musl/blob/c47ad25ea3b484e10326f933e927c0bc8cded3da/arch/aarch64/kstat.h#L1>
113/// 文件的状态信息，类似于 Linux 中的 `stat` 结构体。
114pub struct Stat {
115    /// 设备号，表示文件所在设备的标识符。
116    pub dev: u64,
117    /// inode 号，表示文件在文件系统中的唯一标识符。
118    pub ino: u64,
119    /// 文件类型和访问权限，使用 `StatMode` 类型表示。
120    pub mode: StatMode,
121    /// 文件的硬链接数，表示指向该文件的链接数量。
122    pub nlink: u32,
123    /// 文件所有者的用户ID（UID）。
124    pub uid: u32,
125    /// 文件所有者的组ID（GID）。
126    pub gid: u32,
127    /// 设备文件的设备号，表示特殊设备文件的主设备号和次设备号。
128    pub rdev: u64,
129    /// 保留字段，用于对齐或将来扩展使用。
130    pub __pad: u64,
131    /// 文件的大小，以字节为单位。
132    pub size: u64,
133    /// 文件的块大小，文件系统为文件分配的块的大小。
134    pub blksize: u32,
135    /// 保留字段，用于对齐或将来扩展使用。
136    pub __pad2: u32,
137    /// 文件的占用块数，文件占用的实际磁盘块数。
138    pub blocks: u64,
139    /// 文件的最后访问时间（以 `TimeSpec` 表示）。
140    pub atime: TimeSpec,
141    /// 文件的最后修改时间（以 `TimeSpec` 表示）。
142    pub mtime: TimeSpec,
143    /// 文件的最后状态变更时间（以 `TimeSpec` 表示）。
144    pub ctime: TimeSpec,
145}
146
147#[repr(C)]
148#[derive(Debug, Default)]
149#[cfg(target_arch = "x86_64")]
150/// 文件的状态信息，类似于 Linux 中的 `stat` 结构体。
151///
152/// MUSL: <https://github.com/bminor/musl/blob/c47ad25ea3b484e10326f933e927c0bc8cded3da/arch/x86_64/bits/stat.h#L4>
153/// 在 x86_64上, blksize_t 的大小为 8 字节, 而不是 4 字节，指向 long
154pub struct Stat {
155    /// 设备号，表示文件所在设备的标识符。
156    pub dev: u64,
157    /// inode 号，表示文件在文件系统中的唯一标识符。
158    pub ino: u64,
159    /// 文件的硬链接数，表示指向该文件的链接数量。
160    pub nlink: u64,
161    /// 文件类型和访问权限，使用 `StatMode` 类型表示。
162    pub mode: StatMode,
163    /// 文件所有者的用户ID（UID）。
164    pub uid: u32,
165    /// 文件所有者的组ID（GID）。
166    pub gid: u32,
167    /// 填充字段，确保结构体大小对齐。
168    pub _pad0: u32,
169    /// 设备文件的设备号，表示特殊设备文件的主设备号和次设备号。
170    pub rdev: u64,
171    /// 文件的大小，以字节为单位。
172    pub size: u64,
173    /// 文件的块大小，文件系统为文件分配的块的大小。
174    pub blksize: u64,
175    /// 文件的占用块数，文件占用的实际磁盘块数。
176    pub blocks: u64,
177    /// 文件的最后访问时间（以 `TimeSpec` 表示）。
178    pub atime: TimeSpec,
179    /// 文件的最后修改时间（以 `TimeSpec` 表示）。
180    pub mtime: TimeSpec,
181    /// 文件的最后状态变更时间（以 `TimeSpec` 表示）。
182    pub ctime: TimeSpec,
183}
libc_core/arch/mod.rs

libc_core/arch/
mod.rs
