NAME

sec_login_setup_first-Create local host's current login context

SYNOPSIS

#include <dce/sec_login.h>

boolean32 sec_login_setup_first (
   sec_login_handle_t *login_context,
   error_status_t *status );

PARAMETERS

Output

login_context

The (unvalidated) login context associated with the host's principal/account (self).

status

The completion status.

DESCRIPTION

The sec_login_setup_first() routine creates (see the sec_login_setup_identity()routine) the local host's (unvalidated) current login context; that is, the login context associated with the host's principal/account (self).

If the host's current login context has previously been created (not necessarily validated) the routine fails.

Typically, this routine is called from a host's SCD (or from the host's initial process, sometimes called init), and inherited by the host's hierarchy of daemon processes.

This routine does not take a principal/account name as input (as does sec_login_setup_identity()) -it determines the host principal/account's name in an implementation-dependent manner.

RETURN VALUES

The routine returns a non-0 (TRUE) upon success, and 0 (FALSE) upon failure.

ERRORS

error_status_ok

sec_login_s_config

sec_login_s_default_use

sec_login_s_no_current_context

sec_login_s_no_memory

sec_login_s_privileged

sec_rgy_object_not_found

sec_rgy_server_unavailable

SEE ALSO

Functions: sec_login_init_first(), sec_login_setup_identity(), sec_login_validate_first().