程序14-30 linux/include/sys/resource.h
1 /*
2 * Resource control/accounting header file for linux
3 */
/*
* Linux资源控制/审计头文件。
4
5 #ifndef _SYS_RESOURCE_H
6 #define _SYS_RESOURCE_H
7
// 以下符号常数和结构用于getrusage()。参见kernel/sys.c文件第412行开始。
8 /*
9 * Definition of struct rusage taken from BSD 4.3 Reno
10 *
11 * We don't support all of these yet, but we might as well have them....
12 * Otherwise, each time we add new items, programs which depend on this
13 * structure will lose. This reduces the chances of that happening.
14 */
/*
* rusage结构的定义取自BSD 4.3 Reno系统。
*
* 我们现在还没有支持该结构中的所有这些字段，但我们可能会支持它们的....
* 否则的话，每当我们增加新的字段，那些依赖于这个结构的程序就会出问题。
* 现在把所有字段都包括进来就可以避免这种事情发生。
*/
// 下面是getrusage()的参数who所使用的符号常数。
15 #define RUSAGE_SELF 0 // 返回当前进程的资源利用信息。
16 #define RUSAGE_CHILDREN -1 // 返回当前进程已终止和等待着的子进程的资源利用信息。
17
// rusage是进程的资源利用统计结构，用于getrusage()返回指定进程对资源利用的统计值。
// Linux 0.12内核仅使用了前两个字段，它们都是timeval结构（include/sys/time.h）。
// ru_utime – 进程在用户态运行时间统计值；ru_stime – 进程在内核态运行时间统计值。
18 struct rusage {
19 struct timeval ru_utime; /* user time used */
20 struct timeval ru_stime; /* system time used */
21 long ru_maxrss; /* maximum resident set size */
22 long ru_ixrss; /* integral shared memory size */
23 long ru_idrss; /* integral unshared data size */
24 long ru_isrss; /* integral unshared stack size */
25 long ru_minflt; /* page reclaims */
26 long ru_majflt; /* page faults */
27 long ru_nswap; /* swaps */
28 long ru_inblock; /* block input operations */
29 long ru_oublock; /* block output operations */
30 long ru_msgsnd; /* messages sent */
31 long ru_msgrcv; /* messages received */
32 long ru_nsignals; /* signals received */
33 long ru_nvcsw; /* voluntary context switches */
34 long ru_nivcsw; /* involuntary " */
35 };
36
// 下面是getrlimit()和setrlimit()使用的符号常数和结构。
37 /*
38 * Resource limits
39 */
/*
* 资源限制。
*/
// 以下是Linux 0.12内核中所定义的资源种类，是getrlimit()和setrlimit()中第1个参数
// resource 的取值范围。 其实这些符号常数就是进程任务结构中 rlim[] 数组的项索引值。
// rlim[]数组的每一项都是一个rlimit结构，该结构见下面第58行。
40
41 #define RLIMIT_CPU 0 /* CPU time in ms */ /* 使用的CPU时间 */
42 #define RLIMIT_FSIZE 1 /* Maximum filesize */ /* 最大文件长度 */
43 #define RLIMIT_DATA 2 /* max data size */ /* 最大数据长度 */
44 #define RLIMIT_STACK 3 /* max stack size */ /* 最大栈长度 */
45 #define RLIMIT_CORE 4 /* max core file size */ /* 最大core文件长度 */
46 #define RLIMIT_RSS 5 /* max resident set size */ /* 最大驻留集大小 */
47
// 如果定义了符号notdef，则也包括以下符号常数定义。
48 #ifdef notdef
49 #define RLIMIT_MEMLOCK 6 /* max locked-in-memory address space*/ /* 锁定区 */
50 #define RLIMIT_NPROC 7 /* max number of processes */ /* 最大子进程数 */
51 #define RLIMIT_OFILE 8 /* max number of open files */ /* 最大打开文件数 */
52 #endif
53
// 这个符号常数定义了Linux中限制的资源种类。RLIM_NLIMITS=6，因此仅前面6项有效。
54 #define RLIM_NLIMITS 6
55
// 表示资源无限，或不能修改。
56 #define RLIM_INFINITY 0x7fffffff
57
// 资源界限结构。
58 struct rlimit {
59 int rlim_cur; // 当前资源限制，或称软限制（soft limit）。
60 int rlim_max; // 硬限制（hard limit）。
61 };
62
63 #endif /* _SYS_RESOURCE_H */
64