#pragma once #include "elog_block.hpp" #include "elog_entry.hpp" #include "xyz/openbmc_project/Collection/DeleteAll/server.hpp" #include "xyz/openbmc_project/Logging/Create/server.hpp" #include "xyz/openbmc_project/Logging/Entry/server.hpp" #include "xyz/openbmc_project/Logging/Internal/Manager/server.hpp" #include "xyz/openbmc_project/Logging/error.hpp" #include #include #include namespace phosphor { namespace logging { extern const std::map> g_errMetaMap; extern const std::map g_errLevelMap; using CreateIface = sdbusplus::server::xyz::openbmc_project::logging::Create; using DeleteAllIface = sdbusplus::server::xyz::openbmc_project::collection::DeleteAll; using Severity = sdbusplus::xyz::openbmc_project::Logging::server::Entry::Level; using LogsCleared = sdbusplus::xyz::openbmc_project::Logging::Error::LogsCleared; namespace details { template using ServerObject = typename sdbusplus::server::object_t; using ManagerIface = sdbusplus::server::xyz::openbmc_project::logging::internal::Manager; } // namespace details constexpr size_t ffdcFormatPos = 0; constexpr size_t ffdcSubtypePos = 1; constexpr size_t ffdcVersionPos = 2; constexpr size_t ffdcFDPos = 3; using FFDCEntry = std::tuple; using FFDCEntries = std::vector; namespace internal { /** @class Manager * @brief OpenBMC logging manager implementation. * @details A concrete implementation for the * xyz.openbmc_project.Logging.Internal.Manager DBus API. */ class Manager : public details::ServerObject { public: Manager() = delete; Manager(const Manager&) = delete; Manager& operator=(const Manager&) = delete; Manager(Manager&&) = delete; Manager& operator=(Manager&&) = delete; virtual ~Manager() = default; /** @brief Constructor to put object onto bus at a dbus path. * @param[in] bus - Bus to attach to. * @param[in] path - Path to attach at. */ Manager(sdbusplus::bus_t& bus, const char* objPath) : details::ServerObject(bus, objPath), busLog(bus), entryId(0), fwVersion(readFWVersion()) {}; /* * @fn commit() * @brief sd_bus Commit method implementation callback. * @details Create an error/event log based on transaction id and * error message. * @param[in] transactionId - Unique identifier of the journal entries * to be committed. * @param[in] errMsg - The error exception message associated with the * error log to be committed. */ uint32_t commit(uint64_t transactionId, std::string errMsg) override; /* * @fn commit() * @brief sd_bus CommitWithLvl method implementation callback. * @details Create an error/event log based on transaction id and * error message. * @param[in] transactionId - Unique identifier of the journal entries * to be committed. * @param[in] errMsg - The error exception message associated with the * error log to be committed. * @param[in] errLvl - level of the error */ uint32_t commitWithLvl(uint64_t transactionId, std::string errMsg, uint32_t errLvl) override; /** @brief Erase specified entry d-bus object * * @param[in] entryId - unique identifier of the entry */ void erase(uint32_t entryId); /** @brief Construct error d-bus objects from their persisted * representations. */ void restore(); /** @brief Erase all error log entries * * @return size_t - count of erased entries */ size_t eraseAll(); /** @brief Returns the count of high severity errors * * @return int - count of real errors */ int getRealErrSize(); /** @brief Returns the count of Info errors * * @return int - count of info errors */ int getInfoErrSize(); /** @brief Returns the number of blocking errors * * @return int - count of blocking errors */ int getBlockingErrSize() { return blockingErrors.size(); } /** @brief Returns the number of property change callback objects * * @return int - count of property callback entries */ int getEntryCallbackSize() { return propChangedEntryCallback.size(); } /** * @brief Returns the sdbusplus bus object * * @return sdbusplus::bus_t& */ sdbusplus::bus_t& getBus() { return busLog; } /** * @brief Returns the ID of the last created entry * * @return uint32_t - The ID */ uint32_t lastEntryID() const { return entryId; } /** @brief Creates an event log * * This is an alternative to the _commit() API. It doesn't use * the journal to look up event log metadata like _commit does. * * @param[in] errMsg - The error exception message associated with the * error log to be committed. * @param[in] severity - level of the error * @param[in] additionalData - The AdditionalData property for the error * @param[in] ffdc - A vector of tuples that allows one to pass in file * descriptors for files that contain FFDC (First * Failure Data Capture). These will be passed to any * event logging extensions. */ auto create(const std::string& message, Severity severity, const std::map& additionalData, const FFDCEntries& ffdc = FFDCEntries{}) -> sdbusplus::message::object_path; /** @brief Common wrapper for creating an Entry object * * @return true if quiesce on error setting is enabled, false otherwise */ bool isQuiesceOnErrorEnabled(); /** @brief Create boot block association and quiesce host if running * * @param[in] entryId - The ID of the phosphor logging error */ void quiesceOnError(const uint32_t entryId); /** @brief Check if inventory callout present in input entry * * @param[in] entry - The error to check for callouts * * @return true if inventory item in associations, false otherwise */ bool isCalloutPresent(const Entry& entry); /** @brief Check (and remove) entry being erased from blocking errors * * @param[in] entryId - The entry that is being erased */ void checkAndRemoveBlockingError(uint32_t entryId); /** @brief Persistent map of Entry dbus objects and their ID */ std::map> entries; private: /* * @fn _commit() * @brief commit() helper * @param[in] transactionId - Unique identifier of the journal entries * to be committed. * @param[in] errMsg - The error exception message associated with the * error log to be committed. * @param[in] errLvl - level of the error */ void _commit(uint64_t transactionId, std::string&& errMsg, Entry::Level errLvl); /** @brief Call metadata handler(s), if any. Handlers may create * associations. * @param[in] errorName - name of the error * @param[in] additionalData - list of metadata (in key=value format) * @param[out] objects - list of error's association objects */ void processMetadata(const std::string& errorName, const std::vector& additionalData, AssociationList& objects) const; /** @brief Reads the BMC code level * * @return std::string - the version string */ static std::string readFWVersion(); /** @brief Call any create() functions provided by any extensions. * This is called right after an event log is created to allow * extensions to create their own log based on this one. * * @param[in] entry - the new event log entry * @param[in] ffdc - A vector of FFDC file info */ void doExtensionLogCreate(const Entry& entry, const FFDCEntries& ffdc); /** @brief Common wrapper for creating an Entry object * * @param[in] errMsg - The error exception message associated with the * error log to be committed. * @param[in] errLvl - level of the error * @param[in] additionalData - The AdditionalData property for the error * @param[in] ffdc - A vector of FFDC file info. Defaults to an empty * vector. */ auto createEntry(std::string errMsg, Entry::Level errLvl, std::vector additionalData, const FFDCEntries& ffdc = FFDCEntries{}) -> sdbusplus::message::object_path; /** @brief Notified on entry property changes * * If an entry is blocking, this callback will be registered to monitor for * the entry having it's Resolved field set to true. If it is then remove * the blocking object. * * @param[in] msg - sdbusplus dbusmessage */ void onEntryResolve(sdbusplus::message_t& msg); /** @brief Remove block objects for any resolved entries */ void findAndRemoveResolvedBlocks(); /** @brief Quiesce host if it is running * * This is called when the user has requested the system be quiesced * if a log with a callout is created */ void checkAndQuiesceHost(); /** @brief Persistent sdbusplus DBus bus connection. */ sdbusplus::bus_t& busLog; /** @brief List of error ids for high severity errors */ std::list realErrors; /** @brief List of error ids for Info(and below) severity */ std::list infoErrors; /** @brief Id of last error log entry */ uint32_t entryId; /** @brief The BMC firmware version */ const std::string fwVersion; /** @brief Array of blocking errors */ std::vector> blockingErrors; /** @brief Map of entry id to call back object on properties changed */ std::map> propChangedEntryCallback; }; } // namespace internal /** @class Manager * @brief Implementation for deleting all error log entries and * creating new logs. * @details A concrete implementation for the * xyz.openbmc_project.Collection.DeleteAll and * xyz.openbmc_project.Logging.Create interfaces. */ class Manager : public details::ServerObject { public: Manager() = delete; Manager(const Manager&) = delete; Manager& operator=(const Manager&) = delete; Manager(Manager&&) = delete; Manager& operator=(Manager&&) = delete; virtual ~Manager() = default; /** @brief Constructor to put object onto bus at a dbus path. * Defer signal registration (pass true for deferSignal to the * base class) until after the properties are set. * @param[in] bus - Bus to attach to. * @param[in] path - Path to attach at. * @param[in] manager - Reference to internal manager object. */ Manager(sdbusplus::bus_t& bus, const std::string& path, internal::Manager& manager) : details::ServerObject( bus, path.c_str(), details::ServerObject::action::defer_emit), manager(manager) {}; /** @brief Delete all d-bus objects. */ void deleteAll() override { log("Deleting all log entries"); auto numbersOfLogs = manager.eraseAll(); std::map additionalData; additionalData.emplace("NUM_LOGS", std::to_string(numbersOfLogs)); manager.create(LogsCleared::errName, Severity::Informational, additionalData); } /** @brief D-Bus method call implementation to create an event log. * * @param[in] errMsg - The error exception message associated with the * error log to be committed. * @param[in] severity - Level of the error * @param[in] additionalData - The AdditionalData property for the error */ auto create(std::string message, Severity severity, std::map additionalData) -> sdbusplus::message::object_path override { return manager.create(message, severity, additionalData); } /** @brief D-Bus method call implementation to create an event log with FFDC * * The same as create(), but takes an extra FFDC argument. * * @param[in] errMsg - The error exception message associated with the * error log to be committed. * @param[in] severity - Level of the error * @param[in] additionalData - The AdditionalData property for the error * @param[in] ffdc - A vector of FFDC file info */ void createWithFFDCFiles( std::string message, Severity severity, std::map additionalData, std::vector> ffdc) override { manager.create(message, severity, additionalData, ffdc); } private: /** @brief This is a reference to manager object */ internal::Manager& manager; }; } // namespace logging } // namespace phosphor