개요

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

kstat2_map_get_userdata(3kstat2)

ks...a(3KSTAT2) Kernel Statistics Library Functions, Version 2 ks...a(3KSTAT2)

NAME
       kstat2_map_set_userdata,  kstat2_map_get_userdata  -  set/retrieve user
       data for a kstat2 map

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


       kstat2_status_t kstat2_map_set_userdata(kstat2_map_t map, void *data);


       kstat2_status_t kstat2_map_get_userdata(kstat2_map_t map, void **data)

DESCRIPTION
       The kstat2_map_set_userdata() function allows arbitrary user data to be
       associated with a kstat2 map. To remove user data,  pass  NULL  as  the
       data parameter.


       The  kstat2_map_get_userdata()  function  retrieves the user data for a
       map and returns a reference in data, or NULL if no data has been  asso‐
       ciated with the map.


       The  memory occupied by any user data associated with a map is not man‐
       aged by the kstat2 library. If user data cleanup actions  are  required
       when  a map is deleted, the kstat2_map_set_destroy_cb() function should
       be used to establish a handler which will be called  when  the  map  is
       deleted, see kstat2_map_set_destroy_cb(3KSTAT2).

RETURN VALUES
       Upon successful completion the functions will return KSTAT2_S_OK.

ERRORS
       The kstat2_map_set_userdata() function will fail if:


       KSTAT2_S_INVAL_ARG    The map parameter is NULL




       The kstat2_map_get_userdata() function will fail if:


       KSTAT2_S_INVAL_ARG    The map parameter is NULL or the map has no asso‐
                             ciated user 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 ex‐
       ceptions


SEE ALSO
       kstat2_close(3KSTAT2), kstat2_close(3KSTAT2),  kstat2_map_get(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_size(3KSTAT2),                 kstat2_map_to_array(3KSTAT2),
       kstat2_map_uri(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_up‐
       date(3KSTAT2),  kstat2_uri_decode(3KSTAT2), kstat2_uri_encode(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               21 Apr 2025                  ks...a(3KSTAT2)