Manual Pages for UNIX Operating System command usage for man getloadavg

Standard C Library Functions                       getloadavg(3C)



NAME
     getloadavg - get system load averages

SYNOPSIS
     #include 

     int getloadavg(double loadavg[], int nelem);


DESCRIPTION
     The getloadavg() function returns the number of processes in
     the  system run queue averaged over various periods of time.
     Up to nelem samples are retrieved and assigned to successive
     elements  of  loadavg[].  The  system imposes a maximum of 3
     samples, representing averages over the last 1,  5,  and  15
     minutes,  respectively.  The LOADAVG_1MIN, LOADAVG_5MIN, and
     LOADAVG_15MIN indices, defined in  ,  can  be
     used to extract the data from the appropriate element of the
     loadavg[] array.

RETURN VALUES
     Upon successful completion, the number of  samples  actually
     retrieved is returned. If the load average was unobtainable,
     -1 is returned and errno is set to indicate the error.

ERRORS
     The getloadavg() function will fail if:

     EINVAL    The number of elements specified is less than 0.


USAGE
     If the caller is in a non-global zone and the pools facility
     is  active,  the  behavior  of getloadavg() is equivalent to
     that  of  pset_getloadavg(3C)  called  with  psetid  set  to
     PS_MYID.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Async-Signal-Safe           |
    |_____________________________|_____________________________|


SEE ALSO




SunOS 5.11          Last change: 28 Jun 2004                    1






Standard C Library Functions                       getloadavg(3C)



     uptime(1),      w(1),       pooladm(1M),       Kstat(3PERL),
     pset_getloadavg(3C), standards(5)





















































SunOS 5.11          Last change: 28 Jun 2004                    2