csx_ReleaseConfiguration(9f)

1csx_ReleaseConfiguration(9KFe)rnel Functions for Drivecrssx_ReleaseConfiguration(9F)
2
3
4

NAME

6       csx_ReleaseConfiguration - release PC Card and socket configuration
7

SYNOPSIS

9       #include <sys/pccard.h>
10
11
12
13       int32_t csx_ReleaseConfiguration(client_handle_t ch, release_config_t *rc);
14
15

INTERFACE LEVEL

17       Solaris DDI Specific (Solaris DDI)
18

PARAMETERS

20       ch     Client handle returned from csx_RegisterClient(9F).
21
22
23       rc     Pointer to a release_config_t structure.
24
25

DESCRIPTION

27       This  function  returns  a  PC  Card and socket to a simple memory only
28       interface and sets the card to configuration zero by writing a 0 to the
29       PC card's COR (Configuration Option Register).
30
31
32       Card Services may remove power from the socket if no clients have indi‐
33       cated their usage of the  socket  by  an  active  csx_RequestConfigura‐
34       tion(9F) or csx_RequestWindow(9F).
35
36
37       Card  Services  is  prohibited  from  resetting  the PC Card and is not
38       required to cycle power through zero (0) volts.
39
40
41       After calling csx_ReleaseConfiguration() any  resources  requested  via
42       the   request   functions   csx_RequestIO(9F),  csx_RequestIRQ(9F),  or
43       csx_RequestWindow(9F) that are no longer needed should be  returned  to
44       Card  Services  via  the  corresponding  csx_ReleaseIO(9F),  csx_Relea‐
45       seIRQ(9F), or  csx_ReleaseWindow(9F)  functions.  csx_ReleaseConfigura‐
46       tion() must be called to release the current card and socket configura‐
47       tion before releasing any resources requested by  the  driver  via  the
48       request functions named above.
49

STRUCTURE MEMBERS

51       The structure members of release_config_t are:
52
53         uint32_t     Socket;     /* socket number */
54
55
56
57       The Socket field is not used in Solaris, but for portability with other
58       Card Services implementations, it should be set to the  logical  socket
59       number.
60

RETURN VALUES

62       CS_SUCCESS                  Successful operation.
63
64
65       CS_BAD_HANDLE               Client handle is invalid or csx_RequestCon‐
66                                   figuration(9F) not done.
67
68
69       CS_BAD_SOCKET               Error getting or  setting  socket  hardware
70                                   parameters.
71
72
73       CS_NO_CARD                  No PC card in socket.
74
75
76       CS_UNSUPPORTED_FUNCTION     No PCMCIA hardware installed.
77
78

CONTEXT

80       This function may be called from user or kernel context.
81