Query: scf_session_getsession
OS: sunos
Section: 3smartca
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
SCF_Session_getSession(3SMARTCARD) Smartcard Library Functions SCF_Session_getSession(3SMARTCARD)NAMESCF_Session_getSession - establish a context with a system's smartcard frameworkSYNOPSIScc [ flag... ] file... -lsmartcard [ library...] #include <smartcard/scf.h> SCF_Status_t SCF_Session_getSession(SCF_Session_t *session);PARAMETERSsession A pointer to an SCF_Session_t. If a session is successfully established, the session will be returned through this parame- ter.DESCRIPTIONThe 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 VALUESUpon 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.ERRORSThe 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.EXAMPLESExample 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. */ATTRIBUTESSee attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+SEE ALSOlibsmartcard(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)
Similar Topics in the Unix Linux Community |
---|
Cannot backspace on my session in CRT |
displaying remote x sesson in suse 9.3 |
NFS mount smartcard reader |
Smartcard in redhat 5.7 |