options/ansi: add a comment about layout of timespec

managarm · Mar 4, 2024 · d4d9d0a · d4d9d0a
1 parent 5d12dfa
commit d4d9d0a
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/options/ansi/include/bits/ansi/timespec.h b/options/ansi/include/bits/ansi/timespec.h
@@ -5,8 +5,13 @@
 #include <bits/ansi/time_t.h>
 #include <bits/field-padding.h>
 
+// Equivalent of timespec64 in glibc.
+// Should be used only with 64-bit syscalls
+// or with appropriate compat syscalls.
 struct timespec {
 	time_t tv_sec;
+	// tv_nspec is required to be long by the C standard.
+	// However linux kernel expects long long. So we add padding.
 	__MLIBC_FIELD_PADDED(long, tv_nsec, long long);
 };