dce_acl_copy_acl(3sec)

Synopsis

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

void dce_acl_copy_acl(
sec_acl_t *source,
sec_acl_t *target,
error_status_t *status);

Parameters

Input

source
A pointer to the ACL to be copied.

target
A pointer to the new ACL that is to receive the copy.

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_copy_acl( ) routine makes a copy of a specified ACL. The caller passes the space for the target ACL, but the space for the sec_acl_entries array is allocated. To free the allocated space, call dce_acl_obj_free_entries( ), which frees the entries, but not the ACL itself.

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.

rpc_s_no_memory
The rpc_sm_allocate( ) routine could not obtain memory.

error_status_ok
The call was successful.

Related Information
Functions: dce_acl_obj_free_entries(3sec)