]> Savannah Git Hosting - gnulib.git/commitdiff
boot-time: Add comment about multithread-safety.
authorBruno Haible <bruno@clisp.org>
Fri, 11 Aug 2023 21:31:37 +0000 (23:31 +0200)
committerBruno Haible <bruno@clisp.org>
Fri, 11 Aug 2023 21:31:37 +0000 (23:31 +0200)
* lib/boot-time.h (get_boot_time): Add comment, same as in readutmp.h.

ChangeLog
lib/boot-time.h

index bfc2954a8017c73bd8742f6ebfc1c336d818f5da..472349e5e4b0c579ee7480bd180a3ebcb32a0155 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2023-08-11  Bruno Haible  <bruno@clisp.org>
+
+       boot-time: Add comment about multithread-safety.
+       * lib/boot-time.h (get_boot_time): Add comment, same as in readutmp.h.
+
 2023-08-11  Bruno Haible  <bruno@clisp.org>
 
        boot-time: Simplify execution.
index 159a0056f949bac5fc9907e9f5413c3f0580740f..401e854adbbb59a59fe5d642ba34667852dfe178 100644 (file)
@@ -27,7 +27,13 @@ extern "C" {
 
 
 /* Store the approximate time when the machine last booted in *P_BOOT_TIME,
-   and return 0.  If it cannot be determined, return -1.  */
+   and return 0.  If it cannot be determined, return -1.
+
+   This function is not multithread-safe, since on many platforms it
+   invokes the functions setutxent, getutxent, endutxent.  These
+   functions are needed because they may lock FILE (so that we don't
+   read garbage when a concurrent process writes to FILE), but their
+   drawback is that they have a common global state.  */
 extern int get_boot_time (struct timespec *p_boot_time);