NAME

sec_rgy_unix_getpwuid — Returns a UNIX style passwd entry for the account matching the specified UID

Synopsis

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

contextAn opaque handle bound to a registry server.  Use sec_rgy_site_open() to acquire a bound handle. 

uidA 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. 

statusOn 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 following:

   •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).