v8threads.h

Go to the documentation of this file.

// Copyright 2012 the V8 project authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
 
#ifndef V8_V8THREADS_H_
#define V8_V8THREADS_H_
 
namespace v8 {
namespace internal {
 
 
class ThreadState {
 public:
  // Returns NULL after the last one.
  ThreadState* Next();
 
  enum List {FREE_LIST, IN_USE_LIST};
 
  void LinkInto(List list);
  void Unlink();
 
  // Id of thread.
  void set_id(ThreadId id) { id_ = id; }
  ThreadId id() { return id_; }
 
  // Should the thread be terminated when it is restored?
  bool terminate_on_restore() { return terminate_on_restore_; }
  void set_terminate_on_restore(bool terminate_on_restore) {
    terminate_on_restore_ = terminate_on_restore;
  }
 
  // Get data area for archiving a thread.
  char* data() { return data_; }
 
 private:
  explicit ThreadState(ThreadManager* thread_manager);
  ~ThreadState();
 
  void AllocateSpace();
 
  ThreadId id_;
  bool terminate_on_restore_;
  char* data_;
  ThreadState* next_;
  ThreadState* previous_;
 
  ThreadManager* thread_manager_;
 
  friend class ThreadManager;
};
 
 
// Defined in isolate.h.
class ThreadLocalTop;
 
 
class ThreadVisitor {
 public:
  // ThreadLocalTop may be only available during this call.
  virtual void VisitThread(Isolate* isolate, ThreadLocalTop* top) = 0;
 
 protected:
  virtual ~ThreadVisitor() {}
};
 
 
class ThreadManager {
 public:
  void Lock();
  void Unlock();
 
  void ArchiveThread();
  bool RestoreThread();
  void FreeThreadResources();
  bool IsArchived();
 
  void Iterate(ObjectVisitor* v);
  void IterateArchivedThreads(ThreadVisitor* v);
  bool IsLockedByCurrentThread() {
    return mutex_owner_.Equals(ThreadId::Current());
  }
 
  ThreadId CurrentId();
 
  void TerminateExecution(ThreadId thread_id);
 
  // Iterate over in-use states.
  ThreadState* FirstThreadStateInUse();
  ThreadState* GetFreeThreadState();
 
 private:
  ThreadManager();
  ~ThreadManager();
 
  void DeleteThreadStateList(ThreadState* anchor);
 
  void EagerlyArchiveThread();
 
  base::Mutex mutex_;
  ThreadId mutex_owner_;
  ThreadId lazily_archived_thread_;
  ThreadState* lazily_archived_thread_state_;
 
  // In the following two lists there is always at least one object on the list.
  // The first object is a flying anchor that is only there to simplify linking
  // and unlinking.
  // Head of linked list of free states.
  ThreadState* free_anchor_;
  // Head of linked list of states in use.
  ThreadState* in_use_anchor_;
 
  Isolate* isolate_;
 
  friend class Isolate;
  friend class ThreadState;
};
 
 
} }  // namespace v8::internal
 
#endif  // V8_V8THREADS_H_