Previous section.

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

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:

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.

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