lib/windows-recmutex.h

   1 /* Plain 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.
  18    Based on GCC's gthr-win32.h.  */
  19
  20 #ifndef _WINDOWS_RECMUTEX_H
  21 #define _WINDOWS_RECMUTEX_H
  22
  23 #define WIN32_LEAN_AND_MEAN  /* avoid including junk */
  24 #include <windows.h>
  25
  26 #include "windows-initguard.h"
  27
  28 /* The native Windows documentation says that CRITICAL_SECTION already
  29    implements a recursive lock.  But we need not rely on it: It's easy to
  30    implement a recursive lock without this assumption.  */
  31
  32 typedef struct
  33         {
  34           glwthread_initguard_t guard; /* protects the initialization */
  35           DWORD owner;
  36           unsigned long depth;
  37           CRITICAL_SECTION lock;
  38         }
  39         glwthread_recmutex_t;
  40
  41 #define GLWTHREAD_RECMUTEX_INIT { GLWTHREAD_INITGUARD_INIT, 0, 0 }
  42
  43 #ifdef __cplusplus
  44 extern "C" {
  45 #endif
  46
  47 extern void glwthread_recmutex_init (glwthread_recmutex_t *mutex);
  48 extern int glwthread_recmutex_lock (glwthread_recmutex_t *mutex);
  49 extern int glwthread_recmutex_trylock (glwthread_recmutex_t *mutex);
  50 extern int glwthread_recmutex_unlock (glwthread_recmutex_t *mutex);
  51 extern int glwthread_recmutex_destroy (glwthread_recmutex_t *mutex);
  52
  53 #ifdef __cplusplus
  54 }
  55 #endif
  56
  57 #endif /* _WINDOWS_RECMUTEX_H */