1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
|
/*
* Copyright (C) 2018-2022 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. AND ITS 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 APPLE INC. OR ITS 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.
*/
// Encodes a FragmentedSharedBuffer that is to be sent over IPC
// WARNING: a SharedBufferReference should only be accessed on the IPC's receiver side.
#pragma once
#include <WebCore/SharedBuffer.h>
#include <WebCore/SharedMemory.h>
#include <optional>
namespace IPC {
class SharedBufferReference {
public:
SharedBufferReference() = default;
explicit SharedBufferReference(RefPtr<WebCore::FragmentedSharedBuffer>&& buffer)
: m_size(buffer ? buffer->size() : 0)
, m_buffer(WTFMove(buffer)) { }
explicit SharedBufferReference(Ref<WebCore::FragmentedSharedBuffer>&& buffer)
: m_size(buffer->size())
, m_buffer(WTFMove(buffer)) { }
explicit SharedBufferReference(RefPtr<WebCore::SharedBuffer>&& buffer)
: m_size(buffer ? buffer->size() : 0)
, m_buffer(WTFMove(buffer)) { }
explicit SharedBufferReference(Ref<WebCore::SharedBuffer>&& buffer)
: m_size(buffer->size())
, m_buffer(WTFMove(buffer)) { }
explicit SharedBufferReference(const WebCore::FragmentedSharedBuffer& buffer)
: m_size(buffer.size())
, m_buffer(const_cast<WebCore::FragmentedSharedBuffer*>(&buffer)) { }
#if !USE(UNIX_DOMAIN_SOCKETS)
struct SerializableBuffer {
size_t size;
std::optional<WebCore::SharedMemory::Handle> handle;
};
SharedBufferReference(std::optional<SerializableBuffer>&&);
#endif
SharedBufferReference(const SharedBufferReference&) = default;
SharedBufferReference(SharedBufferReference&&) = default;
SharedBufferReference& operator=(const SharedBufferReference&) = default;
SharedBufferReference& operator=(SharedBufferReference&&) = default;
size_t size() const { return m_size; }
bool isEmpty() const { return !size(); }
bool isNull() const { return isEmpty() && !m_buffer; }
#if USE(UNIX_DOMAIN_SOCKETS)
RefPtr<WebCore::FragmentedSharedBuffer> buffer() const { return m_buffer; }
#else
std::optional<SerializableBuffer> serializableBuffer() const;
#endif
// The following method must only be used on the receiver's IPC side.
// It relies on an implementation detail that makes m_buffer become a contiguous SharedBuffer
// once it's deserialised over IPC.
RefPtr<WebCore::SharedBuffer> unsafeBuffer() const;
std::span<const uint8_t> span() const;
RefPtr<WebCore::SharedMemory> sharedCopy() const;
private:
SharedBufferReference(Ref<WebCore::SharedMemory>&& memory, size_t size)
: m_size(size)
, m_memory(WTFMove(memory)) { }
size_t m_size { 0 };
mutable RefPtr<WebCore::FragmentedSharedBuffer> m_buffer;
RefPtr<WebCore::SharedMemory> m_memory; // Only set on the receiver side and if m_size isn't 0.
};
} // namespace IPC
|
