mirror of
https://github.com/codership/wsrep-lib.git
synced 2025-04-25 17:42:30 +03:00
9318a50d18
This commit defines a TLS service interface. If the implementation is provided by the application when the provider is loaded, appropriate hooks are probed from the provider and the provider side hooks are initialized after the provider is loaded. A sample implementation to demostrate the use of TLS interface is provided in dbsim/db_tls.cpp. Also contains a change to thread service interface: The thread exit virtual method was changed to function pointer to allow thread exit path which does not involve C++.
112 lines
3.8 KiB
C++
112 lines
3.8 KiB
C++
/*
|
|
* Copyright (C) 2019 Codership Oy <info@codership.com>
|
|
*
|
|
* This file is part of wsrep-lib.
|
|
*
|
|
* Wsrep-lib is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* Wsrep-lib is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with wsrep-lib. If not, see <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
|
|
/** @file thread_service.hpp
|
|
*
|
|
* Service interface for threads and synchronization primitives.
|
|
* The purpose of this interface is to provider provider implementations
|
|
* means to integrate with application thread implementation.
|
|
*
|
|
* Interface is designed to resemble POSIX threads, mutexes and
|
|
* condition variables.
|
|
*/
|
|
|
|
#ifndef WSREP_THREAD_SERVICE_HPP
|
|
#define WSREP_THREAD_SERVICE_HPP
|
|
|
|
#include <cstddef> // size_t
|
|
#include "compiler.hpp"
|
|
|
|
struct timespec;
|
|
struct sched_param;
|
|
|
|
namespace wsrep
|
|
{
|
|
|
|
class thread_service
|
|
{
|
|
public:
|
|
|
|
thread_service() : exit() { }
|
|
virtual ~thread_service() { }
|
|
struct thread_key { };
|
|
struct thread { };
|
|
struct mutex_key { };
|
|
struct mutex { };
|
|
struct cond_key { };
|
|
struct cond { };
|
|
|
|
/**
|
|
* Method will be called before library side thread
|
|
* service initialization.
|
|
*/
|
|
virtual int before_init() = 0;
|
|
|
|
/**
|
|
* Method will be called after library side thread service
|
|
* has been initialized.
|
|
*/
|
|
virtual int after_init() = 0;
|
|
|
|
/* Thread */
|
|
virtual const thread_key* create_thread_key(const char* name) WSREP_NOEXCEPT
|
|
= 0;
|
|
virtual int create_thread(const thread_key*, thread**,
|
|
void* (*fn)(void*), void*) WSREP_NOEXCEPT
|
|
= 0;
|
|
virtual int detach(thread*) WSREP_NOEXCEPT = 0;
|
|
virtual int equal(thread*, thread*) WSREP_NOEXCEPT = 0;
|
|
|
|
/*
|
|
* This unlike others is a function pointer to
|
|
* avoid having C++ methods on thread exit codepath.
|
|
*/
|
|
WSREP_NORETURN void (*exit)(thread*, void* retval);
|
|
virtual int join(thread*, void** retval) WSREP_NOEXCEPT = 0;
|
|
virtual thread* self() WSREP_NOEXCEPT = 0;
|
|
virtual int setschedparam(thread*, int,
|
|
const struct sched_param*) WSREP_NOEXCEPT
|
|
= 0;
|
|
virtual int getschedparam(thread*, int*, struct sched_param*) WSREP_NOEXCEPT
|
|
= 0;
|
|
|
|
/* Mutex */
|
|
virtual const mutex_key* create_mutex_key(const char* name) WSREP_NOEXCEPT
|
|
= 0;
|
|
virtual mutex* init_mutex(const mutex_key*, void*, size_t) WSREP_NOEXCEPT = 0;
|
|
virtual int destroy(mutex*) WSREP_NOEXCEPT = 0;
|
|
virtual int lock(mutex*) WSREP_NOEXCEPT = 0;
|
|
virtual int trylock(mutex*) WSREP_NOEXCEPT = 0;
|
|
virtual int unlock(mutex*) WSREP_NOEXCEPT = 0;
|
|
|
|
/* Condition variable */
|
|
virtual const cond_key* create_cond_key(const char* name) WSREP_NOEXCEPT = 0;
|
|
virtual cond* init_cond(const cond_key*, void*, size_t) WSREP_NOEXCEPT = 0;
|
|
virtual int destroy(cond*) WSREP_NOEXCEPT = 0;
|
|
virtual int wait(cond*, mutex*) WSREP_NOEXCEPT = 0;
|
|
virtual int timedwait(cond*, mutex*, const struct timespec*) WSREP_NOEXCEPT
|
|
= 0;
|
|
virtual int signal(cond*) WSREP_NOEXCEPT = 0;
|
|
virtual int broadcast(cond*) WSREP_NOEXCEPT = 0;
|
|
};
|
|
} // namespace wsrep
|
|
|
|
#endif // WSREP_THREAD_SERVICE_HPP
|