Windows PowerShell command on Get-command gss_inquire

Manual Pages for UNIX Operating System command usage for man gss_inquire_context

Generic Security Services API Library Functions

gss_inquire_context(3GSS)

NAME

gss_inquire_context - obtain information about a security

context

SYNOPSIS

cc [ flag... ] file... -lgss [ library... ]

#include

OM_uint32 gss_inquire_context(OM_uint32 *minor_status,

const gss_ctx_id_t context_handle,gss_name_t *src_name,

gss_name_t *targ_name, OM_uint32 *lifetime_rec,

gss_OID *mech_type, OM_uint32 *ctx_flags,

int *locally_initiated, int *open);

DESCRIPTION

The gss_inquire_context() function obtains information about

a security context. The caller must already have obtained a handle that refers to the context, although the context need not be fully established.

PARAMETERS

The parameter descriptions for gss_inquire_context() are as

follows:

minor_status A mechanism-specific status code.

context_handle A handle that refers to the security

context.

src_name The name of the context initiator. If

the context was established using anonymous authentication, and if the application invoking

gss_inquire_context() is the context

acceptor, an anonymous name is returned. Storage associated with this name must be freed by the application after use with a call to

gss_release_name(). Specify NULL if the

parameter is not required.

targ_name The name of the context acceptor.

Storage associated with this name must be freed by the application after use

with a call to gss_release_name(). If

the context acceptor did not authenti-

cate itself, and if the initiator did

SunOS 5.11 Last change: 17 Jan 2003 1

Generic Security Services API Library Functions

gss_inquire_context(3GSS)

not specify a target name in its call

to gss_init_sec_context(), the value

GSS_C_NO_NAME is returned. Specify NULL

if the parameter is not required.

lifetime_rec The number of seconds for which the

context will remain valid. If the con-

text has expired, this parameter will be set to zero. Specify NULL if the parameter is not required.

mech_type The security mechanism providing the

context. The returned OID is a pointer to static storage that should be

treated as read-only by the applica-

tion; in particular, the application should not attempt to free it. Specify NULL if the parameter is not required.

ctx_flags Contains various independent flags,

each of which indicates that the con-

text supports (or is expected to sup-

port, if ctx_open is false) a specific

service option. If not needed, specify NULL. Symbolic names are provided for each flag, and the symbolic names corresponding to the required flags should be logically ANDed with the

ret_flags value to test whether a given

option is supported by the context. The flags are:

GSS_C_DELEG_FLAG If true,

credentials were delegated

from the ini-

tiator to the acceptor. If false, no credentials were delegated.

GSS_C_MUTUAL_FLAG If true, the

acceptor was authenticated to the

SunOS 5.11 Last change: 17 Jan 2003 2

Generic Security Services API Library Functions

gss_inquire_context(3GSS)

initiator. If false, the acceptor did

not authenti-

cate itself.

GSS_C_REPLAY_FLAG If true, the

replay of pro-

tected mes-

sages will be detected. If false,

replayed mes-

sages will not be detected.

GSS_C_SEQUENCE_FLAG If true, out-

of-sequence

protected mes-

sages will be detected. If

false, out-

of-sequence

messages will not be detected.

GSS_C_CONF_FLAG If true, con-

fidential ser-

vice may be invoked by calling the

gss_wrap(3GSS)

routine. If

false, no con-

fidential ser-

vice is avail-

able through

gss_wrap().

gss_wrap()

provides mes-

sage encapsu-

lation, data-

origin authen-

tication, and

integrity ser-

vices only.

SunOS 5.11 Last change: 17 Jan 2003 3

Generic Security Services API Library Functions

gss_inquire_context(3GSS)

GSS_C_INTEG_FLAG If true,

integrity ser-

vice can be invoked by calling either the

gss_get_mic()

or the

gss_wrap()

routine. If

false, per-

message

integrity ser-

vice is una-

vailable.

GSS_C_ANON_FLAG If true, the

initiator's identity is not revealed

to the accep-

tor. The

src_name

parameter, if requested, contains an anonymous internal name. If false, the initiator has

been authenti-

cated nor-

mally.

GSS_C_PROT_READY_FLAG If true, the

protection services, as specified by the states of the

GSS_C_CONF_FLAG

and

GSS_C_INTEG_FLAG,

are available for use. If false, they are available only if the context is

SunOS 5.11 Last change: 17 Jan 2003 4

Generic Security Services API Library Functions

gss_inquire_context(3GSS)

fully esta-

blished, that is, if the open parameter

is non-zero.

GSS_C_TRANS_FLAG If true,

resultant

security con-

text can be transferred to other processes through a call to

gss_export_sec_context().

If false, the

security con-

text is not transferable.

locally_initiated Non-zero if the invoking application is

the context initiator. Specify NULL if the parameter is not required.

open Non-zero if the context is fully esta-

blished; zero if a context-

establishment token is expected from the peer application. Specify NULL if the parameter is not required.

ERRORS

gss_inquire_context() returns one of the following status

codes:

GSS_S_COMPLETE Successful completion.

GSS_S_NO_CONTEXT The referenced context could not be

accessed.

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

SunOS 5.11 Last change: 17 Jan 2003 5

Generic Security Services API Library Functions

gss_inquire_context(3GSS)

minor_status parameter details the error

condition.

ATTRIBUTES

See attributes(5) for descriptions of the following attri-

butes:

____________________________________________________________________

| ATTRIBUTE TYPE | ATTRIBUTE VALUE |

|_____________________________|_____________________________________|

| Availability | system/library/security/gss (32-bit)|

|_____________________________|_____________________________________|

| | SUNWgssx (64-bit) |

|_____________________________|_____________________________________|

| MT-Level | Safe |

|_____________________________|_____________________________________|

gss_inquire_context(3GSS)

SunOS 5.11 Last change: 17 Jan 2003 7

Manual Pages for UNIX Operating System command usage for man gss_inquire_context

gss_inquire_context(3GSS)

NAME

gss_inquire_context - obtain information about a security

SYNOPSIS

OM_uint32 gss_inquire_context(OM_uint32 *minor_status,

DESCRIPTION

The gss_inquire_context() function obtains information about

PARAMETERS

The parameter descriptions for gss_inquire_context() are as

gss_inquire_context() is the context

gss_inquire_context(3GSS)

GSS_C_NO_NAME is returned. Specify NULL

gss_inquire_context(3GSS)

gss_inquire_context(3GSS)

gss_inquire_context(3GSS)

ERRORS

gss_inquire_context() returns one of the following status

GSS_S_NO_CONTEXT The referenced context could not be

gss_inquire_context(3GSS)

ATTRIBUTES

| ATTRIBUTE TYPE | ATTRIBUTE VALUE |

SEE ALSO

gss_inquire_context(3GSS)