scf_strerror(3smartca) [sunos man page]

SCF_strerror(3SMARTCARD)				    Smartcard Library Functions 				  SCF_strerror(3SMARTCARD)

NAME

       SCF_strerror - get a string describing a status code

SYNOPSIS

       cc [ flag... ] file... -lsmartcard [ library...]
       #include <smartcard/scf.h>

       const char *SCF_strerror(SCF_Status_t error);

PARAMETERS

       error	       A value returned from a smartcard SCF function call. A list of all current codes is contained in <smartcard/scf.h>

DESCRIPTION

       The SCF_strerror() function provides a mechanism for generating a brief message that describes each SCF_Status_t error code. An application
       might use the message when displaying or logging errors.

       The string returned by the function does not contain any newline characters. Returned strings must not be modified or freed by the caller.

RETURN VALUES

       A pointer to a valid string is always returned. If the provided error is not a valid SCF error code, a string is returned stating that  the
       error code is unknown. A null pointer is never returned.

EXAMPLES

       Example 1: Report a fatal error.

       SCF_Status_t status;
       SCF_Session_t mySession;

       status = SCF_Session_getSession(&mySession);
       if (status != SCF_STATUS_SUCCESS) {
	   printf("Smartcard startup error: %s
", SCF_strerror(status));
	   exit(1);
       }

       /* ... */

USAGE

       Messages  returned  from  SCF_strerror() are in the native language specified by the LC_MESSAGES locale category; see setlocale(3C).  The C
       locale is used if the native strings could not be loaded.

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_Session_getSession(3SMARTCARD), strerror(3C), attributes(5)

SunOS 5.10							    14 May 2002 					  SCF_strerror(3SMARTCARD)

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)