Mercurial > hg > octave-shane > gnulib-hg

annotate doc/posix-functions/futimens.texi @ 13776:2285cf35fa15

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
docs: update cygwin progress * doc/glibc-functions/mkostemp.texi (mkostemp): Added in cygwin 1.7.6. * doc/glibc-functions/mkostemps.texi (mkostemps): Likewise. * doc/posix-headers/fenv.texi (fenv.h): Added after cygwin 1.7.7. * doc/posix-functions/feclearexcept.texi (feclearexcept): Likewise. * doc/posix-functions/fegetenv.texi (fegetenv): Likewise. * doc/posix-functions/fegetexceptflag.texi (fegetexceptflag): Likewise. * doc/posix-functions/fegetround.texi (fegetround): Likewise. * doc/posix-functions/feholdexcept.texi (feholdexcept): Likewise. * doc/posix-functions/feraiseexcept.texi (feraiseexcept): Likewise. * doc/posix-functions/fesetenv.texi (fesetenv): Likewise. * doc/posix-functions/fesetexceptflag.texi (fesetexceptflag): Likewise. * doc/posix-functions/fesetround.texi (fesetround): Likewise. * doc/posix-functions/fetestexcept.texi (fetestexcept): Likewise. * doc/posix-functions/feupdateenv.texi (feupdateenv): Likewise. * doc/glibc-functions/feenableexcept.texi (feenableexcept): Likewise. * doc/glibc-functions/fedisableexcept.texi (fedisableexcept): Likewise. * doc/glibc-functions/fegetexcept.texi (fegetexcept): Likewise. Signed-off-by: Eric Blake <eblake@redhat.com>
author Eric Blake <eblake@redhat.com>
date Thu, 07 Oct 2010 08:42:24 -0600
parents bb0ceefd22dc
children 586d7f932642
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
10880
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 @node futimens
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
2 @section @code{futimens}
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3 @findex futimens
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
4
13549
bb0ceefd22dc avoid some overlong lines from posix urls, etc.
Karl Berry <karl@freefriends.org>
parents: 12466
diff changeset
5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/futimens.html}
10880
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
6
12162
fe82ecf4f214 futimens: new module
Eric Blake <ebb9@byu.net>
parents: 12155
diff changeset
7 Gnulib module: futimens
10880
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9 Portability problems fixed by Gnulib:
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 @itemize
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
11 @item
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
12 This function is missing on some platforms:
10883
e578654f58d3 Update doc for cygwin 1.7.
Eric Blake <ebb9@byu.net>
parents: 10880
diff changeset
13 glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX
12155
a12f708060ff doc: mention timestamp portability issues
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
14 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw,
a12f708060ff doc: mention timestamp portability issues
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
15 Interix 3.5, BeOS.
12194
16c7c4fa9754 utimensat: work around Solaris 9 bug
Eric Blake <ebb9@byu.net>
parents: 12162
diff changeset
16 However, the replacement function may end up truncating timestamps to
16c7c4fa9754 utimensat: work around Solaris 9 bug
Eric Blake <ebb9@byu.net>
parents: 12162
diff changeset
17 less resolution than supported by the file system.
12155
a12f708060ff doc: mention timestamp portability issues
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
18 @item
a12f708060ff doc: mention timestamp portability issues
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
19 This function returns a bogus value instead of failing with
a12f708060ff doc: mention timestamp portability issues
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
20 @code{ENOSYS} on some platforms:
a12f708060ff doc: mention timestamp portability issues
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
21 Linux kernel 2.6.21.
a12f708060ff doc: mention timestamp portability issues
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
22 @item
a12f708060ff doc: mention timestamp portability issues
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
23 When using @code{UTIME_OMIT} or @code{UTIME_NOW}, some systems require
a12f708060ff doc: mention timestamp portability issues
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
24 the @code{tv_sec} argument to be 0, and don't necessarily handle all
a12f708060ff doc: mention timestamp portability issues
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
25 file permissions in the manner required by POSIX:
a12f708060ff doc: mention timestamp portability issues
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
26 Linux kernel 2.6.25.
12466
e31a9e90d604 utimens: check for ctime update
Eric Blake <ebb9@byu.net>
parents: 12194
diff changeset
27 @item
e31a9e90d604 utimens: check for ctime update
Eric Blake <ebb9@byu.net>
parents: 12194
diff changeset
28 When using @code{UTIME_OMIT} for the modification time, but specifying
e31a9e90d604 utimens: check for ctime update
Eric Blake <ebb9@byu.net>
parents: 12194
diff changeset
29 an access time, some systems fail to update the change time:
e31a9e90d604 utimens: check for ctime update
Eric Blake <ebb9@byu.net>
parents: 12194
diff changeset
30 Linux kernel 2.6.32.
12162
fe82ecf4f214 futimens: new module
Eric Blake <ebb9@byu.net>
parents: 12155
diff changeset
31 @end itemize
fe82ecf4f214 futimens: new module
Eric Blake <ebb9@byu.net>
parents: 12155
diff changeset
32
fe82ecf4f214 futimens: new module
Eric Blake <ebb9@byu.net>
parents: 12155
diff changeset
33 Portability problems not fixed by Gnulib:
fe82ecf4f214 futimens: new module
Eric Blake <ebb9@byu.net>
parents: 12155
diff changeset
34 @itemize
12155
a12f708060ff doc: mention timestamp portability issues
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
35 @item
a12f708060ff doc: mention timestamp portability issues
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
36 Some platforms lack the ability to change the timestamps of a file
12162
fe82ecf4f214 futimens: new module
Eric Blake <ebb9@byu.net>
parents: 12155
diff changeset
37 descriptor, so the replacement can fail with @code{ENOSYS}; the gnulib
12194
16c7c4fa9754 utimensat: work around Solaris 9 bug
Eric Blake <ebb9@byu.net>
parents: 12162
diff changeset
38 module @samp{utimens} provides a more reliable interface @code{fdutimens}.
16c7c4fa9754 utimensat: work around Solaris 9 bug
Eric Blake <ebb9@byu.net>
parents: 12162
diff changeset
39 @item
16c7c4fa9754 utimensat: work around Solaris 9 bug
Eric Blake <ebb9@byu.net>
parents: 12162
diff changeset
40 The mere act of using @code{stat} modifies the access time of
16c7c4fa9754 utimensat: work around Solaris 9 bug
Eric Blake <ebb9@byu.net>
parents: 12162
diff changeset
41 directories on some platforms, so @code{utimensat} can only
16c7c4fa9754 utimensat: work around Solaris 9 bug
Eric Blake <ebb9@byu.net>
parents: 12162
diff changeset
42 effectively change directory modification time:
16c7c4fa9754 utimensat: work around Solaris 9 bug
Eric Blake <ebb9@byu.net>
parents: 12162
diff changeset
43 Cygwin 1.5.x.
10880
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
44 @end itemize