sec_rgy_unix_getpwuid(3sec)

Synopsis

#include <dce/rgynbase.h>

void sec_rgy_unix_getpwuid(
sec_rgy_handle_t context,
signed32 uid,
sec_rgy_cursor_t *item_cursor,
sec_rgy_unix_passwd_t *passwd_entry,
error_status_t *status);

Parameters

Input

context
An opaque handle bound to a registry server. Use sec_rgy_site_open( ) to acquire a bound handle.

uid
A 32-bit integer UNIX ID.

Input/Output

item_cursor
An opaque pointer indicating a specific PGO item entry in the registry database. The sec_rgy_unix_getpwuid( ) routine returns the PGO item indicated by item_cursor, and advances the cursor to point to the next item in the database. When the end of the list of entries is reached, the routine returns sec_rgy_no_more_entries. Use sec_rgy_cursor_reset( ) to refresh the cursor.

Output

passwd_entry
A UNIX style password structure returned with information about the account matching uid.

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

Description
The sec_rgy_unix_getpwuid( ) routine looks up the next passwd entry in the registry that matches the input UNIX ID and returns the corresponding sec_rgy_passwd structure. The structure is in the following form:

typedef struct {
sec_rgy_unix_login_name_t name;
sec_rgy_unix_passwd_buf_t passwd;
signed32 Vuid;
signed32 Vgid;
signed32 oid;
sec_rgy_unix_gecos_t gecos;
sec_rgy_pname_t homedir;
sec_rgy_pname_t shell;
} sec_rgy_unix_passwd_t;

The structure includes

· The account's login name.

· The account's password.

· The account's UNIX ID.

· The UNIX ID of group and organization associated with the account.

· The account's GECOS information.

· The account's home directory.

· The account's login shell

Files

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

This call is provided in source code form.

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_no_more_entries
The end of the list of entries has been reached.

sec_rgy_server_unavailable
The DCE Registry Server is unavailable.

error_status_ok
The call was successful.

Related Information
Functions: sec_intro(3sec)