lib/windows-timedrecmutex.h

   1 /* Timed recursive mutexes (native Windows implementation).
   2    Copyright (C) 2005-2024 Free Software Foundation, Inc.
   3
   4    This file is free software: you can redistribute it and/or modify
   5    it under the terms of the GNU Lesser General Public License as
   6    published by the Free Software Foundation; either version 2.1 of the
   7    License, or (at your option) any later version.
   8
   9    This file is distributed in the hope that it will be useful,
  10    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12    GNU Lesser General Public License for more details.
  13
  14    You should have received a copy of the GNU Lesser General Public License
  15    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
  16
  17 /* Written by Bruno Haible <bruno@clisp.org>, 2005, 2019.
  18    Based on GCC's gthr-win32.h.  */
  19
  20 #ifndef _WINDOWS_TIMEDRECMUTEX_H
  21 #define _WINDOWS_TIMEDRECMUTEX_H
  22
  23 #define WIN32_LEAN_AND_MEAN  /* avoid including junk */
  24 #include <windows.h>
  25
  26 #include <time.h>
  27
  28 #include "windows-initguard.h"
  29
  30 /* The native Windows documentation says that CRITICAL_SECTION already
  31    implements a recursive lock.  But we need not rely on it: It's easy to
  32    implement a recursive lock without this assumption.  */
  33
  34 typedef struct
  35         {
  36           glwthread_initguard_t guard; /* protects the initialization */
  37           DWORD owner;
  38           unsigned long depth;
  39           HANDLE event;
  40           CRITICAL_SECTION lock;
  41         }
  42         glwthread_timedrecmutex_t;
  43
  44 #define GLWTHREAD_TIMEDRECMUTEX_INIT { GLWTHREAD_INITGUARD_INIT, 0, 0 }
  45
  46 #ifdef __cplusplus
  47 extern "C" {
  48 #endif
  49
  50 extern int glwthread_timedrecmutex_init (glwthread_timedrecmutex_t *mutex);
  51 extern int glwthread_timedrecmutex_lock (glwthread_timedrecmutex_t *mutex);
  52 extern int glwthread_timedrecmutex_trylock (glwthread_timedrecmutex_t *mutex);
  53 extern int glwthread_timedrecmutex_timedlock (glwthread_timedrecmutex_t *mutex,
  54                                               const struct timespec *abstime);
  55 extern int glwthread_timedrecmutex_unlock (glwthread_timedrecmutex_t *mutex);
  56 extern int glwthread_timedrecmutex_destroy (glwthread_timedrecmutex_t *mutex);
  57
  58 #ifdef __cplusplus
  59 }
  60 #endif
  61
  62 #endif /* _WINDOWS_TIMEDRECMUTEX_H */