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_Session_getSession(3SMARTCARD)			    Smartcard Library Functions 			SCF_Session_getSession(3SMARTCARD)

NAME

       SCF_Session_getSession - establish a context with a system's smartcard framework

SYNOPSIS

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

       SCF_Status_t SCF_Session_getSession(SCF_Session_t *session);

PARAMETERS

       session	       A  pointer to an SCF_Session_t. If a session is successfully established, the session will be returned through this parame-
		       ter.

DESCRIPTION

       The SCF_Session_getSession() function establishes a session with the Solaris Smart Card Framework (SCF). Once a session	has  been  opened,
       the session can be used with SCF_Session_getTerminal(3SMARTCARD) to access a smartcard terminal (reader). Information about the session can
       be obtained by calling SCF_Session_getInfo(3SMARTCARD).

       When the session is no longer needed, SCF_Session_close(3SMARTCARD) should be called to end the	session  and  release  session	resources.
       Closing a session will also close any terminals and cards opened within the session.

       An  application	usually  needs	to open only a single session.	For example, multiple terminals can be opened from the same session. If an
       appication opens additional sessions, each call will return independent (different) sessions.

RETURN VALUES

       Upon success, SCF_STATUS_SUCCESS is returned and session contains a valid session. If a session could not be established, an error value is
       returned and session remains unaltered.

ERRORS

       The SCF_Session_getSession() function will fail if:

       SCF_STATUS_BADARGS      The session argument is a null pointer.

       SCF_STATUS_COMMERROR    The  library was unable to contact the smartcard server daemon (ocfserv(1M)), or the library was unable to obtain a
			       session from the server.

       SCF_STATUS_FAILED       An internal error occurred.

EXAMPLES

       Example 1: Establish a session with the framework.

       SCF_Status_t status;
       SCF_Session_t mySession;

       status = SCF_Session_getSession(&mySession);
       if (status != SCF_STATUS_SUCCESS) exit(1);

       /* Proceed with other smartcard operations. */

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_close(3SMARTCARD), SCF_Session_getInfo(3SMARTCARD), SCF_Session_getTerminal(3SMARTCARD), attributes(5)

SunOS 5.10							    28 Feb 2001 				SCF_Session_getSession(3SMARTCARD)