Scroll to navigation

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 system 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;
The load average over 1 minute.
The load average over 5 minutes.
The load average over 15 minutes.
The timestamp when the above stats where collected in seconds since epoch

SEE ALSO

statgrab(3)

WEBSITE

⟨https://libstatgrab.org/⟩

2019-03-08 libstatgrab