dce_acl_obj_init(3sec)

Synopsis

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

void dce_acl_obj_init(
uuid_t *mgr_type,
sec_acl_t *acl,
error_status_t *status);

Parameters

Input

mgr_type
A pointer to the UUID identifying the type of the ACL manager in question. There may be more than one type of ACL manager protecting the object whose ACL is bound to the input handle. Use this parameter to distinguish them.

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

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_init( ) routine initializes an ACL. The caller passes in the pointer to the already-existing ACL structure (of type sec_acl_t), for which the caller provides the space.

Examples
This example shows the use of dce_acl_obj_init( ) and the corresponding routine to free the entries, dce_acl_obj_free_entries( ).

sec_acl_t acl;
extern uuid_t my_mgr_type;
error_status_t status;
dce_acl_obj_init(&my_mgr_type, &acl, &status);
/* ... use the ACL ... */
dce_acl_obj_free_entries(&acl, &status);

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.

error_status_ok
The call was successful.

Related Information
Functions: dce_acl_obj_free_entries(3sec)