CodingGuidelines: st_mtimespec vs st_mtim vs st_mtime

Most unfortunately macOS does not support st_[amc]tim for timestamps
down to nanosecond resolution as POSIX systems.

Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Junio C Hamano
2026-04-10 11:10:48 -07:00
parent 2b39a27d40
commit b96490241e
+6
View File
@@ -681,6 +681,12 @@ For C programs:
char *dogs[] = ...;
walk_all_dogs(dogs);
- For file timestamps, do not use "st_mtim" (and other timestamp
members in "struct stat") unconditionally; not everybody is POSIX
(grep for USE_ST_TIMESPEC). If you only need a timestamp in whole
second resolution, "st_mtime" should work fine everywhere.
For Perl programs:
- Most of the C guidelines above apply.