2002-02-12 16:55:25 +00:00
|
|
|
#ifndef BOOST_DETAIL_LIGHTWEIGHT_MUTEX_HPP_INCLUDED
|
|
|
|
#define BOOST_DETAIL_LIGHTWEIGHT_MUTEX_HPP_INCLUDED
|
|
|
|
|
|
|
|
#if _MSC_VER >= 1020
|
|
|
|
#pragma once
|
|
|
|
#endif
|
|
|
|
|
|
|
|
//
|
|
|
|
// boost/detail/lightweight_mutex.hpp - lightweight mutex
|
|
|
|
//
|
|
|
|
// Copyright (c) 2002 Peter Dimov and Multi Media Ltd.
|
|
|
|
//
|
|
|
|
// Permission to copy, use, modify, sell and distribute this software
|
|
|
|
// is granted provided this copyright notice appears in all copies.
|
|
|
|
// This software is provided "as is" without express or implied
|
|
|
|
// warranty, and with no claim as to its suitability for any purpose.
|
|
|
|
//
|
|
|
|
// typedef <implementation-defined> boost::detail::lightweight_mutex;
|
|
|
|
//
|
|
|
|
// boost::detail::lightweight_mutex meets the Mutex concept requirements
|
|
|
|
// See http://www.boost.org/libs/thread/doc/mutex_concept.html#Mutex
|
|
|
|
//
|
|
|
|
// * Used by the smart pointer library
|
|
|
|
// * Performance oriented
|
|
|
|
// * Header-only implementation
|
|
|
|
// * Small memory footprint
|
|
|
|
// * Not a general purpose mutex, use boost::mutex, CRITICAL_SECTION or
|
|
|
|
// pthread_mutex instead.
|
|
|
|
// * Never spin in a tight lock/do-something/unlock loop, since
|
|
|
|
// lightweight_mutex does not guarantee fairness.
|
|
|
|
// * Never keep a lightweight_mutex locked for long periods.
|
|
|
|
//
|
|
|
|
|
2002-03-01 16:17:08 +00:00
|
|
|
// Note: lwm_linux.hpp has been disabled by default; see the comments
|
|
|
|
// inside for more info.
|
|
|
|
|
2002-02-12 16:55:25 +00:00
|
|
|
|
|
|
|
#include <boost/config.hpp>
|
|
|
|
|
2002-03-15 22:00:10 +00:00
|
|
|
//
|
|
|
|
// Note to implementors: if you write a platform-specific lightweight_mutex
|
|
|
|
// for a platform that supports pthreads, be sure to test its performance
|
2002-05-21 16:48:20 +00:00
|
|
|
// against the pthreads-based version using shared_ptr_timing_test.cpp and
|
|
|
|
// shared_ptr_mt_test.cpp. Custom versions are usually not worth the trouble
|
2002-03-15 22:00:10 +00:00
|
|
|
// _unless_ the performance gains are substantial.
|
|
|
|
//
|
2002-05-21 16:48:20 +00:00
|
|
|
// Be sure to compare against a "real" pthreads library;
|
|
|
|
// shared_ptr_timing_test.cpp will compile succesfully with a stub do-nothing
|
|
|
|
// pthreads library, since it doesn't create any threads.
|
|
|
|
//
|
2002-03-15 22:00:10 +00:00
|
|
|
|
2002-02-12 16:55:25 +00:00
|
|
|
#ifndef BOOST_HAS_THREADS
|
|
|
|
# include <boost/detail/lwm_nop.hpp>
|
2002-03-01 16:17:08 +00:00
|
|
|
#elif defined(BOOST_USE_ASM_ATOMIC_H)
|
2002-02-16 15:00:55 +00:00
|
|
|
# include <boost/detail/lwm_linux.hpp>
|
2002-03-15 22:00:10 +00:00
|
|
|
#elif defined(BOOST_LWM_USE_CRITICAL_SECTION)
|
|
|
|
# include <boost/detail/lwm_win32_cs.hpp>
|
|
|
|
#elif defined(BOOST_LWM_USE_PTHREADS)
|
|
|
|
# include <boost/detail/lwm_pthreads.hpp>
|
|
|
|
#elif defined(WIN32) || defined(_WIN32) || defined(__WIN32__)
|
|
|
|
# include <boost/detail/lwm_win32.hpp>
|
2002-02-27 16:35:15 +00:00
|
|
|
#elif defined(__sgi)
|
|
|
|
# include <boost/detail/lwm_irix.hpp>
|
2002-05-21 16:48:20 +00:00
|
|
|
#elif defined(__GLIBCPP__)
|
|
|
|
# include <boost/detail/lwm_gcc.hpp>
|
2002-02-12 16:55:25 +00:00
|
|
|
#elif defined(BOOST_HAS_PTHREADS)
|
2002-03-15 22:00:10 +00:00
|
|
|
# define BOOST_LWM_USE_PTHREADS
|
2002-02-12 16:55:25 +00:00
|
|
|
# include <boost/detail/lwm_pthreads.hpp>
|
|
|
|
#else
|
|
|
|
# include <boost/detail/lwm_nop.hpp>
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#endif // #ifndef BOOST_DETAIL_LIGHTWEIGHT_MUTEX_HPP_INCLUDED
|