PreviousNext

sec_rgy_unix_getpwnam(3sec)

Returns a UNIX style passwd entry 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 passwd 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 passwd 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

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 bad_data
The name supplied as input was too long.

error_status_ok
The call was successful.

sec_rgy_no_more_entries
The end of the list of entries has been reached.

Related Information
Functions: sec_intro(3sec)