Kernel Functions for Drivers          csxParseCISTPLFUNCID(9F)



NAME
     csxParseCISTPLFUNCID  -  parse  Function   Identification
     tuple

SYNOPSIS
     #include 



     int32t csxParseCISTPLFUNCID(clienthandlet ch, tuplet *tu,
          cistplfuncidt *cf);


INTERFACE LEVEL
     Solaris DI Specific (Solaris DI)

PARAMETERS
     ch    Client handle returned from csxRegisterClient(9F).


     tu    Pointer  to  a  tuplet  structure   (see   tuple(9S))
           returned   by   a  call  to  csxGetFirstTuple(9F)  or
           csxGetNextTuple(9F).


     cf    Pointer to a cistplfuncidt structure which  contains
           the parsed CISTPLFUNCID tuple information upon return
           from this function.


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


     The CISTPLFUNCID 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 CISTPLFUNCE
     follow this tuple (see csxParseCISTPLFUNCE(9F)).

STRUCTURE MEMBERS
     The structure members of cistplfuncidt are:

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







SunOS 5.11          Last change: 20 Dec 1996                    1






Kernel Functions for Drivers          csxParseCISTPLFUNCID(9F)



     The fields are defined as follows:

     function    This is the function type for CISTPLFUNCID:

                 TPLFUNCMULTI              Vendor-specific  mul-
                                            tifunction card


                 TPLFUNCMEMORY             Memory card


                 TPLFUNCSERIAL             Serial I/O port


                 TPLFUNCPARALEL           Parallel printer port


                 TPLFUNCFIXED              Fixed  disk,  silicon
                                            or removable


                 TPLFUNCVIDEO              Video interface


                 TPLFUNCLAN                Local  Area   Network
                                            adapter


                 TPLFUNCAIMS               Auto     Incrementing
                                            Mass Storage


                 TPLFUNCSCSI               SCSI bridge


                 TPLFUNCSECURITY           Security cards


                 TPLFUNCVENDORSPECIFIC    Vendor specific


                 TPLFUNCUNKNOWN            Unknown function(s)



     sysinit    This field is bit-mapped and defined as follows:

                TPLINITPOST    POST should attempt configure


                TPLINITROM     Map ROM during sys init




SunOS 5.11          Last change: 20 Dec 1996                    2






Kernel Functions for Drivers          csxParseCISTPLFUNCID(9F)



RETURN VALUES
     CSUCES                 Successful operation.


     CSBADHANDLE              Client handle is invalid.


     CSUNKNOWNTUPLE           Parser does not know how to parse
                                tuple.


     CSNOCARD                 No PC Card in socket.


     CSNOCIS                  No  Card  Information   Structure
                                (CIS) on PC Card.


     CSUNSUPORTEDFUNCTION    No PCMCIA hardware installed.


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

SEE ALSO
     csxGetFirstTuple(9F),                 csxGetTupleData(9F),
     csxParseCISTPLFUNCE(9F),          csxRegisterClient(9F),
     csxValidateCIS(9F), tuple(9S)


     PC Card 95 Standard, PCMCIA/JEIDA
























SunOS 5.11          Last change: 20 Dec 1996                    3