NAME

sec_rgy_login_get_info-Returns login information for an account

SYNOPSIS

#include <dce/misc.h>

void sec_rgy_login_get_info(
    sec_rgy_handle_t context,
    sec_rgy_login_name_t *login_name,
    sec_rgy_acct_key_t *key_parts,
    sec_rgy_sid_t *sid,
    sec_rgy_unix_sid_t *unix_sid,
    sec_rgy_acct_user_t *user_part,
    sec_rgy_acct_admin_t *admin_part,
    sec_rgy_plcy_t *policy_data,
    signed32 max_number,
    signed32 *supplied_number,
    uuid_t id_projlist[],
    signed32 unix_projlist[],
    signed32 *num_projects,
    sec_rgy_name_t cell_name,
    uuid_t *cell_uuid,
    error_status_t *status);

PARAMETERS

Input

context

The registry server handle.

max_number

The maximum number of projects to be returned by the call. This must be no larger than the allocated size of the projlist arrays.

Input/Output

login_name

A pointer to the account login name. A login name is composed of the names for the account's principal, group, and organization (PGO) items.

Output

key_parts

A pointer to the minimum abbreviation allowed when logging in to the account. Abbreviations are not currently implemented and the only legal value is sec_rgy_acct_key_person.

sid

A pointer to a sec_rgy_sid_t structure to receive the UUID's representing the account's PGO items.

unix_sid

A pointer to a sec_rgy_unix_sid_t structure to receive the UNIX numbers for the account's PGO items.

user_part

A pointer to a sec_rgy_acct_user_t structure to receive the returned user data for the account.

admin_part

A pointer to a sec_rgy_acct_admin_t structure to receive the returned administrative data for the account.

policy_data

A pointer to a sec_rgy_policy_t structure to receive the policy data for the account. The policy data is associated with the account's organization, as identified in the login name.

supplied_number

A pointer to the actual number of projects returned. This will always be less than or equal to the max_number supplied on input.

id_projlist[]

An array to receive the UUID of each project returned. The size allocated for the array is given by max_number. If this value is less than the total number of projects in the account project list, multiple calls must be made to return all of the projects.

unix_projlist[]

An array to receive the UNIX number of each project returned. The size allocated for the array is given by max_number. If this value is less than the total number of projects in the account project list, multiple calls must be made to return all of the projects.

num_projects

A pointer indicating the total number of projects in the specified account's project list.

cell_name

The name of the account's cell.

cell_uuid

The UUID for the account's cell.

status

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

DESCRIPTION

The sec_rgy_login_get_info() routine returns login information for the specified account. This information is extracted from the account's entry in the registry database. To return any local overrides for the account's login data, use sec_rgy_login_get_effective().

Permissions Required

The sec_rgy_login_get_info() routine requires the r (read) permission on the account principal from which the data is to be returned.

FILES

/usr/lib/dce/misc.idl

The idl file from which dce/misc.h was derived.

ERRORS

error_status_ok

The call was successful.

sec_rgy_object_not_found

The specified account could not be found.

sec_rgy_server_unavailable

The DCE Registry Server is unavailable.

SEE ALSO

Functions: sec_rgy_acct_add(), sec_rgy_login_get_effective().