summaryrefslogtreecommitdiff
path: root/gnulib/doc/posix-functions/utimes.texi
blob: 0db82c974a28fc08630b2a8149eab48d46652a6c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
@node utimes
@section @code{utimes}
@findex utimes

POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/utimes.html}

Gnulib module: ---

Portability problems fixed by Gnulib:
@itemize
@end itemize

Portability problems not fixed by Gnulib:
@itemize
@item
This function is missing on some platforms:
Minix 3.1.8, mingw, MSVC 9, Interix 3.5, BeOS.
@item
The declaration of this function lacks @code{const} in the second argument
on some platforms:
OSF/1 5.1.
@item
On some platforms, this function mis-handles trailing slash:
FreeBSD 7.2, Solaris 9.
@item
This function cannot set full timestamp resolution.  In particular,
some platforms incorrectly round rather than truncate.  Use
@code{utimensat(AT_FDCWD,file,times,0)}, or the gnulib module utimens,
instead.
@item
On some platforms, @code{utimes (file, NULL)} fails to set the
file's timestamp to the current time:
glibc 2.3.3.
@item
On some platforms, @code{utimes} failed on read-only files when
@code{utime} worked fine.
glibc 2.2.5.
@end itemize

Extension: Gnulib provides a module @samp{utimens} that works around these
problems and allows to set the time with nanosecond resolution (as far as
supported by the file system).