diff options
author | orivej <orivej@yandex-team.ru> | 2022-02-10 16:45:01 +0300 |
---|---|---|
committer | Daniil Cherednik <dcherednik@yandex-team.ru> | 2022-02-10 16:45:01 +0300 |
commit | 2d37894b1b037cf24231090eda8589bbb44fb6fc (patch) | |
tree | be835aa92c6248212e705f25388ebafcf84bc7a1 /contrib/libs/poco/Foundation/include/Poco/NamedMutex.h | |
parent | 718c552901d703c502ccbefdfc3c9028d608b947 (diff) | |
download | ydb-2d37894b1b037cf24231090eda8589bbb44fb6fc.tar.gz |
Restoring authorship annotation for <orivej@yandex-team.ru>. Commit 2 of 2.
Diffstat (limited to 'contrib/libs/poco/Foundation/include/Poco/NamedMutex.h')
-rw-r--r-- | contrib/libs/poco/Foundation/include/Poco/NamedMutex.h | 220 |
1 files changed, 110 insertions, 110 deletions
diff --git a/contrib/libs/poco/Foundation/include/Poco/NamedMutex.h b/contrib/libs/poco/Foundation/include/Poco/NamedMutex.h index 3545d8be5e..421f018e26 100644 --- a/contrib/libs/poco/Foundation/include/Poco/NamedMutex.h +++ b/contrib/libs/poco/Foundation/include/Poco/NamedMutex.h @@ -1,110 +1,110 @@ -// -// NamedMutex.h -// -// Library: Foundation -// Package: Processes -// Module: NamedMutex -// -// Definition of the NamedMutex class. -// -// Copyright (c) 2004-2006, Applied Informatics Software Engineering GmbH. -// and Contributors. -// -// SPDX-License-Identifier: BSL-1.0 -// - - -#ifndef Foundation_NamedMutex_INCLUDED -#define Foundation_NamedMutex_INCLUDED - - -#include "Poco/Foundation.h" -#include "Poco/ScopedLock.h" - - -#if defined(POCO_OS_FAMILY_WINDOWS) && defined(POCO_WIN32_UTF8) -#include "Poco/NamedMutex_WIN32U.h" -#elif defined(POCO_OS_FAMILY_WINDOWS) -#include "Poco/NamedMutex_WIN32.h" -#elif POCO_OS == POCO_OS_ANDROID -#include "Poco/NamedMutex_Android.h" -#elif defined(POCO_OS_FAMILY_UNIX) -#include "Poco/NamedMutex_UNIX.h" -#endif - - -namespace Poco { - - -class Foundation_API NamedMutex: private NamedMutexImpl - /// A NamedMutex (mutual exclusion) is a global synchronization - /// mechanism used to control access to a shared resource - /// in a concurrent (multi process) scenario. - /// Using the ScopedLock class is the preferred way to automatically - /// lock and unlock a mutex. - /// - /// Unlike a Mutex or a FastMutex, which itself is the unit of synchronization, - /// a NamedMutex refers to a named operating system resource being the - /// unit of synchronization. - /// In other words, there can be multiple instances of NamedMutex referring - /// to the same actual synchronization object. - /// - /// - /// There should not be more than one instance of NamedMutex for - /// a given name in a process. Otherwise, the instances may - /// interfere with each other. -{ -public: - typedef Poco::ScopedLock<NamedMutex> ScopedLock; - - NamedMutex(const std::string& name); - /// creates the Mutex. - - ~NamedMutex(); - /// destroys the Mutex. - - void lock(); - /// Locks the mutex. Blocks if the mutex - /// is held by another process or thread. - - bool tryLock(); - /// Tries to lock the mutex. Returns false immediately - /// if the mutex is already held by another process or thread. - /// Returns true if the mutex was successfully locked. - - void unlock(); - /// Unlocks the mutex so that it can be acquired by - /// other threads. - -private: - NamedMutex(); - NamedMutex(const NamedMutex&); - NamedMutex& operator = (const NamedMutex&); -}; - - -// -// inlines -// -inline void NamedMutex::lock() -{ - lockImpl(); -} - - -inline bool NamedMutex::tryLock() -{ - return tryLockImpl(); -} - - -inline void NamedMutex::unlock() -{ - unlockImpl(); -} - - -} // namespace Poco - - -#endif // Foundation_NamedMutex_INCLUDED +// +// NamedMutex.h +// +// Library: Foundation +// Package: Processes +// Module: NamedMutex +// +// Definition of the NamedMutex class. +// +// Copyright (c) 2004-2006, Applied Informatics Software Engineering GmbH. +// and Contributors. +// +// SPDX-License-Identifier: BSL-1.0 +// + + +#ifndef Foundation_NamedMutex_INCLUDED +#define Foundation_NamedMutex_INCLUDED + + +#include "Poco/Foundation.h" +#include "Poco/ScopedLock.h" + + +#if defined(POCO_OS_FAMILY_WINDOWS) && defined(POCO_WIN32_UTF8) +#include "Poco/NamedMutex_WIN32U.h" +#elif defined(POCO_OS_FAMILY_WINDOWS) +#include "Poco/NamedMutex_WIN32.h" +#elif POCO_OS == POCO_OS_ANDROID +#include "Poco/NamedMutex_Android.h" +#elif defined(POCO_OS_FAMILY_UNIX) +#include "Poco/NamedMutex_UNIX.h" +#endif + + +namespace Poco { + + +class Foundation_API NamedMutex: private NamedMutexImpl + /// A NamedMutex (mutual exclusion) is a global synchronization + /// mechanism used to control access to a shared resource + /// in a concurrent (multi process) scenario. + /// Using the ScopedLock class is the preferred way to automatically + /// lock and unlock a mutex. + /// + /// Unlike a Mutex or a FastMutex, which itself is the unit of synchronization, + /// a NamedMutex refers to a named operating system resource being the + /// unit of synchronization. + /// In other words, there can be multiple instances of NamedMutex referring + /// to the same actual synchronization object. + /// + /// + /// There should not be more than one instance of NamedMutex for + /// a given name in a process. Otherwise, the instances may + /// interfere with each other. +{ +public: + typedef Poco::ScopedLock<NamedMutex> ScopedLock; + + NamedMutex(const std::string& name); + /// creates the Mutex. + + ~NamedMutex(); + /// destroys the Mutex. + + void lock(); + /// Locks the mutex. Blocks if the mutex + /// is held by another process or thread. + + bool tryLock(); + /// Tries to lock the mutex. Returns false immediately + /// if the mutex is already held by another process or thread. + /// Returns true if the mutex was successfully locked. + + void unlock(); + /// Unlocks the mutex so that it can be acquired by + /// other threads. + +private: + NamedMutex(); + NamedMutex(const NamedMutex&); + NamedMutex& operator = (const NamedMutex&); +}; + + +// +// inlines +// +inline void NamedMutex::lock() +{ + lockImpl(); +} + + +inline bool NamedMutex::tryLock() +{ + return tryLockImpl(); +} + + +inline void NamedMutex::unlock() +{ + unlockImpl(); +} + + +} // namespace Poco + + +#endif // Foundation_NamedMutex_INCLUDED |