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>
maint
Junio C Hamano 2026-04-10 11:10:48 -07:00
parent 2b39a27d40
commit b96490241e
1 changed files with 6 additions and 0 deletions

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.