sg_get_load_stats, sg_get_load_stats_r, sg_free_load_stats — get system load
#include <statgrab.h>
sg_load_stats *sg_get_load_stats( | entries); |
size_t *entries;sg_load_stats *sg_get_load_stats_r( | entries); |
size_t *entries;sg_error sg_free_load_stats( | data); |
sg_load_stats *data;These calls returns a pointer to a buffer containing information about cumulated machine load.
Table 1. API Shortcut
| function | returns | data owner |
|---|---|---|
| sg_get_load_stats | sg_load_stats * | libstatgrab (thread local) |
| sg_get_load_stats_r | sg_load_stats * | caller |
The sg_load_stats buffer received from
sg_get_load_stats_r() must be freed using
sg_free_load_stats() when not needed any more. The
caller is responsible for doing it.
On most systems this function is just a wrapper to the
getloadavg system call.
The structure returned is of type sg_load_stats.
typedef struct{
double min1;
double min5;
double min15;
time_t systime;
}sg_load_stats;
min1The load average over 1 minute.
min5The load average over 5 minutes.
min15The load average over 15 minutes.
systimeThe timestamp when the above stats where collected in seconds since epoch