*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> acl_valid (3)              



NAME    [Toc]    [Back]

       acl_valid - Checks an ACL for validity

SYNOPSIS    [Toc]    [Back]

       #include <sys/acl.h>

       int acl_valid(
               acl_t acl_d,
               acl_entry_t *entry_p );

LIBRARY    [Toc]    [Back]

       Security Library (libpacl.a)

PARAMETERS    [Toc]    [Back]

       Specifies  the  working storage internal representation of
       an ACL.  Pointer to the location that holds a returned ACL

DESCRIPTION    [Toc]    [Back]

       NOTE:   This  function  is  based on Draft 13 of the POSIX
       P1003.6 standard.

       The acl_valid() function checks the ACL for validity.   An
       ACL  is invalid if one or more of the following conditions
       are violated: The three  required  entries  (ACL_USER_OBJ,
       ACL_GROUP_OBJ, and ACL_OTHER_OBJ) must appear exactly once
       in an ACL of type ACL_TYPE_ACCESS, and in a non-empty  ACL
       must not contain a duplicate entry.  An  entry  is  duplicated
  if another entry in the same ACL has the same entry
       tag type and the same tag qualifier (sameness  or  difference
 in permissions is not relevant).

RETURN VALUES    [Toc]    [Back]

       Upon   successful  completion,  the  acl_valid()  function
       returns a value of 0 (zero). Otherwise, a value of  -1  is
       returned, and the errno global variable is set to indicate
       the error.

ERRORS    [Toc]    [Back]

       For the following condition, the acl_valid() function sets
       the  location  specified by the entry_p parameter with the
       value of the ACL entry for which one  or  more  duplicates
       exist elsewhere in the ACL.  The ACL contains entries that
       are not unique.

       For the following  conditions,  the  acl_valid()  function
       sets  the  location  indicated by the entry_p parameter to
       the NULL value.  The acl_d parameter does not refer  to  a
       valid ACL.

              One or more of the required entries is not present.

SEE ALSO    [Toc]    [Back]

       acl_create_entry(3),      acl_init(3),      acl_get_fd(3),
       acl_get_file(3), acl_set_fd(3), acl_set_file(3), acl(4)


[ Back ]
 Similar pages
Name OS Title
DTtcvalid IRIX check a dat timecode for validity
named-checkzone HP-UX zone validity checking tool
res_hnok IRIX name service record validity routines
mvalid Tru64 Check memory region for validity
testprns.1 IRIX check printer name for validity with smbd
named-checkzone OpenBSD zone file validity checking tool
chkprintcap FreeBSD check validity of entries in the print spooler database
XmRepTypeValidValue Tru64 A representation type manager function that tests the validity of a numerical value of a representat...
_sia_isagroup Tru64 checks a list of known
__sia_isagroup Tru64 checks a list of known
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service