doc/glibc-functions/getfilecon-desc.texi

   1 @macro getfileconDesc{fn}
   2 Gnulib module: selinux-h
   3
   4 Portability problems fixed by Gnulib:
   5 @itemize
   6 @item
   7 This function exists only on Linux and is therefore
   8 missing on all non-glibc platforms:
   9 macOS 14, FreeBSD 14.0, NetBSD 10.0, OpenBSD 7.5, Minix 3.1.8, AIX 7.1, HP-UX 11.31, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
  10 On those platforms, this module provides a stub that always sets
  11 @code{errno} to @code{ENOTSUP} and returns @samp{-1}.
  12 @item
  13 On systems with SELinux support, this module provides a wrapper for the
  14 @code{\fn\} function that insulates the caller from API-nonconforming behavior.
  15 Without this wrapper, @code{\fn\} can return @samp{0} and set
  16 the @code{context} pointer to NULL, and in another scenario can return
  17 @samp{10} and set the @code{context} pointer to @samp{unlabeled}.
  18 This wrapper returns @samp{-1} in each case and sets @code{errno} to
  19 @code{ENOTSUP} and @code{ENODATA} respectively.
  20 While the conditions that can provoke such behavior are rare, the
  21 average caller does not handle them because the possibility of such
  22 behavior is not documented.
  23 @end itemize
  24
  25 Portability problems not fixed by Gnulib:
  26 @itemize
  27 @end itemize
  28 @end macro