NAME

sec_rgy_unix_getpwuid-Returns a UNIX-style password structure for the account matching the specified UUID

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 password entry in the registry that matches the input UNIX ID and returns the corresponding sec_rgy_unix_passwd_t 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

This call is provided in source code form.

FILES

/usr/include/dce/rgynbase.idl

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

ERRORS

error_status_ok

The call was successful.

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.