|
|
libchipcard 4.2.4 (Stable branch)
01-22-2009
Libchipcard is a framework for easy access to chipcards/smartcards via chip card terminals/readers. It uses the CTAPI or IFD driver provided by manufacturers. It works under Linux, FreeBSD, OpenBSD, Mac OS X, and Windows, and has been tested with many different readers (even in parallel). License: GNU Lesser General Public License (LGPL) Changes:|
|
IFDHCreateChannelByName(3SMARTCARD) Smartcard Library Functions IFDHCreateChannelByName(3SMARTCARD) NAME
IFDHCreateChannelByName - create a communication channel with an IFD SYNOPSIS
#include <smartcard/ifdhandler.h> RESPONSECODE IFDHCreateChannelByName(DWORD Lun, LPSTR devicename); PARAMETERS
The IFDHCreateChannelByName() function takes the following parameters: Input Lun Logical Unit Number devicename Device name path DESCRIPTION
The IFDHCreateChannelByName() function opens a communication channel with a card terminal specified by devicename. This function can use open(2) or other system call to open the device and establish a communication path. The caller of this function (smart card framework) assigns a logical unit number Lun per card terminal and slot and passes this value to IFDHCreateChannelByName(). If the IFD handler sup- ports multiple terminals with one instance of the handler (as indicated by capability TAG_IFD_SIMULTANEOUS_ACCESS), it communicates with the card terminal corresponding to this Lun. If the IFD handler supports only one terminal with one slot per instance, it can choose to ignore the Lun. The Logical Unit Number, Lun is encoded as 0xXXXXYYYY, where YYYY represents the lower 16 bits that correspond to the slot number for terminals with multiple slots. Most of the readers have only one slot, in which case YYYY is 0. XXXX represents the next 16 bits that correspond to the card terminal and can range between 0 and a number returned by TAG_IFD_SUMULTA- NEOUS_ACCESS. RETURN VALUES
The following values are returned: IFD_SUCCESS Successful completion. IFD_COMMUNICATION_ERROR An error occurred. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ SEE ALSO
attributes(5) NOTES
This manual page is derived from the MUSCLE PC/SC IFD Driver Developer Kit documentation. License terms and attribution and copyright information for this interface are available at the default location /var/sadm/pkg/SUNWocfh/install/copyright. If the Solaris Operating Environment has been installed anywhere other than the default location, modify the path to access the file at the installed location. SunOS 5.10 4 Dec 2002 IFDHCreateChannelByName(3SMARTCARD)