Previous section.

DCE 1.1: Authentication and Security Services
Copyright © 1997 The Open Group

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:

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.

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index