nptl/pthread_mutex_destroy.c

   1 /* Copyright (C) 2002-2023 Free Software Foundation, Inc.
   2    This file is part of the GNU C Library.
   3
   4    The GNU C Library is free software; you can redistribute it and/or
   5    modify it under the terms of the GNU Lesser General Public
   6    License as published by the Free Software Foundation; either
   7    version 2.1 of the License, or (at your option) any later version.
   8
   9    The GNU C Library 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 GNU
  12    Lesser General Public License for more details.
  13
  14    You should have received a copy of the GNU Lesser General Public
  15    License along with the GNU C Library; if not, see
  16    <https://www.gnu.org/licenses/>.  */
  17
  18 #include <errno.h>
  19 #include "pthreadP.h"
  20 #include <shlib-compat.h>
  21 #include <stap-probe.h>
  22
  23
  24 int
  25 ___pthread_mutex_destroy (pthread_mutex_t *mutex)
  26 {
  27   LIBC_PROBE (mutex_destroy, 1, mutex);
  28
  29   /* See concurrency notes regarding __kind in struct __pthread_mutex_s
  30      in sysdeps/nptl/bits/thread-shared-types.h.  */
  31   if ((atomic_load_relaxed (&(mutex->__data.__kind))
  32        & PTHREAD_MUTEX_ROBUST_NORMAL_NP) == 0
  33       && mutex->__data.__nusers != 0)
  34     return EBUSY;
  35
  36   /* Set to an invalid value.  Relaxed MO is enough as it is undefined behavior
  37      if the mutex is used after it has been destroyed.  But you can reinitialize
  38      it with pthread_mutex_init.  */
  39   atomic_store_relaxed (&(mutex->__data.__kind), -1);
  40
  41   return 0;
  42 }
  43 versioned_symbol (libc, ___pthread_mutex_destroy, pthread_mutex_destroy,
  44                   GLIBC_2_0);
  45 libc_hidden_ver (___pthread_mutex_destroy, __pthread_mutex_destroy)
  46 #ifndef SHARED
  47 strong_alias (___pthread_mutex_destroy, __pthread_mutex_destroy)
  48 #endif
  49
  50 #if OTHER_SHLIB_COMPAT (libpthread, GLIBC_2_0, GLIBC_2_34)
  51 compat_symbol (libpthread, ___pthread_mutex_destroy, __pthread_mutex_destroy,
  52                GLIBC_2_0);
  53 #endif