kc3-lang/gnulib/doc/posix-functions/fchownat.texi

• Show log

  Commit

• Hash : f2c56708
  Author :
  Date : 2011-11-01T11:01:10
  

  New module 'fchownat', split off from module 'openat'.
  
  * lib/openat.h (chownat, lchownat): Enable only if GNULIB_FCHOWNAT is
  defined.
  * m4/fchownat.m4: New file, extracted from m4/openat.m4.
  * m4/openat.m4 (gl_FUNC_OPENAT): Don't set GNULIB_FCHOWNAT. Don't
  invoke gl_FUNC_FCHOWNAT.
  (gl_FUNC_FCHOWNAT_DEREF_BUG, gl_FUNC_FCHOWNAT_EMPTY_FILENAME_BUG,
  gl_FUNC_FCHOWNAT): Moved to m4/fchownat.m4.
  * modules/fchownat: New file, extracted from modules/openat.
  * modules/openat (Files): Remove lib/fchownat.c.
  (Depends-on): Remove lchown.
  (configure.ac): Remove AC_LIBOBJ of fchownat.
  * modules/fchownat-tests: New file, extracted from modules/openat-tests.
  * modules/openat-tests (Files): Remove tests/test-fchownat.c,
  tests/test-chown.h, tests/test-lchown.h, tests/nap.h.
  (Depends-on): Remove mgetgroups, usleep, stat-time.
  (configure.ac): Remove test for getegid.
  (Makefile.am): Remove rules for test-fchownat.
  * doc/posix-functions/fchownat.texi: Mention module 'fchownat' instead
  of module 'openat'.
  * NEWS: Mention the change.
  

Download

• doc/posix-functions/fchownat.texi

• @node fchownat
  @section @code{fchownat}
  @findex fchownat
  
  POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/fchownat.html}
  
  Gnulib module: fchownat
  
  Portability problems fixed by Gnulib:
  @itemize
  @item
  Some platforms fail to detect trailing slash on non-directories, as in
  @code{fchown(dir,"link-to-file/",uid,gid,flag)}:
  Solaris 9.
  @item
  Some platforms mistakenly dereference symlinks when using
  @code{AT_SYMLINK_NOFOLLOW}:
  Linux kernel 2.6.17.
  @item
  This function does not fail for an empty filename on some platforms:
  Linux with glibc < 2.11.
  @item
  This function is missing on some platforms:
  glibc 2.3.6, MacOS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8,
  AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Cygwin 1.5.x, mingw, MSVC 9, Interix 3.5, BeOS.
  But the replacement function is not safe to be used in libraries and
  is not multithread-safe.  Also, the replacement may fail to change
  symlinks if @code{lchown} is unsupported, or fail altogether if
  @code{chown} is unsupported.
  @end itemize
  
  Portability problems not fixed by Gnulib:
  @itemize
  @end itemize
  

Download