Process Time: Libgtop Reference Manual

Process Time

Process Time — Get process time information

Stability Level

Stable, unless otherwise indicated

Functions

void	glibtop_get_proc_time ()

Types and Values

struct

glibtop_proc_time

Includes

#include <glibtop/proctime.h>

Description

Functions

glibtop_get_proc_time ()

void
glibtop_get_proc_time (glibtop_proc_time *buf,
                       pid_t pid);

Get process time information.

Parameters

buf	Returned process time information - see glibtop_proc_time.
pid	Process id

Types and Values

struct glibtop_proc_time

struct glibtop_proc_time {
	guint64 start_time;
	guint64 rtime;
	guint64 utime;
	guint64 stime;
	guint64 cutime;
	guint64 cstime;
	guint64 timeout;
	guint64 it_real_value;
	guint64 frequency;
	guint64 xcpu_utime [GLIBTOP_NCPU];
	guint64 xcpu_stime [GLIBTOP_NCPU];
};

Process time data filled by glibtop_get_proc_time().

Under Linux the start_time value may be wrong due to the information available from the kernel.

The Linux kernel defines INITIAL_JIFFIES which implies a time shift. Because INITIAL_JIFFIES is not user-space defined, we cannot use it to compute an accurate start_time . On Linux 2.6,

INITIAL_JIFFIES is 300 so start_time is

always 3s different from the real start time of the given process. You may also get shift results if your system clock is not synchronised with your hardware clock. See man hwclock.

Members

guint64 `start_time`;	Start time of process in seconds since the epoch.
guint64 `rtime`;	Real time accumulated by process (should be `utime` + `stime` ).
guint64 `utime`;	User-mode CPU time accumulated by process.
guint64 `stime`;	Kernel-mode CPU time accumulated by process.
guint64 `cutime`;	Cumulative utime of process and reaped children.
guint64 `cstime`;	Cumulative stime of process and reaped children.
guint64 `timeout`;	The time (in jiffies) of the process’s next timeout.
guint64 `it_real_value`;	The time (in jiffies) before the next SIGALRM is sent to the process due to an interval timer.
guint64 `frequency`;	Tick frequency.
guint64 `xcpu_utime`[GLIBTOP_NCPU];	SMP user-mode CPU time accumulated by process.
guint64 `xcpu_stime`[GLIBTOP_NCPU];	SMP kernel-mode CPU time accumulated by process