sec_acl_bind(3sec)

Synopsis

#include <dce/daclif.h>

void sec_acl_bind(
unsigned char *entry_name,

boolean32 bind_to_entry,
sec_acl_handle_t *h,
error_status_t *status);

Parameters

Input

entry_name
The name of the target object. Subsequent ACL operations using the returned handle will affect the ACL of this object.

bind_to_entry
Bind indicator, for use when entry_name identifies both an entry in the global namespace and an actual object. A TRUE value binds the handle to the entry in the namespace, while FALSE binds the handle to the actual object.

Output

h
A pointer to the sec_acl_handle_t variable to receive the returned ACL handle. The other sec_acl routines use this handle to refer to the ACL for the object specified with entry_name.

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

Notes
If the specified name is both an actual object, and an entry in the global namespace, there are two ACLs associated with it. For example, in addition to the ACL normally attached to file system objects, the root directory of a file system has an ACL corresponding to its entry in the global namespace. This controls access by outsiders to the entire file system, whereas the resident ACL for the root directory only controls access to the directory and, by inheritance, its subdirectories. The ambiguity must be resolved with the bind_to_entry parameter.

Description
The sec_acl_bind( ) routine returns a handle bound to the indicated object's ACL. This routine is central to all the other sec_acl routines, each of which requires this handle to identify the ACL on which to operate.

Files

/usr/include/dce/daclif.idl
The idl file from which dce/daclif.h was derived.

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_object_not_found
The requested object could not be found.

sec_acl_no_acl_found
There is no ACL associated with the specified object.

error_status_ok
The call was successful.

Related Information
Functions: sec_intro(3sec)