blob: fc027ea79e62aefe354d775a7e15a5448eab2d5d [file] [log] [blame]
/*
* Copyright (C) 2009-2017 Apple Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. 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.
*
* THIS SOFTWARE IS PROVIDED BY APPLE INC. ``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 APPLE INC. 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.
*/
#pragma once
#include "ArrayBufferSharingMode.h"
#include "GCIncomingRefCounted.h"
#include "Weak.h"
#include <wtf/CagedPtr.h>
#include <wtf/Function.h>
#include <wtf/StdLibExtras.h>
#include <wtf/ThreadSafeRefCounted.h>
#include <wtf/text/WTFString.h>
namespace JSC {
class VM;
class ArrayBuffer;
class ArrayBufferView;
class JSArrayBuffer;
typedef Function<void(void*)> ArrayBufferDestructorFunction;
class SharedArrayBufferContents : public ThreadSafeRefCounted<SharedArrayBufferContents> {
public:
SharedArrayBufferContents(void* data, ArrayBufferDestructorFunction&&);
~SharedArrayBufferContents();
void* data() const { return m_data.getMayBeNull(); }
private:
CagedPtr<Gigacage::Primitive, void> m_data;
ArrayBufferDestructorFunction m_destructor;
};
class ArrayBufferContents {
WTF_MAKE_NONCOPYABLE(ArrayBufferContents);
public:
JS_EXPORT_PRIVATE ArrayBufferContents();
JS_EXPORT_PRIVATE ArrayBufferContents(void* data, unsigned sizeInBytes, ArrayBufferDestructorFunction&&);
JS_EXPORT_PRIVATE ArrayBufferContents(ArrayBufferContents&&);
JS_EXPORT_PRIVATE ArrayBufferContents& operator=(ArrayBufferContents&&);
JS_EXPORT_PRIVATE ~ArrayBufferContents();
JS_EXPORT_PRIVATE void clear();
explicit operator bool() { return !!m_data; }
void* data() const { return m_data.getMayBeNull(); }
unsigned sizeInBytes() const { return m_sizeInBytes; }
bool isShared() const { return m_shared; }
private:
void destroy();
void reset();
friend class ArrayBuffer;
enum InitializationPolicy {
ZeroInitialize,
DontInitialize
};
void tryAllocate(unsigned numElements, unsigned elementByteSize, InitializationPolicy);
void makeShared();
void transferTo(ArrayBufferContents&);
void copyTo(ArrayBufferContents&);
void shareWith(ArrayBufferContents&);
ArrayBufferDestructorFunction m_destructor;
RefPtr<SharedArrayBufferContents> m_shared;
CagedPtr<Gigacage::Primitive, void> m_data;
unsigned m_sizeInBytes;
};
class ArrayBuffer : public GCIncomingRefCounted<ArrayBuffer> {
public:
JS_EXPORT_PRIVATE static Ref<ArrayBuffer> create(unsigned numElements, unsigned elementByteSize);
JS_EXPORT_PRIVATE static Ref<ArrayBuffer> create(ArrayBuffer&);
JS_EXPORT_PRIVATE static Ref<ArrayBuffer> create(const void* source, unsigned byteLength);
JS_EXPORT_PRIVATE static Ref<ArrayBuffer> create(ArrayBufferContents&&);
JS_EXPORT_PRIVATE static Ref<ArrayBuffer> createAdopted(const void* data, unsigned byteLength);
JS_EXPORT_PRIVATE static Ref<ArrayBuffer> createFromBytes(const void* data, unsigned byteLength, ArrayBufferDestructorFunction&&);
JS_EXPORT_PRIVATE static RefPtr<ArrayBuffer> tryCreate(unsigned numElements, unsigned elementByteSize);
JS_EXPORT_PRIVATE static RefPtr<ArrayBuffer> tryCreate(ArrayBuffer&);
JS_EXPORT_PRIVATE static RefPtr<ArrayBuffer> tryCreate(const void* source, unsigned byteLength);
// Only for use by Uint8ClampedArray::createUninitialized and SharedBuffer::tryCreateArrayBuffer.
JS_EXPORT_PRIVATE static Ref<ArrayBuffer> createUninitialized(unsigned numElements, unsigned elementByteSize);
JS_EXPORT_PRIVATE static RefPtr<ArrayBuffer> tryCreateUninitialized(unsigned numElements, unsigned elementByteSize);
inline void* data();
inline const void* data() const;
inline unsigned byteLength() const;
void makeShared();
void setSharingMode(ArrayBufferSharingMode);
inline bool isShared() const;
inline ArrayBufferSharingMode sharingMode() const { return isShared() ? ArrayBufferSharingMode::Shared : ArrayBufferSharingMode::Default; }
inline size_t gcSizeEstimateInBytes() const;
JS_EXPORT_PRIVATE RefPtr<ArrayBuffer> slice(int begin, int end) const;
JS_EXPORT_PRIVATE RefPtr<ArrayBuffer> slice(int begin) const;
inline void pin();
inline void unpin();
inline void pinAndLock();
inline bool isLocked();
void makeWasmMemory();
inline bool isWasmMemory();
JS_EXPORT_PRIVATE bool transferTo(VM&, ArrayBufferContents&);
JS_EXPORT_PRIVATE bool shareWith(ArrayBufferContents&);
void neuter(VM&);
bool isNeutered() { return !m_contents.m_data; }
static ptrdiff_t offsetOfData() { return OBJECT_OFFSETOF(ArrayBuffer, m_contents) + OBJECT_OFFSETOF(ArrayBufferContents, m_data); }
~ArrayBuffer() { }
private:
static Ref<ArrayBuffer> create(unsigned numElements, unsigned elementByteSize, ArrayBufferContents::InitializationPolicy);
static Ref<ArrayBuffer> createInternal(ArrayBufferContents&&, const void*, unsigned);
static RefPtr<ArrayBuffer> tryCreate(unsigned numElements, unsigned elementByteSize, ArrayBufferContents::InitializationPolicy);
ArrayBuffer(ArrayBufferContents&&);
RefPtr<ArrayBuffer> sliceImpl(unsigned begin, unsigned end) const;
inline unsigned clampIndex(int index) const;
static inline int clampValue(int x, int left, int right);
void notifyIncommingReferencesOfTransfer(VM&);
ArrayBufferContents m_contents;
unsigned m_pinCount : 30;
bool m_isWasmMemory : 1;
// m_locked == true means that some API user fetched m_contents directly from a TypedArray object,
// the buffer is backed by a WebAssembly.Memory, or is a SharedArrayBuffer.
bool m_locked : 1;
public:
Weak<JSArrayBuffer> m_wrapper;
};
int ArrayBuffer::clampValue(int x, int left, int right)
{
ASSERT(left <= right);
if (x < left)
x = left;
if (right < x)
x = right;
return x;
}
void* ArrayBuffer::data()
{
return m_contents.m_data.getMayBeNull();
}
const void* ArrayBuffer::data() const
{
return m_contents.m_data.getMayBeNull();
}
unsigned ArrayBuffer::byteLength() const
{
return m_contents.m_sizeInBytes;
}
bool ArrayBuffer::isShared() const
{
return m_contents.isShared();
}
size_t ArrayBuffer::gcSizeEstimateInBytes() const
{
// FIXME: We probably want to scale this by the shared ref count or something.
return sizeof(ArrayBuffer) + static_cast<size_t>(byteLength());
}
unsigned ArrayBuffer::clampIndex(int index) const
{
unsigned currentLength = byteLength();
if (index < 0)
index = currentLength + index;
return clampValue(index, 0, currentLength);
}
void ArrayBuffer::pin()
{
m_pinCount++;
}
void ArrayBuffer::unpin()
{
m_pinCount--;
}
void ArrayBuffer::pinAndLock()
{
m_locked = true;
}
bool ArrayBuffer::isLocked()
{
return m_locked;
}
bool ArrayBuffer::isWasmMemory()
{
return m_isWasmMemory;
}
JS_EXPORT_PRIVATE ASCIILiteral errorMesasgeForTransfer(ArrayBuffer*);
} // namespace JSC
using JSC::ArrayBuffer;