sec_rgy_login_get_info(3sec)

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 UUIDs 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

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_rgy_object_not_found
The specified account could not be found.

sec_rgy_server_unavailable
The DCE Registry Server is unavailable.

error_status_ok
The call was successful.

Related Information
Functions:

sec_intro(3sec)

sec_rgy_acct_add(3sec)

sec_rgy_login_get_effective(3sec)