ldi_ev_get_cookie man page on OpenIndiana

Man page or keyword search:  
man Server   20441 pages
apropos Keyword Search (all sections)
Output format
OpenIndiana logo
[printable version]

ldi_ev_get_cookie(9F)	 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 <sys/sunldi.h>

       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 noti‐
	   fication 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 suc‐
       cessful if the framework supports  event	 notification  for  the	 event
       named by "evname". If successful, 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

	   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			  21 Aug 2007		 ldi_ev_get_cookie(9F)
[top]

List of man pages available for OpenIndiana

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net