Previous section.

DCE 1.1: Authentication and Security Services
Copyright © 1997 The Open Group

NAME

sec_rgy_pgo_add-Adds a PGO item to the registry database

SYNOPSIS

#include <dce/pgo.h>

void sec_rgy_pgo_add(
    sec_rgy_handle_t context,
    sec_rgy_domain_t name_domain,
    sec_rgy_name_t name,
    sec_rgy_pgo_item_t *pgo_item,
    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_domain

This variable identifies the type of the principal, group, or organization (PGO) item identified by the given name. The valid values are as follows:

sec_rgy_domain_person

The name identifies a principal.

sec_rgy_domain_group

The name identifies a group.

sec_rgy_domain_org

The name identifies an organization.

name

A pointer to a sec_rgy_name_t character string containing the name of the new PGO item.

pgo_item

A pointer to a sec_rgy_pgo_item_t structure containing the data for the new PGO item. The data in this structure includes the PGO item's name, UUID, UNIX number (if any), and administrative data, such as whether the item may have (or belong to) a concurrent group set.

Output

status

A pointer to the completion status. On successful completion, the routine returns error_status_ok. Otherwise, it returns an error.

DESCRIPTION

The sec_rgy_pgo_add() routine adds a PGO item to the registry database.

The PGO data consists of the following:

Permissions Required
The sec_rgy_pgo_add() routine requires the i (insert) permission on the parent directory in which the the PGO item is to be created.

NOTES

An account can be added to the registry database only when all its constituent PGO items are already in the database, and the appropriate membership relationships between them are established. For example, to establish an account with principal name tom, group name writers, and organization name hp, all three names must exist as independent PGO items in the database. Furthermore, tom must be a member of writers, which must be a member of hp. (See sec_rgy_acct_add() to add an account to the registry.)

FILES

/usr/include/dce/pgo.idl

The idl file from which dce/pgo.h was derived.

ERRORS

error_status_ok

The call was successful.

sec_rgy_not_authorized

The client program is not authorized to add the specified PGO item.

sec_rgy_object_exists

A PGO item already exists with the name given in name.

sec_rgy_server_unavailable

The Registry Server is unavailable.

SEE ALSO

Functions: sec_rgy_pgo_delete(), sec_rgy_pgo_rename(), sec_rgy_pgo_replace(), sec_rgy_acct_add().
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index