rocksdb-native 2.6.3 → 2.6.5

package/vendor/librocksdb/vendor/rocksdb/table/block_fetcher.cc

@@ -1,458 +0,0 @@
-//  Copyright (c) 2011-present, Facebook, Inc.  All rights reserved.
-//  This source code is licensed under both the GPLv2 (found in the
-//  COPYING file in the root directory) and Apache 2.0 License
-//  (found in the LICENSE.Apache file in the root directory).
-//
-// Copyright (c) 2011 The LevelDB Authors. All rights reserved.
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file. See the AUTHORS file for names of contributors.
-
-#include "table/block_fetcher.h"
-
-#include <cassert>
-#include <cinttypes>
-#include <string>
-
-#include "logging/logging.h"
-#include "memory/memory_allocator_impl.h"
-#include "monitoring/perf_context_imp.h"
-#include "rocksdb/compression_type.h"
-#include "rocksdb/env.h"
-#include "table/block_based/block.h"
-#include "table/block_based/block_based_table_reader.h"
-#include "table/block_based/block_type.h"
-#include "table/block_based/reader_common.h"
-#include "table/format.h"
-#include "table/persistent_cache_helper.h"
-#include "util/compression.h"
-#include "util/stop_watch.h"
-
-namespace ROCKSDB_NAMESPACE {
-
-inline void BlockFetcher::ProcessTrailerIfPresent() {
-  if (footer_.GetBlockTrailerSize() > 0) {
-    assert(footer_.GetBlockTrailerSize() == BlockBasedTable::kBlockTrailerSize);
-    if (read_options_.verify_checksums) {
-      io_status_ = status_to_io_status(
-          VerifyBlockChecksum(footer_, slice_.data(), block_size_,
-                              file_->file_name(), handle_.offset()));
-      RecordTick(ioptions_.stats, BLOCK_CHECKSUM_COMPUTE_COUNT);
-      if (!io_status_.ok()) {
-        assert(io_status_.IsCorruption());
-        RecordTick(ioptions_.stats, BLOCK_CHECKSUM_MISMATCH_COUNT);
-      }
-    }
-    compression_type_ =
-        BlockBasedTable::GetBlockCompressionType(slice_.data(), block_size_);
-  } else {
-    // E.g. plain table or cuckoo table
-    compression_type_ = kNoCompression;
-  }
-}
-
-inline bool BlockFetcher::TryGetUncompressBlockFromPersistentCache() {
-  if (cache_options_.persistent_cache &&
-      !cache_options_.persistent_cache->IsCompressed()) {
-    Status status = PersistentCacheHelper::LookupUncompressed(
-        cache_options_, handle_, contents_);
-    if (status.ok()) {
-      // uncompressed page is found for the block handle
-      return true;
-    } else {
-      // uncompressed page is not found
-      if (ioptions_.logger && !status.IsNotFound()) {
-        assert(!status.ok());
-        ROCKS_LOG_INFO(ioptions_.logger,
-                       "Error reading from persistent cache. %s",
-                       status.ToString().c_str());
-      }
-    }
-  }
-  return false;
-}
-
-inline bool BlockFetcher::TryGetFromPrefetchBuffer() {
-  if (prefetch_buffer_ != nullptr) {
-    IOOptions opts;
-    IOStatus io_s = file_->PrepareIOOptions(read_options_, opts);
-    if (io_s.ok()) {
-      bool read_from_prefetch_buffer = prefetch_buffer_->TryReadFromCache(
-          opts, file_, handle_.offset(), block_size_with_trailer_, &slice_,
-          &io_s, for_compaction_);
-      if (read_from_prefetch_buffer) {
-        ProcessTrailerIfPresent();
-        if (io_status_.ok()) {
-          got_from_prefetch_buffer_ = true;
-          used_buf_ = const_cast<char*>(slice_.data());
-        } else if (!(io_status_.IsCorruption() && retry_corrupt_read_)) {
-          return true;
-        }
-      }
-    }
-    if (!io_s.ok()) {
-      io_status_ = io_s;
-      return true;
-    }
-  }
-  return got_from_prefetch_buffer_;
-}
-
-inline bool BlockFetcher::TryGetSerializedBlockFromPersistentCache() {
-  if (cache_options_.persistent_cache &&
-      cache_options_.persistent_cache->IsCompressed()) {
-    std::unique_ptr<char[]> buf;
-    io_status_ = status_to_io_status(PersistentCacheHelper::LookupSerialized(
-        cache_options_, handle_, &buf, block_size_with_trailer_));
-    if (io_status_.ok()) {
-      heap_buf_ = CacheAllocationPtr(buf.release());
-      used_buf_ = heap_buf_.get();
-      slice_ = Slice(heap_buf_.get(), block_size_);
-      ProcessTrailerIfPresent();
-      return true;
-    } else if (!io_status_.IsNotFound() && ioptions_.logger) {
-      assert(!io_status_.ok());
-      ROCKS_LOG_INFO(ioptions_.logger,
-                     "Error reading from persistent cache. %s",
-                     io_status_.ToString().c_str());
-    }
-  }
-  return false;
-}
-
-inline void BlockFetcher::PrepareBufferForBlockFromFile() {
-  // cache miss read from device
-  if ((do_uncompress_ || ioptions_.allow_mmap_reads) &&
-      block_size_with_trailer_ < kDefaultStackBufferSize) {
-    // If we've got a small enough chunk of data, read it in to the
-    // trivially allocated stack buffer instead of needing a full malloc()
-    //
-    // `GetBlockContents()` cannot return this data as its lifetime is tied to
-    // this `BlockFetcher`'s lifetime. That is fine because this is only used
-    // in cases where we do not expect the `GetBlockContents()` result to be the
-    // same buffer we are assigning here. If we guess incorrectly, there will be
-    // a heap allocation and memcpy in `GetBlockContents()` to obtain the final
-    // result. Considering we are eliding a heap allocation here by using the
-    // stack buffer, the cost of guessing incorrectly here is one extra memcpy.
-    //
-    // When `do_uncompress_` is true, we expect the uncompression step will
-    // allocate heap memory for the final result. However this expectation will
-    // be wrong if the block turns out to already be uncompressed, which we
-    // won't know for sure until after reading it.
-    //
-    // When `ioptions_.allow_mmap_reads` is true, we do not expect the file
-    // reader to use the scratch buffer at all, but instead return a pointer
-    // into the mapped memory. This expectation will be wrong when using a
-    // file reader that does not implement mmap reads properly.
-    used_buf_ = &stack_buf_[0];
-  } else if (maybe_compressed_ && !do_uncompress_) {
-    compressed_buf_ =
-        AllocateBlock(block_size_with_trailer_, memory_allocator_compressed_);
-    used_buf_ = compressed_buf_.get();
-  } else {
-    heap_buf_ = AllocateBlock(block_size_with_trailer_, memory_allocator_);
-    used_buf_ = heap_buf_.get();
-  }
-}
-
-inline void BlockFetcher::InsertCompressedBlockToPersistentCacheIfNeeded() {
-  if (io_status_.ok() && read_options_.fill_cache &&
-      cache_options_.persistent_cache &&
-      cache_options_.persistent_cache->IsCompressed()) {
-    PersistentCacheHelper::InsertSerialized(cache_options_, handle_, used_buf_,
-                                            block_size_with_trailer_);
-  }
-}
-
-inline void BlockFetcher::InsertUncompressedBlockToPersistentCacheIfNeeded() {
-  if (io_status_.ok() && !got_from_prefetch_buffer_ &&
-      read_options_.fill_cache && cache_options_.persistent_cache &&
-      !cache_options_.persistent_cache->IsCompressed()) {
-    // insert to uncompressed cache
-    PersistentCacheHelper::InsertUncompressed(cache_options_, handle_,
-                                              *contents_);
-  }
-}
-
-inline void BlockFetcher::CopyBufferToHeapBuf() {
-  assert(used_buf_ != heap_buf_.get());
-  heap_buf_ = AllocateBlock(block_size_with_trailer_, memory_allocator_);
-  memcpy(heap_buf_.get(), used_buf_, block_size_with_trailer_);
-#ifndef NDEBUG
-  num_heap_buf_memcpy_++;
-#endif
-}
-
-inline void BlockFetcher::CopyBufferToCompressedBuf() {
-  assert(used_buf_ != compressed_buf_.get());
-  compressed_buf_ =
-      AllocateBlock(block_size_with_trailer_, memory_allocator_compressed_);
-  memcpy(compressed_buf_.get(), used_buf_, block_size_with_trailer_);
-#ifndef NDEBUG
-  num_compressed_buf_memcpy_++;
-#endif
-}
-
-// Before - Entering this method means the block is uncompressed or do not need
-// to be uncompressed.
-//
-// The block can be in one of the following buffers:
-// 1. prefetch buffer if prefetch is enabled and the block is prefetched before
-// 2. stack_buf_ if block size is smaller than the stack_buf_ size and block
-//    is not compressed
-// 3. heap_buf_ if the block is not compressed
-// 4. compressed_buf_ if the block is compressed
-// 5. direct_io_buf_ if direct IO is enabled or
-// 6. underlying file_system scratch is used (FSReadRequest.fs_scratch).
-//
-// After - After this method, if the block is compressed, it should be in
-// compressed_buf_ and heap_buf_ points to compressed_buf_, otherwise should be
-// in heap_buf_.
-inline void BlockFetcher::GetBlockContents() {
-  if (slice_.data() != used_buf_) {
-    // the slice content is not the buffer provided
-    *contents_ = BlockContents(Slice(slice_.data(), block_size_));
-  } else {
-    // page can be either uncompressed or compressed, the buffer either stack
-    // or heap provided. Refer to https://github.com/facebook/rocksdb/pull/4096
-    if (got_from_prefetch_buffer_ || used_buf_ == &stack_buf_[0]) {
-      CopyBufferToHeapBuf();
-    } else if (used_buf_ == compressed_buf_.get()) {
-      if (compression_type_ == kNoCompression &&
-          memory_allocator_ != memory_allocator_compressed_) {
-        CopyBufferToHeapBuf();
-      } else {
-        heap_buf_ = std::move(compressed_buf_);
-      }
-    } else if (direct_io_buf_.get() != nullptr || use_fs_scratch_) {
-      if (compression_type_ == kNoCompression) {
-        CopyBufferToHeapBuf();
-      } else {
-        CopyBufferToCompressedBuf();
-        heap_buf_ = std::move(compressed_buf_);
-      }
-    }
-    *contents_ = BlockContents(std::move(heap_buf_), block_size_);
-  }
-#ifndef NDEBUG
-  contents_->has_trailer = footer_.GetBlockTrailerSize() > 0;
-#endif
-}
-
-// Read a block from the file and verify its checksum. Upon return, io_status_
-// will be updated with the status of the read, and slice_ will be updated
-// with a pointer to the data.
-void BlockFetcher::ReadBlock(bool retry) {
-  FSReadRequest read_req;
-  IOOptions opts;
-  io_status_ = file_->PrepareIOOptions(read_options_, opts);
-  opts.verify_and_reconstruct_read = retry;
-  read_req.status.PermitUncheckedError();
-  // Actual file read
-  if (io_status_.ok()) {
-    if (file_->use_direct_io()) {
-      PERF_TIMER_GUARD(block_read_time);
-      PERF_CPU_TIMER_GUARD(
-          block_read_cpu_time,
-          ioptions_.env ? ioptions_.env->GetSystemClock().get() : nullptr);
-      io_status_ = file_->Read(opts, handle_.offset(), block_size_with_trailer_,
-                               &slice_, /*scratch=*/nullptr, &direct_io_buf_);
-      PERF_COUNTER_ADD(block_read_count, 1);
-      used_buf_ = const_cast<char*>(slice_.data());
-    } else if (use_fs_scratch_) {
-      PERF_TIMER_GUARD(block_read_time);
-      PERF_CPU_TIMER_GUARD(
-          block_read_cpu_time,
-          ioptions_.env ? ioptions_.env->GetSystemClock().get() : nullptr);
-      read_req.offset = handle_.offset();
-      read_req.len = block_size_with_trailer_;
-      read_req.scratch = nullptr;
-      io_status_ = file_->MultiRead(opts, &read_req, /*num_reqs=*/1,
-                                    /*AlignedBuf* =*/nullptr);
-      PERF_COUNTER_ADD(block_read_count, 1);
-
-      slice_ = Slice(read_req.result.data(), read_req.result.size());
-      used_buf_ = const_cast<char*>(slice_.data());
-    } else {
-      // It allocates/assign used_buf_
-      PrepareBufferForBlockFromFile();
-
-      PERF_TIMER_GUARD(block_read_time);
-      PERF_CPU_TIMER_GUARD(
-          block_read_cpu_time,
-          ioptions_.env ? ioptions_.env->GetSystemClock().get() : nullptr);
-
-      io_status_ = file_->Read(
-          opts, handle_.offset(), /*size*/ block_size_with_trailer_,
-          /*result*/ &slice_, /*scratch*/ used_buf_, /*aligned_buf=*/nullptr);
-      PERF_COUNTER_ADD(block_read_count, 1);
-#ifndef NDEBUG
-      if (slice_.data() == &stack_buf_[0]) {
-        num_stack_buf_memcpy_++;
-      } else if (slice_.data() == heap_buf_.get()) {
-        num_heap_buf_memcpy_++;
-      } else if (slice_.data() == compressed_buf_.get()) {
-        num_compressed_buf_memcpy_++;
-      }
-#endif
-    }
-  }
-
-  // TODO: introduce dedicated perf counter for range tombstones
-  switch (block_type_) {
-    case BlockType::kFilter:
-    case BlockType::kFilterPartitionIndex:
-      PERF_COUNTER_ADD(filter_block_read_count, 1);
-      break;
-
-    case BlockType::kCompressionDictionary:
-      PERF_COUNTER_ADD(compression_dict_block_read_count, 1);
-      break;
-
-    case BlockType::kIndex:
-      PERF_COUNTER_ADD(index_block_read_count, 1);
-      break;
-
-    // Nothing to do here as we don't have counters for the other types.
-    default:
-      break;
-  }
-
-  PERF_COUNTER_ADD(block_read_byte, block_size_with_trailer_);
-  if (io_status_.ok()) {
-    if (use_fs_scratch_ && !read_req.status.ok()) {
-      io_status_ = read_req.status;
-    } else if (slice_.size() != block_size_with_trailer_) {
-      io_status_ = IOStatus::Corruption(
-          "truncated block read from " + file_->file_name() + " offset " +
-          std::to_string(handle_.offset()) + ", expected " +
-          std::to_string(block_size_with_trailer_) + " bytes, got " +
-          std::to_string(slice_.size()));
-    }
-  }
-
-  if (io_status_.ok()) {
-    ProcessTrailerIfPresent();
-  }
-
-  if (io_status_.ok()) {
-    InsertCompressedBlockToPersistentCacheIfNeeded();
-    fs_buf_ = std::move(read_req.fs_scratch);
-  } else {
-    ReleaseFileSystemProvidedBuffer(&read_req);
-    direct_io_buf_.reset();
-    compressed_buf_.reset();
-    heap_buf_.reset();
-    used_buf_ = nullptr;
-  }
-}
-
-IOStatus BlockFetcher::ReadBlockContents() {
-  if (TryGetUncompressBlockFromPersistentCache()) {
-    compression_type_ = kNoCompression;
-#ifndef NDEBUG
-    contents_->has_trailer = footer_.GetBlockTrailerSize() > 0;
-#endif  // NDEBUG
-    return IOStatus::OK();
-  }
-  if (TryGetFromPrefetchBuffer()) {
-    if (!io_status_.ok()) {
-      return io_status_;
-    }
-  } else if (!TryGetSerializedBlockFromPersistentCache()) {
-    ReadBlock(/*retry =*/false);
-    // If the file system supports retry after corruption, then try to
-    // re-read the block and see if it succeeds.
-    if (io_status_.IsCorruption() && retry_corrupt_read_) {
-      assert(!fs_buf_);
-      ReadBlock(/*retry=*/true);
-    }
-    if (!io_status_.ok()) {
-      assert(!fs_buf_);
-      return io_status_;
-    }
-  }
-
-  if (do_uncompress_ && compression_type_ != kNoCompression) {
-    PERF_TIMER_GUARD(block_decompress_time);
-    // compressed page, uncompress, update cache
-    UncompressionContext context(compression_type_);
-    UncompressionInfo info(context, uncompression_dict_, compression_type_);
-    io_status_ = status_to_io_status(UncompressSerializedBlock(
-        info, slice_.data(), block_size_, contents_, footer_.format_version(),
-        ioptions_, memory_allocator_));
-#ifndef NDEBUG
-    num_heap_buf_memcpy_++;
-#endif
-    // Save the compressed block without trailer
-    slice_ = Slice(slice_.data(), block_size_);
-  } else {
-    GetBlockContents();
-    slice_ = Slice();
-  }
-
-  InsertUncompressedBlockToPersistentCacheIfNeeded();
-
-  return io_status_;
-}
-
-IOStatus BlockFetcher::ReadAsyncBlockContents() {
-  if (TryGetUncompressBlockFromPersistentCache()) {
-    compression_type_ = kNoCompression;
-#ifndef NDEBUG
-    contents_->has_trailer = footer_.GetBlockTrailerSize() > 0;
-#endif  // NDEBUG
-    return IOStatus::OK();
-  } else if (!TryGetSerializedBlockFromPersistentCache()) {
-    assert(prefetch_buffer_ != nullptr);
-    if (!for_compaction_) {
-      IOOptions opts;
-      IOStatus io_s = file_->PrepareIOOptions(read_options_, opts);
-      if (!io_s.ok()) {
-        return io_s;
-      }
-      io_s = status_to_io_status(prefetch_buffer_->PrefetchAsync(
-          opts, file_, handle_.offset(), block_size_with_trailer_, &slice_));
-      if (io_s.IsTryAgain()) {
-        return io_s;
-      }
-      if (io_s.ok()) {
-        // Data Block is already in prefetch.
-        got_from_prefetch_buffer_ = true;
-        ProcessTrailerIfPresent();
-        if (io_status_.IsCorruption() && retry_corrupt_read_) {
-          got_from_prefetch_buffer_ = false;
-          ReadBlock(/*retry = */ true);
-        }
-        if (!io_status_.ok()) {
-          assert(!fs_buf_);
-          return io_status_;
-        }
-        used_buf_ = const_cast<char*>(slice_.data());
-
-        if (do_uncompress_ && compression_type_ != kNoCompression) {
-          PERF_TIMER_GUARD(block_decompress_time);
-          // compressed page, uncompress, update cache
-          UncompressionContext context(compression_type_);
-          UncompressionInfo info(context, uncompression_dict_,
-                                 compression_type_);
-          io_status_ = status_to_io_status(UncompressSerializedBlock(
-              info, slice_.data(), block_size_, contents_,
-              footer_.format_version(), ioptions_, memory_allocator_));
-#ifndef NDEBUG
-          num_heap_buf_memcpy_++;
-#endif
-        } else {
-          GetBlockContents();
-        }
-        InsertUncompressedBlockToPersistentCacheIfNeeded();
-        return io_status_;
-      }
-    }
-    // Fallback to sequential reading of data blocks in case of io_s returns
-    // error or for_compaction_is true.
-    return ReadBlockContents();
-  }
-  return io_status_;
-}
-
-}  // namespace ROCKSDB_NAMESPACE

package/vendor/librocksdb/vendor/rocksdb/table/block_fetcher.h

@@ -1,168 +0,0 @@
-//  Copyright (c) 2011-present, Facebook, Inc.  All rights reserved.
-//  This source code is licensed under both the GPLv2 (found in the
-//  COPYING file in the root directory) and Apache 2.0 License
-//  (found in the LICENSE.Apache file in the root directory).
-//
-// Copyright (c) 2011 The LevelDB Authors. All rights reserved.
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file. See the AUTHORS file for names of contributors.
-
-#pragma once
-#include "file/file_util.h"
-#include "memory/memory_allocator_impl.h"
-#include "table/block_based/block.h"
-#include "table/block_based/block_type.h"
-#include "table/format.h"
-#include "table/persistent_cache_options.h"
-
-namespace ROCKSDB_NAMESPACE {
-
-// Retrieves a single block of a given file. Utilizes the prefetch buffer and/or
-// persistent cache provided (if any) to try to avoid reading from the file
-// directly. Note that both the prefetch buffer and the persistent cache are
-// optional; also, note that the persistent cache may be configured to store
-// either compressed or uncompressed blocks.
-//
-// If the retrieved block is compressed and the do_uncompress flag is set,
-// BlockFetcher uncompresses the block (using the uncompression dictionary,
-// if provided, to prime the compression algorithm), and returns the resulting
-// uncompressed block data. Otherwise, it returns the original block.
-//
-// Two read options affect the behavior of BlockFetcher: if verify_checksums is
-// true, the checksum of the (original) block is checked; if fill_cache is true,
-// the block is added to the persistent cache if needed.
-//
-// Memory for uncompressed and compressed blocks is allocated as needed
-// using memory_allocator and memory_allocator_compressed, respectively
-// (if provided; otherwise, the default allocator is used).
-
-class BlockFetcher {
- public:
-  BlockFetcher(RandomAccessFileReader* file,
-               FilePrefetchBuffer* prefetch_buffer,
-               const Footer& footer /* ref retained */,
-               const ReadOptions& read_options,
-               const BlockHandle& handle /* ref retained */,
-               BlockContents* contents,
-               const ImmutableOptions& ioptions /* ref retained */,
-               bool do_uncompress, bool maybe_compressed, BlockType block_type,
-               const UncompressionDict& uncompression_dict /* ref retained */,
-               const PersistentCacheOptions& cache_options /* ref retained */,
-               MemoryAllocator* memory_allocator = nullptr,
-               MemoryAllocator* memory_allocator_compressed = nullptr,
-               bool for_compaction = false)
-      : file_(file),
-        prefetch_buffer_(prefetch_buffer),
-        footer_(footer),
-        read_options_(read_options),
-        handle_(handle),
-        contents_(contents),
-        ioptions_(ioptions),
-        do_uncompress_(do_uncompress),
-        maybe_compressed_(maybe_compressed),
-        block_type_(block_type),
-        block_size_(static_cast<size_t>(handle_.size())),
-        block_size_with_trailer_(block_size_ + footer.GetBlockTrailerSize()),
-        uncompression_dict_(uncompression_dict),
-        cache_options_(cache_options),
-        memory_allocator_(memory_allocator),
-        memory_allocator_compressed_(memory_allocator_compressed),
-        for_compaction_(for_compaction) {
-    io_status_.PermitUncheckedError();  // TODO(AR) can we improve on this?
-    if (CheckFSFeatureSupport(ioptions_.fs.get(), FSSupportedOps::kFSBuffer)) {
-      use_fs_scratch_ = true;
-    }
-    if (CheckFSFeatureSupport(ioptions_.fs.get(),
-                              FSSupportedOps::kVerifyAndReconstructRead)) {
-      retry_corrupt_read_ = true;
-    }
-  }
-
-  IOStatus ReadBlockContents();
-  IOStatus ReadAsyncBlockContents();
-
-  inline CompressionType get_compression_type() const {
-    return compression_type_;
-  }
-  inline size_t GetBlockSizeWithTrailer() const {
-    return block_size_with_trailer_;
-  }
-  inline Slice& GetCompressedBlock() {
-    assert(compression_type_ != kNoCompression);
-    return slice_;
-  }
-
-#ifndef NDEBUG
-  int TEST_GetNumStackBufMemcpy() const { return num_stack_buf_memcpy_; }
-  int TEST_GetNumHeapBufMemcpy() const { return num_heap_buf_memcpy_; }
-  int TEST_GetNumCompressedBufMemcpy() const {
-    return num_compressed_buf_memcpy_;
-  }
-
-#endif
- private:
-#ifndef NDEBUG
-  int num_stack_buf_memcpy_ = 0;
-  int num_heap_buf_memcpy_ = 0;
-  int num_compressed_buf_memcpy_ = 0;
-
-#endif
-  static const uint32_t kDefaultStackBufferSize = 5000;
-
-  RandomAccessFileReader* file_;
-  FilePrefetchBuffer* prefetch_buffer_;
-  const Footer& footer_;
-  const ReadOptions read_options_;
-  const BlockHandle& handle_;
-  BlockContents* contents_;
-  const ImmutableOptions& ioptions_;
-  const bool do_uncompress_;
-  const bool maybe_compressed_;
-  const BlockType block_type_;
-  const size_t block_size_;
-  const size_t block_size_with_trailer_;
-  const UncompressionDict& uncompression_dict_;
-  const PersistentCacheOptions& cache_options_;
-  MemoryAllocator* memory_allocator_;
-  MemoryAllocator* memory_allocator_compressed_;
-  IOStatus io_status_;
-  Slice slice_;
-  char* used_buf_ = nullptr;
-  AlignedBuf direct_io_buf_;
-  CacheAllocationPtr heap_buf_;
-  CacheAllocationPtr compressed_buf_;
-  char stack_buf_[kDefaultStackBufferSize];
-  bool got_from_prefetch_buffer_ = false;
-  CompressionType compression_type_;
-  bool for_compaction_ = false;
-  bool use_fs_scratch_ = false;
-  bool retry_corrupt_read_ = false;
-  FSAllocationPtr fs_buf_;
-
-  // return true if found
-  bool TryGetUncompressBlockFromPersistentCache();
-  // return true if found
-  bool TryGetFromPrefetchBuffer();
-  bool TryGetSerializedBlockFromPersistentCache();
-  void PrepareBufferForBlockFromFile();
-  // Copy content from used_buf_ to new heap_buf_.
-  void CopyBufferToHeapBuf();
-  // Copy content from used_buf_ to new compressed_buf_.
-  void CopyBufferToCompressedBuf();
-  void GetBlockContents();
-  void InsertCompressedBlockToPersistentCacheIfNeeded();
-  void InsertUncompressedBlockToPersistentCacheIfNeeded();
-  void ProcessTrailerIfPresent();
-  void ReadBlock(bool retry);
-
-  void ReleaseFileSystemProvidedBuffer(FSReadRequest* read_req) {
-    if (use_fs_scratch_) {
-      // Free the scratch buffer allocated by FileSystem.
-      if (read_req->fs_scratch != nullptr) {
-        read_req->fs_scratch.reset();
-        read_req->fs_scratch = nullptr;
-      }
-    }
-  }
-};
-}  // namespace ROCKSDB_NAMESPACE