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