sec_login_setup_first(3sec)

Synopsis

#include <dce/sec_login.h>

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

Parameters

Output

init_context
A pointer to an opaque handle to login context data. The login context contains, among other data, the account principal name and UUID, account restrictions, records of group membership, and the process home directory. In this call, the context will be that of the host machine initial process. (See sec_intro(3sec) for more details about the login context.)

status
A pointer to the completion status. On successful completion, status is assigned error_status_ok. Otherwise, it returns an error.

Description
The sec_login_setup_first( ) routine sets up the default context network identity. If the default context already contains valid credentials, the routine fails. Typically, this routine is called from the Security Validation Service of the dced process to breathe life into the default credentials for the host machine process hierarchy.

This routine uses the hostname available via the local dce_config interface as the principal name for the setup, so it does need a principal name as input.

Return Values
The routine returns a boolean32 value that is TRUE if the setup was successful, and FALSE otherwise.

Files

/usr/include/dce/sec_login.idl
The idl file from which dce/sec_login.h was derived.

Errors

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

sec_login_s_default_use
The default context is already in use and does not need to be set up again.

sec_login_s_no_current_context
The calling process has no context of its own.

sec_login_s_privileged
An unprivileged process was called in.

sec_login_s_config
The DCE configuration (dce_config) information is not available.

sec_rgy_object_not_found
The principal does not exist.

sec_rgy_server_unavailable
The network registry is not available.

sec_login_s_no_memory
A memory allocation error occurred.

error_status_ok
The call was successful.

Related Information
Functions:

sec_intro(3sec)

sec_login_init_first(3sec)

sec_login_validate_first(3sec)