PreviousNext

sec_rgy_login_get_effective(3sec)

Returns the effective login data for an account

Synopsis

#include <dce/misc.h>

void sec_rgy_login_get_effective(
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,
sec_override_fields_t *
overridden,
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 returned Subject Identifier (SID) for the account. This structure consists of the UUIDs for the account's PGO items.

unix_sid
A pointer to a sec_rgy_unix_sid_t structure to receive the returned UNIX Subject Identifier (SID) for the account. This structure consists of 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.

overridden
A pointer to a 32-bit set of flags identifying the local overrides, if any, for the account login information.

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_effective( ) routine returns effective login information for the specified account. Login information is extracted from the account's entry in the registry database. Effective login information is a combination of the login information from the registry database and any login overrides defined for the account on the local machine.

The overridden parameter indicates which, if any, of the following local overrides have been defined for the account:

· The UNIX user ID

· The group ID

· The encrypted password

· The account's miscellaneous information (gecos) field

· The account's home directory

· The account's login shell

Local overrides for account login information are defined in the /etc/passwd_override file and apply only to the local machine.

Files

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

/etc/passwd_override
The file that defines local overrides for account login information.

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_info(3sec)

Files: passwd_override(5sec)