svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
zs_usage_read(3zonestat)
zs_usage(3ZONESTAT) Zones Statistics Library Functions zs_usage(3ZONESTAT)
NAME
zs_usage, zs_usage_read, zs_usage_diff, zs_usage_free - read system
configuration and utilization
SYNOPSIS
cc [ flag ... ] file... -lzonestat [ library ... ]
#include <zonestat.h>
zs_usage_t zs_usage_read(zs_ctl_t ctl);
zs_usage_t zs_usage_diff(zs_usage_t u1, zs_usage_t u2);
void zs_usage_free(zs_usage_t zsctl);
DESCRIPTION
The zs_usage_read() function reads the system configuration and uti‐
lization with respect to zones, memory, and CPU.
Each zs_usage_read() will return a zs_usage_t object, which includes
the following information:
o The current system resources and their utilization.
o The currently running zones. All properties reflect the cur‐
rent running state of each zone.
o The usage of each resource by each zone.
o The usage by each zone of its configured limits.
o The currently existing processor sets. All properties and
usages reflect the current running state of each processor
set.
o The usage of each processor set by each zone utilizing it.
Increasing utilization values are described libzonestat(3LIB). Increas‐
ing values continually increase, starting at zero from the point at
which zs_open(3ZONESTAT) was first called.
For all other utilization values, utilization information will be the
usage at the point in time at which zs_usage_read() is called.
For zones and processors sets that were booted or created after
zs_open() was called, the increasing usage values will be usage since
the most recent boot or creation before the call to zs_usage_read().
The zs_usage_diff() function computes and returns the utilization dif‐
ferences between two zs_usage_t objects returned by zs_usage_read().
Both u1 and u2 must be read from the same zsctl object. u2 must be read
after u1.
The purpose of zs_usage_diff() is to simplify the comparison of zs_us‐
age_read() calls made at a interval.
The returned zs_usage_t object will contain:
o The current system resources, as they exist in u2.
o The zones and processor sets that exist in u2.
o For increasing utilization values, the value of (u2 - u1).
If a specific value does not exist in u1 (such as the CPU
utilization for a zone in u2 which does not exist in u1),
the value will be the value from u2.
o For non-increasing utilization values, the value of u2.
The zs_usage_free() function frees the memory associated with a zs_us‐
age_t object returned by zs_usage_read() or zs_usage_diff().
RETURN VALUES
On success, zs_usage_free() and zs_usage_diff() return a pointer to a
zonestat usage object. On failure, zs_open() returns NULL.
ERRORS
The zs_usage_diff() function will fail if:
EAGAIN Insufficient resources are available.
ENOMEM Insufficient memory is available.
The zs_usage_read() function will fail if:
EAGAIN Insufficient resources are available.
EINTR A signal was caught.
ENOMEM Insufficient memory is available.
ESRCH Unable to connect to the zones monitoring service. See Notes.
EXAMPLES
Example 1 Read zone CPU utilization.
The following example uses zs_usage_read() to read each zones CPU uti‐
lization at a regular interval.
#include <zonestat.h>
...
extern int time_to_quit; /* hypothetical quit notification */
...
zs_ctl_t ctl;
zs_usage_t last;
zs_usage_t next;
zs_usage_t diff;
zs_zone_t zone;
timestruct_t time;
uint64_t cpus;
ctl = zs_open(); /* Open zone statistics */
last = zs_usage_read(); /* Read initial usage */
for (;;) {
sleep(10);
next = zs_usage_read();
diff = zs_usage_diff(last, next);
/* Walk zones in usage data */
for (zone = zs_zone_first(diff); zone != NULL ;
zone = zs_zone_next(diff, zone)) {
/*
* fetch cpu time used by zone over interval in terms of
* seconds and nanoseconds
*/
zs_resource_used_zone_time(zone, ZS_RESOURCE_CPU,
&time);
/*
* fetch cpu time used by zone over interval in terms of
* cpu used. 100 equals one cpu. For example, a
* value of 250 means the zone used 2.5 cpus worth of
* time between last and next.
*/
cpus = zs_resource_used_zone_uint64(zone, ZS_RESOURCE_CPU);
}
zs_usage_free(diff);
zs_usage_free(last);
last = next;
if (time_to_quit)
break;
}
zs_usage_free(last);
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Interface StabilityCommitted _ MT-LevelSee below
The zs_usage_*() functions are MT-safe, with the exception that only
one thread may actively use a zs_ctl_t * object at any time. Synchro‐
nization is left to the application.
SEE ALSO
zonestat(1), libpool(3LIB), libzonestat(3LIB), zs_open(3ZONESTAT),
zs_property(3ZONESTAT), zs_pset(3ZONESTAT), zs_pset_zone(3ZONESTAT),
zs_resource(3ZONESTAT), zs_zone(3ZONESTAT), attributes(7), resource-
controls(7), pooladm(8), psrset(8), rcapadm(8), swap(8), zoneadm(8),
zonestatd(8)
NOTES
The service svc:/system/zones-monitoring:default must be enabled in the
global zone in order for zs_usage_read() to succeed. This requirement
exists for use of libzonestat(3LIB) in both the global zone and non-
global zones.
If the zones-monitoring service goes off line, ESRCH will be returned.
At this point the zsctl object is no longer usable. Use zs_close(zsctl)
and use zs_open(3ZONESTAT) to reconnect.
Oracle Solaris 11.4 13 Nov 2020 zs_usage(3ZONESTAT)