SunOS man pages


	www.sun.com	docs.sun.com \| \| \|

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Kernel Functions for Drivers

csx_Parse_CISTPL_FUNCID(9F)

INTERFACE LEVEL
PARAMETERS
DESCRIPTION
STRUCTURE MEMBERS
RETURN VALUES
CONTEXT
SEE ALSO

NAME

csx_Parse_CISTPL_FUNCID - parse Function Identification tuple

SYNOPSIS

#include <sys/pccard.h> int32_t csx_Parse_CISTPL_FUNCID(client_handle_t ch, tuple_t *tu, cistpl_funcid_t *cf);

PARAMETERS

ch: Client handle returned from csx_RegisterClient(9F).
tu: Pointer to a tuple_t structure (see tuple(9S)) returned by a call to csx_GetFirstTuple(9F) or csx_GetNextTuple(9F).
cf: Pointer to a cistpl_funcid_t structure which contains the parsed CISTPL_FUNCID tuple information upon return from this function.

DESCRIPTION

This function parses the Function Identification tuple, CISTPL_FUNCID, into a form usable by PC Card drivers.

The CISTPL_FUNCID tuple is used to describe information about the functionality provided by a PC Card. Information is also provided to enable system utilities to decide if the PC Card should be configured during system initialization. If additional function specific information is available, one or more function extension tuples of type CISTPL_FUNCE follow this tuple (see csx_Parse_CISTPL_FUNCE(9F)).

STRUCTURE MEMBERS

The structure members of cistpl_funcid_t are:

uint32_t function; /* PC Card function code */ uint32_t sysinit; /* system initialization mask */

The fields are defined as follows:

function

This is the function type for CISTPL_FUNCID:

TPLFUNC_MULTI: Vendor-specific multifunction card
TPLFUNC_MEMORY: Memory card
TPLFUNC_SERIAL: Serial I/O port
TPLFUNC_PARALLEL: Parallel printer port
TPLFUNC_FIXED: Fixed disk, silicon or removable
TPLFUNC_VIDEO: Video interface
TPLFUNC_LAN: Local Area Network adapter
TPLFUNC_AIMS: Auto Incrementing Mass Storage
TPLFUNC_SCSI: SCSI bridge
TPLFUNC_SECURITY: Security cards
TPLFUNC_VENDOR_SPECIFIC: Vendor specific
TPLFUNC_UNKNOWN: Unknown function(s)

sysinit

This field is bit-mapped and defined as follows:

TPLINIT_POST: POST should attempt configure
TPLINIT_ROM: Map ROM during sys init

RETURN VALUES

CS_SUCCESS: Successful operation.
CS_BAD_HANDLE: Client handle is invalid.
CS_UNKNOWN_TUPLE: Parser does not know how to parse tuple.
CS_NO_CARD: No PC Card in socket.
CS_NO_CIS: No Card Information Structure (CIS) on PC Card.
CS_UNSUPPORTED_FUNCTION: No PCMCIA hardware installed.

CONTEXT

This function may be called from user or kernel context.