개요

• 솔라나라에 설명된 어플리케이션에 대해 맨 페이지를 찾아 출력한다.
• MAN 페이지에 대한 설명은 윈디하나의 솔라나라: MAN 페이지을 참고하자.
• svcadm(1M)을 검색하려면 섹션에서 1M 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.

zs_open(3zonestat)

Zones Statistics Library Functions                          zs_open(3ZONESTAT)



NAME
       zs_open, zs_close - open and close the zones statistics facility

SYNOPSIS
       cc [ flag ... ] file... -lzonestat [ library ... ]
       #include <zonestat.h>

       zs_ctl_t zs_open();


       void zs_close(zs_ctl_t zsctl);

DESCRIPTION
       The  zs_open()  function  connects  to the zones statistic facility and
       returns a zonestat control object, which can then be used to read  zone
       utilization information.


       All  reads using a zonestat control object are relative to the point in
       time in which the object was returned by zs_open().  For  example,  CPU
       usage will be reported as usage since the zs_open() call was made.


       The  zs_close()  function closes the connection to the zones statistics
       facility and frees all associated resources.

RETURN VALUES
       On success, zs_open() returns a pointer to a zonestat  control  object.
       On  failure,  zs_open()  returns  NULL  and  sets errno to indicate the
       error.

ERRORS
       The zs_open() function will fail if:

       EAGAIN    There are insufficient resources available.


       EMFILE    Opening would exceed the maximum number of  file  descriptors
                 allowed for the current process.


       ENOMEM    There is insufficient memory available.


       EPERM     The caller does not have privilege proc_info.


       ESRCH     Unable  to connect to the zones monitoring service. See Notes
                 below.


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_open() and zs_close() functions are MT-safe, with the exception
       that only one thread may actively use a zs_ctl_t object  at  any  time.
       Synchronization is left to the application.

SEE ALSO
       zonestat(1),  libpool(3LIB), libzonestat(3LIB), zs_property(3ZONESTAT),
       zs_pset(3ZONESTAT),  zs_pset_zone(3ZONESTAT),   zs_resource(3ZONESTAT),
       zs_usage(3ZONESTAT),  zs_zone(3ZONESTAT),  attributes(7), resource-con‐
       trols(7), pooladm(8), psrset(8), rcapadm(8), swap(8), zoneadm(8),  zon‐
       estatd(8)

NOTES
       The service svc:/system/zones-monitoring:default must be enabled in the
       global zone in order for zs_open() to succeed. This requirement  exists
       for use of libzonestat in both the global zone and non-global zones.



Oracle Solaris 11.4               13 Nov 2020               zs_open(3ZONESTAT)