Previous section.

DCE 1.1: Authentication and Security Services
Copyright © 1997 The Open Group

NAME

sec_login_set_context-Set a login context (including making it current)

SYNOPSIS

#include <dce/sec_login.h>

void sec_login_set_context (
    sec_login_handle_t login_context,
    error_status_t *status );

PARAMETERS

Input

login_context

The login context to be set.

Output

status

The completion status.

DESCRIPTION

The sec_login_set_context() routine sets a (validated) login context; that is, registers it in the sense of making it (potentially) accessible to other processes on the local host, and makes it the calling process' current login context.

In typical implementations, this routine writes the login context information to a file called the login context's (credential) cache file on the local host (this file contains this login context's information only), thereby making it (potentially) accessible to other processes (provided they know the name of this file and have access privilege to the file). This routine also records the name of this file in an (implementation-specific) well-known environment variable (typically, KRB5CCNAME), thereby marking it as the calling process' current login context, and (implicitly) passing the file's name to its child processes.

ERRORS

error_status_ok

sec_login_s_auth_local

sec_login_s_context_invalid

sec_login_s_default_use

sec_login_s_internal_error

SEE ALSO

Functions: sec_login_get_current_context().
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index