sg_get_load_stats(3)sg_get_load_stats(3)NAME
sg_get_load_stats, sg_get_load_stats_r, sg_free_load_stats - get system
load
SYNOPSIS
#include <statgrab.h>
sg_load_stats *sg_get_load_stats (size_t *entries);
sg_load_stats *sg_get_load_stats_r (size_t *entries);
sg_error sg_free_load_stats (sg_load_stats *data);
DESCRIPTION
These calls returns a pointer to a buffer containing information about
cumulated machine load.
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 sys‐
tem call.
RETURN VALUES
The structure returned is of type sg_load_stats.
typedef struct{
double min1;
double min5;
double min15;
time_t systime;
}sg_load_stats;
min1 The load average over 1 minute.
min5 The load average over 5 minutes.
min15 The load average over 15 minutes.
systime
The timestamp when the above stats where collected in seconds
since epoch
SEE ALSOstatgrab(3)WEBSITE
⟨http://www.i-scream.org/libstatgrab/⟩
i-scream 2013-06-17 sg_get_load_stats(3)