/** * Copyright © 2018 Intel Corporation * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "config.h" #include "settings.hpp" #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #if __has_include() #include #elif __has_include() #include namespace std { // splice experimental::filesystem into std namespace filesystem = std::experimental::filesystem; } // namespace std #else #error filesystem not available #endif namespace fs = std::filesystem; using namespace phosphor::logging; // IPMI Spec, shared Reservation ID. static unsigned short selReservationID = 0xFFFF; static bool selReservationValid = false; unsigned short reserveSel(void) { // IPMI spec, Reservation ID, the value simply increases against each // execution of the Reserve SEL command. if (++selReservationID == 0) { selReservationID = 1; } selReservationValid = true; return selReservationID; } bool checkSELReservation(unsigned short id) { return (selReservationValid && selReservationID == id); } void cancelSELReservation(void) { selReservationValid = false; } EInterfaceIndex getInterfaceIndex(void) { return interfaceKCS; } sd_bus* bus; sd_event* events = nullptr; sd_event* ipmid_get_sd_event_connection(void) { return events; } sd_bus* ipmid_get_sd_bus_connection(void) { return bus; } namespace ipmi { static inline unsigned int makeCmdKey(unsigned int cluster, unsigned int cmd) { return (cluster << 8) | cmd; } using HandlerTuple = std::tuple; /* map to handle standard registered commands */ static std::unordered_map handlerMap; /* special map for decoding Group registered commands (NetFn 2Ch) */ static std::unordered_map groupHandlerMap; /* special map for decoding OEM registered commands (NetFn 2Eh) */ static std::unordered_map oemHandlerMap; using FilterTuple = std::tuple; /* list to hold all registered ipmi command filters */ static std::forward_list filterList; namespace impl { /* common function to register all standard IPMI handlers */ bool registerHandler(int prio, NetFn netFn, Cmd cmd, Privilege priv, HandlerBase::ptr handler) { // check for valid NetFn: even; 00-0Ch, 30-3Eh if (netFn & 1 || (netFn > netFnTransport && netFn < netFnGroup) || netFn > netFnOemEight) { return false; } // create key and value for this handler unsigned int netFnCmd = makeCmdKey(netFn, cmd); HandlerTuple item(prio, priv, handler); // consult the handler map and look for a match auto& mapCmd = handlerMap[netFnCmd]; if (!std::get(mapCmd) || std::get(mapCmd) <= prio) { mapCmd = item; return true; } return false; } /* common function to register all Group IPMI handlers */ bool registerGroupHandler(int prio, Group group, Cmd cmd, Privilege priv, HandlerBase::ptr handler) { // create key and value for this handler unsigned int netFnCmd = makeCmdKey(group, cmd); HandlerTuple item(prio, priv, handler); // consult the handler map and look for a match auto& mapCmd = groupHandlerMap[netFnCmd]; if (!std::get(mapCmd) || std::get(mapCmd) <= prio) { mapCmd = item; return true; } return false; } /* common function to register all OEM IPMI handlers */ bool registerOemHandler(int prio, Iana iana, Cmd cmd, Privilege priv, HandlerBase::ptr handler) { // create key and value for this handler unsigned int netFnCmd = makeCmdKey(iana, cmd); HandlerTuple item(prio, priv, handler); // consult the handler map and look for a match auto& mapCmd = oemHandlerMap[netFnCmd]; if (!std::get(mapCmd) || std::get(mapCmd) <= prio) { mapCmd = item; return true; } return false; } /* common function to register all IPMI filter handlers */ void registerFilter(int prio, FilterBase::ptr filter) { // check for initial placement if (filterList.empty() || std::get(filterList.front()) < prio) { filterList.emplace_front(std::make_tuple(prio, filter)); } // walk the list and put it in the right place auto j = filterList.begin(); for (auto i = j; i != filterList.end() && std::get(*i) > prio; i++) { j = i; } filterList.emplace_after(j, std::make_tuple(prio, filter)); } } // namespace impl message::Response::ptr filterIpmiCommand(message::Request::ptr request) { // pass the command through the filter mechanism // This can be the firmware firewall or any OEM mechanism like // whitelist filtering based on operational mode for (auto& item : filterList) { FilterBase::ptr filter = std::get(item); ipmi::Cc cc = filter->call(request); if (ipmi::ccSuccess != cc) { return errorResponse(request, cc); } } return message::Response::ptr(); } message::Response::ptr executeIpmiCommandCommon( std::unordered_map& handlers, unsigned int keyCommon, message::Request::ptr request) { // filter the command first; a non-null message::Response::ptr // means that the message has been rejected for some reason message::Response::ptr response = filterIpmiCommand(request); if (response) { return response; } Cmd cmd = request->ctx->cmd; unsigned int key = makeCmdKey(keyCommon, cmd); auto cmdIter = handlers.find(key); if (cmdIter != handlers.end()) { HandlerTuple& chosen = cmdIter->second; if (request->ctx->priv < std::get(chosen)) { return errorResponse(request, ccInsufficientPrivilege); } return std::get(chosen)->call(request); } else { unsigned int wildcard = makeCmdKey(keyCommon, cmdWildcard); cmdIter = handlers.find(wildcard); if (cmdIter != handlers.end()) { HandlerTuple& chosen = cmdIter->second; if (request->ctx->priv < std::get(chosen)) { return errorResponse(request, ccInsufficientPrivilege); } return std::get(chosen)->call(request); } } return errorResponse(request, ccInvalidCommand); } message::Response::ptr executeIpmiGroupCommand(message::Request::ptr request) { // look up the group for this request Group group; if (0 != request->payload.unpack(group)) { return errorResponse(request, ccReqDataLenInvalid); } // The handler will need to unpack group as well; we just need it for lookup request->payload.reset(); message::Response::ptr response = executeIpmiCommandCommon(groupHandlerMap, group, request); // if the handler should add the group; executeIpmiCommandCommon does not if (response->cc != ccSuccess && response->payload.size() == 0) { response->pack(group); } return response; } message::Response::ptr executeIpmiOemCommand(message::Request::ptr request) { // look up the iana for this request Iana iana; if (0 != request->payload.unpack(iana)) { return errorResponse(request, ccReqDataLenInvalid); } request->payload.reset(); message::Response::ptr response = executeIpmiCommandCommon(oemHandlerMap, iana, request); // if the handler should add the iana; executeIpmiCommandCommon does not if (response->cc != ccSuccess && response->payload.size() == 0) { response->pack(iana); } return response; } message::Response::ptr executeIpmiCommand(message::Request::ptr request) { NetFn netFn = request->ctx->netFn; if (netFnGroup == netFn) { return executeIpmiGroupCommand(request); } else if (netFnOem == netFn) { return executeIpmiOemCommand(request); } return executeIpmiCommandCommon(handlerMap, netFn, request); } /* called from sdbus async server context */ auto executionEntry(boost::asio::yield_context yield, NetFn netFn, uint8_t lun, Cmd cmd, std::vector& data, std::map& options) { auto ctx = std::make_shared(netFn, cmd, 0, 0, ipmi::Privilege::Admin, &yield); auto request = std::make_shared( ctx, std::forward>(data)); message::Response::ptr response = executeIpmiCommand(request); // Responses in IPMI require a bit set. So there ya go... netFn |= 0x01; return std::make_tuple(netFn, lun, cmd, response->cc, response->payload.raw); } /** @struct IpmiProvider * * RAII wrapper for dlopen so that dlclose gets called on exit */ struct IpmiProvider { public: /** @brief address of the opened library */ void* addr; std::string name; IpmiProvider() = delete; IpmiProvider(const IpmiProvider&) = delete; IpmiProvider& operator=(const IpmiProvider&) = delete; IpmiProvider(IpmiProvider&&) = delete; IpmiProvider& operator=(IpmiProvider&&) = delete; /** @brief dlopen a shared object file by path * @param[in] filename - path of shared object to open */ explicit IpmiProvider(const char* fname) : addr(nullptr), name(fname) { log("Open IPMI provider library", entry("PROVIDER=%s", name.c_str())); try { addr = dlopen(name.c_str(), RTLD_NOW); } catch (std::exception& e) { log("ERROR opening IPMI provider", entry("PROVIDER=%s", name.c_str()), entry("ERROR=%s", e.what())); } catch (...) { std::exception_ptr eptr = std::current_exception(); try { std::rethrow_exception(eptr); } catch (std::exception& e) { log("ERROR opening IPMI provider", entry("PROVIDER=%s", name.c_str()), entry("ERROR=%s", e.what())); } } if (!isOpen()) { log("ERROR opening IPMI provider", entry("PROVIDER=%s", name.c_str()), entry("ERROR=%s", dlerror())); } } ~IpmiProvider() { if (isOpen()) { dlclose(addr); } } bool isOpen() const { return (nullptr != addr); } }; // Plugin libraries need to contain .so either at the end or in the middle constexpr const char ipmiPluginExtn[] = ".so"; /* return a list of self-closing library handles */ std::forward_list loadProviders(const fs::path& ipmiLibsPath) { std::vector libs; for (const auto& libPath : fs::directory_iterator(ipmiLibsPath)) { fs::path fname = libPath.path(); while (fname.has_extension()) { fs::path extn = fname.extension(); if (extn == ipmiPluginExtn) { libs.push_back(libPath.path()); break; } fname.replace_extension(); } } std::sort(libs.begin(), libs.end()); std::forward_list handles; for (auto& lib : libs) { #ifdef __IPMI_DEBUG__ log("Registering handler", entry("HANDLER=%s", lib.c_str())); #endif handles.emplace_front(lib.c_str()); } return handles; } } // namespace ipmi #ifdef ALLOW_DEPRECATED_API /* legacy registration */ void ipmi_register_callback(ipmi_netfn_t netFn, ipmi_cmd_t cmd, ipmi_context_t context, ipmid_callback_t handler, ipmi_cmd_privilege_t priv) { auto h = ipmi::makeLegacyHandler(handler, context); // translate priv from deprecated enum to current ipmi::Privilege realPriv; switch (priv) { case PRIVILEGE_CALLBACK: realPriv = ipmi::Privilege::Callback; break; case PRIVILEGE_USER: realPriv = ipmi::Privilege::User; break; case PRIVILEGE_OPERATOR: realPriv = ipmi::Privilege::Operator; break; case PRIVILEGE_ADMIN: realPriv = ipmi::Privilege::Admin; break; case PRIVILEGE_OEM: realPriv = ipmi::Privilege::Oem; break; case SYSTEM_INTERFACE: realPriv = ipmi::Privilege::Admin; break; default: realPriv = ipmi::Privilege::Admin; break; } ipmi::impl::registerHandler(ipmi::prioOpenBmcBase, netFn, cmd, realPriv, h); } namespace oem { class LegacyRouter : public oem::Router { public: virtual ~LegacyRouter() { } /// Enable message routing to begin. void activate() override { } void registerHandler(Number oen, ipmi_cmd_t cmd, Handler handler) override { auto h = ipmi::makeLegacyHandler(std::forward(handler)); ipmi::impl::registerOemHandler(ipmi::prioOpenBmcBase, oen, cmd, ipmi::Privilege::Admin, h); } }; static LegacyRouter legacyRouter; Router* mutableRouter() { return &legacyRouter; } } // namespace oem /* legacy alternative to executionEntry */ void handleLegacyIpmiCommand(sdbusplus::message::message& m) { unsigned char seq, netFn, lun, cmd; std::vector data; m.read(seq, netFn, lun, cmd, data); auto ctx = std::make_shared(netFn, cmd, 0, 0, ipmi::Privilege::Admin); auto request = std::make_shared( ctx, std::forward>(data)); ipmi::message::Response::ptr response = ipmi::executeIpmiCommand(request); // Responses in IPMI require a bit set. So there ya go... netFn |= 0x01; const char *dest, *path; constexpr const char* DBUS_INTF = "org.openbmc.HostIpmi"; dest = m.get_sender(); path = m.get_path(); getSdBus()->async_method_call([](boost::system::error_code ec) {}, dest, path, DBUS_INTF, "sendMessage", seq, netFn, lun, cmd, response->cc, response->payload.raw); } #endif /* ALLOW_DEPRECATED_API */ // Calls host command manager to do the right thing for the command using CommandHandler = phosphor::host::command::CommandHandler; std::unique_ptr cmdManager; void ipmid_send_cmd_to_host(CommandHandler&& cmd) { return cmdManager->execute(std::forward(cmd)); } std::unique_ptr& ipmid_get_host_cmd_manager() { return cmdManager; } // These are symbols that are present in libipmid, but not expected // to be used except here (or maybe a unit test), so declare them here extern void setIoContext(std::shared_ptr& newIo); extern void setSdBus(std::shared_ptr& newBus); int main(int argc, char* argv[]) { // Connect to system bus auto io = std::make_shared(); setIoContext(io); if (argc > 1 && std::string(argv[1]) == "-session") { sd_bus_default_user(&bus); } else { sd_bus_default_system(&bus); } auto sdbusp = std::make_shared(*io, bus); setSdBus(sdbusp); sdbusp->request_name("xyz.openbmc_project.Ipmi.Host"); // TODO: Hack to keep the sdEvents running.... Not sure why the sd_event // queue stops running if we don't have a timer that keeps re-arming phosphor::Timer t2([]() { ; }); t2.start(std::chrono::microseconds(500000), true); // TODO: Remove all vestiges of sd_event from phosphor-host-ipmid // until that is done, add the sd_event wrapper to the io object sdbusplus::asio::sd_event_wrapper sdEvents(*io); cmdManager = std::make_unique(*sdbusp); // Register all command providers and filters auto handles = ipmi::loadProviders(HOST_IPMI_LIB_PATH); // Add bindings for inbound IPMI requests auto server = sdbusplus::asio::object_server(sdbusp); auto iface = server.add_interface("/xyz/openbmc_project/Ipmi", "xyz.openbmc_project.Ipmi.Server"); iface->register_method("execute", ipmi::executionEntry); iface->initialize(); #ifdef ALLOW_DEPRECATED_API // listen on deprecated signal interface for kcs/bt commands constexpr const char* FILTER = "type='signal',interface='org.openbmc." "HostIpmi',member='ReceivedMessage'"; sdbusplus::bus::match::match oldIpmiInterface(*sdbusp, FILTER, handleLegacyIpmiCommand); #endif /* ALLOW_DEPRECATED_API */ // set up boost::asio signal handling std::function stopAsioRunLoop = [&io](int signalNumber) { log("Received signal; quitting", entry("SIGNAL=%d", signalNumber)); io->stop(); return SignalResponse::breakExecution; }; registerSignalHandler(ipmi::prioOpenBmcBase, SIGINT, stopAsioRunLoop); registerSignalHandler(ipmi::prioOpenBmcBase, SIGTERM, stopAsioRunLoop); io->run(); // destroy all the IPMI handlers so the providers can unload safely ipmi::handlerMap.clear(); ipmi::groupHandlerMap.clear(); ipmi::oemHandlerMap.clear(); ipmi::filterList.clear(); // unload the provider libraries handles.clear(); return 0; }