On retrofit devices, an OTA package or super_empty.img won't know which
slot it applies to. This is not an issue on devices shipping with
dynamic partitions, since they ship on the "a" slot.
To work around this, partitions and block devices can be flagged as
"auto-slot-suffixed". This indicates that ReadMetadata should
automatically append a slot suffix before returning the metadata. This
flag is added by MetadataBuilder when requested, and will be enabled via
lpmake separately.
After ReadMetadata has applied slot suffixes, it takes care to remove
the slot-suffix flag. This prevents the suffix from being applied twice,
if for example the metadata is then imported into a MetadataBuilder.
Bug: 116802789
Test: liblp_test gtest
retrofit device boots
Change-Id: Ic7de06d31253a8d5b8d15c0d936175ca2939f857
52 lines
2 KiB
C++
52 lines
2 KiB
C++
/*
|
|
* Copyright (C) 2018 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.
|
|
*/
|
|
|
|
#ifndef LIBLP_READER_H_
|
|
#define LIBLP_READER_H_
|
|
|
|
#include <stddef.h>
|
|
|
|
#include <memory>
|
|
|
|
#include <liblp/liblp.h>
|
|
|
|
namespace android {
|
|
namespace fs_mgr {
|
|
|
|
// Parse an LpMetadataGeometry from a buffer. The buffer must be at least
|
|
// LP_METADATA_GEOMETRY_SIZE bytes in size.
|
|
bool ParseGeometry(const void* buffer, LpMetadataGeometry* geometry);
|
|
|
|
// Helper functions for manually reading geometry and metadata.
|
|
std::unique_ptr<LpMetadata> ParseMetadata(const LpMetadataGeometry& geometry, int fd);
|
|
std::unique_ptr<LpMetadata> ParseMetadata(const LpMetadataGeometry& geometry, const void* buffer,
|
|
size_t size);
|
|
bool ReadLogicalPartitionGeometry(int fd, LpMetadataGeometry* geometry);
|
|
bool ReadPrimaryGeometry(int fd, LpMetadataGeometry* geometry);
|
|
bool ReadBackupGeometry(int fd, LpMetadataGeometry* geometry);
|
|
|
|
// These functions assume a valid geometry and slot number, and do not obey
|
|
// auto-slot-suffixing. They are used for tests and for checking whether
|
|
// the metadata is coherent across primary and backup copies.
|
|
std::unique_ptr<LpMetadata> ReadPrimaryMetadata(int fd, const LpMetadataGeometry& geometry,
|
|
uint32_t slot_number);
|
|
std::unique_ptr<LpMetadata> ReadBackupMetadata(int fd, const LpMetadataGeometry& geometry,
|
|
uint32_t slot_number);
|
|
|
|
} // namespace fs_mgr
|
|
} // namespace android
|
|
|
|
#endif /* LIBLP_READER_H_ */
|