| Index: src/circular-queue.h
|
| diff --git a/src/circular-queue.h b/src/circular-queue.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..11159e0388edc1d5fdfff922904d5b083a29dcd1
|
| --- /dev/null
|
| +++ b/src/circular-queue.h
|
| @@ -0,0 +1,130 @@
|
| +// Copyright 2010 the V8 project authors. All rights reserved.
|
| +// Redistribution and use in source and binary forms, with or without
|
| +// modification, are permitted provided that the following conditions are
|
| +// met:
|
| +//
|
| +// * Redistributions of source code must retain the above copyright
|
| +// notice, this list of conditions and the following disclaimer.
|
| +// * Redistributions in binary form must reproduce the above
|
| +// copyright notice, this list of conditions and the following
|
| +// disclaimer in the documentation and/or other materials provided
|
| +// with the distribution.
|
| +// * Neither the name of Google Inc. nor the names of its
|
| +// contributors may be used to endorse or promote products derived
|
| +// from this software without specific prior written permission.
|
| +//
|
| +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
| +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
| +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
| +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
| +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
| +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
| +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
| +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
| +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
| +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
| +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
| +
|
| +#ifndef V8_CIRCULAR_QUEUE_H_
|
| +#define V8_CIRCULAR_QUEUE_H_
|
| +
|
| +namespace v8 {
|
| +namespace internal {
|
| +
|
| +
|
| +// Lock-based blocking circular queue for small records. Intended for
|
| +// transfer of small records between a single producer and a single
|
| +// consumer. Blocks on enqueue operation if the queue is full.
|
| +template<typename Record>
|
| +class CircularQueue {
|
| + public:
|
| + inline explicit CircularQueue(int desired_buffer_size_in_bytes);
|
| + inline ~CircularQueue();
|
| +
|
| + INLINE(void Dequeue(Record* rec));
|
| + INLINE(void Enqueue(const Record& rec));
|
| + INLINE(bool IsEmpty()) { return enqueue_pos_ == dequeue_pos_; }
|
| +
|
| + private:
|
| + INLINE(Record* Next(Record* curr));
|
| +
|
| + Record* buffer_;
|
| + Record* const buffer_end_;
|
| + Semaphore* enqueue_semaphore_;
|
| + Record* enqueue_pos_;
|
| + Record* dequeue_pos_;
|
| +
|
| + DISALLOW_COPY_AND_ASSIGN(CircularQueue);
|
| +};
|
| +
|
| +
|
| +// Lock-free cache-friendly sampling circular queue for large
|
| +// records. Intended for fast transfer of large records between a
|
| +// single producer and a single consumer. If the queue is full,
|
| +// previous unread records are overwritten. The queue is designed with
|
| +// a goal in mind to evade cache lines thrashing by preventing
|
| +// simultaneous reads and writes to adjanced memory locations.
|
| +//
|
| +// IMPORTANT: as a producer never checks for chunks cleanness, it is
|
| +// possible that it can catch up and overwrite a chunk that a consumer
|
| +// is currently reading, resulting in a corrupt record being read.
|
| +class SamplingCircularQueue {
|
| + public:
|
| + // Executed on the application thread.
|
| + SamplingCircularQueue(int record_size_in_bytes,
|
| + int desired_chunk_size_in_bytes,
|
| + int buffer_size_in_chunks);
|
| + ~SamplingCircularQueue();
|
| +
|
| + // Executed on the producer (sampler) or application thread.
|
| + void SetUpProducer();
|
| + // Enqueue returns a pointer to a memory location for storing the next
|
| + // record.
|
| + INLINE(void* Enqueue());
|
| + void TearDownProducer();
|
| +
|
| + // Executed on the consumer (analyzer) thread.
|
| + void SetUpConsumer();
|
| + // StartDequeue returns a pointer to a memory location for retrieving
|
| + // the next record. After the record had been read by a consumer,
|
| + // FinishDequeue must be called. Until that moment, subsequent calls
|
| + // to StartDequeue will return the same pointer.
|
| + void* StartDequeue();
|
| + void FinishDequeue();
|
| + // Due to a presence of slipping between the producer and the consumer,
|
| + // the queue must be notified whether producing has been finished in order
|
| + // to process remaining records from the buffer.
|
| + void FlushResidualRecords();
|
| + void TearDownConsumer();
|
| +
|
| + typedef AtomicWord Cell;
|
| + // Reserved values for the first cell of a record.
|
| + static const Cell kClear = 0; // Marks clean (processed) chunks.
|
| + static const Cell kEnd = -1; // Marks the end of the buffer.
|
| +
|
| + private:
|
| + struct ConsumerPosition {
|
| + Cell* dequeue_chunk_pos;
|
| + Cell* dequeue_chunk_poll_pos;
|
| + Cell* dequeue_pos;
|
| + Cell* dequeue_end_pos;
|
| + };
|
| +
|
| + INLINE(void WrapPositionIfNeeded(Cell** pos));
|
| +
|
| + const int record_size_;
|
| + const int chunk_size_in_bytes_;
|
| + const int chunk_size_;
|
| + const int buffer_size_;
|
| + const int producer_consumer_distance_;
|
| + Cell* buffer_;
|
| + // Store producer and consumer data in TLS to avoid modifying the
|
| + // same CPU cache line from two threads simultaneously.
|
| + Thread::LocalStorageKey consumer_key_;
|
| + Thread::LocalStorageKey producer_key_;
|
| +};
|
| +
|
| +
|
| +} } // namespace v8::internal
|
| +
|
| +#endif // V8_CIRCULAR_QUEUE_H_
|
|
|