| ## 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) ##