/** * Copyright 2013-2021 Software Radio Systems Limited * * This file is part of srsRAN. * * srsRAN is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as * published by the Free Software Foundation, either version 3 of * the License, or (at your option) any later version. * * srsRAN is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Affero General Public License for more details. * * A copy of the GNU Affero General Public License can be found in * the LICENSE file in the top-level directory of this distribution * and at http://www.gnu.org/licenses/. * */ #ifndef SRSENB_ENB_EVENTS_H #define SRSENB_ENB_EVENTS_H #include #include namespace srslog { class log_channel; } namespace srsenb { /// This interface logs different kinds of events to the configured channel. By default, if no log channel is configured /// logging will be disabled. class event_logger_interface { public: virtual ~event_logger_interface() = default; /// Logs into the underlying log channel any RRC event. virtual void log_rrc_event(uint32_t enb_cc_idx, const std::string& asn1_oct_str, const std::string& asn1_txt_str, unsigned type, unsigned additional_info, uint16_t rnti) = 0; /// Logs into the underlying log channel the S1 context create event. virtual void log_s1_ctx_create(uint32_t enb_cc_idx, uint32_t mme_id, uint32_t enb_id, uint16_t rnti) = 0; /// Logs into the underlying log channel the S1 context delete event. virtual void log_s1_ctx_delete(uint32_t enb_cc_idx, uint32_t mme_id, uint32_t enb_id, uint16_t rnti) = 0; /// Logs into the underlying log channel when a sector has been started. virtual void log_sector_start(uint32_t cc_idx, uint32_t pci, uint32_t cell_id, const std::string &hnb_name) = 0; /// Logs into the underlying log channel when a sector has been stopped. virtual void log_sector_stop(uint32_t cc_idx, uint32_t pci, uint32_t cell_id, const std::string &hnb_name) = 0; /// Logs into the underlying log channel a measurement report event. virtual void log_measurement_report(uint32_t enb_cc_idx, const std::string& asn1_oct_str, const std::string& asn1_txt_str, uint16_t rnti) = 0; /// Logs into the underlying log channel a RLF report. virtual void log_rlf_report(uint32_t enb_cc_idx, const std::string& asn1_oct_str, const std::string& asn1_txt_str, uint16_t rnti) = 0; /// Logs into the underlying log channel a RLF detection event. virtual void log_rlf_detected(uint32_t enb_cc_idx, const std::string& type, uint16_t rnti) = 0; /// Logs into the underlying log channel a handover command event. virtual void log_handover_command(uint32_t enb_cc_idx, uint32_t target_pci, uint32_t target_earfcn, uint16_t new_ue_rnti, uint16_t rnti) = 0; /// Logs into the underlying log channel a connection resume event. virtual void log_connection_resume(uint32_t enb_cc_idx, uint16_t resume_rnti, uint16_t rnti) = 0; }; /// Singleton class to provide global access to the event_logger_interface interface. class event_logger { event_logger() = default; public: /// ASN1 output printing format. enum class asn1_output_format { text, octets }; /// Returns the instance of the event logger. static event_logger_interface& get(); /// Uses the specified log channel for event logging. /// NOTE: This method is not thread safe. static void configure(srslog::log_channel& c, asn1_output_format asn1_format); private: static std::unique_ptr pimpl; }; } // namespace srsenb #endif // SRSENB_ENB_EVENTS_H