Kernel Functions for Drivers         csxParseCISTPLBATERY(9F)



NAME
     csxParseCISTPLBATERY -  parse  the  Battery  Replacement
     Date tuple

SYNOPSIS
     #include 



     int32t csxParseCISTPLBATERY(clienthandlet ch, tuplet *tu,
          cistplbatteryt *cb);


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


     cb    Pointer to a cistplbatteryt structure which contains
           the   parsed  CISTPLBATERY  tuple  information  upon
           return from this function.


DESCRIPTION
     This function parses the  Battery  Replacement  Date  tuple,
     CISTPLBATERY, into a form usable by PC Card drivers.


     The CISTPLBATERY tuple is an optional tuple which shall be
     present  only  in  PC  Cards with battery-backed storage. It
     indicates the date on which the battery  was  replaced,  and
     the  date  on which the battery is expected to need replace-
     ment. Only one CISTPLBATERY tuple is allowed per PC Card.

STRUCTURE MEMBERS
     The structure members of cistplbatteryt are:

       uint32t     rday;     /* date battery last replaced */
       uint32t     xday;     /* date battery due for replacement */



     The fields are defined as follows:





SunOS 5.11          Last change: 20 Dec 1996                    1






Kernel Functions for Drivers         csxParseCISTPLBATERY(9F)



     rday    This field indicates the date on which  the  battery
             was last replaced.


     xday    This field indicates the date on which  the  battery
             should be replaced.


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: 20 Dec 1996                    2