NAME

sec_rgy_unix_getpwnam-Returns a UNIX-style password structure for account matching the specified name

SYNOPSIS

#include <dce/rgynbase.h>

void sec_rgy_unix_getpwnam (
    sec_rgy_handle_t context, 
    sec_rgy_name_t name,
    unsigned32 name_len,
    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.

name

A character string (of type sec_rgy_name_t) containing the name of the person, group, or organization whose name entry is desired.

name_len

A 32-bit integer representing the length of the name in characters.

Input/Output

item_cursor

An opaque pointer indicating a specific PGO item entry in the registry database. The sec_rgy_unix_getpwnam() 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 name.

status

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

DESCRIPTION

The sec_rgy_unix_getpwnam() routine returns the next UNIX-style password structure that matches the input name. The structure is in the form:

typedef struct {
    sec_rgy_unix_login_name_t   name;
    sec_rgy_unix_passwd_buf_t   passwd;
    signed32                    uid;
    signed32                    gid;
    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 rgynbase.h was derived.

ERRORS

error_status_ok

The call was successful.

sec_rgy_bad_data

The name supplied as input was too long.

sec_rgy_no_more_entries

The end of the list of entries has been reached.