xref: /titanic_52/usr/src/man/man9f/csx_GetFirstClient.9f (revision d15978eab6c23a98f0a5474466d5fe9b1be3ca9b)
te
Copyright (c) 1997, Sun Microsystems, Inc. All Rights Reserved
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.
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.
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]
csx_GetFirstClient 9F "16 May 1997" "SunOS 5.11" "Kernel Functions for Drivers"
NAME
csx_GetFirstClient, csx_GetNextClient - return first or next client
SYNOPSIS

#include <sys/pccard.h>



int32_t csx_GetFirstClient(get_firstnext_client_t *fnc);

int32_t csx_GetNextClient(get_firstnext_client_t *fnc);
INTERFACE LEVEL

Solaris DDI Specific (Solaris DDI)

PARAMETERS

fnc

Pointer to a get_firstnext_client_t structure.

DESCRIPTION

The functions csx_GetFirstClient() and csx_GetNextClient() return information about the first or subsequent PC cards, respectively, that are installed in the system.

STRUCTURE MEMBERS

The structure members of get_firstnext_client_t are:

uint32_t Socket; /* socket number */
uint32_t Attributes; /* attributes */
client_handle_t client_handle; /* client handle */
uint32_t num_clients; /* number of clients */

The fields are defined as follows:

Socket

If the CS_GET_FIRSTNEXT_CLIENT_SOCKET_ONLY attribute is set, return information only on the PC card installed in this socket.

Attributes

This field indicates the type of client. The field is bit-mapped; the following bits are defined:

CS_GET_FIRSTNEXT_CLIENT_ALL_CLIENTS

Return information on all clients.

CS_GET_FIRSTNEXT_CLIENT_SOCKET_ONLY

Return client information for the specified socket only.

client_handle

The client handle of the PC card driver is returned in this field.

num_clients

The number of clients is returned in this field.

RETURN VALUES

CS_SUCCESS

Successful operation.

CS_BAD_HANDLE

Client handle is invalid.

CS_BAD_SOCKET

Socket number is invalid.

CS_NO_CARD

No PC Card in socket.

CS_NO_MORE_ITEMS

PC Card driver does not handle the CS_EVENT_CLIENT_INFO event.

CS_UNSUPPORTED_FUNCTION

No PCMCIA hardware installed.

CONTEXT

This function may be called from user or kernel context.

SEE ALSO

csx_event_handler(9E)

PC Card 95 Standard, PCMCIA/JEIDA