GSS_CONTEXT_TIME(3GSS) Generic Security Services API Library Functions


NAME


gss_context_time - determine how long a context will remain valid

SYNOPSIS


cc [ flag... ] file... -lgss [ library... ]
#include <gssapi/gssapi.h>

OM_uint32 gss_context_time(OM_uint32 *minor_status,
gss_ctx_id_t *context_handle,OM_uint32 *time_rec);


DESCRIPTION


The gss_context_time() function determines the number of seconds for
which the specified context will remain valid.

PARAMETERS


The parameter descriptions for gss_context_time() are as follows:

minor_status
A mechanism-specific status code.


context_handle
A read-only value. Identifies the context to be
interrogated.


time_rec
Modifies the number of seconds that the context remains
valid. If the context has already expired, returns
zero.


ERRORS


The gss_context_time() function returns one of the following status
codes:

GSS_S_COMPLETE
Successful completion.


GSS_S_CONTEXT_EXPIRED
The context has already expired.


GSS_S_NO_CONTEXT
The context_handle parameter did not identify a
valid context.


GSS_S_FAILURE
The underlying mechanism detected an error for
which no specific GSS status code is defined.
The mechanism-specific status code reported by
means of the minor_status parameter details the
error condition.


ATTRIBUTES


See attributes(5) for descriptions of the following attributes:


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT Level | Safe |
+---------------+-----------------+

SEE ALSO


gss_init_sec_context(3GSS), gss_accept_sec_context(3GSS),
gss_delete_sec_context(3GSS), gss_process_context_token(3GSS),
gss_inquire_context(3GSS), gss_wrap_size_limit(3GSS),
gss_export_sec_context(3GSS), gss_import_sec_context(3GSS), attributes(5)


Solaris Security for Developers Guide


January 15, 2003 GSS_CONTEXT_TIME(3GSS)