ifdhcreatechannelbyname(3smartca) [sunos man page]
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)
Check Out this Related Man Page
SCF_Card_reset(3SMARTCARD) Smartcard Library Functions SCF_Card_reset(3SMARTCARD) NAME
SCF_Card_reset - perform a reset of a smartcard SYNOPSIS
cc [ flag... ] file... -lsmartcard [ library...] #include <smartcard/scf.h> SCF_Status_t SCF_Card_reset(SCF_Card_t card); PARAMETERS
card The card (from SCF_Terminal_getCard(3SMARTCARD)) to be reset DESCRIPTION
The SCF_Card_reset() function causes the specified smartcard to be reset by the terminal. A card can be reset only if it has not been locked (with SCF_Card_lock(3SMARTCARD)) by another client. A client wishing to reset a card should either first call SCF_Card_lock() to obtain the card lock, or be prepared to retry the reset operation if it fails because another client holds the card lock. When the card is reset, any SCF_Card_t object representing the card will continue to remain valid after the reset. When the reset occurs, an SCF_EVENT_CARDRESET event will be sent to all registered event listeners for the terminal (assuming they registered for this event). This is the only notification of a reset provided to SCF clients. When a client receives this event, it should be prepared to reinitialize any state on the card that might have been interrupted by the reset. New information about the card (for example, ATR, if it changed) can also be available from SCF_Card_getInfo(3SMARTCARD). RETURN VALUES
If the card is successfully reset, SCF_STATUS_SUCCESS is returned. Otherwise, the status of the card remains unchanged and an error value is returned. ERRORS
The SCF_Card_reset() function will fail if: SCF_STATUS_BADHANDLE The specified card has been closed or is invalid. SCF_STATUS_CARDLOCKED The card cannot be reset because another client holds a lock on the card. SCF_STATUS_CARDREMOVED The card cannot be reset because the card represented by the SCF_Card_t has been removed. SCF_STATUS_COMMERROR The connection to the server was lost. SCF_STATUS_FAILED An internal error occured. EXAMPLES
Example 1: Reset a card. SCF_Status_t status; SCF_Card_t myCard; /* (...call SCF_Terminal_getCard to open myCard...) */ status = SCF_Card_lock(myCard, SCF_TIMEOUT_MAX); if (status != SCF_STATUS_SUCCESS) exit(1); status = SCF_Card_reset(myCard); if (status != SCF_STATUS_SUCCESS) exit(1); status = SCF_Card_unlock(myCard); if (status != SCF_STATUS_SUCCESS) exit(1); /* ... */ ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
libsmartcard(3LIB), SCF_Card_getInfo(3SMARTCARD), SCF_Card_lock(3SMARTCARD), SCF_Terminal_addEventListener(3SMARTCARD), SCF_Terminal_get- Card(3SMARTCARD), attributes(5) SunOS 5.10 28 Feb 2001 SCF_Card_reset(3SMARTCARD)