Tribblix: manual page: csx_Parse_CISTPL

CSX_PARSE_CISTPL_GEOMETRY(9F) Kernel Functions for Drivers

NAME

csx_Parse_CISTPL_GEOMETRY - parse the Geometry tuple

SYNOPSIS

#include <sys/pccard.h>

int32_t csx_Parse_CISTPL_GEOMETRY(client_handle_t ch, tuple_t *tu,
cistpl_geometry_t *pt);

INTERFACE LEVEL

illumos DDI Specific (illumos DDI)

PARAMETERS

ch
Client handle returned from csx_RegisterClient(9F).

tu
Pointer to a tuple_t structure (see tuple(9S)) returned by a
call to csx_GetFirstTuple(9F) or csx_GetNextTuple(9F).

pt
Pointer to a cistpl_geometry_t structure which contains the
parsed CISTPL_GEOMETRY tuple information upon return from this
function.

DESCRIPTION

This function parses the Geometry tuple, CISTPL_GEOMETRY, into a form
usable by PC Card drivers.

The CISTPL_GEOMETRY tuple indicates the geometry of a disk-like
device.

STRUCTURE MEMBERS

The structure members of cistpl_geometry_t are:

uint32_t spt;
uint32_t tpc;
uint32_t ncyl;

The fields are defined as follows:

spt
This field indicates the number of sectors per track.

tpc
This field indicates the number of tracks per cylinder.

ncyl
This field indicates the number of cylinders.

RETURN VALUES

CS_SUCCESS
Successful operation.

CS_BAD_HANDLE
Client handle is invalid.

CS_UNKNOWN_TUPLE
Parser does not know how to parse tuple.

CS_NO_CARD
No PC Card in socket.

CS_NO_CIS
No Card Information Structure (CIS) on PC
Card.

CS_UNSUPPORTED_FUNCTION
No PCMCIA hardware installed.

CONTEXT

This function may be called from user or kernel context.