NAME

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

Synopsis

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

aclA pointer to the ACL that is to be modified. 

entry_typeMust 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

permsetThe permissions to be granted to the foreign group or foreign user. 

realmThe UUID of the foreign cell. 

idThe UUID identifying the foreign group or foreign user. 

Output

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