/******************************************************************************** * Copyright (C) 2014 GSI Helmholtzzentrum fuer Schwerionenforschung GmbH * * * * This software is distributed under the terms of the * * GNU Lesser General Public Licence (LGPL) version 3, * * copied verbatim in the file "LICENSE" * ********************************************************************************/ #include "Monitor.h" #include "Common.h" #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #if FAIRMQ_HAS_STD_FILESYSTEM #include namespace fs = std::filesystem; #else #include namespace fs = ::boost::filesystem; #endif using namespace std; using bie = ::boost::interprocess::interprocess_exception; namespace bipc = ::boost::interprocess; namespace bpt = ::boost::posix_time; namespace { volatile sig_atomic_t gSignalStatus = 0; } namespace fair::mq::shmem { struct TerminalConfig { TerminalConfig() { termios t; tcgetattr(STDIN_FILENO, &t); // get the current terminal I/O structure t.c_lflag &= ~ICANON; // disable canonical input t.c_lflag &= ~ECHO; // do not echo input chars tcsetattr(STDIN_FILENO, TCSANOW, &t); // apply the new settings } ~TerminalConfig() { termios t; tcgetattr(STDIN_FILENO, &t); // get the current terminal I/O structure t.c_lflag |= ICANON; // re-enable canonical input t.c_lflag |= ECHO; // echo input chars tcsetattr(STDIN_FILENO, TCSANOW, &t); // apply the new settings } }; void signalHandler(int signal) { gSignalStatus = signal; } Monitor::Monitor(string shmId, bool selfDestruct, bool interactive, bool viewOnly, unsigned int timeoutInMS, unsigned int intervalInMS, bool monitor, bool cleanOnExit) : fSelfDestruct(selfDestruct) , fInteractive(interactive) , fViewOnly(viewOnly) , fMonitor(monitor) , fSeenOnce(false) , fCleanOnExit(cleanOnExit) , fTimeoutInMS(timeoutInMS) , fIntervalInMS(intervalInMS) , fShmId(std::move(shmId)) , fTerminating(false) , fHeartbeatTriggered(false) , fLastHeartbeat(chrono::high_resolution_clock::now()) { if (!fViewOnly) { try { bipc::named_mutex monitorStatus(bipc::create_only, string("fmq_" + fShmId + "_ms").c_str()); } catch (bie&) { if (fInteractive) { LOG(error) << "fairmq-shmmonitor for shm id " << fShmId << " is already running. Try `fairmq-shmmonitor --cleanup --shmid " << fShmId << "`, or run in view-only mode (-v)"; } else { LOG(error) << "fairmq-shmmonitor for shm id " << fShmId << " is already running. Try `fairmq-shmmonitor --cleanup --shmid " << fShmId << "`"; } throw DaemonPresent(tools::ToString("fairmq-shmmonitor (in monitoring mode) for shm id ", fShmId, " is already running.")); } } } void Monitor::CatchSignals() { signal(SIGINT, signalHandler); signal(SIGTERM, signalHandler); fSignalThread = thread(&Monitor::SignalMonitor, this); } void Monitor::SignalMonitor() { while (true) { if (gSignalStatus != 0) { fTerminating = true; LOG(info) << "signal: " << gSignalStatus; break; } else if (fTerminating) { break; } this_thread::sleep_for(chrono::milliseconds(100)); } } void Monitor::Run() { thread heartbeatThread; if (!fViewOnly) { heartbeatThread = thread(&Monitor::CheckHeartbeats, this); } if (fInteractive) { Interactive(); } else { Watch(); } if (!fViewOnly) { heartbeatThread.join(); } } void Monitor::Watch() { while (!fTerminating) { using namespace boost::interprocess; try { managed_shared_memory managementSegment(open_read_only, std::string("fmq_" + fShmId + "_mng").c_str()); fSeenOnce = true; auto now = chrono::high_resolution_clock::now(); unsigned int duration = chrono::duration_cast(now - fLastHeartbeat.load()).count(); if (fHeartbeatTriggered && duration > fTimeoutInMS) { // memory is present, but no heartbeats since timeout duration LOG(info) << "no heartbeats since over " << fTimeoutInMS << " milliseconds, cleaning..."; Cleanup(ShmId{fShmId}); fHeartbeatTriggered = false; if (fSelfDestruct) { LOG(info) << "self destructing (segment has been observed and cleaned up by the monitor)"; fTerminating = true; } } } catch (bie&) { fHeartbeatTriggered = false; if (fSelfDestruct) { if (fSeenOnce) { // segment has been observed at least once, can self-destruct LOG(info) << "self destructing (segment has been observed and cleaned up orderly)"; fTerminating = true; } else { // if self-destruct is requested, and no segment has ever been observed, quit after double timeout duration auto now = chrono::high_resolution_clock::now(); unsigned int duration = chrono::duration_cast(now - fLastHeartbeat.load()).count(); if (duration > fTimeoutInMS * 2) { Cleanup(ShmId{fShmId}); LOG(info) << "self destructing (no segments observed within (timeout * 2) since start)"; fTerminating = true; } } } } this_thread::sleep_for(chrono::milliseconds(100)); } } bool Monitor::PrintShm(const ShmId& shmId) { using namespace boost::interprocess; try { managed_shared_memory managementSegment(open_read_only, std::string("fmq_" + shmId.shmId + "_mng").c_str()); VoidAlloc allocInstance(managementSegment.get_segment_manager()); Uint16SegmentInfoHashMap* segmentInfos = managementSegment.find(unique_instance).first; std::unordered_map> segments; if (!segmentInfos) { LOG(error) << "Found management segment, but cannot locate segment info, something went wrong..."; return false; } for (const auto& s : *segmentInfos) { if (s.second.fAllocationAlgorithm == AllocationAlgorithm::rbtree_best_fit) { segments.emplace(s.first, RBTreeBestFitSegment(open_read_only, std::string("fmq_" + shmId.shmId + "_m_" + to_string(s.first)).c_str())); } else { segments.emplace(s.first, SimpleSeqFitSegment(open_read_only, std::string("fmq_" + shmId.shmId + "_m_" + to_string(s.first)).c_str())); } } unsigned int numDevices = 0; int creatorId = -1; std::string sessionName; DeviceCounter* deviceCounter = managementSegment.find(unique_instance).first; if (deviceCounter) { numDevices = deviceCounter->fCount; } SessionInfo* sessionInfo = managementSegment.find(unique_instance).first; if (sessionInfo) { creatorId = sessionInfo->fCreatorId; sessionName = sessionInfo->fSessionName; } #ifdef FAIRMQ_DEBUG_MODE Uint16MsgCounterHashMap* msgCounters = managementSegment.find(unique_instance).first; #endif stringstream ss; size_t mfree = managementSegment.get_free_memory(); size_t mtotal = managementSegment.get_size(); size_t mused = mtotal - mfree; ss << "shm id: " << shmId.shmId << ", session: " << sessionName << ", creator id: " << creatorId << ", devices: " << numDevices << ", segments:\n"; for (const auto& s : segments) { size_t free = boost::apply_visitor(SegmentFreeMemory(), s.second); size_t total = boost::apply_visitor(SegmentSize(), s.second); size_t used = total - free; ss << " [" << s.first << "]: total: " << total #ifdef FAIRMQ_DEBUG_MODE << ", msgs: " << ( (msgCounters != nullptr) ? to_string((*msgCounters)[s.first].fCount) : "unknown") #else << ", msgs: NODEBUG" #endif << ", free: " << free << ", used: " << used << "\n"; } ss << " [m]: " << "total: " << mtotal << ", free: " << mfree << ", used: " << mused; LOGV(info, user1) << ss.str(); } catch (bie&) { return false; } return true; } void Monitor::ListAll(const std::string& path) { try { if (fs::is_empty(path)) { LOG(info) << "directory " << fs::path(path) << " is empty."; return; } for (const auto& entry : fs::directory_iterator(path)) { string filename = entry.path().filename().string(); // LOG(info) << filename << ", size: " << entry.file_size() << " bytes"; if (tools::StrStartsWith(filename, "fmq_") || tools::StrStartsWith(filename, "sem.fmq_")) { // LOG(info) << "The file '" << filename << "' belongs to FairMQ."; if (tools::StrEndsWith(filename, "_mng")) { string shmId = filename.substr(4, 8); LOG(info) << "\nFound shmid '" << shmId << "':\n"; if (!PrintShm(ShmId{shmId})) { LOG(info) << "could not open file for shmid '" << shmId << "'"; } } } else { LOG(info) << "The file '" << filename << "' does not belong to FairMQ, skipping..."; } } } catch (fs::filesystem_error& fse) { LOG(error) << "error: " << fse.what(); } } void Monitor::CheckHeartbeats() { using namespace boost::interprocess; uint64_t localHb = 0; while (!fTerminating) { std::this_thread::sleep_for(std::chrono::milliseconds(200)); try { managed_shared_memory managementSegment(open_read_only, std::string("fmq_" + fShmId + "_mng").c_str()); Heartbeat* hb = managementSegment.find(unique_instance).first; if (hb) { uint64_t globalHb = hb->fCount; if (localHb != globalHb) { fHeartbeatTriggered = true; fLastHeartbeat.store(chrono::high_resolution_clock::now()); localHb = globalHb; } } } catch (bie&) { // management segment not found, simply retry. } } } void Monitor::Interactive() { char c = 0; pollfd cinfd[1]; cinfd[0].fd = fileno(stdin); cinfd[0].events = POLLIN; TerminalConfig tcfg; LOG(info) << "\n"; PrintHelp(); while (!fTerminating) { if (poll(cinfd, 1, fIntervalInMS)) { if (fTerminating || gSignalStatus != 0) { break; } c = getchar(); switch (c) { case 'q': LOG(info) << "\n[q] --> quitting."; fTerminating = true; break; case 'x': LOG(info) << "\n[x] --> closing shared memory:"; if (!fViewOnly) { Cleanup(ShmId{fShmId}); } else { LOG(info) << "cannot close because in view only mode"; } break; case 'h': LOG(info) << "\n[h] --> help:\n"; PrintHelp(); LOG(info); break; case '\n': LOG(info) << "\n[\\n] --> invalid input."; break; case 'b': PrintDebugInfo(ShmId{fShmId}); break; default: LOG(info) << "\n[" << c << "] --> invalid input."; break; } if (fTerminating) { break; } } if (fTerminating) { break; } PrintShm(ShmId{fShmId}); } } void Monitor::PrintDebugInfo(const ShmId& shmId __attribute__((unused))) { #ifdef FAIRMQ_DEBUG_MODE string managementSegmentName("fmq_" + shmId.shmId + "_mng"); try { bipc::managed_shared_memory managementSegment(bipc::open_only, managementSegmentName.c_str()); boost::interprocess::named_mutex mtx(boost::interprocess::open_only, string("fmq_" + shmId.shmId + "_mtx").c_str()); boost::interprocess::scoped_lock lock(mtx); Uint16MsgDebugMapHashMap* debug = managementSegment.find(bipc::unique_instance).first; size_t numMessages = 0; for (const auto& e : *debug) { numMessages += e.second.size(); } LOG(info) << endl << "found " << numMessages << " messages."; for (const auto& s : *debug) { for (const auto& e : s.second) { using time_point = chrono::system_clock::time_point; time_point tmpt{chrono::duration_cast(chrono::nanoseconds(e.second.fCreationTime))}; time_t t = chrono::system_clock::to_time_t(tmpt); uint64_t ms = e.second.fCreationTime % 1000000; auto tm = localtime(&t); LOG(info) << "segment: " << setw(3) << setfill(' ') << s.first << ", offset: " << setw(12) << setfill(' ') << e.first << ", size: " << setw(10) << setfill(' ') << e.second.fSize << ", creator PID: " << e.second.fPid << setfill('0') << ", at: " << setw(2) << tm->tm_hour << ":" << setw(2) << tm->tm_min << ":" << setw(2) << tm->tm_sec << "." << setw(6) << ms; } } } catch (bie&) { LOG(info) << "no segments found"; } #else LOG(info) << "FairMQ was not compiled in debug mode (FAIRMQ_DEBUG_MODE)"; #endif } void Monitor::PrintDebugInfo(const SessionId& sessionId) { ShmId shmId{makeShmIdStr(sessionId.sessionId)}; PrintDebugInfo(shmId); } unordered_map> Monitor::GetDebugInfo(const ShmId& shmId __attribute__((unused))) { unordered_map> result; #ifdef FAIRMQ_DEBUG_MODE string managementSegmentName("fmq_" + shmId.shmId + "_mng"); try { bipc::managed_shared_memory managementSegment(bipc::open_only, managementSegmentName.c_str()); boost::interprocess::named_mutex mtx(boost::interprocess::open_only, string("fmq_" + shmId.shmId + "_mtx").c_str()); boost::interprocess::scoped_lock lock(mtx); Uint16MsgDebugMapHashMap* debug = managementSegment.find(bipc::unique_instance).first; result.reserve(debug->size()); for (const auto& s : *debug) { result[s.first].reserve(s.second.size()); for (const auto& e : s.second) { result[s.first][e.first] = BufferDebugInfo(e.first, e.second.fPid, e.second.fSize, e.second.fCreationTime); } } } catch (bie&) { LOG(info) << "no segments found"; } #else LOG(info) << "FairMQ was not compiled in debug mode (FAIRMQ_DEBUG_MODE)"; #endif return result; } unordered_map> Monitor::GetDebugInfo(const SessionId& sessionId) { ShmId shmId{makeShmIdStr(sessionId.sessionId)}; return GetDebugInfo(shmId); } unsigned long Monitor::GetFreeMemory(const ShmId& shmId, uint16_t segmentId) { using namespace boost::interprocess; try { bipc::managed_shared_memory managementSegment(bipc::open_only, std::string("fmq_" + shmId.shmId + "_mng").c_str()); boost::interprocess::named_mutex mtx(boost::interprocess::open_only, std::string("fmq_" + shmId.shmId + "_mtx").c_str()); boost::interprocess::scoped_lock lock(mtx); Uint16SegmentInfoHashMap* segmentInfos = managementSegment.find(unique_instance).first; if (!segmentInfos) { LOG(error) << "Found management segment, but could not locate segment info"; throw MonitorError("Found management segment, but could not locate segment info"); } auto it = segmentInfos->find(segmentId); if (it != segmentInfos->end()) { if (it->second.fAllocationAlgorithm == AllocationAlgorithm::rbtree_best_fit) { RBTreeBestFitSegment segment(open_read_only, std::string("fmq_" + shmId.shmId + "_m_" + std::to_string(segmentId)).c_str()); return segment.get_free_memory(); } else { SimpleSeqFitSegment segment(open_read_only, std::string("fmq_" + shmId.shmId + "_m_" + std::to_string(segmentId)).c_str()); return segment.get_free_memory(); } } else { LOG(error) << "Could not find segment id '" << segmentId << "'"; throw MonitorError(tools::ToString("Could not find segment id '", segmentId, "'")); } } catch (bie&) { LOG(error) << "Could not find management segment for shmid '" << shmId.shmId << "'"; throw MonitorError(tools::ToString("Could not find management segment for shmid '", shmId.shmId, "'")); } } unsigned long Monitor::GetFreeMemory(const SessionId& sessionId, uint16_t segmentId) { ShmId shmId{makeShmIdStr(sessionId.sessionId)}; return GetFreeMemory(shmId, segmentId); } void Monitor::PrintHelp() { LOG(info) << "controls: [x] close memory, " << "[b] print a list of allocated messages (only available when compiled with FAIMQ_DEBUG_MODE=ON), " << "[h] help, " << "[q] quit."; } std::pair RunRemoval(std::function f, std::string name, bool verbose) { if (f(name)) { if (verbose) { LOG(info) << "Successfully removed '" << name << "'."; } return {name, true}; } else { if (verbose) { LOG(debug) << "Did not remove '" << name << "'. Already removed?"; } return {name, false}; } } bool Monitor::RemoveObject(const string& name) { return bipc::shared_memory_object::remove(name.c_str()); } bool Monitor::RemoveFileMapping(const string& name) { return bipc::file_mapping::remove(name.c_str()); } bool Monitor::RemoveQueue(const string& name) { return bipc::message_queue::remove(name.c_str()); } bool Monitor::RemoveMutex(const string& name) { return bipc::named_mutex::remove(name.c_str()); } bool Monitor::RemoveCondition(const string& name) { return bipc::named_condition::remove(name.c_str()); } std::vector> Monitor::Cleanup(const ShmId& shmId, bool verbose /* = true */) { std::vector> result; if (verbose) { LOG(info) << "Cleaning up for shared memory id '" << shmId.shmId << "'..."; } string managementSegmentName("fmq_" + shmId.shmId + "_mng"); try { bipc::managed_shared_memory managementSegment(bipc::open_only, managementSegmentName.c_str()); try { RegionCounter* rc = managementSegment.find(bipc::unique_instance).first; if (rc) { if (verbose) { LOG(debug) << "Region counter found: " << rc->fCount; } uint16_t regionCount = rc->fCount; Uint16RegionInfoMap* m = managementSegment.find(bipc::unique_instance).first; for (uint16_t i = 1; i <= regionCount; ++i) { if (m != nullptr) { RegionInfo ri = m->at(i); string path = ri.fPath.c_str(); int flags = ri.fFlags; if (verbose) { LOG(info) << "Found RegionInfo with path: '" << path << "', flags: " << flags << ", fDestroyed: " << ri.fDestroyed << "."; } if (!path.empty()) { result.emplace_back(RunRemoval(Monitor::RemoveFileMapping, path + "fmq_" + shmId.shmId + "_rg_" + to_string(i), verbose)); } else { result.emplace_back(RunRemoval(Monitor::RemoveObject, "fmq_" + shmId.shmId + "_rg_" + to_string(i), verbose)); } } else { result.emplace_back(RunRemoval(Monitor::RemoveObject, "fmq_" + shmId.shmId + "_rg_" + to_string(i), verbose)); } result.emplace_back(RunRemoval(Monitor::RemoveQueue, string("fmq_" + shmId.shmId + "_rgq_" + to_string(i)), verbose)); } } else { if (verbose) { LOG(info) << "No region counter found. No regions to cleanup."; } } } catch(out_of_range& oor) { if (verbose) { LOG(info) << "Could not locate element in the region map, out of range: " << oor.what(); } } Uint16SegmentInfoHashMap* segmentInfos = managementSegment.find(bipc::unique_instance).first; for (const auto& s : *segmentInfos) { result.emplace_back(RunRemoval(Monitor::RemoveObject, "fmq_" + shmId.shmId + "_m_" + to_string(s.first), verbose)); } result.emplace_back(RunRemoval(Monitor::RemoveObject, managementSegmentName.c_str(), verbose)); } catch (bie&) { if (verbose) { LOG(info) << "Did not find '" << managementSegmentName << "' shared memory segment. No regions to cleanup."; } } result.emplace_back(RunRemoval(Monitor::RemoveMutex, "fmq_" + shmId.shmId + "_mtx", verbose)); result.emplace_back(RunRemoval(Monitor::RemoveCondition, "fmq_" + shmId.shmId + "_cv", verbose)); return result; } std::vector> Monitor::Cleanup(const SessionId& sessionId, bool verbose /* = true */) { ShmId shmId{makeShmIdStr(sessionId.sessionId)}; if (verbose) { LOG(info) << "Cleanup called with session id '" << sessionId.sessionId << "', translating to shared memory id '" << shmId.shmId << "'"; } return Cleanup(shmId, verbose); } std::vector> Monitor::CleanupFull(const ShmId& shmId, bool verbose /* = true */) { auto result = Cleanup(shmId, verbose); result.emplace_back(RunRemoval(Monitor::RemoveMutex, "fmq_" + shmId.shmId + "_ms", verbose)); return result; } std::vector> Monitor::CleanupFull(const SessionId& sessionId, bool verbose /* = true */) { ShmId shmId{makeShmIdStr(sessionId.sessionId)}; if (verbose) { LOG(info) << "Cleanup called with session id '" << sessionId.sessionId << "', translating to shared memory id '" << shmId.shmId << "'"; } return CleanupFull(shmId, verbose); } Monitor::~Monitor() { if (fSignalThread.joinable()) { fSignalThread.join(); } if (fCleanOnExit) { Cleanup(ShmId{fShmId}); } if (!fViewOnly) { RemoveMutex("fmq_" + fShmId + "_ms"); } } } // namespace fair::mq::shmem