Kernel Functions for Drivers          csxParseCISTPLFORMAT(9F)



NAME
     csxParseCISTPLFORMAT - parse the  Data  Recording  Format
     tuple

SYNOPSIS
     #include 



     int32t csxParseCISTPLFORMAT(clienthandlet ch, tuplet *tu,
          cistplformatt *pt);


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).


     pt    Pointer to a cistplformatt structure which  contains
           the parsed CISTPLFORMAT tuple information upon return
           from this function.


DESCRIPTION
     This  function  parses  the  Data  Recording  Format  tuple,
     CISTPLFORMAT, into a form usable by PC Card drivers.


     The CISTPLFORMAT tuple indicates the data recording  format
     for a device partition.

STRUCTURE MEMBERS
     The structure members of cistplformatt are:

       uint32t     type;
       uint32t     edclength;
       uint32t     edctype;
       uint32t     offset;
       uint32t     nbytes;
       uint32t     dev.disk.bksize;
       uint32t     dev.disk.nblocks;
       uint32t     dev.disk.edcloc;
       uint32t     dev.mem.flags;
       uint32t     dev.mem.reserved;
       caddrt      dev.mem.address;



SunOS 5.11          Last change: 24 Jan 1997                    1






Kernel Functions for Drivers          csxParseCISTPLFORMAT(9F)



       uint32t     dev.mem.edcloc;



     The fields are defined as follows:

     type                This field indicates the type of device:

                         TPLFMTYPEDISK    disk-like device


                         TPLFMTYPEMEM     memory-like device


                         TPLFMTYPEVS      vendor-specific  dev-
                                            ice



     edclength          This field indicates the error detection
                         code length.


     edctype            This field indicates the error detection
                         code type.


     offset              This field indicates the offset  of  the
                         first byte of data in this partition.


     nbytes              This field indicates the number of bytes
                         of data in this partition


     dev.disk.bksize     This field indicates the block size, for
                         disk devices.


     dev.disk.nblocks    This  field  indicates  the  number   of
                         blocks, for disk devices.


     dev.disk.edcloc     This field indicates the location of the
                         error detection code, for disk devices.


     dev.mem.flags       This field provides  flags,  for  memory
                         devices.  Valid flags are:

                         TPLFMTFLAGSADR    address is valid




SunOS 5.11          Last change: 24 Jan 1997                    2






Kernel Functions for Drivers          csxParseCISTPLFORMAT(9F)



                         TPLFMTFLAGSAUTO    automatically    map
                                             memory region



     dev.mem.reserved    This field is reserved.


     dev.mem.address     This  field   indicates   the   physical
                         address, for memory devices.


     dev.mem.edcloc      This field indicates the location of the
                         error  detection  code,  for memory dev-
                         ices.


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),
     csxRegisterClient(9F), csxValidateCIS(9F), tuple(9S)


     PC Card 95 Standard, PCMCIA/JEIDA








SunOS 5.11          Last change: 24 Jan 1997                    3