The PGO items in the registry database are created and maintained with routines that are prefixed with sec_rgy_pgo_. The contents of a PGO item vary with the domain. If the domain is group or organization, the contents are the membership list of principal names. If the domain is principal, the contents are the data corresponding to the registry account using that name.
The sec_rgy_pgo_*( ) interface contains the following calls for maintaining the PGO trees:
· sec_rgy_pgo_add( )
Adds a PGO item
· sec_rgy_pgo_delete( )
Deletes a PGO item
· sec_rgy_pgo_rename( )
Changes the name of a PGO item
· sec_rgy_pgo_replace( )
Replaces information corresponding to the specified PGO item
The sec_rgy_pgo_*( ) interface contains the following calls for maintaining PGO membership lists:
· sec_rgy_pgo_add_member( )
Adds a member to a group or organization membership list
· sec_rgy_pgo_delete_member( )
Deletes a member from a group or organization membership list
· sec_rgy_pgo_get_members( )
Returns a list of members of a group or organization
· sec_rgy_pgo_is_member( )
Tests whether a principal is a member of a specified group or organization
The sec_rgy_pgo_*( ) interface contains the following calls for retrieving PGO item data:
· sec_rgy_pgo_get_by_id( )
Returns the PGO item with the specified UUID
· sec_rgy_pgo_get_by_eff_unix_num( )
Returns the PGO item with the specified effective UNIX number
· sec_rgy_pgo_get_by_name( )
Returns the PGO item with the specified name
· sec_rgy_pgo_get_by_unix_num( )
Returns the PGO item with the specified UNIX number
· sec_rgy_pgo_get_next( )
Returns the PGO item that follows the last PGO item returned
The sec_rgy_pgo_*( ) interface also contains routines that convert PGO item specifiers, as follows:
· sec_rgy_pgo_id_to_name( )
· sec_rgy_pgo_id_to_unix_num( )
· sec_rgy_pgo_name_to_id( )
· sec_rgy_pgo_unix_num_to_id( )
· sec_rgy_pgo_name_to_unix_num( )
· sec_rgy_pgo_unix_num_to_name( )