개요

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

zs_open(3zonestat)

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 re‐
       turns  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  er‐
       ror.

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)