sec_rgy_unix_getpwnam-Returns a UNIX-style password structure for account matching the specified name
#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);
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.
The sec_rgy_unix_getpwnam() routine returns the next UNIX-style password structure that matches the input name. The structure is in the form:The structure includes: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 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.
- /usr/include/dce/rgynbase.idl
The idl file from which rgynbase.h was derived.
- 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.
Contents | Next section | Index |