csx_Parse_CISTPL_VERS_2(9f)

1csx_Parse_CISTPL_VERS_2(9FK)ernel Functions for Drivercssx_Parse_CISTPL_VERS_2(9F)
2
3
4

NAME

6       csx_Parse_CISTPL_VERS_2 - parse Level-2 Version and Information tuple
7

SYNOPSIS

9       #include <sys/pccard.h>
10
11
12
13       int32_t csx_Parse_CISTPL_VERS_2(client_handle_t ch, tuple_t *tu,
14            cistpl_vers_2_t *cv2);
15
16

INTERFACE LEVEL

18       Solaris DDI Specific (Solaris DDI)
19

PARAMETERS

21       ch     Client handle returned from csx_RegisterClient(9F).
22
23
24       tu     Pointer  to  a  tuple_t  structure (see tuple(9S)) returned by a
25              call to csx_GetFirstTuple(9F) or csx_GetNextTuple(9F).
26
27
28       cv2    Pointer to a cistpl_vers_2_t structure which contains the parsed
29              CISTPL_VERS_2 tuple information upon return from this function.
30
31

DESCRIPTION

33       This  function  parses  the  Level-2  Version  and  Information  tuple,
34       CISTPL_VERS_2, into a form usable by PC Card drivers.
35
36
37       The CISTPL_VERS_2 tuple is used to describe the card  Level-2  informa‐
38       tion which has the logical organization of the card's data.
39

STRUCTURE MEMBERS

41       The structure members of cistpl_vers_2_t are:
42
43         uint32_t   vers;     /* version number */
44         uint32_t   comply;   /* level of compliance */
45         uint32_t   dindex;   /* byte address of first data byte in card */
46         uint32_t   vspec8;   /* vendor specific (byte 8) */
47         uint32_t   vspec9;   /* vendor specific (byte 9) */
48         uint32_t   nhdr;     /* number of copies of CIS present on device */
49         char       oem[CIS_MAX_TUPLE_DATA_LEN];
50                              /* Vendor of software that formatted card */
51         char       info[CIS_MAX_TUPLE_DATA_LEN];
52                              /* Informational message about card */
53
54

RETURN VALUES

56       CS_SUCCESS                 Successful operation.
57
58
59       CS_BAD_HANDLE              Client handle is invalid.
60
61
62       CS_UNKNOWN_TUPLE           Parser does not know how to parse tuple.
63
64
65       CS_NO_CARD                 No PC Card in socket.
66
67
68       CS_NO_CIS                  No  Card  Information  Structure (CIS) on PC
69                                  Card.
70
71
72       CS_UNSUPPORTED_FUNCTION    No PCMCIA hardware installed.
73
74

CONTEXT

76       This function may be called from user or kernel context.
77