folly/SpinLock.h

   1 /*
   2  * Copyright 2016 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 <folly/detail/SpinLockImpl.h>
  36
  37 namespace folly {
  38
  39 #if __x86_64__
  40 typedef SpinLockMslImpl SpinLock;
  41 #elif __APPLE__
  42 typedef SpinLockAppleImpl SpinLock;
  43 #elif FOLLY_HAVE_PTHREAD_SPINLOCK_T
  44 typedef SpinLockPthreadImpl SpinLock;
  45 #else
  46 typedef SpinLockPthreadMutexImpl SpinLock;
  47 #endif
  48
  49 template <typename LOCK>
  50 class SpinLockGuardImpl : private boost::noncopyable {
  51  public:
  52   FOLLY_ALWAYS_INLINE explicit SpinLockGuardImpl(LOCK& lock) :
  53     lock_(lock) {
  54     lock_.lock();
  55   }
  56   FOLLY_ALWAYS_INLINE ~SpinLockGuardImpl() {
  57     lock_.unlock();
  58   }
  59  private:
  60   LOCK& lock_;
  61 };
  62
  63 typedef SpinLockGuardImpl<SpinLock> SpinLockGuard;
  64
  65 }