svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
zs_resource(3zonestat)
zs_...urce(3ZONESTAT) Zones Statistics Library Functions zs_...urce(3ZONESTAT)
NAME
zs_resource, zs_resource_property, zs_resource_type, zs_resource_to‐
tal_uint64, zs_resource_total_time, zs_resource_used_uint64, zs_re‐
source_used_time, zs_resource_used_pct, zs_resource_used_zone_uint64,
zs_resource_used_zone_time, zs_resource_used_zone_pct - libzonestat re‐
source accessor methods
SYNOPSIS
cc [ flag ... ] file... -lzonestat [ library ... ]
#include <zonestat.h>
zs_property_t zs_resource_property(zs_usage_t usage,
zs_resource_property_t prop);
zs_resource_type_t zs_resource_type(zs_resource_t resource);
uint64_t zs_resource_total_uint64(zs_usage_t usage,
zs_resource_t resource);
void zs_resource_total_time(zs_usage_t usage,
zs_resource_t resource, timestruc_t *ts);
uint64_t zs_resource_used_uint64(zs_usage_t usage,
zs_resource_t resource, zs_user_t user);
void zs_resource_used_time(zs_usage_t usage, zs_resource_t resource,
zs_user_t user, timestruc_t *ts);
uint_t zs_resource_used_pct(zs_usage_t usage, zs_resource_t resource,
zs_user_t user);
uint64_t zs_resource_used_zone_uint64(zs_zone_t zone,
zs_resource_t resource);
void zs_resource_used_zone_time(zs_zone_t zone, zs_resource_t resource,
timestruc_t *ts);
uint_t zs_resource_used_zone_pct(zs_zone_t zone, zs_resource_t resource);
DESCRIPTION
These functions are used to access properties and utilization informa‐
tion of the system resources. Also provided by the zs_re‐
source_used_zone_*() functions is per-zone utilization information of
each resource.
See libzonestat(3LIB) for the ZS_RESOURCE_* resource codes and the
ZS_USER_* user codes.
The zs_resource_property() function returns resource property prop. See
libzonestat(3LIB) for a description of the ZS_RESOURCE_PROP_* property
codes.
The zs_resource_type() function returns the data type of the resource.
The following types can be returned:
ZS_RESOURCE_TYPE_TIME
The resource and its usage can be retrieved in terms of time. This
limit can be passed to zs_resource_total_time() and zs_re‐
source_used_time(), as well as all other zs_resource_*() functions.
ZS_RESOURCE_TYPE_COUNT
The resource reflects a quantity of discrete objects. For instance,
a limit on the number of processes.
ZS_RESOURCE_TYPE_BYTES
The resource reflects a quantity of bytes.
The zs_resource_total_uint64() function returns the total resource
available of type resource.
The zs_resource_total_time() function sets ts to the total time avail‐
able for the given resource. This is supported only for the ZS_RE‐
SOURCE_CPU resource. The total CPU time represents the total CPU time
available since zs_open(3ZONESTAT) was called.
The zs_resource_used_uint64() function returns the total resource used
for the given resource by the given user.
The zs_resource_used_time() function sets ts to the total time used for
resource by user. This is supported only for the ZS_RESOURCE_CPU re‐
source. The used CPU time represents the CPU time used since zs_open()
was called.
The zs_resource_used_pct() function returns the percentage of resource
used by user.
The zs_resource_used_zone_uint64() function returns the quantity of re‐
source by zone.
The zs_resource_used_zone_time() function returns the quantity of re‐
source time used by zone. This usage value is increasing from when
zs_open() as first called. This function supports only the ZS_RE‐
SOURCE_CPU resource.
The zs_resource_used_zone_pct() function returns the percent of re‐
source used by zone.
RETURN VALUES
See Description.
ERRORS
If a zs_resource_*() function is called with an invalid resource or
user code, the function will abort with abort(3C).
EXAMPLES
Example 1 Retrieve physical memory.
The following example retrieves physical memory utilization both sys‐
tem-wide and for each zone.
#include <zonestat.h>
...
extern zs_usage_t usage; /* assume returned by zs_usage_read() */
...
zs_zone_t zone;
uint64_t total_memory;
uint64_t used_memory;
uint64_t zone_used_memory;
total_memory = zs_resource_total_uint64(usage, ZS_RESOURCE_RAM);
used_memory = zs_resource_used_uint64(usage, ZS_RESOURCE_RAM, ZS_USER_ALL);
for (zone = zs_zone_first(usage); zone != NULL;
zone = zs_zone_next(usage, zone)) {
zone_used_memory = zs_resource_used_zone_uint64(zone, ZS_RESOURCE_RAM);
}
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-LevelSafe
SEE ALSO
zonestat(1), abort(3C), libpool(3LIB), libzonestat(3LIB), zs_open(3ZON‐
ESTAT), zs_property(3ZONESTAT), zs_pset(3ZONESTAT), zs_pset_zone(3ZONE‐
STAT), zs_usage(3ZONESTAT), zs_zone(3ZONESTAT), attributes(7), re‐
source-controls(7), pooladm(8), psrset(8), rcapadm(8), swap(8),
zoneadm(8), zonestatd(8)
Oracle Solaris 11.4 13 Nov 2020 zs_...urce(3ZONESTAT)