manual/acl/original/man3/acl_delete_perm.3

   1 .\" Access Control Lists manual pages
   2 .\"
   3 .\" (C) 2002 Andreas Gruenbacher, <a.gruenbacher@bestbits.at>
   4 .\"
   5 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
   6 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   7 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   8 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
   9 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  10 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  11 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  12 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  13 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  14 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  15 .\" SUCH DAMAGE.
  16 .\"
  17 .Dd March 23, 2002
  18 .Dt ACL_DELETE_PERM 3
  19 .Os "Linux ACL"
  20 .Sh NAME
  21 .Nm acl_delete_perm
  22 .Nd delete a permission from an ACL permission set
  23 .Sh LIBRARY
  24 Linux Access Control Lists library (libacl, \-lacl).
  25 .Sh SYNOPSIS
  26 .In sys/types.h
  27 .In sys/acl.h
  28 .Ft int
  29 .Fn acl_delete_perm "acl_permset_t permset_d" "acl_perm_t perm"
  30 .Sh DESCRIPTION
  31 The
  32 .Fn acl_delete_perm
  33 function deletes the permission contained in the argument
  34 .Va perm
  35 from the permission set referred to by the argument
  36 .Va permset_d .
  37 An attempt to delete a permission that is not contained in the permission
  38 set is not considered an error.
  39 .Pp
  40 Any existing descriptors that refer to
  41 .Va permset_d
  42 continue to refer to that permission set.
  43 .Sh RETURN VALUE
  44 .Rv -std acl_delete_perm
  45 .Sh ERRORS
  46 If any of the following conditions occur, the
  47 .Fn acl_delete_perm
  48 function returns
  49 .Li -1
  50 and sets
  51 .Va errno
  52 to the corresponding value:
  53 .Bl -tag -width Er
  54 .It Bq Er EINVAL
  55 The argument
  56 .Va permset_d
  57 is not a valid descriptor for a permission set within an ACL entry.
  58 .Pp
  59 The argument
  60 .Va perm
  61 does not contain a valid
  62 .Va acl_perm_t
  63 value.
  64 .El
  65 .Sh STANDARDS
  66 IEEE Std 1003.1e draft 17 (\(lqPOSIX.1e\(rq, abandoned)
  67 .Sh SEE ALSO
  68 .Xr acl_add_perm 3 ,
  69 .Xr acl_clear_perms 3 ,
  70 .Xr acl_get_perm 3 ,
  71 .Xr acl_get_permset 3 ,
  72 .Xr acl_set_permset 3 ,
  73 .Xr acl 5
  74 .Sh AUTHOR
  75 Derived from the FreeBSD manual pages written by
  76 .An "Robert N M Watson" Aq rwatson@FreeBSD.org ,
  77 and adapted for Linux by
  78 .An "Andreas Gruenbacher" Aq a.gruenbacher@bestbits.at .