PreviousNext

dce_acl_obj_add_foreign_entry(3sec)

Adds permissions for an ACL entry for a foreign user or group to the given ACL

Synopsis

#include <dce/dce.h>
#include <dce/aclif.h>

void dce_acl_obj_add_foreign_entry(
sec_acl_t *acl,
sec_acl_entry_type_t
entry_type,
sec_acl_permset_t
permset,
uuid_t *
realm,
uuid_t *
id,
error_status_t *
status);

Parameters

Input

acl
A pointer to the ACL that is to be modified.

entry_type
Must be one of the following types:

· sec_acl_e_type_foreign_user

· sec_acl_e_type_foreign_group

· sec_acl_e_type_for_user_deleg

· sec_acl_e_type_for_group_deleg

permset
The permissions to be granted to the foreign group or foreign user.

realm
The UUID of the foreign cell.

id
The UUID identifying the foreign group or foreign user.

Output

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

Description
The dce_acl_obj_add_foreign_entry( ) routine adds an ACL entry for sec_acl_e_type_foreign_xxx access to the specified ACL.

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_acl_invalid_entry_type
The type specified in entry_type is not one of the four specified types.

error_status_ok
The call was successful.

Related Information
Functions:

dce_acl_obj_add_id_entry(3sec)

sec_id_parse_name(3sec)