blob: 24cfd0ca80e98431693e58375eb5a5eb7c92464e [file] [log] [blame]
Dhruvaraj Subhashchandranfef66a92020-09-06 13:10:59 -05001#pragma once
2
3#include "dump_manager.hpp"
4#include "dump_utils.hpp"
5#include "watch.hpp"
6#include "xyz/openbmc_project/Dump/Internal/Create/server.hpp"
7
8#include <experimental/filesystem>
9#include <xyz/openbmc_project/Dump/Create/server.hpp>
10
11namespace phosphor
12{
13namespace dump
14{
15namespace bmc
16{
17namespace internal
18{
19
20class Manager;
21
22} // namespace internal
23
24using CreateIface = sdbusplus::server::object::object<
25 sdbusplus::xyz::openbmc_project::Dump::server::Create>;
26
27using UserMap = phosphor::dump::inotify::UserMap;
28
29using Type =
30 sdbusplus::xyz::openbmc_project::Dump::Internal::server::Create::Type;
31
32namespace fs = std::experimental::filesystem;
33
34using Watch = phosphor::dump::inotify::Watch;
35
36// Type to dreport type string map
37static const std::map<Type, std::string> TypeMap = {
38 {Type::ApplicationCored, "core"},
39 {Type::UserRequested, "user"},
40 {Type::InternalFailure, "elog"},
41 {Type::Checkstop, "checkstop"}};
42
43/** @class Manager
44 * @brief OpenBMC Dump manager implementation.
45 * @details A concrete implementation for the
46 * xyz.openbmc_project.Dump.Create DBus API
47 */
48class Manager : virtual public CreateIface,
49 virtual public phosphor::dump::Manager
50{
51 friend class internal::Manager;
52
53 public:
54 Manager() = delete;
55 Manager(const Manager&) = default;
56 Manager& operator=(const Manager&) = delete;
57 Manager(Manager&&) = delete;
58 Manager& operator=(Manager&&) = delete;
59 virtual ~Manager() = default;
60
61 /** @brief Constructor to put object onto bus at a dbus path.
62 * @param[in] bus - Bus to attach to.
63 * @param[in] event - Dump manager sd_event loop.
64 * @param[in] path - Path to attach at.
65 * @param[in] baseEntryPath - Base path for dump entry.
66 * @param[in] filePath - Path where the dumps are stored.
67 */
68 Manager(sdbusplus::bus::bus& bus, const EventPtr& event, const char* path,
69 const std::string& baseEntryPath, const char* filePath) :
70 CreateIface(bus, path),
71 phosphor::dump::Manager(bus, path, baseEntryPath),
72 eventLoop(event.get()),
73 dumpWatch(
74 eventLoop, IN_NONBLOCK, IN_CLOSE_WRITE | IN_CREATE, EPOLLIN,
75 filePath,
76 std::bind(std::mem_fn(&phosphor::dump::bmc::Manager::watchCallback),
77 this, std::placeholders::_1)),
78 dumpDir(filePath)
79 {
80 }
81
82 /** @brief Implementation of dump watch call back
83 * @param [in] fileInfo - map of file info path:event
84 */
85 void watchCallback(const UserMap& fileInfo);
86
87 /** @brief Construct dump d-bus objects from their persisted
88 * representations.
89 */
90 void restore() override;
91
92 /** @brief Implementation for CreateDump
Dhruvaraj Subhashchandran6ccb50e2020-10-29 09:33:18 -050093 * Method to create a BMC dump entry when user requests for a new BMC dump
Dhruvaraj Subhashchandranfef66a92020-09-06 13:10:59 -050094 *
Dhruvaraj Subhashchandran6ccb50e2020-10-29 09:33:18 -050095 * @return object_path - The object path of the new dump entry.
Dhruvaraj Subhashchandranfef66a92020-09-06 13:10:59 -050096 */
Dhruvaraj Subhashchandran969f9a52020-10-30 01:42:39 -050097 sdbusplus::message::object_path
98 createDump(std::map<std::string, std::string> params) override;
Dhruvaraj Subhashchandranfef66a92020-09-06 13:10:59 -050099
100 private:
101 /** @brief Create Dump entry d-bus object
102 * @param[in] fullPath - Full path of the Dump file name
103 */
104 void createEntry(const fs::path& fullPath);
105
106 /** @brief Capture BMC Dump based on the Dump type.
107 * @param[in] type - Type of the Dump.
108 * @param[in] fullPaths - List of absolute paths to the files
109 * to be included as part of Dump package.
110 * @return id - The Dump entry id number.
111 */
112 uint32_t captureDump(Type type, const std::vector<std::string>& fullPaths);
113
114 /** @brief sd_event_add_child callback
115 *
116 * @param[in] s - event source
117 * @param[in] si - signal info
118 * @param[in] userdata - pointer to Watch object
119 *
120 * @returns 0 on success, -1 on fail
121 */
122 static int callback(sd_event_source*, const siginfo_t*, void*)
123 {
124 // No specific action required in
125 // the sd_event_add_child callback.
126 return 0;
127 }
128 /** @brief Remove specified watch object pointer from the
129 * watch map and associated entry from the map.
130 * @param[in] path - unique identifier of the map
131 */
132 void removeWatch(const fs::path& path);
133
134 /** @brief Calculate per dump allowed size based on the available
135 * size in the dump location.
136 * @returns dump size in kilobytes.
137 */
138 size_t getAllowedSize();
139
140 /** @brief sdbusplus Dump event loop */
141 EventPtr eventLoop;
142
143 /** @brief Dump main watch object */
144 Watch dumpWatch;
145
146 /** @brief Path to the dump file*/
147 std::string dumpDir;
148
149 /** @brief Child directory path and its associated watch object map
150 * [path:watch object]
151 */
152 std::map<fs::path, std::unique_ptr<Watch>> childWatchMap;
153};
154
155} // namespace bmc
156} // namespace dump
157} // namespace phosphor