| ## sec_rgy_unix_getpwuid(3sec) Returns a UNIX style passwd entry for the account matching the specified UID Synopsis #include <dce/rgynbase.h> void sec_rgy_unix_getpwuid( sec_rgy_handle_t context, signed32 uid, 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. uid A 32-bit integer UNIX ID. Input/Output item_cursor An opaque pointer indicating a specific PGO item entry in the registry database. The sec_rgy_unix_getpwuid( ) 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 uid. status On successful completion, the routine returns error_status_ok. Otherwise, it returns an error. Description The sec_rgy_unix_getpwuid( ) routine looks up the next passwd entry in the registry that matches the input UNIX ID and returns the corresponding sec_rgy_passwd structure. The structure is in the following form: typedef struct { sec_rgy_unix_login_name_t name; sec_rgy_unix_passwd_buf_t passwd; signed32 Vuid; signed32 Vgid; 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 Files /usr/include/dce/rgynbase.idl The idl file from which dce/rgynbase.h was derived. This call is provided in source code form. 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_no_more_entries The end of the list of entries has been reached. sec_rgy_server_unavailable The DCE Registry Server is unavailable. error_status_ok The call was successful. Related Information Functions: sec_intro(3sec) ##