This is a backward compatible implementation of compile time constructed String16 support. As much as we'd like a regular constexpr constructor for String16, we want to make sure the regular non-static String16 does not regress. We also need to make sure prebuilts built with previous version of String16 still works with new libutils. This means we cannot change the size of String16 objects and we cannot make anything virtual. To add a flag to indicate whether a String16 is static without increasing the size of non-static String16 objects, we repurpose a reserved field in SharedBuffer as "for client use". With this, we can tag every String16 and perform memory operation differently based on how the underlying buffers are allocated. By using StaticString16, we are able to eliminate the runtime construction of a String16 and move it out of .bss section. Bug: 138856262 Test: Run newly added unit tests. Change-Id: I72bb8dc27a59b9ef34e0d934bc1e00b0f675855a
140 lines
3.9 KiB
C++
140 lines
3.9 KiB
C++
/*
|
|
* Copyright (C) 2005 The Android Open Source Project
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#define LOG_TAG "sharedbuffer"
|
|
|
|
#include "SharedBuffer.h"
|
|
|
|
#include <stdlib.h>
|
|
#include <string.h>
|
|
|
|
#include <log/log.h>
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
namespace android {
|
|
|
|
SharedBuffer* SharedBuffer::alloc(size_t size)
|
|
{
|
|
// Don't overflow if the combined size of the buffer / header is larger than
|
|
// size_max.
|
|
LOG_ALWAYS_FATAL_IF((size >= (SIZE_MAX - sizeof(SharedBuffer))),
|
|
"Invalid buffer size %zu", size);
|
|
|
|
SharedBuffer* sb = static_cast<SharedBuffer *>(malloc(sizeof(SharedBuffer) + size));
|
|
if (sb) {
|
|
// Should be std::atomic_init(&sb->mRefs, 1);
|
|
// But that generates a warning with some compilers.
|
|
// The following is OK on Android-supported platforms.
|
|
sb->mRefs.store(1, std::memory_order_relaxed);
|
|
sb->mSize = size;
|
|
sb->mClientMetadata = 0;
|
|
}
|
|
return sb;
|
|
}
|
|
|
|
|
|
void SharedBuffer::dealloc(const SharedBuffer* released)
|
|
{
|
|
free(const_cast<SharedBuffer*>(released));
|
|
}
|
|
|
|
SharedBuffer* SharedBuffer::edit() const
|
|
{
|
|
if (onlyOwner()) {
|
|
return const_cast<SharedBuffer*>(this);
|
|
}
|
|
SharedBuffer* sb = alloc(mSize);
|
|
if (sb) {
|
|
memcpy(sb->data(), data(), size());
|
|
release();
|
|
}
|
|
return sb;
|
|
}
|
|
|
|
SharedBuffer* SharedBuffer::editResize(size_t newSize) const
|
|
{
|
|
if (onlyOwner()) {
|
|
SharedBuffer* buf = const_cast<SharedBuffer*>(this);
|
|
if (buf->mSize == newSize) return buf;
|
|
// Don't overflow if the combined size of the new buffer / header is larger than
|
|
// size_max.
|
|
LOG_ALWAYS_FATAL_IF((newSize >= (SIZE_MAX - sizeof(SharedBuffer))),
|
|
"Invalid buffer size %zu", newSize);
|
|
|
|
buf = (SharedBuffer*)realloc(buf, sizeof(SharedBuffer) + newSize);
|
|
if (buf != nullptr) {
|
|
buf->mSize = newSize;
|
|
return buf;
|
|
}
|
|
}
|
|
SharedBuffer* sb = alloc(newSize);
|
|
if (sb) {
|
|
const size_t mySize = mSize;
|
|
memcpy(sb->data(), data(), newSize < mySize ? newSize : mySize);
|
|
release();
|
|
}
|
|
return sb;
|
|
}
|
|
|
|
SharedBuffer* SharedBuffer::attemptEdit() const
|
|
{
|
|
if (onlyOwner()) {
|
|
return const_cast<SharedBuffer*>(this);
|
|
}
|
|
return nullptr;
|
|
}
|
|
|
|
SharedBuffer* SharedBuffer::reset(size_t new_size) const
|
|
{
|
|
// cheap-o-reset.
|
|
SharedBuffer* sb = alloc(new_size);
|
|
if (sb) {
|
|
release();
|
|
}
|
|
return sb;
|
|
}
|
|
|
|
void SharedBuffer::acquire() const {
|
|
mRefs.fetch_add(1, std::memory_order_relaxed);
|
|
}
|
|
|
|
int32_t SharedBuffer::release(uint32_t flags) const
|
|
{
|
|
const bool useDealloc = ((flags & eKeepStorage) == 0);
|
|
if (onlyOwner()) {
|
|
// Since we're the only owner, our reference count goes to zero.
|
|
mRefs.store(0, std::memory_order_relaxed);
|
|
if (useDealloc) {
|
|
dealloc(this);
|
|
}
|
|
// As the only owner, our previous reference count was 1.
|
|
return 1;
|
|
}
|
|
// There's multiple owners, we need to use an atomic decrement.
|
|
int32_t prevRefCount = mRefs.fetch_sub(1, std::memory_order_release);
|
|
if (prevRefCount == 1) {
|
|
// We're the last reference, we need the acquire fence.
|
|
atomic_thread_fence(std::memory_order_acquire);
|
|
if (useDealloc) {
|
|
dealloc(this);
|
|
}
|
|
}
|
|
return prevRefCount;
|
|
}
|
|
|
|
|
|
}; // namespace android
|