Manual Pages for UNIX Operating System command usage for man ldi_ev_get_cookie

Kernel Functions for Drivers                ldi_ev_get_cookie(9F)



NAME
     ldi_ev_get_cookie - get an LDI event cookie for a  specified
     event

SYNOPSIS
     #include 

     int ldi_ev_get_cookie(ldi_handle_t lh, char *evname,
          ldi_ev_cookie_t *cookiep);


INTERFACE LEVEL
     Solaris DDI specific (Solaris DDI)

PARAMETERS
     ldi_handle_t lh

         A layered handle representing the device for  which  the
         event notification was requested.


     char *evname

         The string name of the event.


     ldi_ev_cookie_t *cookiep

         A pointer to type ldi_ev_cookie_t. Contains a pointer to
         the event cookie on return.


DESCRIPTION
     The ldi_ev_get_cookie() function accepts the string name  of
     a state change event affecting the device represented by the
     layered driver handle "lh" and returns an opaque  cookie  on
     success.  The  call  is successful if the framework supports
     event notification for the event named by "evname". If  suc-
     cessful,  the  function returns an opaque cookie through the
     "cookiep" parameter. The cookie is  required  in  subsequent
     calls for registering callbacks on events.


     The following two LDI events are currently defined:

     LDI_EV_OFFLINE

         The device is moving to the offline state.


     LDI_EV_DEGRADE




SunOS 5.11          Last change: 21 Aug 2007                    1






Kernel Functions for Drivers                ldi_ev_get_cookie(9F)



         The device is moving to the degraded state.



     ldi_ev_get_cookie() also accepts  the  string  name  of  any
     events  defined   for  NDI  event services. For such events,
     ldi_ev_get_cookie() replaces ldi_get_eventcookie(9F)  (which
     is now obsolete).

RETURN VALUES
     The return values for this function are:

     LDI_EV_SUCCESS

         The event cookie was created successfully.


     LDI_EV_FAILURE

         An error occurred and the cookie was not created.


CONTEXT
     This function can be called from user  and  kernel  contexts
     only.

SEE ALSO
     ldi_ev_register_callbacks(9F), ldi_ev_remove_callbacks(9F)



























SunOS 5.11          Last change: 21 Aug 2007                    2