csx_Parse_CISTPL_LINKTARGET(9f)

1csx_Parse_CISTPL_LINKTARGEKTe(r9nFe)l Functions for Drcisvxe_rPsarse_CISTPL_LINKTARGET(9F)
2
3
4

NAME

6       csx_Parse_CISTPL_LINKTARGET - parse the Link Target tuple
7

SYNOPSIS

9       #include <sys/pccard.h>
10
11
12       int32_t csx_Parse_CISTPL_LINKTARGET(client_handle_t ch, tuple_t *tu,
13            cistpl_linktarget_t *pt);
14
15

INTERFACE LEVEL

17       Solaris DDI Specific (Solaris DDI)
18

PARAMETERS

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

DESCRIPTION

33       This function parses the Link Target tuple, CISTPL_LINKTARGET,  into  a
34       form usable by PCCard drivers.
35
36
37       The  CISTPL_LINKTARGET  tuple is used to verify that tuple chains other
38       than the primary chain  are  valid.  All  secondary  tuple  chains  are
39       required to contain this tuple as the first tuple of the chain.
40

STRUCTURE MEMBERS

42       The structure members of cistpl_linktarget_t are:
43
44         uint32_t   length;
45         char       tpltg_tag[CIS_MAX_TUPLE_DATA_LEN];
46
47
48
49       The fields are defined as follows:
50
51       length        This field indicates the number of bytes in tpltg_tag.
52
53
54       tpltg_tag     This field provides the Link Target tuple information.
55
56

RETURN VALUES

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

CONTEXT

78       This function may be called from user or kernel context.
79