mirror of
https://git.savannah.gnu.org/git/gnulib.git
synced 2025-08-16 01:22:18 +03:00
e5194dcec6
* lib/utime.in.h: Add comment for snippets. (utime): New declaration. * lib/utime.c: New file. * m4/utime.m4: New file. * m4/utime_h.m4 (gl_UTIME_H): Test for utime declaration. (gl_UTIME_H_DEFAULTS): Initialize GNULIB_UTIME, HAVE_UTIME, REPLACE_UTIME. * modules/utime-h (Depends-on): Add snippets. (Makefile.am): Substitute GNULIB_UTIME, HAVE_UTIME, REPLACE_UTIME. Insert snippets. * modules/utime: New file. * doc/posix-functions/utime.texi: Mention the new module.
34 lines
958 B
Plaintext
34 lines
958 B
Plaintext
@node utime
|
|
@section @code{utime}
|
|
@findex utime
|
|
|
|
POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/utime.html}
|
|
|
|
Gnulib module: utime
|
|
|
|
Portability problems fixed by Gnulib:
|
|
@itemize
|
|
@item
|
|
The times that are set on the file are affected by the current time zone and
|
|
by the DST flag of the current time zone on some platforms:
|
|
mingw, MSVC 14 (when the environment variable @code{TZ} is set).
|
|
@item
|
|
On some platforms, the prototype for @code{utime} omits @code{const}
|
|
for the second argument:
|
|
mingw, MSVC 9.
|
|
@end itemize
|
|
|
|
Portability problems not fixed by Gnulib:
|
|
@itemize
|
|
@item
|
|
On some old platforms (Sequent), @code{utime (file, NULL)} fails to set the
|
|
file's timestamp to the current time.
|
|
@item
|
|
On some platforms, this function mis-handles trailing slash:
|
|
Solaris 9.
|
|
@item
|
|
This function cannot set full timestamp resolution. Use
|
|
@code{utimensat(AT_FDCWD,file,times,0)}, or the gnulib module utimens,
|
|
instead.
|
|
@end itemize
|