blob: 3f058811c70434fd0120bf117e4123f545cbdec7 [file] [log] [blame]
/*
* Copyright (C) 2017 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 "CompatibilityMatrix.h"
#include <iostream>
#include <utility>
#include "parse_string.h"
#include "parse_xml.h"
#include "utils.h"
namespace android {
namespace vintf {
bool CompatibilityMatrix::add(MatrixHal &&hal) {
return HalGroup<MatrixHal>::add(std::move(hal));
}
bool CompatibilityMatrix::add(MatrixKernel &&kernel) {
if (mType != SchemaType::FRAMEWORK) {
return false;
}
framework.mKernels.push_back(std::move(kernel));
return true;
}
SchemaType CompatibilityMatrix::type() const {
return mType;
}
Level CompatibilityMatrix::level() const {
return mLevel;
}
Version CompatibilityMatrix::getMinimumMetaVersion() const {
// TODO(b/62801658): this needs to depend on whether there are 1.1 requirements
// (e.g. required <xmlfile> entry)
return {1, 0};
}
status_t CompatibilityMatrix::fetchAllInformation(const std::string& path, std::string* error) {
return details::fetchAllInformation(path, gCompatibilityMatrixConverter, this, error);
}
std::string CompatibilityMatrix::getXmlSchemaPath(const std::string& xmlFileName,
const Version& version) const {
using std::literals::string_literals::operator""s;
auto range = getXmlFiles(xmlFileName);
for (auto it = range.first; it != range.second; ++it) {
const MatrixXmlFile& matrixXmlFile = it->second;
if (matrixXmlFile.versionRange().contains(version)) {
if (!matrixXmlFile.overriddenPath().empty()) {
return matrixXmlFile.overriddenPath();
}
return "/"s + (type() == SchemaType::DEVICE ? "vendor" : "system") + "/etc/" +
xmlFileName + "_V" + std::to_string(matrixXmlFile.versionRange().majorVer) +
"_" + std::to_string(matrixXmlFile.versionRange().maxMinor) + "." +
to_string(matrixXmlFile.format());
}
}
return "";
}
// Add all package@other_version::interface/instance as an optional instance.
// If package@this_version::interface/instance is in this (that is, some instance
// with the same package and interface and instance exists), then other_version is
// considered a possible replacement to this_version.
// See LibVintfTest.AddOptionalHal* tests for details.
bool CompatibilityMatrix::addAllHalsAsOptional(CompatibilityMatrix* other, std::string* error) {
if (other == nullptr || other->level() <= level()) {
return true;
}
for (auto& pair : other->mHals) {
const std::string& name = pair.first;
MatrixHal& halToAdd = pair.second;
bool added = false;
for (auto* existingHal : getHals(name)) {
if (existingHal->containsInstances(halToAdd)) {
existingHal->insertVersionRanges(halToAdd);
added = true;
// Do not break here; try other <hal> with the same name as well.
}
}
if (!added) {
halToAdd.setOptional(true);
if (!add(std::move(halToAdd))) {
if (error) {
*error = "Cannot add HAL " + name + " for unknown reason.";
}
return false;
}
}
}
return true;
}
bool CompatibilityMatrix::addAllXmlFilesAsOptional(CompatibilityMatrix* other, std::string* error) {
if (other == nullptr || other->level() <= level()) {
return true;
}
for (auto& pair : other->mXmlFiles) {
const std::string& name = pair.first;
MatrixXmlFile& xmlFileToAdd = pair.second;
xmlFileToAdd.mOptional = true;
if (!addXmlFile(std::move(xmlFileToAdd))) {
if (error) {
*error = "Cannot add XML File " + name + " for unknown reason.";
}
return false;
}
}
return true;
}
bool operator==(const CompatibilityMatrix &lft, const CompatibilityMatrix &rgt) {
return lft.mType == rgt.mType && lft.mLevel == rgt.mLevel && lft.mHals == rgt.mHals &&
lft.mXmlFiles == rgt.mXmlFiles &&
(lft.mType != SchemaType::DEVICE ||
(
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wdeprecated-declarations"
lft.device.mVndk == rgt.device.mVndk &&
#pragma clang diagnostic pop
lft.device.mVendorNdk == rgt.device.mVendorNdk &&
lft.device.mSystemSdk == rgt.device.mSystemSdk)) &&
(lft.mType != SchemaType::FRAMEWORK ||
(lft.framework.mKernels == rgt.framework.mKernels &&
lft.framework.mSepolicy == rgt.framework.mSepolicy &&
lft.framework.mAvbMetaVersion == rgt.framework.mAvbMetaVersion));
}
// Find compatibility_matrix.empty.xml (which has unspecified level) and use it
// as a base matrix.
CompatibilityMatrix* CompatibilityMatrix::findOrInsertBaseMatrix(
std::vector<Named<CompatibilityMatrix>>* matrices, std::string* error) {
bool multipleFound = false;
CompatibilityMatrix* matrix = nullptr;
for (auto& e : *matrices) {
if (e.object.level() == Level::UNSPECIFIED) {
if (!e.object.mHals.empty()) {
if (error) {
*error = "Error: File \"" + e.name + "\" should not contain " + "HAL elements.";
}
return nullptr;
}
if (!e.object.mXmlFiles.empty()) {
if (error) {
*error =
"Error: File \"" + e.name + "\" should not contain " + "XML File elements.";
}
return nullptr;
}
if (matrix != nullptr) {
multipleFound = true;
}
matrix = &e.object;
// continue to detect multiple files with "unspecified" levels
}
}
if (multipleFound) {
if (error) {
*error =
"Error: multiple framework compatibility matrix files have "
"unspecified level; there should only be one such file.\n";
for (auto& e : *matrices) {
if (e.object.level() == Level::UNSPECIFIED) {
*error += " " + e.name + "\n";
}
}
}
return nullptr;
}
if (matrix == nullptr) {
matrix = &matrices->emplace(matrices->end())->object;
matrix->mType = SchemaType::FRAMEWORK;
matrix->mLevel = Level::UNSPECIFIED;
}
return matrix;
}
CompatibilityMatrix* CompatibilityMatrix::combine(Level deviceLevel,
std::vector<Named<CompatibilityMatrix>>* matrices,
std::string* error) {
if (deviceLevel == Level::UNSPECIFIED) {
if (error) {
*error = "Error: device level is unspecified.";
}
return nullptr;
}
CompatibilityMatrix* matrix = findOrInsertBaseMatrix(matrices, error);
if (matrix == nullptr) {
return nullptr;
}
matrix->mLevel = deviceLevel;
for (auto& e : *matrices) {
if (&e.object != matrix && e.object.level() == deviceLevel) {
if (!matrix->addAllHals(&e.object, error)) {
if (error) {
*error = "File \"" + e.name + "\" cannot be added: HAL " + *error +
" has a conflict.";
}
return nullptr;
}
if (!matrix->addAllXmlFiles(&e.object, error)) {
if (error) {
*error = "File \"" + e.name + "\" cannot be added: XML File entry " + *error +
" has a conflict.";
}
return nullptr;
}
}
}
for (auto& e : *matrices) {
if (&e.object != matrix && e.object.level() != Level::UNSPECIFIED &&
e.object.level() > deviceLevel) {
if (!matrix->addAllHalsAsOptional(&e.object, error)) {
if (error) {
*error = "File \"" + e.name + "\" cannot be added: " + *error +
". See <hal> with the same name " +
"in previously parsed files or previously declared in this file.";
}
return nullptr;
}
if (!matrix->addAllXmlFilesAsOptional(&e.object, error)) {
if (error) {
*error = "File \"" + e.name + "\" cannot be added: XML File entry " + *error +
" has a conflict.";
}
return nullptr;
}
}
}
for (auto& e : *matrices) {
if (&e.object != matrix && e.object.level() == deviceLevel &&
e.object.type() == SchemaType::FRAMEWORK) {
for (MatrixKernel& kernel : e.object.framework.mKernels) {
KernelVersion ver = kernel.minLts();
if (!matrix->add(std::move(kernel))) {
if (error) {
*error = "Cannot add kernel version " + to_string(ver) +
" from FCM version " + to_string(deviceLevel);
}
return nullptr;
}
}
}
}
return matrix;
}
bool CompatibilityMatrix::forEachInstanceOfVersion(
const std::string& package, const Version& expectVersion,
const std::function<bool(const MatrixInstance&)>& func) const {
for (const MatrixHal* hal : getHals(package)) {
bool cont = hal->forEachInstance([&](const MatrixInstance& matrixInstance) {
if (matrixInstance.versionRange().contains(expectVersion)) {
return func(matrixInstance);
}
return true;
});
if (!cont) return false;
}
return true;
}
} // namespace vintf
} // namespace android