Oracle Solaris Security for Developers Guide

Developing Smart Card Consumer Applications

The SCF API provides a set of interfaces for accessing smart cards. These interfaces provide communication to the cards in low-level application protocol data unit (APDU) form. These interfaces are provided in both C and Java. The interfaces work with all readers that are supported by the Solaris operating system and with any smart card that communicates with APDUs. The SCF API is based on the following components:

The SCF API provides functionality in the following areas:

The following sections provide information about the specific SCF interfaces.

SCF Session Interfaces

The following functions are used for SCF sessions.


Establishes a session with a system's smart card framework. After a session has been opened, the session can be used with SCF_Session_getTerminal(3SMARTCARD) to access a smart card terminal.


Releases the resources that were allocated when the session was opened. Also, closes any terminals or cards that are associated with that session.


Obtains information about a session.


Deallocates storage that is returned from SCF_Session_getInfo(3SMARTCARD).


Establishes a context with a specific smart card terminal in the session. Terminal objects are used for detecting card movement, that is, insertion or removal. Terminal objects are also used to create card objects for accessing a specific card.

SCF Terminal Interfaces

The following functions are used to access SCF terminals.


Releases the resources that were allocated when the terminal was opened. The function also closes any cards that were associated with the terminal.


Obtains information about a terminal.


Deallocates storage that has been returned from SCF_Terminal_getInfo(3SMARTCARD).


Blocks and waits until a card is present in the specified terminal.


Blocks and waits until the card in the specified terminal is removed.


Allows a program to receive callback notifications when events occur on a terminal. The concept is similar to a signal handler. When an event occurs, a service thread executes the provided callback function.


Updates the specified event listener that is associated with this terminal.


Removes the specified event listener from the listener list that is associated with this terminal.


Establishes a context with a specific smart card in a terminal. Card objects can be used to send APDUs to the card with SCF_Card_exchangeAPDU(3SMARTCARD).

SCF Card and Miscellaneous Interfaces

The following functions are used to access smart cards and to get status.


Releases resources, such as memory and threads, that were allocated when the card was opened. Also, releases the lock that was held by that card.


Obtains information about a card.


Deallocates storage that has been returned from SCF_Card_getInfo(3SMARTCARD).


Obtains a lock on a specific card. This function allows an application to perform a multiple APDU transaction without interference from other smart card applications.


Removes a lock from a specific card.


Sends a command APDU to a card and reads the card's response.


Checks to see if a specific card has been removed. If another card or even the same card has since been reinserted, the function reports that the old card was removed.


Resets a specific card.


Gets a string that describes a status code.