opensolaris man page for csx_event2text

csx_Event2Text(9F)					   Kernel Functions for Drivers 					csx_Event2Text(9F)

NAME
       csx_Event2Text - convert events to text strings

SYNOPSIS
       #include <sys/pccard.h>

       int32_t csx_Event2Text(event2text_t *ev);

INTERFACE LEVEL
       Solaris DDI Specific (Solaris DDI)

PARAMETERS
       ev    Pointer to an event2text_t structure.

DESCRIPTION
       This function is a Solaris-specific extension that provides a method for clients to convert Card Services events to text strings.

STRUCTURE MEMBERS
       The structure members of event2text_t are:

	 event_t     event;			   /*the event code*/
	 char	     text[CS_EVENT_MAX_BUFSIZE]    /*the event code*/

       The fields are defined as follows:

       event	The text for the event code in the event field is returned in the text field.

       text	The text string describing the name of the event.

RETURN VALUES
       CS_SUCCESS		  Successful operation.

       CS_UNSUPPORTED_FUNCTION	  No PCMCIA hardware installed.

CONTEXT
       This function may be called from user or kernel context.

EXAMPLES
       Example 1 : Using csx_Event2Text()

	 xx_event(event_t event, int priority, event_callback_args_t *eca)
	 {
		event2text_t	event2text;

		event2text.event = event;
		csx_Event2Text(&event2text);
		cmn_err(CE_CONT, "event %s (0x%x)", event2text.text, (int)event);
	 }

SEE ALSO
       csx_event_handler(9E), csx_Error2Text(9F)

       PC Card	95 Standard, PCMCIA/JEIDA

SunOS 5.11							    19 Jul 1996 						csx_Event2Text(9F)