Dateien
rocm-systems/source/lib/rocprofiler-sdk/tests/buffer.cpp
T
Madsen, Jonathan 8a1ee46e47 [SDK] Fix double buffer data race (#394)
* Fix double buffer data race

- fixes relatively rare data race in double buffering scheme

In `rocprofiler::buffer::instance::emplace`, the `container::record_header_buffer::get_record_headers()` function returned a `std::vector<rocprofiler_record_header_t*>` and then invoked callback to tool. It was possible for that callback to still be executing while the buffer was being updated. This potentially introduced a scenario where the rocprofiler_record_header_t* was modified (or corrupted) before the tool processed the record. In rocprofv3, this would result in a "future" buffer record showing up among "past" buffer records. E.g., correlation id sequence of 1-15 where the buffer flushes after five values, could result in this during processing:
|     |     |     |     |      |
|:---:|:---:|:---:|:---:|:---:|
|  1 |  2 |  3 |  4 | 15 |
|  6 |  7 |  8 |  9 | 10 |
| 11 | 12 | 13 | 14 | 15 |

Because buffer A (of double buffering scheme) originally containing corr ids 1-5 stalled after process corr id 4 (e.g. write to disk), buffer B filled up with 6-10 and started flushing, causing a switch back to buffer A, and buffer A was filled with 11-15 by the time callback accessed what was originally corr id 5 but was now updated to corr id 15.

* Update CHANGELOG

* misc minor cleanup

---------

Co-authored-by: Jonathan R. Madsen <jonathanrmadsen@gmail.com>
2025-05-14 13:19:22 -05:00

75 Zeilen
2.9 KiB
C++

// MIT License
//
// Copyright (c) 2023-2025 Advanced Micro Devices, Inc. All rights reserved.
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in all
// copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
// SOFTWARE.
#include "lib/rocprofiler-sdk/buffer.hpp"
#include "lib/common/units.hpp"
#include <rocprofiler-sdk/buffer.h>
#include <rocprofiler-sdk/fwd.h>
#include <rocprofiler-sdk/registration.h>
#include <gtest/gtest.h>
#include <pthread.h>
#include <cstdint>
#include <cstdlib>
#include <random>
#include <typeinfo>
TEST(rocprofiler_lib, buffer)
{
namespace buffer = ::rocprofiler::buffer;
namespace common = ::rocprofiler::common;
ASSERT_EQ(buffer::get_buffers()->size(), 0)
<< "no buffers should have been created at this point";
auto buffer_id = buffer::allocate_buffer();
EXPECT_TRUE(buffer_id) << "failed to allocate buffer";
EXPECT_GT(buffer_id->handle, 0);
EXPECT_TRUE(buffer::is_valid_buffer_id(*buffer_id)) << "id=" << buffer_id->handle;
ASSERT_EQ(buffer::get_buffers()->size(), 1) << "incorrect number of buffers created";
// get pointer to buffer
auto* buffer_v = buffer::get_buffer(*buffer_id);
ASSERT_NE(buffer_v, nullptr) << "get_buffer returned a nullptr. id=" << buffer_id->handle;
EXPECT_EQ(buffer_v->buffer_id, buffer_id->handle);
buffer_v->watermark = common::units::get_page_size();
EXPECT_EQ(buffer_v->get_internal_buffer().get_num_record_headers(), 0);
EXPECT_TRUE(buffer_v->get_internal_buffer().allocate(sizeof(rocprofiler_buffer_id_t)));
EXPECT_EQ(buffer_v->get_internal_buffer().capacity(), common::units::get_page_size());
auto data = *buffer_id;
buffer_v->emplace(1, 1, data);
EXPECT_EQ(buffer_v->get_internal_buffer().get_num_record_headers(), 1);
auto flush_status = buffer::flush(*buffer_id, true);
EXPECT_EQ(flush_status, ROCPROFILER_STATUS_SUCCESS);
auto destroy_status = rocprofiler_destroy_buffer(*buffer_id);
EXPECT_EQ(destroy_status, ROCPROFILER_STATUS_SUCCESS);
}