개요

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

kstat2_uri_encode(3kstat2)

Kernel Statistics Library Functions, Version 2         kstat2_map_uri(3KSTAT2)



NAME
       kstat2_map_uri,  kstat2_uri_encode,  kstat2_uri_decode  -  retrieve and
       manipulate kstat2 URIs

SYNOPSIS
       cc [ flag... ] file... -lkstat2 [ library...]
            #include <kstat2.h>


       kstat2_status_t kstat2_map_uri(kstat2_map_t map, char **uri);


       kstat2_status_t kstat2_nv_uri(kstat2_map_t map, const char *nv_name,
                char **uri);


       kstat2_status_t kstat2_uri_encode(const char *unenc, char **enc);


       kstat2_status_t kstat2_uri_decode(const char *enc, char **unenc);

DESCRIPTION
       The kstat2_map_uri() function retrieves the URI for a kstat2  map.  The
       URI  will  be  returned in the uri parameter. When the URI is no longer
       required the caller is responsible for disposing it with free().


       The kstat2_nv_uri()  function  retrieves  the  URI  for  a  kstat2  map
       name/value  entry.  The URI will be returned in the uri parameter. When
       the URI is no longer required the caller is responsible  for  disposing
       it with free().


       The  kstat2_uri_encode()  function  URI-uncodes a string representing a
       component of a kstat2 URI. Any URI-unsafe characters  are  replaced  by
       their  encoded  equivalents and the resulting string is returned in the
       enc parameter. When the encoded string is no longer required the caller
       is responsible for disposing it with free().


       The  kstat2_uri_decode()  function  URI-decodes a string representing a
       component of a kstat2 URI. Any encoded characters are replaced by their
       unencoded equivalents and the resulting string is returned in the unenc
       parameter. When the encoded string is no longer required the caller  is
       responsible for disposing of it with free().

RETURN VALUES
       Upon   successful   completion,   the   above   functions  will  return
       KSTAT2_S_OK. If there is an error performing the  requested  operation,
       an error code will be returned.

ERRORS
       The above functions will fail if:


       KSTAT2_S_INVAL_ARG    The  map,  uri,  enc,  or  unenc  parameters  are
                             invalid


       KSTAT2_S_NO_MEM       Memory could not be allocated for the data



FILES
       /dev/kstat               kernel statistics driver


       /usr/include/kstat2.h    header



EXAMPLES
       See the kstat2(3KSTAT2) manpage.

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-LevelMT-Safe with
       exceptions


SEE ALSO
       kstat2(3KSTAT2),     kstat2_close(3KSTAT2),      kstat2_close(3KSTAT2),
       kstat2_map_get(3KSTAT2),              kstat2_map_get_userdata(3KSTAT2),
       kstat2_map_meta(3KSTAT2),                   kstat2_map_parent(3KSTAT2),
       kstat2_map_put_integer(3KSTAT2),      kstat2_map_put_integers(3KSTAT2),
       kstat2_map_put_string(3KSTAT2),        kstat2_map_put_strings(3KSTAT2),
       kstat2_map_remove(3KSTAT2),            kstat2_map_set_data_cb(3KSTAT2),
       kstat2_map_set_destroy_cb(3KSTAT2),    kstat2_map_set_tree_cb(3KSTAT2),
       kstat2_map_set_userdata(3KSTAT2),             kstat2_map_size(3KSTAT2),
       kstat2_map_to_array(3KSTAT2),              kstat2_mapiter_end(3KSTAT2),
       kstat2_mapiter_hasnext(3KSTAT2),          kstat2_mapiter_next(3KSTAT2),
       kstat2_mapiter_remove(3KSTAT2),          kstat2_mapiter_start(3KSTAT2),
       kstat2_mapref_alloc(3KSTAT2),             kstat2_mapref_deref(3KSTAT2),
       kstat2_mapref_free(3KSTAT2),                   kstat2_nv_meta(3KSTAT2),
       kstat2_open(3KSTAT2),                    kstat2_status_string(3KSTAT2),
       kstat2_update(3KSTAT2), libkstat2(3LIB)

NOTES
       The kstat2 functions are MT-Safe  with  the  exception  that  only  one
       thread  may  actively  use  a  kstat2_handle_t,  or any object obtained
       through it, at any one time. Synchronization is  required  if  multiple
       threads  intend  to  share  a  kstat2_handle_t  or  any object obtained
       through it. Synchronization is left to the application.



Oracle Solaris 11.4               14 May 2018          kstat2_map_uri(3KSTAT2)