blob: f4515c8e3bf5c7a71bff157911963d7f6a7531da [file] [log] [blame]
/*
* Copyright (C) 2020 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.
*/
#include "SerializedFlushToState.h"
#include <map>
#include <android-base/logging.h>
#include <android-base/stringprintf.h>
#include <android-base/strings.h>
#include <gtest/gtest.h>
using android::base::Join;
using android::base::StringPrintf;
constexpr size_t kChunkSize = 3 * 4096;
class SerializedFlushToStateTest : public testing::Test {
protected:
void SetUp() override {
// This test spams many unneeded INFO logs, so we suppress them.
old_log_severity_ = android::base::SetMinimumLogSeverity(android::base::WARNING);
}
void TearDown() override { android::base::SetMinimumLogSeverity(old_log_severity_); }
std::string TestReport(const std::vector<uint64_t>& expected,
const std::vector<uint64_t>& read) {
auto sequence_to_log_id = [&](uint64_t sequence) -> int {
for (const auto& [log_id, sequences] : sequence_numbers_per_buffer_) {
if (std::find(sequences.begin(), sequences.end(), sequence) != sequences.end()) {
return log_id;
}
}
return -1;
};
std::map<int, std::vector<uint64_t>> missing_sequences;
std::vector<uint64_t> missing_expected;
std::set_difference(expected.begin(), expected.end(), read.begin(), read.end(),
std::back_inserter(missing_expected));
for (uint64_t sequence : missing_expected) {
int log_id = sequence_to_log_id(sequence);
missing_sequences[log_id].emplace_back(sequence);
}
std::map<int, std::vector<uint64_t>> extra_sequences;
std::vector<uint64_t> extra_read;
std::set_difference(read.begin(), read.end(), expected.begin(), expected.end(),
std::back_inserter(extra_read));
for (uint64_t sequence : extra_read) {
int log_id = sequence_to_log_id(sequence);
extra_sequences[log_id].emplace_back(sequence);
}
std::vector<std::string> errors;
for (const auto& [log_id, sequences] : missing_sequences) {
errors.emplace_back(
StringPrintf("Log id %d missing %zu sequences", log_id, sequences.size()));
}
for (const auto& [log_id, sequences] : extra_sequences) {
errors.emplace_back(
StringPrintf("Log id %d has extra %zu sequences", log_id, sequences.size()));
}
return Join(errors, ", ");
}
// Read sequence numbers in order from SerializedFlushToState for every mask combination and all
// sequence numbers from 0 through the highest logged sequence number + 1.
// This assumes that all of the logs have already been written.
void TestAllReading() {
uint64_t max_sequence = sequence_ + 1;
uint32_t max_mask = (1 << LOG_ID_MAX) - 1;
for (uint64_t sequence = 0; sequence < max_sequence; ++sequence) {
for (uint32_t mask = 0; mask < max_mask; ++mask) {
auto state = SerializedFlushToState{sequence, mask};
state.InitializeLogs(log_chunks_);
TestReading(sequence, mask, state);
}
}
}
// Similar to TestAllReading() except that it doesn't assume any logs are in the buffer, instead
// it calls write_logs() in a loop for sequence/mask combination. It clears log_chunks_ and
// sequence_numbers_per_buffer_ between calls, such that only the sequence numbers written in
// the previous call to write_logs() are expected.
void TestAllReadingWithFutureMessages(const std::function<bool(int)>& write_logs) {
uint64_t max_sequence = sequence_ + 1;
uint32_t max_mask = (1 << LOG_ID_MAX) - 1;
for (uint64_t sequence = 1; sequence < max_sequence; ++sequence) {
for (uint32_t mask = 1; mask < max_mask; ++mask) {
log_id_for_each(i) { log_chunks_[i].clear(); }
auto state = SerializedFlushToState{sequence, mask};
state.InitializeLogs(log_chunks_);
int loop_count = 0;
while (write_logs(loop_count++)) {
TestReading(sequence, mask, state);
sequence_numbers_per_buffer_.clear();
}
}
}
}
void TestReading(uint64_t start, LogMask log_mask, SerializedFlushToState& state) {
std::vector<uint64_t> expected_sequence;
log_id_for_each(i) {
if (((1 << i) & log_mask) == 0) {
continue;
}
for (const auto& sequence : sequence_numbers_per_buffer_[i]) {
if (sequence >= start) {
expected_sequence.emplace_back(sequence);
}
}
}
std::sort(expected_sequence.begin(), expected_sequence.end());
std::vector<uint64_t> read_sequence;
while (state.HasUnreadLogs()) {
auto top = state.PopNextUnreadLog();
read_sequence.emplace_back(top.entry->sequence());
}
EXPECT_TRUE(std::is_sorted(read_sequence.begin(), read_sequence.end()));
EXPECT_EQ(expected_sequence.size(), read_sequence.size());
EXPECT_EQ(expected_sequence, read_sequence)
<< "start: " << start << " log_mask: " << log_mask << " "
<< TestReport(expected_sequence, read_sequence);
}
// Add a chunk with the given messages to the a given log buffer. Keep track of the sequence
// numbers for future validation. Optionally mark the block as having finished writing.
void AddChunkWithMessages(bool finish_writing, int buffer,
const std::vector<std::string>& messages) {
auto chunk = SerializedLogChunk{kChunkSize};
for (const auto& message : messages) {
auto sequence = sequence_++;
sequence_numbers_per_buffer_[buffer].emplace_back(sequence);
ASSERT_TRUE(chunk.CanLog(message.size() + 1));
chunk.Log(sequence, log_time(), 0, 1, 1, message.c_str(), message.size() + 1);
}
if (finish_writing) {
chunk.FinishWriting();
}
log_chunks_[buffer].emplace_back(std::move(chunk));
}
android::base::LogSeverity old_log_severity_;
std::map<int, std::vector<uint64_t>> sequence_numbers_per_buffer_;
std::list<SerializedLogChunk> log_chunks_[LOG_ID_MAX];
uint64_t sequence_ = 1;
};
// 0: multiple chunks, with variable number of entries, with/without finishing writing
// 1: 1 chunk with 1 log and finished writing
// 2: 1 chunk with 1 log and not finished writing
// 3: 1 chunk with 0 logs and not finished writing
// 4: 1 chunk with 0 logs and finished writing (impossible, but SerializedFlushToState handles it)
// 5-7: 0 chunks
TEST_F(SerializedFlushToStateTest, smoke) {
AddChunkWithMessages(true, 0, {"1st", "2nd"});
AddChunkWithMessages(true, 1, {"3rd"});
AddChunkWithMessages(false, 0, {"4th"});
AddChunkWithMessages(true, 0, {"4th", "5th", "more", "even", "more", "go", "here"});
AddChunkWithMessages(false, 2, {"6th"});
AddChunkWithMessages(true, 0, {"7th"});
AddChunkWithMessages(false, 3, {});
AddChunkWithMessages(true, 4, {});
TestAllReading();
}
TEST_F(SerializedFlushToStateTest, random) {
srand(1);
for (int count = 0; count < 20; ++count) {
unsigned int num_messages = 1 + rand() % 15;
auto messages = std::vector<std::string>{num_messages, "same message"};
bool compress = rand() % 2;
int buf = rand() % LOG_ID_MAX;
AddChunkWithMessages(compress, buf, messages);
}
TestAllReading();
}
// Same start as smoke, but we selectively write logs to the buffers and ensure they're read.
TEST_F(SerializedFlushToStateTest, future_writes) {
auto write_logs = [&](int loop_count) {
switch (loop_count) {
case 0:
// Initial writes.
AddChunkWithMessages(true, 0, {"1st", "2nd"});
AddChunkWithMessages(true, 1, {"3rd"});
AddChunkWithMessages(false, 0, {"4th"});
AddChunkWithMessages(true, 0, {"4th", "5th", "more", "even", "more", "go", "here"});
AddChunkWithMessages(false, 2, {"6th"});
AddChunkWithMessages(true, 0, {"7th"});
AddChunkWithMessages(false, 3, {});
AddChunkWithMessages(true, 4, {});
break;
case 1:
// Smoke test, add a simple chunk.
AddChunkWithMessages(true, 0, {"1st", "2nd"});
break;
case 2:
// Add chunks to all but one of the logs.
AddChunkWithMessages(true, 0, {"1st", "2nd"});
AddChunkWithMessages(true, 1, {"1st", "2nd"});
AddChunkWithMessages(true, 2, {"1st", "2nd"});
AddChunkWithMessages(true, 3, {"1st", "2nd"});
AddChunkWithMessages(true, 4, {"1st", "2nd"});
AddChunkWithMessages(true, 5, {"1st", "2nd"});
AddChunkWithMessages(true, 6, {"1st", "2nd"});
break;
case 3:
// Finally add chunks to all logs.
AddChunkWithMessages(true, 0, {"1st", "2nd"});
AddChunkWithMessages(true, 1, {"1st", "2nd"});
AddChunkWithMessages(true, 2, {"1st", "2nd"});
AddChunkWithMessages(true, 3, {"1st", "2nd"});
AddChunkWithMessages(true, 4, {"1st", "2nd"});
AddChunkWithMessages(true, 5, {"1st", "2nd"});
AddChunkWithMessages(true, 6, {"1st", "2nd"});
AddChunkWithMessages(true, 7, {"1st", "2nd"});
break;
default:
return false;
}
return true;
};
TestAllReadingWithFutureMessages(write_logs);
}
TEST_F(SerializedFlushToStateTest, no_dangling_references) {
AddChunkWithMessages(true, 0, {"1st", "2nd"});
AddChunkWithMessages(true, 0, {"3rd", "4th"});
auto state = SerializedFlushToState{1, kLogMaskAll};
state.InitializeLogs(log_chunks_);
ASSERT_EQ(log_chunks_[0].size(), 2U);
auto first_chunk = log_chunks_[0].begin();
auto second_chunk = std::next(first_chunk);
ASSERT_TRUE(state.HasUnreadLogs());
auto first_log = state.PopNextUnreadLog();
EXPECT_STREQ(first_log.entry->msg(), "1st");
EXPECT_EQ(first_chunk->reader_ref_count(), 1U);
EXPECT_EQ(second_chunk->reader_ref_count(), 0U);
ASSERT_TRUE(state.HasUnreadLogs());
auto second_log = state.PopNextUnreadLog();
EXPECT_STREQ(second_log.entry->msg(), "2nd");
EXPECT_EQ(first_chunk->reader_ref_count(), 1U);
EXPECT_EQ(second_chunk->reader_ref_count(), 0U);
ASSERT_TRUE(state.HasUnreadLogs());
auto third_log = state.PopNextUnreadLog();
EXPECT_STREQ(third_log.entry->msg(), "3rd");
EXPECT_EQ(first_chunk->reader_ref_count(), 0U);
EXPECT_EQ(second_chunk->reader_ref_count(), 1U);
ASSERT_TRUE(state.HasUnreadLogs());
auto fourth_log = state.PopNextUnreadLog();
EXPECT_STREQ(fourth_log.entry->msg(), "4th");
EXPECT_EQ(first_chunk->reader_ref_count(), 0U);
EXPECT_EQ(second_chunk->reader_ref_count(), 1U);
EXPECT_FALSE(state.HasUnreadLogs());
}