Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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

IFDHSetCapabilities(3SMARTCARD) 			    Smartcard Library Functions 			   IFDHSetCapabilities(3SMARTCARD)

NAME

       IFDHSetCapabilities - set slot or card capabilities

SYNOPSIS

       #include <smartcard/ifdhandler.h>

       RESPONSECODE IFDHSetCapabilities(DWORD Lun, DWORD Tag, DWORD Length, PUCHAR Value);

PARAMETERS

       The IFDHSetCapabilities() function takes the following parameters:

   Input
       Lun	       Logical Unit Number

       Tag	       Tag of the desired data value

       Length	       Maximum length of the desired data value

       Value	       Value of the desired data

DESCRIPTION

       The IFDHSetCapabilities() function sets the slot or card capabilities for the slot or card specified by Lun.

RETURN VALUES

       The following values are returned:

       IFD_SUCCESS		       Successful completion.

       IFD_ERROR_TAG		       The tag is invalid.

       IFD_ERROR_SET_FAILURE	       The value of the data could not be set.

       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					   IFDHSetCapabilities(3SMARTCARD)
Man Page