Method System.getrusage()

Method getrusage

mapping(string:int) getrusage()

Description

Return resource usage about the current process. An error is thrown if it isn't supported or if the system fails to return any information.

Returns

Returns a mapping describing the current resource usage:

"utime" : int	Time in milliseconds spent in user code.
"stime" : int	Time in milliseconds spent in system calls.
"maxrss" : int	Maximum used resident size in kilobytes. [1]
"ixrss" : int	Quote from GNU libc: An integral value expressed in kilobytes times ticks of execution, which indicates the amount of memory used by text that was shared with other processes. [1]
"idrss" : int	Quote from GNU libc: An integral value expressed the same way, which is the amount of unshared memory used for data. [1]
"isrss" : int	Quote from GNU libc: An integral value expressed the same way, which is the amount of unshared memory used for stack space. [1]
"minflt" : int	Minor page faults, i.e. TLB misses which required no disk I/O.
"majflt" : int	Major page faults, i.e. paging with disk I/O required.
"nswap" : int	Number of times the process has been swapped out entirely.
"inblock" : int	Number of block input operations.
"oublock" : int	Number of block output operations.
"msgsnd" : int	Number of IPC messsages sent.
"msgrcv" : int	Number of IPC messsages received.
"nsignals" : int	Number of signals received.
"nvcsw" : int	Number of voluntary context switches (usually to wait for some service).
"nivcsw" : int	Number of preemptions, i.e. context switches due to expired time slices, or when processes with higher priority were scheduled.
"sysc" : int	Number of system calls. [2]
"ioch" : int	Number of characters read and written. [2]
"rtime" : int	Elapsed real time (ms). [2]
"ttime" : int	Elapsed system trap (system call) time (ms). [2]
"tftime" : int	Text page fault sleep time (ms). [2]
"dftime" : int	Data page fault sleep time (ms). [2]
"kftime" : int	Kernel page fault sleep time (ms). [2]
"ltime" : int	User lock wait sleep time (ms). [2]
"slptime" : int	Other sleep time (ms). [2]
"wtime" : int	Wait CPU (latency) time (ms). [2]
"stoptime" : int	Time spent in stopped (suspended) state. [2]
"brksize" : int	Heap size. [3]
"stksize" : int	Stack size. [3]

Note

[1] Not if /proc rusage is used.

[2] Only from (Solaris?) /proc rusage.

[3] Only from /proc PRS usage.

On some systems, only utime will be filled in.

See also

gethrvtime()