#pragma once #include "fs.hpp" #include "handler_config.hpp" #include "status.hpp" #include #include #include #include #include namespace ipmi_flash { /** * build a systemd file triggerable action from json data */ std::unique_ptr buildFileSystemd(const nlohmann::json& data); /** * build a systemd triggerable action from json data */ std::unique_ptr buildSystemd(const nlohmann::json& data); constexpr std::array defaultConfigPaths = { "/usr/share/phosphor-ipmi-flash", "/run/phosphor-ipmi-flash", }; /* HandlersBuilderIfc is a helper class that builds Handlers from the json files * found within a specified directory. * The child class that inherits from HandlersBuilderIfc should implement * buildHandlersConfigs to perform json validation and parsing. * */ template struct HandlersBuilderIfc { virtual ~HandlersBuilderIfc() = default; /** * Builds configurations from the default set of paths used by the blob * handler. */ std::vector> buildHandlerConfigsFromDefaultPaths() { std::vector> ret; for (auto path : defaultConfigPaths) { auto tmp = buildHandlerConfigs(path); std::move(tmp.begin(), tmp.end(), std::back_inserter(ret)); } return ret; } /** * Given a folder of json configs, build the configurations. * * @param[in] directory - the directory to search (recursively). * @return list of HandlerConfig objects. */ std::vector> buildHandlerConfigs(const char* directory) { std::vector> output; std::vector jsonPaths = GetJsonList(directory); for (const auto& path : jsonPaths) { std::ifstream jsonFile(path); if (!jsonFile.is_open()) { std::fprintf(stderr, "Unable to open json file: %s\n", path.c_str()); continue; } auto data = nlohmann::json::parse(jsonFile, nullptr, false); if (data.is_discarded()) { std::fprintf(stderr, "Parsing json failed: %s\n", path.c_str()); continue; } std::vector> configs = buildHandlerFromJson(data); std::move(configs.begin(), configs.end(), std::back_inserter(output)); } return output; }; /** * Given a list of handlers as json data, construct the appropriate * HandlerConfig objects. This method is meant to be called per json * configuration file found. * * The list will only contain validly build HandlerConfig objects. Any * invalid configuration is skipped. The hope is that the BMC firmware * update configuration will never be invalid, but if another aspect is * invalid, it can be fixed with a BMC firmware update once the bug is * identified. * * This code does not validate that the blob specified is unique, that * should be handled at a higher layer. * * @param[in] data - json data from a json file. * @return list of HandlerConfig objects. */ virtual std::vector> buildHandlerFromJson(const nlohmann::json& data) = 0; }; } // namespace ipmi_flash