folly/SpinLock.h

   1 /*
   2  * Copyright 2017 Facebook, Inc.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *   http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 /*
  18  * N.B. You most likely do _not_ want to use SpinLock or any other
  19  * kind of spinlock.  Use std::mutex instead.
  20  *
  21  * In short, spinlocks in preemptive multi-tasking operating systems
  22  * have serious problems and fast mutexes like std::mutex are almost
  23  * certainly the better choice, because letting the OS scheduler put a
  24  * thread to sleep is better for system responsiveness and throughput
  25  * than wasting a timeslice repeatedly querying a lock held by a
  26  * thread that's blocked, and you can't prevent userspace
  27  * programs blocking.
  28  *
  29  * Spinlocks in an operating system kernel make much more sense than
  30  * they do in userspace.
  31  */
  32
  33 #pragma once
  34
  35 #include <type_traits>
  36
  37 #include <folly/detail/SpinLockImpl.h>
  38
  39 namespace folly {
  40
  41 #if __x86_64__
  42 typedef SpinLockMslImpl SpinLock;
  43 #elif __APPLE__
  44 typedef SpinLockAppleImpl SpinLock;
  45 #elif FOLLY_HAVE_PTHREAD_SPINLOCK_T
  46 typedef SpinLockPthreadImpl SpinLock;
  47 #else
  48 typedef SpinLockPthreadMutexImpl SpinLock;
  49 #endif
  50
  51 template <typename LOCK>
  52 class SpinLockGuardImpl : private boost::noncopyable {
  53  public:
  54   FOLLY_ALWAYS_INLINE explicit SpinLockGuardImpl(LOCK& lock) :
  55     lock_(lock) {
  56     lock_.lock();
  57   }
  58   FOLLY_ALWAYS_INLINE ~SpinLockGuardImpl() {
  59     lock_.unlock();
  60   }
  61  private:
  62   LOCK& lock_;
  63 };
  64
  65 typedef SpinLockGuardImpl<SpinLock> SpinLockGuard;
  66
  67 }