csx_Parse_CISTPL_FUNCID(9f)

1csx_Parse_CISTPL_FUNCID(9FK)ernel Functions for Drivercssx_Parse_CISTPL_FUNCID(9F)
2
3
4

NAME

6       csx_Parse_CISTPL_FUNCID - parse Function Identification tuple
7

SYNOPSIS

9       #include <sys/pccard.h>
10
11
12
13       int32_t csx_Parse_CISTPL_FUNCID(client_handle_t ch, tuple_t *tu,
14            cistpl_funcid_t *cf);
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 call
25             to csx_GetFirstTuple(9F) or csx_GetNextTuple(9F).
26
27
28       cf    Pointer to a cistpl_funcid_t structure which contains the  parsed
29             CISTPL_FUNCID tuple information upon return from this function.
30
31

DESCRIPTION

33       This  function parses the Function Identification tuple, CISTPL_FUNCID,
34       into a form usable by PC Card drivers.
35
36
37       The CISTPL_FUNCID tuple is used to describe information about the func‐
38       tionality provided by a PC Card. Information is also provided to enable
39       system utilities to decide if the PC Card should be  configured  during
40       system  initialization.  If additional function specific information is
41       available, one or more function extension tuples of  type  CISTPL_FUNCE
42       follow this tuple (see csx_Parse_CISTPL_FUNCE(9F)).
43

STRUCTURE MEMBERS

45       The structure members of cistpl_funcid_t are:
46
47         uint32_t     function;     /* PC Card function code */
48         uint32_t     sysinit;      /* system initialization mask */
49
50
51
52       The fields are defined as follows:
53
54       function    This is the function type for CISTPL_FUNCID:
55
56                   TPLFUNC_MULTI              Vendor-specific    multifunction
57                                              card
58
59
60                   TPLFUNC_MEMORY             Memory card
61
62
63                   TPLFUNC_SERIAL             Serial I/O port
64
65
66                   TPLFUNC_PARALLEL           Parallel printer port
67
68
69                   TPLFUNC_FIXED              Fixed disk, silicon or removable
70
71
72                   TPLFUNC_VIDEO              Video interface
73
74
75                   TPLFUNC_LAN                Local Area Network adapter
76
77
78                   TPLFUNC_AIMS               Auto Incrementing Mass Storage
79
80
81                   TPLFUNC_SCSI               SCSI bridge
82
83
84                   TPLFUNC_SECURITY           Security cards
85
86
87                   TPLFUNC_VENDOR_SPECIFIC    Vendor specific
88
89
90                   TPLFUNC_UNKNOWN            Unknown function(s)
91
92
93
94       sysinit    This field is bit-mapped and defined as follows:
95
96                  TPLINIT_POST    POST should attempt configure
97
98
99                  TPLINIT_ROM     Map ROM during sys init
100
101
102

RETURN VALUES

104       CS_SUCCESS                 Successful operation.
105
106
107       CS_BAD_HANDLE              Client handle is invalid.
108
109
110       CS_UNKNOWN_TUPLE           Parser does not know how to parse tuple.
111
112
113       CS_NO_CARD                 No PC Card in socket.
114
115
116       CS_NO_CIS                  No Card Information Structure  (CIS)  on  PC
117                                  Card.
118
119
120       CS_UNSUPPORTED_FUNCTION    No PCMCIA hardware installed.
121
122

CONTEXT

124       This function may be called from user or kernel context.
125