Implement the tor_mutex API using CRITICAL_SECTION. More...

#include "orconfig.h"
#include <windows.h>
#include "lib/lock/compat_mutex.h"
#include "lib/err/torerr.h"

Functions
void	tor_locking_init (void)

void	tor_mutex_init (tor_mutex_t *m)

void	tor_mutex_init_nonrecursive (tor_mutex_t *m)

void	tor_mutex_uninit (tor_mutex_t *m)

static void	tor_mutex_acquire_recursive (tor_mutex_t *m)

static void	tor_mutex_acquire_nonrecursive (tor_mutex_t *m)

void	tor_mutex_acquire (tor_mutex_t *m)

static void	tor_mutex_release_recursive (tor_mutex_t *m)

static void	tor_mutex_release_nonrecursive (tor_mutex_t *m)

void	tor_mutex_release (tor_mutex_t *m)

Detailed Description

Implement the tor_mutex API using CRITICAL_SECTION.

Definition in file compat_mutex_winthreads.c.

Function Documentation

◆ tor_locking_init()

void tor_locking_init ( void )

Initialize the locking module, if it is not already initialized.

Definition at line 33 of file compat_mutex_winthreads.c.

Referenced by tor_threads_init().

◆ tor_mutex_acquire()

void tor_mutex_acquire ( tor_mutex_t * m )

Wait until m is free, then acquire it.

Definition at line 80 of file compat_mutex_winthreads.c.

Referenced by atomic_counter_add(), atomic_counter_exchange(), atomic_counter_get(), dup_onion_keys(), expire_old_onion_keys(), openssl_locking_cb_(), queue_reply(), threadpool_queue_update(), worker_thread_main(), and workqueue_entry_cancel().

◆ tor_mutex_init()

void tor_mutex_init ( tor_mutex_t * m )

Initialize mutex so it can be locked. Every mutex must be set up with tor_mutex_init() or tor_mutex_new(); not both.

Definition at line 38 of file compat_mutex_winthreads.c.

Referenced by init_logging().

◆ tor_mutex_init_nonrecursive()

void tor_mutex_init_nonrecursive ( tor_mutex_t * m )

As tor_mutex_init, but initialize a mutex suitable that may be non-recursive, if the OS supports that.

Definition at line 46 of file compat_mutex_winthreads.c.

Referenced by atomic_counter_init().

◆ tor_mutex_release()

void tor_mutex_release ( tor_mutex_t * m )

Release the lock m so another thread can have it.

Definition at line 107 of file compat_mutex_winthreads.c.

Referenced by atomic_counter_add(), atomic_counter_exchange(), atomic_counter_get(), dup_onion_keys(), openssl_locking_cb_(), queue_reply(), socket_accounting_unlock(), worker_thread_main(), and workqueue_entry_cancel().

◆ tor_mutex_uninit()

void tor_mutex_uninit ( tor_mutex_t * m )

Clean up the mutex m so that it no longer uses any system resources. Does not free m. This function must only be called on mutexes from tor_mutex_init().

Destroying a locked mutex is undefined behaviour. Global mutexes may be locked when they are passed to this function, because multiple threads can still access them. So we can either:

destroy on shutdown, and re-initialise when tor re-initialises, or
skip destroying and re-initialisation, using a sentinel variable. See #31735 for details.

Definition at line 53 of file compat_mutex_winthreads.c.

Referenced by atomic_counter_destroy(), and tor_mutex_free_().

Functions