manual/acl/original/man3/acl_error.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_CHECK 3
  19 .Os "Linux ACL"
  20 .Sh NAME
  21 .Nm acl_error
  22 .Nd convert an ACL error code to a text message
  23 .Sh LIBRARY
  24 Linux Access Control Lists library (libacl, \-lacl).
  25 .Sh SYNOPSIS
  26 .In sys/types.h
  27 .In acl/libacl.h
  28 .Ft const char *
  29 .Fn acl_error "int code"
  30 .Sh DESCRIPTION
  31 The
  32 .Fn acl_error
  33 function converts an ACL error code such as returned by the
  34 .Fn acl_check
  35 function to a text message describing the error condition. In the
  36 \(lqPOSIX\(rq locale,
  37 .Fn acl_check
  38 returns the following descriptions for the error codes.
  39 .Bl -tag -width ACL_DUPLICATE_ERROR.
  40 .It ACL_MULTI_ERROR
  41 \(lqMultiple entries\(rq
  42 .It ACL_DUPLICATE_ERROR
  43 \(lqDuplicate entries\(rq
  44 .It ACL_MISS_ERROR
  45 \(lqMissing or wrong entry\(rq
  46 .It ACL_ENTRY_ERROR
  47 \(lqInvalid entry type\(rq
  48 .El
  49 .Sh RETURN VALUE
  50 The
  51 .Fn acl_error
  52 function returns a text message if the error code is recognized, and a value of
  53 .Li (const char *)NULL
  54 otherwise.
  55 .Sh STANDARDS
  56 This is a non-portable, Linux specific extension to the ACL manipulation
  57 functions defined in IEEE Std 1003.1e draft 17 (\(lqPOSIX.1e\(rq, abandoned).
  58 .Sh SEE ALSO
  59 .Xr acl_check 3 ,
  60 .Xr acl_valid 3 ,
  61 .Xr acl 5
  62 .Sh AUTHOR
  63 Written by
  64 .An "Andreas Gruenbacher" Aq a.gruenbacher@bestbits.at .