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;

       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 ALSO

       statgrab(3)

WEBSITE

       ⟨https://libstatgrab.org/⟩