xref: /openbmc/phosphor-logging/elog_meta.hpp (revision 991bb769)
1 #pragma once
2 
3 #include "callouts-gen.hpp"
4 #include "elog_entry.hpp"
5 
6 #include <algorithm>
7 #include <cstring>
8 #include <phosphor-logging/elog-errors.hpp>
9 #include <string>
10 #include <tuple>
11 #include <vector>
12 
13 namespace phosphor
14 {
15 namespace logging
16 {
17 namespace metadata
18 {
19 
20 using Metadata = std::string;
21 
22 namespace associations
23 {
24 
25 using Type = void(const std::string&, const std::vector<std::string>&,
26                   AssociationList& list);
27 
28 /** @brief Pull out metadata name and value from the string
29  *         <metadata name>=<metadata value>
30  *  @param [in] data - metadata key=value entries
31  *  @param [out] metadata - map of metadata name:value
32  */
33 inline void parse(const std::vector<std::string>& data,
34                   std::map<std::string, std::string>& metadata)
35 {
36     constexpr auto separator = '=';
37     for (const auto& entryItem : data)
38     {
39         auto pos = entryItem.find(separator);
40         if (std::string::npos != pos)
41         {
42             auto key = entryItem.substr(0, entryItem.find(separator));
43             auto value = entryItem.substr(entryItem.find(separator) + 1);
44             metadata.emplace(std::move(key), std::move(value));
45         }
46     }
47 };
48 
49 /** @brief Combine the metadata keys and values from the map
50  *         into a vector of strings that look like:
51  *            "<metadata name>=<metadata value>"
52  *  @param [in] data - metadata key:value map
53  *  @param [out] metadata - vector of "key=value" strings
54  */
55 inline void combine(const std::map<std::string, std::string>& data,
56                     std::vector<std::string>& metadata)
57 {
58     for (const auto& [key, value] : data)
59     {
60         std::string line{key};
61         line += "=" + value;
62         metadata.push_back(std::move(line));
63     }
64 }
65 
66 /** @brief Build error associations specific to metadata. Specialize this
67  *         template for handling a specific type of metadata.
68  *  @tparam M - type of metadata
69  *  @param [in] match - metadata to be handled
70  *  @param [in] data - metadata key=value entries
71  *  @param [out] list - list of error association objects
72  */
73 template <typename M>
74 void build(const std::string& match, const std::vector<std::string>& data,
75            AssociationList& list) = delete;
76 
77 // Example template specialization - we don't want to do anything
78 // for this metadata.
79 using namespace example::xyz::openbmc_project::Example::Elog;
80 template <>
81 inline void build<TestErrorTwo::DEV_ID>(const std::string& match,
82                                         const std::vector<std::string>& data,
83                                         AssociationList& list)
84 {
85 }
86 
87 template <>
88 inline void
89     build<example::xyz::openbmc_project::Example::Device::Callout::
90               CALLOUT_DEVICE_PATH_TEST>(const std::string& match,
91                                         const std::vector<std::string>& data,
92                                         AssociationList& list)
93 {
94     std::map<std::string, std::string> metadata;
95     parse(data, metadata);
96     auto iter = metadata.find(match);
97     if (metadata.end() != iter)
98     {
99         auto comp = [](const auto& first, const auto& second) {
100             return (std::strcmp(std::get<0>(first), second) < 0);
101         };
102         auto callout = std::lower_bound(callouts.begin(), callouts.end(),
103                                         (iter->second).c_str(), comp);
104         if ((callouts.end() != callout) &&
105             !std::strcmp((iter->second).c_str(), std::get<0>(*callout)))
106         {
107             constexpr auto ROOT = "/xyz/openbmc_project/inventory";
108 
109             list.push_back(std::make_tuple(
110                 "callout", "fault", std::string(ROOT) + std::get<1>(*callout)));
111         }
112     }
113 }
114 
115 // The PROCESS_META flag is needed to get out of tree builds working. Such
116 // builds will have access only to internal error interfaces, hence handlers
117 // for out dbus error interfaces won't compile. This flag is not set by default,
118 // the phosphor-logging recipe enabled it.
119 #if defined PROCESS_META
120 
121 template <>
122 void build<xyz::openbmc_project::Common::Callout::Device::CALLOUT_DEVICE_PATH>(
123     const std::string& match, const std::vector<std::string>& data,
124     AssociationList& list);
125 
126 template <>
127 void build<
128     xyz::openbmc_project::Common::Callout::Inventory::CALLOUT_INVENTORY_PATH>(
129     const std::string& match, const std::vector<std::string>& data,
130     AssociationList& list);
131 
132 #endif // PROCESS_META
133 
134 } // namespace associations
135 } // namespace metadata
136 } // namespace logging
137 } // namespace phosphor
138