NAME

sec_acl_calc_mask — Returns the sec_acl_type_mask_obj entry for the specified ACL list

Synopsis

void sec_acl_calc_mask(
sec_acl_list_t ∗sec_acl_list,
error_status_t ∗status);

Parameters

Input/Output

sec_acl_list
A pointer to a sec_acl_type_t  the specifies the number of ACLs of each ACL type.  The sec_acl_type_t data type distinguishes between the various types of ACLs an object can possess for a given manager.  In the file system, for example, most objects have only one ACL, controlling the access to that object, but objects that control the creation of other objects (sometimes referred to as containers) may have more.  A directory, for example, can have ACLs to be used as initial values when member objects are created. 

Do not confuse ACL types with the permissions corresponding to different ACL manager types or with the ACL manager types themselves. 

Output

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

Description

The sec_acl_calc_mask() routine calculates and sets the sec_acl_e_type_mask_obj entry of the specified ACL list.  The value of the sec_acl_e_type_mask_obj entry is the union of the permissions of all ACL entries that refer to members of the file group class. 

This operation is performed locally, within the client.  The function does not check to determine if the manager to which the specified ACL list will be submitted supports the sec_acl_e_type_mask_obj entry type.  The calling application must determine whether to call this routine, after obtaining the required, if any, POSIX semantics, via the sec_acl_get_mgr_types_semantics() routine. 

Notes

This call is provided in source code form. 

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_cant_allocate_memory
Requested operation requires more memory than is available.

error_status_ok
The call was successful.

Related Information

Functions: sec_intro(3sec).