libc_core/
resource.rs

1//! This module provides the `libc` types for Resource (system resource management).
2//!
3//! MUSL: <https://github.com/bminor/musl/blob/c47ad25ea3b484e10326f933e927c0bc8cded3da/include/sys/resource.h>
4
5use crate::types::TimeVal;
6
7/// 资源限制结构体(对应 C 的 `struct rlimit`)
8/// 用于描述进程对某种资源的当前限制和最大限制
9#[repr(C)]
10#[derive(Debug, Clone)]
11pub struct Rlimit {
12    /// 当前资源软限制(soft limit),即实际生效的限制值
13    /// 进程可以在不超过 `max` 的情况下修改它
14    pub curr: usize,
15    /// 最大资源限制(hard limit),软限制不能超过该值
16    /// 只有具有特权的进程才能提升此值
17    pub max: usize,
18}
19
20/// 资源使用情况结构体(对应 C 的 `struct rusage`)
21/// 记录进程或线程的时间和资源消耗信息
22/// MUSL: <https://github.com/bminor/musl/blob/c47ad25ea3b484e10326f933e927c0bc8cded3da/include/sys/resource.h#L27>
23#[repr(C)]
24pub struct Rusage {
25    /// 用户态运行时间(单位:秒 + 微秒)
26    pub utime: TimeVal,
27    /// 内核态运行时间(单位:秒 + 微秒)
28    pub stime: TimeVal,
29    /// 最大常驻集大小(单位:KB),即内存占用峰值
30    pub maxrss: i64,
31    /// 索引页的使用数量(已废弃)
32    pub ixrss: i64,
33    /// 数据段内存使用量(已废弃)
34    pub idrss: i64,
35    /// 堆栈段内存使用量(已废弃)
36    pub isrss: i64,
37    /// 页面缺页异常数(软缺页,不涉及磁盘 IO)
38    pub minflt: i64,
39    /// 主缺页异常数(硬缺页,需要从磁盘读取页面)
40    pub majflt: i64,
41    /// 发生的交换(swap)次数
42    pub nswap: i64,
43    /// 输入操作(块设备读取)的次数
44    pub inblock: i64,
45    /// 输出操作(块设备写入)的次数
46    pub oublock: i64,
47    /// 发送的 IPC 消息数(已废弃)
48    pub msgsnd: i64,
49    /// 接收的 IPC 消息数(已废弃)
50    pub msgrcv: i64,
51    /// 捕获的信号数量
52    pub nsignals: i64,
53    /// 自愿上下文切换次数(如等待锁)
54    pub nvcsw: i64,
55    /// 非自愿上下文切换次数(被内核抢占)
56    pub nivcsw: i64,
57}