blob: 7eaca8391afd53811c45536c9aac3c539962466b [file] [log] [blame]
// Copyright 2020 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include "src/storage/fvm/format.h"
#include "src/storage/fvm/fvm_sparse.h"
#include "src/storage/volume_image/address_descriptor.h"
#include "src/storage/volume_image/fvm/fvm_descriptor.h"
#include "src/storage/volume_image/options.h"
#include "src/storage/volume_image/utils/compressor.h"
#include "src/storage/volume_image/utils/decompressor.h"
#include "src/storage/volume_image/utils/writer.h"
namespace storage::volume_image {
namespace fvm_sparse_internal {
// Returns a bit set representing the suported options in the |fvm::SparseImage| that are equivalent
// in |FvmOptions|.
uint32_t GetImageFlags(const FvmOptions& options);
// Returns a bit set representing the suported options in the |fvm::PartitionDescriptor| that are
// equivalent in |Partition|.
uint32_t GetPartitionFlags(const Partition& partition);
} // namespace fvm_sparse_internal
// Represents a |Partition| in the |fvm::SparseImage| format.
struct FvmSparsePartitionEntry {
// Describes a partition, with things like name, guid and flags.
fvm::PartitionDescriptor descriptor;
// Describes each extent individually.
std::vector<fvm::ExtentDescriptor> extents;
// Returns a |fvm::SparseImage| representation of |descriptor| on success.
fvm::SparseImage FvmSparseGenerateHeader(const FvmDescriptor& descriptor);
// Returns a |FvmSparsePartitionEntry| representation of |partition| on success.
fit::result<FvmSparsePartitionEntry, std::string> FvmSparseGeneratePartitionEntry(
uint64_t slice_size, const Partition& partition);
// Returns the size in bytes of the generated sparse image for |descriptor|.
uint64_t FvmSparseCalculateUncompressedImageSize(const FvmDescriptor& descriptor);
// Returns the size of the written image in bytes when successfully writing a |SparseImage| and
// its data with |writer|.
fit::result<uint64_t, std::string> FvmSparseWriteImage(const FvmDescriptor& descriptor,
Writer* writer,
Compressor* compressor = nullptr);
// Returns the compressions options stored in |header|.
CompressionOptions FvmSparseImageGetCompressionOptions(const fvm::SparseImage& header);
// On success, returns the valid |fvm::SparseImage| header contained in |reader| starting at
// |offset|.
// On failure, returns the error which caused the header to be invalid.
fit::result<fvm::SparseImage, std::string> FvmSparseImageGetHeader(uint64_t offset,
const Reader& reader);
// On success, returns the valid collection of |FvmSparsePartitionEntry| as described by |header|
// and contained in |reader| as described in |offset|. That is, the partition descriptors start
// at |offset| in |reader|.
fit::result<std::vector<FvmSparsePartitionEntry>, std::string> FvmSparseImageGetPartitions(
uint64_t offset, const Reader& reader, const fvm::SparseImage& header);
} // namespace storage::volume_image