/* Copyright (c) 2006, 2024, Oracle and/or its affiliates. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2.0, as published by the Free Software Foundation. This program is designed to work with certain software (including but not limited to OpenSSL) that is licensed under separate terms, as designated in a particular file or component or in included license documentation. The authors of MySQL hereby grant you an additional permission to link the program and your derivative works with the separately licensed software that they have either included with the program or referenced in the documentation. This program 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 General Public License, version 2.0, for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */ #ifndef RPL_REPORTING_H #define RPL_REPORTING_H #include #include #include #include #include "my_compiler.h" #include "my_inttypes.h" #include "my_systime.h" //my_getsystime #include "mysql/components/services/bits/mysql_mutex_bits.h" #include "mysql/my_loglevel.h" #include "mysql/psi/mysql_mutex.h" /** Maximum size of an error message from a slave thread. */ #define MAX_SLAVE_ERRMSG 1024 class THD; struct Gtid_specification; /** Mix-in to handle the message logging and reporting for relay log info and master log info structures. By inheriting from this class, the class is imbued with capabilities to do slave reporting. */ class Slave_reporting_capability { public: /** lock used to synchronize m_last_error on 'SHOW REPLICA STATUS' **/ mutable mysql_mutex_t err_lock; /** Constructor. @param thread_name Printable name of the slave thread that is reporting. */ Slave_reporting_capability(char const *thread_name); /** Writes a message and, if it's an error message, to Last_Error (which will be displayed by SHOW REPLICA STATUS). @param level The severity level @param err_code The error code @param msg The message (usually related to the error code, but can contain more information), in printf() format. */ virtual void report(loglevel level, int err_code, const char *msg, ...) const MY_ATTRIBUTE((format(printf, 4, 5))); virtual void report(loglevel level, int err_code, const Gtid_specification *gtid_next, const char *msg, ...) const MY_ATTRIBUTE((format(printf, 5, 6))); void va_report(loglevel level, int err_code, const char *prefix_msg, const char *msg, va_list v_args) const MY_ATTRIBUTE((format(printf, 5, 0))); /** Clear errors. They will not show up under SHOW REPLICA STATUS. */ void clear_error() { mysql_mutex_lock(&err_lock); m_last_error.clear(); mysql_mutex_unlock(&err_lock); } /** Check if the current error is of temporary nature or not. */ int has_temporary_error(THD *thd, uint error_arg = 0, bool *silent = nullptr) const; /** Error information structure. */ class Error { friend class Slave_reporting_capability; public: Error() { clear(); } void clear() { number = 0; message[0] = '\0'; timestamp[0] = '\0'; } void update_timestamp() { struct tm tm_tmp; struct tm *start; time_t tt_tmp; skr = my_getsystime() / 10; tt_tmp = skr / 1000000; localtime_r(&tt_tmp, &tm_tmp); start = &tm_tmp; snprintf(timestamp, sizeof(timestamp), "%02d%02d%02d %02d:%02d:%02d", start->tm_year % 100, start->tm_mon + 1, start->tm_mday, start->tm_hour, start->tm_min, start->tm_sec); timestamp[15] = '\0'; } /** Error code */ uint32 number; /** Error message */ char message[MAX_SLAVE_ERRMSG]; /** Error timestamp as string */ char timestamp[64]; /** Error timestamp in microseconds. Used in performance_schema */ ulonglong skr; }; Error const &last_error() const { return m_last_error; } bool is_error() const { return last_error().number != 0; } /* For MSR, there is a need to introduce error messages per channel. Instead of changing the error messages in share/messages_to_error_log.txt to introduce the clause, FOR CHANNEL "%s", we construct a string like this. There might be problem with a client applications which could print error messages and see no %s. @TODO: fix this. */ virtual const char *get_for_channel_str(bool upper_case) const = 0; virtual ~Slave_reporting_capability() = 0; protected: virtual void do_report(loglevel level, int err_code, const char *msg, va_list v_args) const MY_ATTRIBUTE((format(printf, 4, 0))); virtual void do_report(loglevel level, int err_code, const Gtid_specification *gtid_next, const char *msg, va_list v_args) const MY_ATTRIBUTE((format(printf, 5, 0))); /** Last error produced by the I/O or SQL thread respectively. */ mutable Error m_last_error; private: char const *const m_thread_name; // not implemented Slave_reporting_capability(const Slave_reporting_capability &rhs); Slave_reporting_capability &operator=(const Slave_reporting_capability &rhs); }; inline void Slave_reporting_capability::do_report(loglevel level, int err_code, const char *msg, va_list v_args) const { va_report(level, err_code, nullptr, msg, v_args); } inline void Slave_reporting_capability::do_report(loglevel level, int err_code, const Gtid_specification *, const char *msg, va_list v_args) const { va_report(level, err_code, nullptr, msg, v_args); } #endif // RPL_REPORTING_H