blob: ba3e5fa82b49cd6d59dd2d0e3314ed9eea065311 [file] [log] [blame]
James Feist5b4aa862018-08-16 14:07:01 -07001/*
2 // Copyright (c) 2018 Intel Corporation
3 //
4 // Licensed under the Apache License, Version 2.0 (the "License");
5 // you may not use this file except in compliance with the License.
6 // You may obtain a copy of the License at
7 //
8 // http://www.apache.org/licenses/LICENSE-2.0
9 //
10 // Unless required by applicable law or agreed to in writing, software
11 // distributed under the License is distributed on an "AS IS" BASIS,
12 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 // See the License for the specific language governing permissions and
14 // limitations under the License.
15 */
16#pragma once
17
Nan Zhou80d37e72022-06-21 17:46:14 +000018#include "dbus_singleton.hpp"
Ed Tanous863c1c22022-02-21 21:33:06 -080019#include "logging.hpp"
Nan Zhou80d37e72022-06-21 17:46:14 +000020
Nan Zhoud5c80ad2022-07-11 01:16:31 +000021#include <boost/system/error_code.hpp> // IWYU pragma: keep
George Liua4eb7612023-02-11 15:49:46 +080022#include <sdbusplus/asio/property.hpp>
Nan Zhoud5c80ad2022-07-11 01:16:31 +000023#include <sdbusplus/message/native_types.hpp>
James Feist5b4aa862018-08-16 14:07:01 -070024
Nan Zhou80d37e72022-06-21 17:46:14 +000025#include <array>
Nan Zhoud5c80ad2022-07-11 01:16:31 +000026#include <cstddef>
27#include <cstdint>
Manojkiran Eda17a897d2020-09-12 15:31:58 +053028#include <filesystem>
George Liu21384832022-11-09 11:21:15 +080029#include <functional>
Gunnar Mills1214b7e2020-06-04 10:11:30 -050030#include <regex>
George Liu21384832022-11-09 11:21:15 +080031#include <span>
Nan Zhoud5c80ad2022-07-11 01:16:31 +000032#include <sstream>
Nan Zhou80d37e72022-06-21 17:46:14 +000033#include <string>
George Liu7a1dbc42022-12-07 16:03:22 +080034#include <string_view>
Nan Zhou80d37e72022-06-21 17:46:14 +000035#include <tuple>
Nan Zhoud5c80ad2022-07-11 01:16:31 +000036#include <utility>
Ed Tanous40681292022-02-22 10:11:43 -080037#include <variant>
Nan Zhou80d37e72022-06-21 17:46:14 +000038#include <vector>
Gunnar Mills1214b7e2020-06-04 10:11:30 -050039
Nan Zhoud5c80ad2022-07-11 01:16:31 +000040// IWYU pragma: no_include <stddef.h>
41// IWYU pragma: no_include <stdint.h>
42// IWYU pragma: no_include <boost/system/detail/error_code.hpp>
43
James Feist5b4aa862018-08-16 14:07:01 -070044namespace dbus
45{
46
47namespace utility
48{
49
Ed Tanousd1a64812021-12-13 12:14:05 -080050// clang-format off
Ed Tanous40681292022-02-22 10:11:43 -080051using DbusVariantType = std::variant<
Ed Tanousd1a64812021-12-13 12:14:05 -080052 std::vector<std::tuple<std::string, std::string, std::string>>,
53 std::vector<std::string>,
54 std::vector<double>,
55 std::string,
56 int64_t,
57 uint64_t,
58 double,
59 int32_t,
60 uint32_t,
61 int16_t,
62 uint16_t,
63 uint8_t,
64 bool,
Ed Tanousd1a64812021-12-13 12:14:05 -080065 sdbusplus::message::unix_fd,
66 std::vector<uint32_t>,
67 std::vector<uint16_t>,
68 sdbusplus::message::object_path,
69 std::tuple<uint64_t, std::vector<std::tuple<std::string, std::string, double, uint64_t>>>,
70 std::vector<std::tuple<std::string, std::string>>,
71 std::vector<std::tuple<uint32_t, std::vector<uint32_t>>>,
72 std::vector<std::tuple<uint32_t, size_t>>,
73 std::vector<std::tuple<sdbusplus::message::object_path, std::string,
74 std::string, std::string>>
75 >;
James Feist5b4aa862018-08-16 14:07:01 -070076
Ed Tanousd1a64812021-12-13 12:14:05 -080077// clang-format on
Ed Tanous711ac7a2021-12-20 09:34:41 -080078using DBusPropertiesMap = std::vector<std::pair<std::string, DbusVariantType>>;
79using DBusInteracesMap = std::vector<std::pair<std::string, DBusPropertiesMap>>;
Zbigniew Kurzynski755a33c2020-02-28 14:06:37 +010080using ManagedObjectType =
81 std::vector<std::pair<sdbusplus::message::object_path, DBusInteracesMap>>;
James Feist5b4aa862018-08-16 14:07:01 -070082
Shantappa Teekappanavar5df6eda2022-01-18 12:29:28 -060083// Map of service name to list of interfaces
84using MapperServiceMap =
85 std::vector<std::pair<std::string, std::vector<std::string>>>;
86
87// Map of object paths to MapperServiceMaps
88using MapperGetSubTreeResponse =
89 std::vector<std::pair<std::string, MapperServiceMap>>;
90
Ed Tanousb9d36b42022-02-26 21:42:46 -080091using MapperGetObject =
92 std::vector<std::pair<std::string, std::vector<std::string>>>;
93
94using MapperGetAncestorsResponse = std::vector<
95 std::pair<std::string,
96 std::vector<std::pair<std::string, std::vector<std::string>>>>>;
97
98using MapperGetSubTreePathsResponse = std::vector<std::string>;
99
George Liua4eb7612023-02-11 15:49:46 +0800100using MapperEndPoints = std::vector<std::string>;
101
James Feist5b4aa862018-08-16 14:07:01 -0700102inline void escapePathForDbus(std::string& path)
103{
104 const std::regex reg("[^A-Za-z0-9_/]");
105 std::regex_replace(path.begin(), path.begin(), path.end(), reg, "_");
106}
107
Ed Tanous863c1c22022-02-21 21:33:06 -0800108inline void logError(const boost::system::error_code& ec)
109{
110 if (ec)
111 {
112 BMCWEB_LOG_ERROR << "DBus error: " << ec << ", cannot call method";
113 }
114}
115
James Feist5b4aa862018-08-16 14:07:01 -0700116// gets the string N strings deep into a path
117// i.e. /0th/1st/2nd/3rd
118inline bool getNthStringFromPath(const std::string& path, int index,
119 std::string& result)
120{
Manojkiran Eda17a897d2020-09-12 15:31:58 +0530121 if (index < 0)
James Feist5b4aa862018-08-16 14:07:01 -0700122 {
Manojkiran Eda17a897d2020-09-12 15:31:58 +0530123 return false;
124 }
125
126 std::filesystem::path p1(path);
127 int count = -1;
Patrick Williams89492a12023-05-10 07:51:34 -0500128 for (const auto& element : p1)
Manojkiran Eda17a897d2020-09-12 15:31:58 +0530129 {
130 if (element.has_filename())
James Feist5b4aa862018-08-16 14:07:01 -0700131 {
Manojkiran Eda17a897d2020-09-12 15:31:58 +0530132 ++count;
James Feist5b4aa862018-08-16 14:07:01 -0700133 if (count == index)
134 {
Manojkiran Eda17a897d2020-09-12 15:31:58 +0530135 result = element.stem().string();
James Feist5b4aa862018-08-16 14:07:01 -0700136 break;
137 }
138 }
139 }
Ed Tanousdcf2ebc2022-01-25 10:07:45 -0800140 return count >= index;
James Feist5b4aa862018-08-16 14:07:01 -0700141}
142
Ratan Gupta22c33712019-05-03 21:50:28 +0530143template <typename Callback>
144inline void checkDbusPathExists(const std::string& path, Callback&& callback)
145{
Ratan Gupta22c33712019-05-03 21:50:28 +0530146 crow::connections::systemBus->async_method_call(
Ed Tanousf94c4ec2022-01-06 12:44:41 -0800147 [callback{std::forward<Callback>(callback)}](
Ed Tanous5e7e2dc2023-02-16 10:37:01 -0800148 const boost::system::error_code& ec,
Ed Tanousb9d36b42022-02-26 21:42:46 -0800149 const dbus::utility::MapperGetObject& objectNames) {
Ed Tanous002d39b2022-05-31 08:59:27 -0700150 callback(!ec && !objectNames.empty());
Ratan Gupta22c33712019-05-03 21:50:28 +0530151 },
152 "xyz.openbmc_project.ObjectMapper",
153 "/xyz/openbmc_project/object_mapper",
154 "xyz.openbmc_project.ObjectMapper", "GetObject", path,
155 std::array<std::string, 0>());
156}
157
George Liu21384832022-11-09 11:21:15 +0800158inline void
George Liue99073f2022-12-09 11:06:16 +0800159 getSubTree(const std::string& path, int32_t depth,
160 std::span<const std::string_view> interfaces,
George Liu21384832022-11-09 11:21:15 +0800161 std::function<void(const boost::system::error_code&,
162 const MapperGetSubTreeResponse&)>&& callback)
163{
164 crow::connections::systemBus->async_method_call(
165 [callback{std::move(callback)}](
Ed Tanous5e7e2dc2023-02-16 10:37:01 -0800166 const boost::system::error_code& ec,
George Liu21384832022-11-09 11:21:15 +0800167 const MapperGetSubTreeResponse& subtree) { callback(ec, subtree); },
168 "xyz.openbmc_project.ObjectMapper",
169 "/xyz/openbmc_project/object_mapper",
George Liue99073f2022-12-09 11:06:16 +0800170 "xyz.openbmc_project.ObjectMapper", "GetSubTree", path, depth,
171 interfaces);
George Liu21384832022-11-09 11:21:15 +0800172}
173
174inline void getSubTreePaths(
George Liu7a1dbc42022-12-07 16:03:22 +0800175 const std::string& path, int32_t depth,
176 std::span<const std::string_view> interfaces,
George Liu21384832022-11-09 11:21:15 +0800177 std::function<void(const boost::system::error_code&,
178 const MapperGetSubTreePathsResponse&)>&& callback)
179{
180 crow::connections::systemBus->async_method_call(
181 [callback{std::move(callback)}](
Ed Tanous5e7e2dc2023-02-16 10:37:01 -0800182 const boost::system::error_code& ec,
George Liu21384832022-11-09 11:21:15 +0800183 const MapperGetSubTreePathsResponse& subtreePaths) {
184 callback(ec, subtreePaths);
185 },
186 "xyz.openbmc_project.ObjectMapper",
187 "/xyz/openbmc_project/object_mapper",
George Liu7a1dbc42022-12-07 16:03:22 +0800188 "xyz.openbmc_project.ObjectMapper", "GetSubTreePaths", path, depth,
George Liu21384832022-11-09 11:21:15 +0800189 interfaces);
190}
191
Willy Tu8d018362023-04-14 09:14:16 -0700192inline void getAssociatedSubTree(
193 const sdbusplus::message::object_path& associatedPath,
194 const sdbusplus::message::object_path& path, int32_t depth,
195 std::span<const std::string_view> interfaces,
196 std::function<void(const boost::system::error_code&,
197 const MapperGetSubTreeResponse&)>&& callback)
198{
199 crow::connections::systemBus->async_method_call(
200 [callback{std::move(callback)}](
201 const boost::system::error_code& ec,
202 const MapperGetSubTreeResponse& subtree) { callback(ec, subtree); },
203 "xyz.openbmc_project.ObjectMapper",
204 "/xyz/openbmc_project/object_mapper",
205 "xyz.openbmc_project.ObjectMapper", "GetAssociatedSubTree",
206 associatedPath, path, depth, interfaces);
207}
208
209inline void getAssociatedSubTreePaths(
210 const sdbusplus::message::object_path& associatedPath,
211 const sdbusplus::message::object_path& path, int32_t depth,
212 std::span<const std::string_view> interfaces,
213 std::function<void(const boost::system::error_code&,
214 const MapperGetSubTreePathsResponse&)>&& callback)
215{
216 crow::connections::systemBus->async_method_call(
217 [callback{std::move(callback)}](
218 const boost::system::error_code& ec,
219 const MapperGetSubTreePathsResponse& subtreePaths) {
220 callback(ec, subtreePaths);
221 },
222 "xyz.openbmc_project.ObjectMapper",
223 "/xyz/openbmc_project/object_mapper",
224 "xyz.openbmc_project.ObjectMapper", "GetAssociatedSubTreePaths",
225 associatedPath, path, depth, interfaces);
226}
227
George Liu2b731192023-01-11 16:27:13 +0800228inline void
229 getDbusObject(const std::string& path,
230 std::span<const std::string_view> interfaces,
231 std::function<void(const boost::system::error_code&,
232 const MapperGetObject&)>&& callback)
233{
234 crow::connections::systemBus->async_method_call(
235 [callback{std::move(callback)}](const boost::system::error_code& ec,
236 const MapperGetObject& object) {
237 callback(ec, object);
238 },
239 "xyz.openbmc_project.ObjectMapper",
240 "/xyz/openbmc_project/object_mapper",
241 "xyz.openbmc_project.ObjectMapper", "GetObject", path, interfaces);
242}
243
George Liua4eb7612023-02-11 15:49:46 +0800244inline void getAssociationEndPoints(
245 const std::string& path,
246 std::function<void(const boost::system::error_code&,
247 const MapperEndPoints&)>&& callback)
248{
249 sdbusplus::asio::getProperty<MapperEndPoints>(
250 *crow::connections::systemBus, "xyz.openbmc_project.ObjectMapper", path,
251 "xyz.openbmc_project.Association", "endpoints", std::move(callback));
252}
253
George Liuf5892d02023-03-01 10:37:08 +0800254inline void
255 getManagedObjects(const std::string& service,
256 const sdbusplus::message::object_path& path,
257 std::function<void(const boost::system::error_code&,
258 const ManagedObjectType&)>&& callback)
259{
260 crow::connections::systemBus->async_method_call(
261 [callback{std::move(callback)}](const boost::system::error_code& ec,
262 const ManagedObjectType& objects) {
263 callback(ec, objects);
264 },
265 service, path, "org.freedesktop.DBus.ObjectManager",
266 "GetManagedObjects");
267}
268
James Feist5b4aa862018-08-16 14:07:01 -0700269} // namespace utility
270} // namespace dbus