Description

These functions are used to access properties and utilization information of the
system resources. Also provided by the zs_resource_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_resource_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 available for the
given resource. This is supported only for the ZS_RESOURCE_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 resource. 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 resource by zone.

The zs_resource_used_zone_time() function returns the quantity of resource time used by zone.
This usage value is increasing from when zs_open() as first called. This
function supports only the ZS_RESOURCE_CPU resource.

The zs_resource_used_zone_pct() function returns the percent of resource 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 system-wide and for each
zone.