manual/acl/original/man3/acl_clear_perms.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_CLEAR_PERMS 3
  19 .Os "Linux ACL"
  20 .Sh NAME
  21 .Nm acl_clear_perms
  22 .Nd clear all permissions 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_clear_perms "acl_permset_t permset_d"
  30 .Sh DESCRIPTION
  31 The
  32 .Fn acl_clear_perms
  33 function clears all permissions from the permission set referred to by the argument
  34 .Va permset_d .
  35 .Pp
  36 Any existing descriptors that refer to
  37 .Va permset_d
  38 shall continue to refer to that permission set.
  39 .Sh RETURN VALUE
  40 .Rv -std acl_clear_perms
  41 .Sh ERRORS
  42 If any of the following conditions occur, the
  43 .Fn acl_clear_perms
  44 function returns
  45 .Li -1
  46 and sets
  47 .Va errno
  48 to the corresponding value:
  49 .Bl -tag -width Er
  50 .It Bq Er EINVAL
  51 The argument
  52 .Va permset_d
  53 is not a valid descriptor for a permission set within an ACL entry.
  54 .El
  55 .Sh STANDARDS
  56 IEEE Std 1003.1e draft 17 (\(lqPOSIX.1e\(rq, abandoned)
  57 .Sh SEE ALSO
  58 .Xr acl_add_perm 3 ,
  59 .Xr acl_delete_perm 3 ,
  60 .Xr acl_get_perm 3 ,
  61 .Xr acl_get_permset 3 ,
  62 .Xr acl_set_permset 3 ,
  63 .Xr acl 5
  64 .Sh AUTHOR
  65 Derived from the FreeBSD manual pages written by
  66 .An "Robert N M Watson" Aq rwatson@FreeBSD.org ,
  67 and adapted for Linux by
  68 .An "Andreas Gruenbacher" Aq a.gruenbacher@bestbits.at .