Tribblix: manual page: csx

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

illumos DDI Specific (illumos DDI)

PARAMETERS

ev
Pointer to an event2text_t structure.

DESCRIPTION

This function is an illumos-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);
}