1 '\" te
   2 .\"  Copyright (c) 1996, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH CSX_RELEASECONFIGURATION 9F "Jul 19, 1996"
   7 .SH NAME
   8 csx_ReleaseConfiguration \- release PC Card and socket configuration
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 #include <sys/pccard.h>
  13 
  14 
  15 
  16 \fBint32_t\fR \fBcsx_ReleaseConfiguration\fR(\fBclient_handle_t\fR \fIch\fR, \fBrelease_config_t *\fR\fIrc\fR);
  17 .fi
  18 
  19 .SH INTERFACE LEVEL
  20 .sp
  21 .LP
  22 Solaris \fBDDI\fR Specific (Solaris \fBDDI\fR)
  23 .SH PARAMETERS
  24 .sp
  25 .ne 2
  26 .na
  27 \fB\fIch\fR \fR
  28 .ad
  29 .RS 7n
  30 Client handle returned from \fBcsx_RegisterClient\fR(9F).
  31 .RE
  32 
  33 .sp
  34 .ne 2
  35 .na
  36 \fB\fIrc\fR \fR
  37 .ad
  38 .RS 7n
  39 Pointer to a \fBrelease_config_t\fR structure.
  40 .RE
  41 
  42 .SH DESCRIPTION
  43 .sp
  44 .LP
  45 This function returns a \fBPC\fR Card and socket to a simple memory only
  46 interface and sets the card to configuration zero by writing a \fB0\fR to the
  47 \fBPC\fR card's \fBCOR\fR (Configuration Option Register).
  48 .sp
  49 .LP
  50 Card Services may remove power from the socket if no clients have indicated
  51 their usage of the socket by an active \fBcsx_RequestConfiguration\fR(9F) or
  52 \fBcsx_RequestWindow\fR(9F).
  53 .sp
  54 .LP
  55 Card Services is prohibited from resetting the \fBPC\fR Card and is not
  56 required to cycle power through zero (\fB0\fR) volts.
  57 .sp
  58 .LP
  59 After calling \fBcsx_ReleaseConfiguration()\fR any resources requested via the
  60 request functions \fBcsx_RequestIO\fR(9F), \fBcsx_RequestIRQ\fR(9F), or
  61 \fBcsx_RequestWindow\fR(9F) that are no longer needed should be returned to
  62 Card Services via the corresponding \fBcsx_ReleaseIO\fR(9F),
  63 \fBcsx_ReleaseIRQ\fR(9F), or \fBcsx_ReleaseWindow\fR(9F) functions.
  64 \fBcsx_ReleaseConfiguration()\fR must be called to release the current card and
  65 socket configuration before releasing any resources requested by the driver via
  66 the request functions named above.
  67 .SH STRUCTURE MEMBERS
  68 .sp
  69 .LP
  70 The structure members of \fBrelease_config_t\fR are:
  71 .sp
  72 .in +2
  73 .nf
  74 uint32_t     Socket;     /* socket number */
  75 .fi
  76 .in -2
  77 
  78 .sp
  79 .LP
  80 The \fBSocket\fR field is not used in Solaris, but for portability with other
  81 Card Services implementations, it should be set to the logical socket number.
  82 .SH RETURN VALUES
  83 .sp
  84 .ne 2
  85 .na
  86 \fB\fBCS_SUCCESS\fR \fR
  87 .ad
  88 .RS 28n
  89 Successful operation.
  90 .RE
  91 
  92 .sp
  93 .ne 2
  94 .na
  95 \fB\fBCS_BAD_HANDLE\fR \fR
  96 .ad
  97 .RS 28n
  98 Client handle is invalid or \fBcsx_RequestConfiguration\fR(9F) not done.
  99 .RE
 100 
 101 .sp
 102 .ne 2
 103 .na
 104 \fB\fBCS_BAD_SOCKET\fR \fR
 105 .ad
 106 .RS 28n
 107 Error getting or setting socket hardware parameters.
 108 .RE
 109 
 110 .sp
 111 .ne 2
 112 .na
 113 \fB\fBCS_NO_CARD\fR \fR
 114 .ad
 115 .RS 28n
 116 No \fBPC\fR card in socket.
 117 .RE
 118 
 119 .sp
 120 .ne 2
 121 .na
 122 \fB\fBCS_UNSUPPORTED_FUNCTION\fR \fR
 123 .ad
 124 .RS 28n
 125 No \fBPCMCIA\fR hardware installed.
 126 .RE
 127 
 128 .SH CONTEXT
 129 .sp
 130 .LP
 131 This function may be called from user or kernel context.
 132 .SH SEE ALSO
 133 .sp
 134 .LP
 135 \fBcsx_RegisterClient\fR(9F), \fBcsx_RequestConfiguration\fR(9F),
 136 \fBcsx_RequestIO\fR(9F), \fBcsx_RequestIRQ\fR(9F), \fBcsx_RequestWindow\fR(9F)
 137 .sp
 138 .LP
 139 \fIPC Card 95 Standard\fR, PCMCIA/JEIDA