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

• Show log

  Commit

• Hash : 06b335ad
  Author :
  Date : 2012-06-22T13:26:07
  

  Write "Mac OS X" instead of "MacOS X".
  
  * README: Write "Mac OS X" instead of "MacOS X".
  * build-aux/bootstrap: Likewise.
  * build-aux/install-reloc: Likewise.
  * lib/acl-internal.h: Likewise.
  * lib/acl_entries.c: Likewise.
  * lib/argp-ba.c: Likewise.
  * lib/argp-pv.c: Likewise.
  * lib/config.charset: Likewise.
  * lib/copy-acl.c: Likewise.
  * lib/csharpexec.c: Likewise.
  * lib/euidaccess.c: Likewise.
  * lib/fbufmode.c: Likewise.
  * lib/fflush.c: Likewise.
  * lib/file-has-acl.c: Likewise.
  * lib/filemode.h: Likewise.
  * lib/fpurge.c: Likewise.
  * lib/freadable.c: Likewise.
  * lib/freadahead.c: Likewise.
  * lib/freading.c: Likewise.
  * lib/freadptr.c: Likewise.
  * lib/freadseek.c: Likewise.
  * lib/fseeko.c: Likewise.
  * lib/fseterr.c: Likewise.
  * lib/fsusage.c: Likewise.
  * lib/fwritable.c: Likewise.
  * lib/fwriting.c: Likewise.
  * lib/get-rusage-as.c: Likewise.
  * lib/get-rusage-data.c: Likewise.
  * lib/getdomainname.c: Likewise.
  * lib/idpriv-drop.c: Likewise.
  * lib/idpriv-droptemp.c: Likewise.
  * lib/localcharset.c: Likewise.
  * lib/locale.in.h: Likewise.
  * lib/localename.c: Likewise.
  * lib/mbsrtowcs-state.c: Likewise.
  * lib/nproc.c: Likewise.
  * lib/passfd.c: Likewise.
  * lib/posix_openpt.c: Likewise.
  * lib/printf-parse.c: Likewise.
  * lib/progreloc.c: Likewise.
  * lib/safe-read.h: Likewise.
  * lib/safe-write.h: Likewise.
  * lib/sched.in.h: Likewise.
  * lib/set-mode-acl.c: Likewise.
  * lib/signal.in.h: Likewise.
  * lib/stdint.in.h: Likewise.
  * lib/stdio-impl.h: Likewise.
  * lib/stdlib.in.h: Likewise.
  * lib/strtod.c: Likewise.
  * lib/sys_select.in.h: Likewise.
  * lib/tcgetsid.c: Likewise.
  * lib/unistd.in.h: Likewise.
  * lib/unlockpt.c: Likewise.
  * lib/vasnprintf.c: Likewise.
  * lib/vma-iter.c: Likewise.
  * lib/wcsrtombs-state.c: Likewise.
  * m4/acl.m4: Likewise.
  * m4/acosl.m4: Likewise.
  * m4/asinl.m4: Likewise.
  * m4/atanl.m4: Likewise.
  * m4/c-stack.m4: Likewise.
  * m4/cosl.m4: Likewise.
  * m4/expl.m4: Likewise.
  * m4/extensions.m4: Likewise.
  * m4/fdatasync.m4: Likewise.
  * m4/fmal.m4: Likewise.
  * m4/frexp.m4: Likewise.
  * m4/frexpf.m4: Likewise.
  * m4/frexpl.m4: Likewise.
  * m4/fsusage.m4: Likewise.
  * m4/getdomainname.m4: Likewise.
  * m4/getloadavg.m4: Likewise.
  * m4/getopt.m4: Likewise.
  * m4/gettext.m4: Likewise.
  * m4/gnulib-common.m4: Likewise.
  * m4/intdiv0.m4: Likewise.
  * m4/intlmacosx.m4: Likewise.
  * m4/largefile.m4: Likewise.
  * m4/ldexpl.m4: Likewise.
  * m4/link-follow.m4: Likewise.
  * m4/locale-ar.m4: Likewise.
  * m4/locale-fr.m4: Likewise.
  * m4/locale-ja.m4: Likewise.
  * m4/locale-tr.m4: Likewise.
  * m4/locale-zh.m4: Likewise.
  * m4/locale_h.m4: Likewise.
  * m4/lock.m4: Likewise.
  * m4/logl.m4: Likewise.
  * m4/mathfunc.m4: Likewise.
  * m4/minus-zero.m4: Likewise.
  * m4/mktime.m4: Likewise.
  * m4/mmap-anon.m4: Likewise.
  * m4/multiarch.m4: Likewise.
  * m4/nanosleep.m4: Likewise.
  * m4/nocrash.m4: Likewise.
  * m4/poll.m4: Likewise.
  * m4/printf-frexpl.m4: Likewise.
  * m4/printf.m4: Likewise.
  * m4/signbit.m4: Likewise.
  * m4/sinl.m4: Likewise.
  * m4/sqrtl.m4: Likewise.
  * m4/strerror_r.m4: Likewise.
  * m4/tanl.m4: Likewise.
  * m4/threadlib.m4: Likewise.
  * m4/ttyname_r.m4: Likewise.
  * m4/unlink.m4: Likewise.
  * m4/visibility.m4: Likewise.
  * m4/wcwidth.m4: Likewise.
  * tests/minus-zero.h: Likewise.
  * tests/test-alloca-opt.c: Likewise.
  * tests/test-copy-acl.sh: Likewise.
  * tests/test-copy-file.sh: Likewise.
  * tests/test-fdatasync.c: Likewise.
  * tests/test-file-has-acl.sh: Likewise.
  * tests/test-flock.c: Likewise.
  * tests/test-fsync.c: Likewise.
  * tests/test-localename.c: Likewise.
  * tests/test-malloca.c: Likewise.
  * tests/test-nonblocking-pipe.h: Likewise.
  * tests/test-nonblocking-socket.h: Likewise.
  * tests/test-openpty.c: Likewise.
  * tests/test-posix_openpt.c: Likewise.
  * tests/test-ptsname.c: Likewise.
  * tests/test-ptsname_r.c: Likewise.
  * tests/test-sameacls.c: Likewise.
  * tests/test-select.h: Likewise.
  * tests/test-set-mode-acl.sh: Likewise.
  * tests/test-snprintf-posix.h: Likewise.
  * tests/test-sprintf-posix.h: Likewise.
  * tests/test-strtod.c: Likewise.
  * tests/test-time.c: Likewise.
  * tests/test-vasnprintf-posix.c: Likewise.
  * tests/test-vasprintf-posix.c: Likewise.
  * doc/acl-resources.txt: Likewise.
  * doc/**/*.texi: Likewise.
  Reported by Max Horn <max@quendi.de>.
  

Download

• doc/posix-functions/unlinkat.texi

• @node unlinkat
  @section @code{unlinkat}
  @findex unlinkat
  
  POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/unlinkat.html}
  
  Gnulib module: unlinkat
  
  Portability problems fixed by Gnulib:
  @itemize
  @item
  This function is missing on some platforms:
  glibc 2.3.6, Mac OS 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.
  @item
  Some systems mistakenly succeed on @code{unlinkat(fd,"file/",flag)}:
  GNU/Hurd, Solaris 9.
  @item
  Some platforms declare this function in @code{fcntl.h} instead of
  @code{unistd.h}:
  Cygwin 1.7.1.
  @end itemize
  
  Portability problems not fixed by Gnulib:
  @itemize
  @item
  When @code{unlinkat(fd,name,AT_REMOVEDIR)} fails because the specified
  directory is not empty, the @code{errno} value is system dependent.
  @item
  POSIX requires that @code{unlinkdir(fd,"link-to-empty/",AT_REMOVEDIR)}
  remove @file{empty} and leave @file{link-to-empty} as a dangling
  symlink.  This is counter-intuitive, so some systems fail with
  @code{ENOTDIR} instead:
  glibc
  @item
  Some systems allow a superuser to unlink directories, even though this
  can cause file system corruption.  The error given if a process is not
  permitted to unlink directories varies across implementations; it is
  not always the POSIX value of @code{EPERM}.  Meanwhile, if a process
  has the ability to unlink directories, POSIX requires that
  @code{unlinkat(fd,"symlink-to-dir/",0)} remove @file{dir} and leave
  @file{symlink-to-dir} dangling; this behavior is counter-intuitive.
  The gnulib module unlinkdir can help determine whether code must be
  cautious of unlinking directories.
  @item
  Removing an open file is non-portable: On Unix this allows the programs that
  have the file already open to continue working with it; the file's storage
  is only freed when the no process has the file open any more.  On Windows,
  the attempt to remove an open file fails.
  @end itemize
  

Download