Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

ifdhpowericc(3smartca) [sunos man page]

IFDHPowerICC(3SMARTCARD)				    Smartcard Library Functions 				  IFDHPowerICC(3SMARTCARD)

NAME

       IFDHPowerICC - power up or power down the smart card

SYNOPSIS

       #include <smartcard/ifdhandler.h>

       RESPONSECODE IFDHPowerICC(DWORD Lun, DWORD Action, PUCHAR Atr, PDWORD AtrLength);

PARAMETERS

       The IFDHPowerICC() takes the following parameters:

   Input
       Lun	       Logical Unit Number

       Action	       Action to be taken

       AtrLength       Maximum length of the ATR

   Output
       Atr	       Answer to Reset (ATR) value of the inserted card

       AtrLength       Actual length of the ATR

DESCRIPTION

       The  IFDHPowerICC()  function  controls	the  power  and reset signals of the ICC (smart card) at the reader or slot specified by Lun.  The
       Action parameter can take one of the following values:

       IFD_POWER_UP	       Power and reset the card. Return the ATR and its length.

       IFD_POWER_DOWN	       Power down the card. The Atr and AtrLength parameters are set to 0.

       IFD_RESET	       Perform a quick reset on the card. Return the ATR and its length.

       The IFD handler caches the ATR during a power up or reset and returns the ATR and its length in a call to IFDHGetCapabilities(3SMARTCARD).

       Memory cards without an ATR return IFD_SUCCESS on power up or reset but Atr and AtrLength are set to 0.

RETURN VALUES

       The following values are returned:

       IFD_SUCCESS		       Successful completion.

       IFD_ERROR_POWER_ACTION	       An error occurred while powering up or resetting the card.

       IFD_NOT_SUPPORTED	       The action specified by Action is not supported.

       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

       IFDHCreateChannelByName(3SMARTCARD), IFDHGetCapabilities(3SMARTCARD), 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						  IFDHPowerICC(3SMARTCARD)

Check Out this Related Man Page

IFDHControl(3SMARTCARD) 				    Smartcard Library Functions 				   IFDHControl(3SMARTCARD)

NAME

       IFDHControl - send control information to an IFD

SYNOPSIS

       #include <smartcard/ifdhandler.h>

       RESPONSECODE IFDHControl(DWORD Lun, PUCHAR TxBuffer, DWORD TxLength, PUCHAR RxBuffer, PDWORD RxLength);

PARAMETERS

       The IFDHControl() function takes the following parameters:

   Input
       Lun	       Logical Unit Number

       TxBuffer        Control bytes to send

       TxLength        Length of bytes to send

       RxLength        Expected length of response

   Output
       RxBuffer        Buffer to receive response

       RxLength        Length of response received

DESCRIPTION

       The  IFDHControl()  performs control information exchange with some types of readers such as PIN pads, biometrics, and LCD panels according
       to the MCT and CTBCS specification. This function does not exchange data with the card.

RETURN VALUES

       The following values are returned:

       IFD_SUCCESS		       Successful completion.

       IFD_RESPONSE_TIMEOUT	       The response has timed out.

       IFD_COMMUNICATION_ERROR	       An error has occurred.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       IFDHCreateChannelByName(3SMARTCARD), 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						   IFDHControl(3SMARTCARD)
Man Page