PreviousNext

sec_acl_get_mgr_types_semantics(3sec)

Lists the manager types of the ACLs protecting an object

Synopsis

#include <dce/daclif.h>

void sec_acl_get_mgr_types_semantics(
sec_acl_handle_t h,
sec_acl_type_t
sec_acl_type,
unsigned32
size_avail,
unsigned32 *
size_used,
unsigned32 *
num_types,
uuid_t
manager_types[ ],
sec_acl_posix_semantics_t
posix_semantics[ ],
error_status_t *
status);

Parameters

Input

h
A handle referring to the target object. Use sec_acl_bind( ) to create this handle.

sec_acl_type
The ACL type. The sec_acl_type_t data type distinguishes the various types of ACLs an object can possess for a given manager type. The possible values are as follows:

· sec_acl_type_object

· sec_acl_type_default_object

· sec_acl_type_default_container

size_avail
An unsigned 32-bit integer containing the allocated length of the manager_types[ ] array.

Output

size_used
An unsigned 32-bit integer containing the number of output entries returned in the manager_types[ ] array.

num_types
An unsigned 32-bit integer containing the number of types returned in the manager_types[ ] array. This may be greater than size_used if there was not enough space allocated in the manager_types[ ] array for all the manager types.

manager_types[ ]
An array of length size_avail to contain UUIDs (of type uuid_t) identifying the different types of ACL managers protecting the target object.

posix_semantics[ ]
An array of POSIX semantics supported by each manager type with entries of type sec_acl_posix_semantics_t.

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

Description
The sec_acl_get_mgr_types_semantics( ) routine returns a list of the manager types of ACLs of type sec_acl_type that are protecting the object identified by h. For example, in addition to the regular file system ACL, a file representing the stable storage of some database could have an ACL manager that supported permissions allowing database updates only on certain days of the week.

ACL editors and browsers can use this operation to determine the ACL manager types that a particular reference monitor is using to protect a selected entity. Then, using the sec_acl_get_printstring( ) routine, they can determine how to format for display the permissions supported by a specific manager.

Permissions Required
The sec_acl_get_mgr_types_semantics( ) routine requires at least one permission of any kind on the object for which the ACL manager types are to be returned.

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.

error_status_ok
The call was successful.

Related Information
Functions:

sec_intro(3sec)

sec_acl_bind(3sec)

sec_acl_get_printstring(3sec)