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}