MySQL 8.4.3
Source Code Documentation
binlog.h
Go to the documentation of this file.
1#ifndef BINLOG_H_INCLUDED
2/* Copyright (c) 2010, 2024, Oracle and/or its affiliates.
3
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License, version 2.0,
6 as published by the Free Software Foundation.
7
8 This program is designed to work with certain software (including
9 but not limited to OpenSSL) that is licensed under separate terms,
10 as designated in a particular file or component or in included license
11 documentation. The authors of MySQL hereby grant you an additional
12 permission to link the program and your derivative works with the
13 separately licensed software that they have either included with
14 the program or referenced in the documentation.
15
16 This program is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 GNU General Public License, version 2.0, for more details.
20
21 You should have received a copy of the GNU General Public License
22 along with this program; if not, write to the Free Software
23 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */
24
25#define BINLOG_H_INCLUDED
26
27#include <string.h>
28#include <sys/types.h>
29#include <time.h>
30#include <atomic>
31#include <string_view>
32#include <utility>
33
34#include "my_dbug.h"
35#include "my_inttypes.h"
36#include "my_io.h"
37#include "my_sharedlib.h"
38#include "my_sys.h"
39#include "mysql/binlog/event/binlog_event.h" // enum_binlog_checksum_alg
49#include "mysql_com.h" // Item_result
50#include "sql/binlog_reader.h" // Binlog_file_reader
53#include "sql/tc_log.h" // TC_LOG
54#include "sql/transaction_info.h" // Transaction_ctx
55#include "thr_mutex.h"
56
59class Gtid_set;
60class Ha_trx_info;
61class Log_event;
62class Master_info;
63class Relay_log_info;
64class Rows_log_event;
65class Tsid_map;
66class THD;
67class Transaction_boundary_parser;
69class user_var_entry;
71
72struct Gtid;
73
75
76/*
77 Maximum unique log filename extension.
78 Note: setting to 0x7FFFFFFF due to atol windows
79 overflow/truncate.
80 */
81#define MAX_LOG_UNIQUE_FN_EXT 0x7FFFFFFF
82
83/*
84 Maximum allowed unique log filename extension for
85 RESET BINARY LOGS AND GTIDS command - 2 Billion
86 */
87#define MAX_ALLOWED_FN_EXT_RESET_BIN_LOGS 2000000000
88
91 char *value;
92 ulong length;
96};
97
98/* log info errors */
99#define LOG_INFO_EOF -1
100#define LOG_INFO_IO -2
101#define LOG_INFO_INVALID -3
102#define LOG_INFO_SEEK -4
103#define LOG_INFO_MEM -6
104#define LOG_INFO_FATAL -7
105#define LOG_INFO_IN_USE -8
106#define LOG_INFO_EMFILE -9
107#define LOG_INFO_BACKUP_LOCK -10
108#define LOG_INFO_NOT_IN_USE -11
109
110/* bitmap to MYSQL_BIN_LOG::close() */
111#define LOG_CLOSE_INDEX 1
112#define LOG_CLOSE_TO_BE_OPENED 2
113#define LOG_CLOSE_STOP_EVENT 4
114
115struct LOG_INFO {
119 bool fatal; // if the purge happens to give us a negative offset
120 int entry_index; // used in purge_logs(), calculatd in find_log_pos().
126 pos(0),
127 fatal(false),
128 entry_index(0),
130 thread_id(0) {
131 memset(log_file_name, 0, FN_REFLEN);
132 }
133};
134
135/*
136 TODO use mmap instead of IO_CACHE for binlog
137 (mmap+fsync is two times faster than write+fsync)
138*/
139class MYSQL_BIN_LOG : public TC_LOG {
140 public:
141 class Binlog_ofile;
142
143 private:
145
146 /* LOCK_log is inited by init_pthread_objects() */
148 char *name;
150 char db[NAME_LEN + 1];
153
154 /** Instrumentation key to use for file io in @c log_file */
156 /** The instrumentation key to use for @ LOCK_log. */
158 /** The instrumentation key to use for @ LOCK_index. */
160 /** The instrumentation key to use for @ LOCK_binlog_end_pos. */
162 /** The PFS instrumentation key for @ LOCK_commit_queue. */
164 /** The PFS instrumentation key for @ LOCK_after_commit_queue. */
166 /** The PFS instrumentation key for @ LOCK_done. */
168 /** The PFS instrumentation key for @ LOCK_flush_queue. */
170 /** The PFS instrumentation key for @ LOCK_sync_queue. */
172 /** The PFS instrumentation key for @ LOCK_wait_for_group_turn. */
174 /** The PFS instrumentation key for @ COND_done. */
176 /** The PFS instrumentation key for @ COND_flush_queue. */
178 /** The instrumentation key to use for @ LOCK_commit. */
180 /** The instrumentation key to use for @ LOCK_after_commit. */
182 /** The instrumentation key to use for @ LOCK_sync. */
184 /** The instrumentation key to use for @ LOCK_xids. */
186 /** The instrumentation key to use for @ m_key_LOCK_log_info. */
188 /** The instrumentation key to use for @ update_cond. */
190 /** The instrumentation key to use for @ prep_xids_cond. */
192 /** The PFS instrumentation key for @ COND_wait_for_group_turn. */
194 /** The instrumentation key to use for opening the log file. */
196 /** The instrumentation key to use for opening the log index file. */
198 /** The instrumentation key to use for opening a log cache file. */
200 /** The instrumentation key to use for opening a log index cache file. */
202
203 /* POSIX thread objects are inited by init_pthread_objects() */
211
212 std::atomic<my_off_t> atomic_binlog_end_pos;
216 /*
217 crash_safe_index_file is temp file used for guaranteeing
218 index file crash safe when master server restarts.
219 */
222 /*
223 purge_file is a temp file used in purge_logs so that the index file
224 can be updated before deleting files from disk, yielding better crash
225 recovery. It is created on demand the first time purge_logs is called
226 and then reused for subsequent calls. It is cleaned up in cleanup().
227 */
230 /*
231 The max size before rotation (usable only if log_type == LOG_BIN: binary
232 logs and relay logs).
233 For a binlog, max_size should be max_binlog_size.
234 For a relay log, it should be max_relay_log_size if this is non-zero,
235 max_binlog_size otherwise.
236 max_size is set in init(), and dynamically changed (when one does SET
237 GLOBAL MAX_BINLOG_SIZE|MAX_RELAY_LOG_SIZE) by fix_max_binlog_size and
238 fix_max_relay_log_size).
239 */
240 ulong max_size;
241
242 // current file sequence number for load data infile binary logging
244
245 /* pointer to the sync period variable, for binlog this will be
246 sync_binlog_period, for relay log this will be
247 sync_relay_log_period
248 */
251
253 std::atomic<int32> m_atomic_prep_xids{0};
254
255 /**
256 Increment the prepared XID counter.
257 */
258 void inc_prep_xids(THD *thd);
259
260 /**
261 Decrement the prepared XID counter.
262
263 Signal m_prep_xids_cond if the counter reaches zero.
264 */
265 void dec_prep_xids(THD *thd);
266
268
269 inline uint get_sync_period() { return *sync_period_ptr; }
270
271 public:
272 /*
273 This is used to start writing to a new log file. The difference from
274 new_file() is locking. new_file_without_locking() does not acquire
275 LOCK_log.
276 */
278 Format_description_log_event *extra_description_event);
279
280 /**
281 Checks whether binlog caches are disabled (binlog does not cache data) or
282 empty in case binloggging is enabled in the current call to this function.
283 This function may be safely called in case binlogging is disabled.
284 @retval true binlog local caches are empty or disabled and binlogging is
285 enabled
286 @retval false binlog local caches are enabled and contain data or binlogging
287 is disabled
288 */
290
291 private:
292 int new_file_impl(bool need_lock,
293 Format_description_log_event *extra_description_event);
294
295 bool open(PSI_file_key log_file_key, const char *log_name,
296 const char *new_name, uint32 new_index_number);
297 bool init_and_set_log_file_name(const char *log_name, const char *new_name,
298 uint32 new_index_number);
299 int generate_new_name(char *new_name, const char *log_name,
300 uint32 new_index_number = 0);
301 /**
302 * Read binary log stream header and Format_desc event from
303 * binlog_file_reader. Check for LOG_EVENT_BINLOG_IN_USE_F flag.
304 * @param[in] binlog_file_reader a Binlog_file_reader
305 * @return true - LOG_EVENT_BINLOG_IN_USE_F is set
306 * false - LOG_EVENT_BINLOG_IN_USE_F is not set or an error occurred
307 * while reading log events
308 */
309 bool read_binlog_in_use_flag(Binlog_file_reader &binlog_file_reader);
310
311 protected:
312 /**
313 @brief Notifies waiting threads that binary log has been updated
314 */
315 void signal_update();
316
317 public:
318 const char *generate_name(const char *log_name, const char *suffix,
319 char *buff);
320 bool is_open() const { return atomic_log_state != LOG_CLOSED; }
321
322 /// @brief Obtains the list of logs from the index file
323 /// @return List of log filenames
324 std::pair<std::list<std::string>, mysql::utils::Error> get_filename_list();
325
326 /* This is relay log */
328
329 uint8 checksum_alg_reset; // to contain a new value when binlog is rotated
330 /*
331 Holds the last seen in Relay-Log FD's checksum alg value.
332 The initial value comes from the slave's local FD that heads
333 the very first Relay-Log file. In the following the value may change
334 with each received master's FD_m.
335 Besides to be used in verification events that IO thread receives
336 (except the 1st fake Rotate, see @c Master_info:: checksum_alg_before_fd),
337 the value specifies if/how to compute checksum for slave's local events
338 and the first fake Rotate (R_f^1) coming from the master.
339 R_f^1 needs logging checksum-compatibly with the RL's heading FD_s.
340
341 Legends for the checksum related comments:
342
343 FD - Format-Description event,
344 R - Rotate event
345 R_f - The fake Rotate event
346 E - An arbitrary event
347
348 The underscore indexes for any event
349 `_s' - Indicates the event is generated by the Replica
350 `_m' - By the Source
351
352 Two special underscore indexes of FD:
353 FD_q - Format Description event for queuing (relay-logging)
354 FD_e - Format Description event for executing (relay-logging)
355
356 Upper indexes:
357 E^n - n:th event is a sequence
358
359 RL - Relay Log
360 (A) - checksum algorithm descriptor value
361 FD.(A) - the value of (A) in FD
362 */
364
365 MYSQL_BIN_LOG(uint *sync_period, bool relay_log = false);
366 ~MYSQL_BIN_LOG() override;
367
369 PSI_mutex_key key_LOCK_index, PSI_mutex_key key_LOCK_commit,
370 PSI_mutex_key key_LOCK_commit_queue, PSI_mutex_key key_LOCK_after_commit,
371 PSI_mutex_key key_LOCK_after_commit_queue, PSI_mutex_key key_LOCK_done,
372 PSI_mutex_key key_LOCK_flush_queue, PSI_mutex_key key_LOCK_log,
373 PSI_mutex_key key_LOCK_binlog_end_pos, PSI_mutex_key key_LOCK_sync,
374 PSI_mutex_key key_LOCK_sync_queue, PSI_mutex_key key_LOCK_xids,
375 PSI_mutex_key key_LOCK_log_info,
376 PSI_mutex_key key_LOCK_wait_for_group_turn, PSI_cond_key key_COND_done,
377 PSI_cond_key key_COND_flush_queue, PSI_cond_key key_update_cond,
378 PSI_cond_key key_prep_xids_cond,
379 PSI_cond_key key_COND_wait_for_group_turn, PSI_file_key key_file_log,
380 PSI_file_key key_file_log_index, PSI_file_key key_file_log_cache,
381 PSI_file_key key_file_log_index_cache) {
382 m_key_COND_done = key_COND_done;
383 m_key_COND_flush_queue = key_COND_flush_queue;
384
385 m_key_LOCK_commit_queue = key_LOCK_commit_queue;
386 m_key_LOCK_after_commit_queue = key_LOCK_after_commit_queue;
387 m_key_LOCK_done = key_LOCK_done;
388 m_key_LOCK_flush_queue = key_LOCK_flush_queue;
389 m_key_LOCK_sync_queue = key_LOCK_sync_queue;
390
391 m_key_LOCK_index = key_LOCK_index;
392 m_key_LOCK_log = key_LOCK_log;
393 m_key_LOCK_binlog_end_pos = key_LOCK_binlog_end_pos;
394 m_key_LOCK_commit = key_LOCK_commit;
395 m_key_LOCK_after_commit = key_LOCK_after_commit;
396 m_key_LOCK_sync = key_LOCK_sync;
397 m_key_LOCK_xids = key_LOCK_xids;
398 m_key_LOCK_log_info = key_LOCK_log_info;
399 m_key_update_cond = key_update_cond;
400 m_key_prep_xids_cond = key_prep_xids_cond;
401 m_key_file_log = key_file_log;
402 m_key_file_log_index = key_file_log_index;
403 m_key_file_log_cache = key_file_log_cache;
404 m_key_file_log_index_cache = key_file_log_index_cache;
405
406 m_key_LOCK_wait_for_group_turn = key_LOCK_wait_for_group_turn;
407 m_key_COND_wait_for_group_turn = key_COND_wait_for_group_turn;
408 }
409
410 public:
411 /** Manage the MTS dependency tracking */
413
414 /**
415 Find the oldest binary log referenced by the index file
416
417 @param[out] binlog_file_name the file name of oldest log found
418 @param[out] errmsg the error message outputted, which is left untouched
419 if the function returns false
420 @return false on success, true on error.
421 */
422 bool find_first_log(std::string &binlog_file_name, std::string &errmsg);
423
424 /**
425 Find the oldest binary log that contains any GTID that
426 is not in the given gtid set.
427
428 @param[out] binlog_file_name the file name of oldest binary log found
429 @param[in] gtid_set the given gtid set
430 @param[out] first_gtid the first GTID information from the binary log
431 file returned at binlog_file_name
432 @param[out] errmsg the error message outputted, which is left untouched
433 if the function returns false
434 @return false on success, true on error.
435 */
436 bool find_first_log_not_in_gtid_set(char *binlog_file_name,
437 const Gtid_set *gtid_set,
438 Gtid *first_gtid, std::string &errmsg);
439
440 /**
441 Reads the set of all GTIDs in the binary/relay log, and the set
442 of all lost GTIDs in the binary log, and stores each set in
443 respective argument.
444
445 @param all_gtids Will be filled with all GTIDs in this binary/relay
446 log.
447 @param lost_gtids Will be filled with all GTIDs in the
448 Previous_gtids_log_event of the first binary log that has a
449 Previous_gtids_log_event. This is requested to binary logs but not
450 to relay logs.
451 @param verify_checksum If true, checksums will be checked.
452 @param need_lock If true, LOCK_log, LOCK_index, and
453 global_tsid_lock->wrlock are acquired; otherwise they are asserted
454 to be taken already.
455 @param [out] trx_parser This will be used to return the actual
456 relaylog transaction parser state because of the possibility
457 of partial transactions.
458 @param [out] partial_trx If a transaction was left incomplete
459 on the relaylog, its GTID information should be returned to be
460 used in the case of the rest of the transaction be added to the
461 relaylog.
462 @param is_server_starting True if the server is starting.
463 @return false on success, true on error.
464 */
465 bool init_gtid_sets(
466 Gtid_set *all_gtids, Gtid_set *lost_gtids, bool verify_checksum,
467 bool need_lock,
469 Gtid_monitoring_info *partial_trx, bool is_server_starting = false);
470
471 void set_previous_gtid_set_relaylog(Gtid_set *previous_gtid_set_param) {
472 assert(is_relay_log);
473 previous_gtid_set_relaylog = previous_gtid_set_param;
474 }
475 /**
476 If the thread owns a GTID, this function generates an empty
477 transaction and releases ownership of the GTID.
478
479 - If the binary log is disabled for this thread, the GTID is
480 inserted directly into the mysql.gtid_executed table and the
481 GTID is included in @@global.gtid_executed. (This only happens
482 for DDL, since DML will save the GTID into table and release
483 ownership inside ha_commit_trans.)
484
485 - If the binary log is enabled for this thread, an empty
486 transaction consisting of GTID, BEGIN, COMMIT is written to the
487 binary log, the GTID is included in @@global.gtid_executed, and
488 the GTID is added to the mysql.gtid_executed table on the next
489 binlog rotation.
490
491 This function must be called by any committing statement (COMMIT,
492 implicitly committing statements, or Xid_log_event), after the
493 statement has completed execution, regardless of whether the
494 statement updated the database.
495
496 This logic ensures that an empty transaction is generated for the
497 following cases:
498
499 - Explicit empty transaction:
500 SET GTID_NEXT = 'UUID:NUMBER'; BEGIN; COMMIT;
501
502 - Transaction or DDL that gets completely filtered out in the
503 slave thread.
504
505 @param thd The committing thread
506
507 @retval 0 Success
508 @retval nonzero Error
509 */
510 int gtid_end_transaction(THD *thd);
511 /**
512 Re-encrypt previous existent binary/relay logs as below.
513 Starting from the next to last entry on the index file, iterating
514 down to the first one:
515 - If the file is encrypted, re-encrypt it. Otherwise, skip it.
516 - If failed to open the file, report an error.
517
518 @retval False Success
519 @retval True Error
520 */
521 bool reencrypt_logs();
522
523 private:
524 std::atomic<enum_log_state> atomic_log_state{LOG_CLOSED};
525
526 /* The previous gtid set in relay log. */
528
529 int open(const char *opt_name) override { return open_binlog(opt_name); }
530
531 /**
532 Enter a stage of the ordered commit procedure.
533
534 Entering is stage is done by:
535
536 - Atomically entering a queue of THD objects (which is just one for
537 the first phase).
538
539 - If the queue was empty, the thread is the leader for that stage
540 and it should process the entire queue for that stage.
541
542 - If the queue was not empty, the thread is a follower and can go
543 waiting for the commit to finish.
544
545 The function will lock the stage mutex if the calling thread was designated
546 leader for the phase.
547
548 @param[in] thd Session structure
549 @param[in] stage The stage to enter
550 @param[in] queue Thread queue for the stage
551 @param[in] leave_mutex Mutex that will be released when changing stage
552 @param[in] enter_mutex Mutex that will be taken when changing stage
553
554 @retval true In case this thread did not become leader, the function
555 returns true *after* the leader has completed the commit
556 on its behalf, so the thread should continue doing the
557 thread-local processing after the commit
558 (i.e. call finish_commit).
559
560 @retval false The thread is the leader for the stage and should do
561 the processing.
562 */
564 mysql_mutex_t *leave_mutex, mysql_mutex_t *enter_mutex);
565 std::pair<int, my_off_t> flush_thread_caches(THD *thd);
566 int flush_cache_to_file(my_off_t *flush_end_pos);
567 int finish_commit(THD *thd);
568 std::pair<bool, bool> sync_binlog_file(bool force);
570 void process_after_commit_stage_queue(THD *thd, THD *first);
571
572 /**
573 Set thread variables used while flushing a transaction.
574
575 @param[in] thd thread whose variables need to be set
576 @param[in] all This is @c true if this is a real transaction commit, and
577 @c false otherwise.
578 @param[in] skip_commit
579 This is @c true if the call to @c ha_commit_low should
580 be skipped (it is handled by the caller somehow) and @c
581 false otherwise (the normal case).
582 */
583 void init_thd_variables(THD *thd, bool all, bool skip_commit);
584
585 /**
586 Fetch and empty BINLOG_FLUSH_STAGE and COMMIT_ORDER_FLUSH_STAGE flush queues
587 and flush transactions to the disk, and unblock threads executing slave
588 preserve commit order.
589
590 @param[in] check_and_skip_flush_logs
591 if false then flush prepared records of transactions to the log
592 of storage engine.
593 if true then flush prepared records of transactions to the log
594 of storage engine only if COMMIT_ORDER_FLUSH_STAGE queue is
595 non-empty.
596
597 @return Pointer to the first session of the BINLOG_FLUSH_STAGE stage queue.
598 */
600 const bool check_and_skip_flush_logs = false);
601
602 /**
603 Execute the flush stage.
604
605 @param[out] total_bytes_var Pointer to variable that will be set to total
606 number of bytes flushed, or NULL.
607
608 @param[out] out_queue_var Pointer to the sessions queue in flush stage.
609
610 @return Error code on error, zero on success
611 */
612 int process_flush_stage_queue(my_off_t *total_bytes_var, THD **out_queue_var);
613
614 /**
615 Flush and commit the transaction.
616
617 This will execute an ordered flush and commit of all outstanding
618 transactions and is the main function for the binary log group
619 commit logic. The function performs the ordered commit in four stages.
620
621 Pre-condition: transactions should have called ha_prepare_low, using
622 HA_IGNORE_DURABILITY, before entering here.
623
624 Stage#0 implements replica-preserve-commit-order for applier threads that
625 write the binary log. i.e. it forces threads to enter the queue in the
626 correct commit order.
627
628 The stage#1 flushes the caches to the binary log and under
629 LOCK_log and marks all threads that were flushed as not pending.
630
631 The stage#2 syncs the binary log for all transactions in the group.
632
633 The stage#3 executes under LOCK_commit and commits all transactions in
634 order.
635
636 There are three queues of THD objects: one for each stage.
637 The Commit_order_manager maintains it own queue and its own order for the
638 commit. So Stage#0 doesn't maintain separate StageID.
639
640 When a transaction enters a stage, it adds itself to a queue. If the queue
641 was empty so that this becomes the first transaction in the queue, the
642 thread is the *leader* of the queue. Otherwise it is a *follower*. The
643 leader will do all work for all threads in the queue, and the followers
644 will wait until the last stage is finished.
645
646 Stage 0 (SLAVE COMMIT ORDER):
647 1. If replica-preserve-commit-order and is slave applier worker thread, then
648 waits until its turn to commit i.e. till it is on the top of the queue.
649 2. When it reaches top of the queue, it signals next worker in the commit
650 order queue to awake.
651
652 Stage 1 (FLUSH):
653 1. Sync the engines (ha_flush_logs), since they prepared using non-durable
654 settings (HA_IGNORE_DURABILITY).
655 2. Generate GTIDs for all transactions in the queue.
656 3. Write the session caches for all transactions in the queue to the binary
657 log.
658 4. Increment the counter of prepared XIDs.
659
660 Stage 2 (SYNC):
661 1. If it is time to sync, based on the sync_binlog option, sync the binlog.
662 2. If sync_binlog==1, signal dump threads that they can read up to the
663 position after the last transaction in the queue
664
665 Stage 3 (COMMIT):
666 This is performed by each thread separately, if binlog_order_commits=0.
667 Otherwise by the leader does it for all threads.
668 1. Call the after_sync hook.
669 2. update the max_committed counter in the dependency_tracker
670 3. call ha_commit_low
671 4. Call the after_commit hook
672 5. Update gtids
673 6. Decrement the counter of prepared transactions
674
675 If the binary log needs to be rotated, it is done after this. During
676 rotation, it takes a lock that prevents new commit groups from executing the
677 flush stage, and waits until the counter of prepared transactions becomes 0,
678 before it creates the new file.
679
680 @param[in] thd Session to commit transaction for
681 @param[in] all This is @c true if this is a real transaction commit, and
682 @c false otherwise.
683 @param[in] skip_commit
684 This is @c true if the call to @c ha_commit_low should
685 be skipped and @c false otherwise (the normal case).
686 */
687 int ordered_commit(THD *thd, bool all, bool skip_commit = false);
688 void handle_binlog_flush_or_sync_error(THD *thd, bool need_lock_log,
689 const char *message);
691 class Binlog_event_writer *writer);
693
694 public:
695 int open_binlog(const char *opt_name);
696 void close() override;
697 enum_result commit(THD *thd, bool all) override;
698 int rollback(THD *thd, bool all) override;
699 bool truncate_relaylog_file(Master_info *mi, my_off_t valid_pos);
700 int prepare(THD *thd, bool all) override;
701#if defined(MYSQL_SERVER)
702
705 bool is_transactional);
706
707#endif /* defined(MYSQL_SERVER) */
710 /// @brief Adds bytes written in the current relay log into the variable
711 /// handling the total number of bytes acquired by the replica. Resets the
712 /// counter of bytes written. If requested by caller,
713 /// acquires relay log space lock
714 /// @param rli Pointer to the applier metadata object
715 /// @param need_log_space_lock Information on whether to acquire the
716 /// lock protecting data responsible for keeping the relay log space at bay
717 void harvest_bytes_written(Relay_log_info *rli, bool need_log_space_lock);
718 void set_max_size(ulong max_size_arg);
719
720 void update_binlog_end_pos(bool need_lock = true);
721 void update_binlog_end_pos(const char *file, my_off_t pos);
722
723 /**
724 Wait until we get a signal that the binary log has been updated.
725
726 NOTES
727 @param[in] timeout a pointer to a timespec;
728 NULL means to wait w/o timeout.
729 @retval 0 if got signalled on update
730 @retval non-0 if wait timeout elapsed
731 @note
732 LOCK_binlog_end_pos must be owned before calling this function, may be
733 temporarily released while the thread is waiting and is reacquired before
734 returning from the function
735 */
736 int wait_for_update(const std::chrono::nanoseconds &timeout);
737
738 /**
739 Wait until we get a signal that the binary log has been updated.
740 @retval 0 success
741 @note
742 LOCK_binlog_end_pos must be owned before calling this function, may be
743 temporarily released while the thread is waiting and is reacquired before
744 returning from the function
745 */
746 int wait_for_update();
747
748 public:
750 void cleanup();
751 /**
752 Create a new binary log.
753 @param log_name Name of binlog
754 @param new_name Name of binlog, too. todo: what's the difference
755 between new_name and log_name?
756 @param max_size_arg The size at which this binlog will be rotated.
757 @param null_created_arg If false, and a Format_description_log_event
758 is written, then the Format_description_log_event will have the
759 timestamp 0. Otherwise, it the timestamp will be the time when the
760 event was written to the log.
761 @param need_lock_index If true, LOCK_index is acquired; otherwise
762 LOCK_index must be taken by the caller.
763 @param need_tsid_lock If true, the read lock on global_tsid_lock
764 will be acquired. Otherwise, the caller must hold the read lock
765 on global_tsid_lock.
766 @param extra_description_event The master's FDE to be written by the I/O
767 thread while creating a new relay log file. This should be NULL for
768 binary log files.
769 @param new_index_number The binary log file index number to start from
770 after the RESET BINARY LOGS AND GTIDS command is called.
771 */
772 bool open_binlog(const char *log_name, const char *new_name,
773 ulong max_size_arg, bool null_created_arg,
774 bool need_lock_index, bool need_tsid_lock,
775 Format_description_log_event *extra_description_event,
776 uint32 new_index_number = 0);
777 bool open_index_file(const char *index_file_name_arg, const char *log_name,
778 bool need_lock_index);
779 /* Use this to start writing a new log file */
780 int new_file(Format_description_log_event *extra_description_event);
781
782 bool write_event(Log_event *event_info);
783 bool write_cache(THD *thd, class binlog_cache_data *cache_data,
784 class Binlog_event_writer *writer);
785 /**
786 Assign automatic generated GTIDs for all commit group threads in the flush
787 stage having gtid_next.type == AUTOMATIC_GTID.
788
789 @param first_seen The first thread seen entering the flush stage.
790 @return Returns false if succeeds, otherwise true is returned.
791 */
793 bool write_transaction(THD *thd, binlog_cache_data *cache_data,
794 Binlog_event_writer *writer,
795 bool parallelization_barrier);
796
797 /**
798 Write a dml into statement cache and then flush it into binlog. It writes
799 Gtid_log_event and BEGIN, COMMIT automatically.
800
801 It is aimed to handle cases of "background" logging where a statement is
802 logged indirectly, like "TRUNCATE TABLE a_memory_table". So don't use it on
803 any normal statement.
804
805 @param[in] thd the THD object of current thread.
806 @param[in] stmt the DML statement.
807 @param[in] stmt_len the length of the DML statement.
808 @param[in] sql_command the type of SQL command.
809
810 @return Returns false if succeeds, otherwise true is returned.
811 */
812 bool write_stmt_directly(THD *thd, const char *stmt, size_t stmt_len,
813 enum enum_sql_command sql_command);
814
815 void report_cache_write_error(THD *thd, bool is_transactional);
816 bool check_write_error(const THD *thd);
819 void start_union_events(THD *thd, query_id_t query_id_param);
820 void stop_union_events(THD *thd);
821 bool is_query_in_union(THD *thd, query_id_t query_id_param);
822
823 bool write_buffer(const char *buf, uint len, Master_info *mi);
824 bool write_event(Log_event *ev, Master_info *mi);
825
826 /**
827 Logging XA commit/rollback of a prepared transaction.
828
829 It fills in the appropriate event in the statement cache whenever xid
830 state is marked with is_binlogged() flag that indicates the prepared
831 part of the transaction must've been logged.
832
833 About early returns from the function:
834 - ONE_PHASE option to XA-COMMIT is handled to skip writing XA-commit
835 event now.
836 - check is for the read-only XA that is not to be logged.
837
838 @param thd THD handle
839 @return error code, 0 success
840 */
841 int write_xa_to_cache(THD *thd);
842
843 ///
844 /// Write an incident and call commit.
845 ///
846 /// The incident is written by marking the transaction cache as having an
847 /// incident and then commit it to binlog. During commit, the flush stage will
848 /// write and Incident_log_event and preceding Gtid_log_event to give the
849 /// incident a proper GTID. The incident will also cause the binlog to be
850 /// rotated and check if some purge is applicable.
851 ///
852 /// @param[in] thd the THD object of current thread.
853 /// @param[in] incident_message A message describing the incident.
854 ///
855 /// @return Returns false if succeeds, otherwise true is returned.
856 ///
857 bool write_incident_commit(THD *thd, std::string_view incident_message);
858
859 private:
861
862 public:
863 /**
864 * Truncte log file and clear LOG_EVENT_BINLOG_IN_USE_F when update is set.
865 * @param[in] log_name name of the log file to be trunacted
866 * @param[in] valid_pos position at which to truncate the log file
867 * @param[in] binlog_size length of the log file before truncated
868 * @param[in] update should the LOG_EVENT_BINLOG_IN_USE_F flag be cleared
869 * true - set LOG_EVENT_BINLOG_IN_USE_F to 0
870 * false - do not modify LOG_EVENT_BINLOG_IN_USE_F flag
871 * @return true - sucess, false - failed
872 */
873 bool truncate_update_log_file(const char *log_name, my_off_t valid_pos,
874 my_off_t binlog_size, bool update);
875
876 void make_log_name(char *buf, const char *log_ident);
877 bool is_active(const char *log_file_name) const;
878
879 /// @brief Remove logs from index file, except files between 'start' and
880 /// 'last'
881 /// @details To make it crash safe, we copy the content of the index file
882 /// from index_file_start_offset recorded in log_info to a
883 /// crash safe index file first and then move the crash
884 /// safe index file to the index file.
885 /// @param start_log_info Metadata of the first log to be kept
886 /// in the index file
887 /// @param need_update_threads If we want to update the log coordinates
888 /// of all threads. False for relay logs,
889 /// true otherwise.
890 /// @param last_log_info Metadata of the last log to be kept in the index
891 /// file; nullptr means that all logs after start_log_info will be kept
892 /// @retval
893 /// 0 ok
894 /// @retval
895 /// LOG_INFO_IO Got IO error while reading/writing file
897 bool need_update_threads,
898 LOG_INFO *last_log_info = nullptr);
899 /// @brief Remove logs from index file except logs between first and last
900 /// @param first Filename of the first relay log to be kept in index file
901 /// @param last Filename of the last relay log to be kept in index file
902
903 /// @retval 0 OK
904 /// @retval LOG_INFO_IO Got IO error while reading/writing file
905 /// @retval LOG_INFO_EOF Could not find requested log file (first or last)
906 int remove_logs_outside_range_from_index(const std::string &first,
907 const std::string &last);
908 int rotate(bool force_rotate, bool *check_purge);
909
910 /**
911 @brief This function runs automatic purge if the conditions to meet
912 automatic purge are met. Such conditions are: log is open, instance is not
913 locked for backup and automatic purge is enabled.
914
915 If all conditions are met, purge is done according to the configuration
916 of the purge window.
917 */
918 void auto_purge();
919
920 /**
921 @brief This member function is to be called at server startup. It checks if
922 purge can be done and does if it can.
923 */
925 int rotate_and_purge(THD *thd, bool force_rotate);
926
927 bool flush();
928 /**
929 Flush binlog cache and synchronize to disk.
930
931 This function flushes events in binlog cache to binary log file,
932 it will do synchronizing according to the setting of system
933 variable 'sync_binlog'. If file is synchronized, @c synced will
934 be set to 1, otherwise 0.
935
936 @param[in] force if true, ignores the 'sync_binlog' and synchronizes the
937 file.
938
939 @retval 0 Success
940 @retval other Failure
941 */
942 bool flush_and_sync(const bool force = false);
943 int purge_logs(const char *to_log, bool included, bool need_lock_index,
944 bool need_update_threads, ulonglong *decrease_log_space,
945 bool auto_purge);
946 int purge_logs_before_date(time_t purge_time, bool auto_purge);
947 int set_crash_safe_index_file_name(const char *base_file_name);
950 int add_log_to_index(uchar *log_file_name, size_t name_len,
951 bool need_lock_index);
952 int move_crash_safe_index_file_to_index_file(bool need_lock_index);
953 int set_purge_index_file_name(const char *base_file_name);
958 int register_purge_index_entry(const char *entry);
959 int register_create_index_entry(const char *entry);
960 int purge_index_entry(THD *thd, ulonglong *decrease_log_space,
961 bool need_lock_index);
962 bool reset_logs(THD *thd, bool delete_only = false);
963 void close(uint exiting, bool need_lock_log, bool need_lock_index);
964
965 // iterating through the log index file
966 int find_log_pos(LOG_INFO *linfo, const char *log_name, bool need_lock_index);
967 int find_next_log(LOG_INFO *linfo, bool need_lock_index);
968 int find_next_relay_log(char log_name[FN_REFLEN + 1]);
969 int get_current_log(LOG_INFO *linfo, bool need_lock_log = true);
970 int raw_get_current_log(LOG_INFO *linfo);
971 uint next_file_id();
972 /**
973 Retrieves the contents of the index file associated with this log object
974 into an `std::list<std::string>` object. The order held by the index file is
975 kept.
976
977 @param need_lock_index whether or not the lock over the index file should be
978 acquired inside the function.
979
980 @return a pair: a function status code; a list of `std::string` objects with
981 the content of the log index file.
982 */
983 std::pair<int, std::list<std::string>> get_log_index(
984 bool need_lock_index = true);
985 inline char *get_index_fname() { return index_file_name; }
986 inline char *get_log_fname() { return log_file_name; }
987 const char *get_name() const { return name; }
988 inline mysql_mutex_t *get_log_lock() { return &LOCK_log; }
992 inline mysql_cond_t *get_log_cond() { return &update_cond; }
994
997 inline IO_CACHE *get_index_file() { return &index_file; }
998
999 /**
1000 Function to report the missing GTIDs.
1001
1002 This function logs the missing transactions on master to its error log
1003 as a warning. If the missing GTIDs are too long to print in a message,
1004 it suggests the steps to extract the missing transactions.
1005
1006 This function also informs slave about the GTID set sent by the slave,
1007 transactions missing on the master and few suggestions to recover from
1008 the error. This message shall be wrapped by
1009 ER_SOURCE_FATAL_ERROR_READING_BINLOG on slave and will be logged as an
1010 error.
1011
1012 This function will be called from mysql_binlog_send() function.
1013
1014 @param slave_executed_gtid_set GTID set executed by slave
1015 @param errmsg Pointer to the error message
1016 */
1017 void report_missing_purged_gtids(const Gtid_set *slave_executed_gtid_set,
1018 std::string &errmsg);
1019
1020 /**
1021 Function to report the missing GTIDs.
1022
1023 This function logs the missing transactions on master to its error log
1024 as a warning. If the missing GTIDs are too long to print in a message,
1025 it suggests the steps to extract the missing transactions.
1026
1027 This function also informs slave about the GTID set sent by the slave,
1028 transactions missing on the master and few suggestions to recover from
1029 the error. This message shall be wrapped by
1030 ER_SOURCE_FATAL_ERROR_READING_BINLOG on slave and will be logged as an
1031 error.
1032
1033 This function will be called from find_first_log_not_in_gtid_set()
1034 function.
1035
1036 @param previous_gtid_set Previous GTID set found
1037 @param slave_executed_gtid_set GTID set executed by slave
1038 @param errmsg Pointer to the error message
1039 */
1040 void report_missing_gtids(const Gtid_set *previous_gtid_set,
1041 const Gtid_set *slave_executed_gtid_set,
1042 std::string &errmsg);
1044 /*
1045 It is called by the threads (e.g. dump thread, applier thread) which want
1046 to read hot log without LOCK_log protection.
1047 */
1050 return atomic_binlog_end_pos;
1051 }
1055
1056 /**
1057 Deep copy global_tsid_map and gtid_executed.
1058 Both operations are done under LOCK_commit and global_tsid_lock
1059 protection.
1060
1061 @param[out] tsid_map The Tsid_map to which global_tsid_map will
1062 be copied.
1063 @param[out] gtid_set The Gtid_set to which gtid_executed will
1064 be copied.
1065
1066 @return the operation status
1067 @retval 0 OK
1068 @retval !=0 Error
1069 */
1070 int get_gtid_executed(Tsid_map *tsid_map, Gtid_set *gtid_set);
1071
1072 public:
1073 /**
1074 Register LOG_INFO so that log_in_use and adjust_linfo_offsets can
1075 operate on all logs. Note that register_log_info, unregister_log_info,
1076 log_in_use, adjust_linfo_offsets are is used on global mysql_bin_log object.
1077 @param log_info pointer to LOG_INFO which is registred
1078 */
1080 /**
1081 Unregister LOG_INFO when it is no longer needed.
1082 @param log_info pointer to LOG_INFO which is registred
1083 */
1085 /**
1086 Check if any threads use log name.
1087 @note This method expects the LOCK_index to be taken so there are no
1088 concurrent edits against linfo objects being iterated
1089 @param log_name name of a log which is checked for usage
1090
1091 */
1092 int log_in_use(const char *log_name);
1093 /**
1094 Adjust the position pointer in the binary log file for all running replicas.
1095 SYNOPSIS
1096 adjust_linfo_offsets()
1097 purge_offset Number of bytes removed from start of log index file
1098 NOTES
1099 - This is called when doing a PURGE when we delete lines from the
1100 index log file. This method expects the LOCK_index to be taken so there
1101 are no concurrent edits against linfo objects being iterated. REQUIREMENTS
1102 - Before calling this function, we have to ensure that no threads are
1103 using any binary log file before purge_offset.
1104 TODO
1105 - Inform the replica threads that they should sync the position
1106 in the binary log file with flush_relay_log_info.
1107 Now they sync is done for next read.
1108 */
1109 void adjust_linfo_offsets(my_off_t purge_offset);
1110
1111 private:
1113 // Set of log info objects that are in usage and might prevent some other
1114 // operations from executing.
1115 std::set<LOG_INFO *> log_info_set;
1116};
1117
1122};
1123
1125
1126/**
1127 Check if the the transaction is empty.
1128
1129 @param thd The client thread that executed the current statement.
1130
1131 @retval true No changes found in any storage engine
1132 @retval false Otherwise.
1133
1134**/
1135bool is_transaction_empty(THD *thd);
1136/**
1137 Check if the transaction has no rw flag set for any of the storage engines.
1138
1139 @param thd The client thread that executed the current statement.
1140 @param trx_scope The transaction scope to look into.
1141
1142 @retval the number of engines which have actual changes.
1143 */
1145
1146/**
1147 Check if at least one of transacaction and statement binlog caches contains
1148 an empty transaction, other one is empty or contains an empty transaction,
1149 which has two binlog events "BEGIN" and "COMMIT".
1150
1151 @param thd The client thread that executed the current statement.
1152
1153 @retval true At least one of transacaction and statement binlog caches
1154 contains an empty transaction, other one is empty or
1155 contains an empty transaction.
1156 @retval false Otherwise.
1157*/
1159bool trans_has_updated_trans_table(const THD *thd);
1161bool ending_trans(THD *thd, const bool all);
1162bool ending_single_stmt_trans(THD *thd, const bool all);
1163bool trans_cannot_safely_rollback(const THD *thd);
1164bool stmt_cannot_safely_rollback(const THD *thd);
1165
1167
1168/**
1169 @brief Purges the binary log files up to the file name passed as
1170 a paramenter. Purge will not delete the file passed as
1171 an argument.
1172
1173 @param thd The session context.
1174 @param to_log Up to which log file to purge.
1175 @return true if there was an error.
1176 @return false if there was no error.
1177 */
1178bool purge_source_logs_to_file(THD *thd, const char *to_log);
1179
1180bool purge_source_logs_before_date(THD *thd, time_t purge_time);
1182bool mysql_show_binlog_events(THD *thd);
1183void check_binlog_cache_size(THD *thd);
1185bool binlog_enabled();
1186int query_error_code(const THD *thd, bool not_killed);
1187
1188extern const char *log_bin_index;
1189extern const char *log_bin_basename;
1190extern bool opt_binlog_order_commits;
1191extern ulong rpl_read_size;
1192/**
1193 Turns a relative log binary log path into a full path, based on the
1194 opt_bin_logname or opt_relay_logname. Also trims the cr-lf at the
1195 end of the full_path before return to avoid any server startup
1196 problem on windows.
1197
1198 @param from The log name we want to make into an absolute path.
1199 @param to The buffer where to put the results of the
1200 normalization.
1201 @param is_relay_log Switch that makes is used inside to choose which
1202 option (opt_bin_logname or opt_relay_logname) to
1203 use when calculating the base path.
1204
1205 @returns true if a problem occurs, false otherwise.
1206 */
1207
1208bool normalize_binlog_name(char *to, const char *from, bool is_relay_log);
1209
1210#endif /* BINLOG_H_INCLUDED */
int destroy(azio_stream *s)
Definition: azio.cc:371
int64 query_id_t
Definition: binlog.h:72
MYSQL_PLUGIN_IMPORT MYSQL_BIN_LOG mysql_bin_log
Contains the classes representing events occurring in the replication stream.
It owns an allocator, a byte stream, an event_data stream and an event object stream.
Definition: binlog_reader.h:295
Byte container that provides a storage for serializing session binlog events.
Definition: binlog_ostream.h:174
Auxiliary class to copy serialized events to the binary log and correct some of the fields that are n...
Definition: binlog.cc:1415
StageID
Constants for queues for different stages.
Definition: rpl_commit_stage_manager.h:166
For binlog version 4.
Definition: log_event.h:1525
Stores information to monitor a transaction during the different replication stages.
Definition: rpl_gtid.h:1412
Represents a set of GTIDs.
Definition: rpl_gtid.h:1556
Container to hold and allow iteration over a set of Ha_trx_info objects.
Definition: transaction_info.h:503
Either statement transaction or normal transaction - related thread-specific storage engine data.
Definition: transaction_info.h:403
This is the abstract base class for binary log events.
Definition: log_event.h:538
Logical binlog file which wraps and hides the detail of lower layer storage implementation.
Definition: binlog.cc:380
Definition: binlog.h:139
mysql_mutex_t * get_binlog_end_pos_lock()
Definition: binlog.h:1052
const char * get_name() const
Definition: binlog.h:987
mysql_cond_t m_prep_xids_cond
Definition: binlog.h:252
mysql_mutex_t * get_commit_lock()
Definition: binlog.h:990
mysql_mutex_t LOCK_binlog_end_pos
Definition: binlog.h:208
std::atomic< my_off_t > atomic_binlog_end_pos
Definition: binlog.h:212
void unlock_binlog_end_pos()
Definition: binlog.h:1054
PSI_mutex_key m_key_LOCK_xids
The instrumentation key to use for @ LOCK_xids.
Definition: binlog.h:185
mysql_mutex_t LOCK_commit
Definition: binlog.h:205
char db[NAME_LEN+1]
Definition: binlog.h:150
void set_previous_gtid_set_relaylog(Gtid_set *previous_gtid_set_param)
Definition: binlog.h:471
IO_CACHE crash_safe_index_file
Definition: binlog.h:220
void reset_bytes_written()
Definition: binlog.h:709
void lock_binlog_end_pos()
Definition: binlog.h:1053
enum_log_state
Definition: binlog.h:144
@ LOG_OPENED
Definition: binlog.h:144
@ LOG_CLOSED
Definition: binlog.h:144
@ LOG_TO_BE_OPENED
Definition: binlog.h:144
mysql_mutex_t LOCK_index
Definition: binlog.h:204
PSI_mutex_key m_key_COND_done
The PFS instrumentation key for @ COND_done.
Definition: binlog.h:175
mysql_mutex_t LOCK_sync
Definition: binlog.h:207
PSI_mutex_key m_key_LOCK_after_commit
The instrumentation key to use for @ LOCK_after_commit.
Definition: binlog.h:181
PSI_mutex_key m_key_LOCK_commit_queue
The PFS instrumentation key for @ LOCK_commit_queue.
Definition: binlog.h:163
mysql_mutex_t LOCK_after_commit
Definition: binlog.h:206
Binlog_ofile * get_binlog_file()
Definition: binlog.h:993
mysql_mutex_t LOCK_log_info
Definition: binlog.h:1112
int open(const char *opt_name) override
Initialize and open the coordinator log.
Definition: binlog.h:529
mysql_mutex_t * get_log_lock()
Definition: binlog.h:988
bool is_open() const
Definition: binlog.h:320
IO_CACHE purge_index_file
Definition: binlog.h:228
PSI_cond_key m_key_prep_xids_cond
The instrumentation key to use for @ prep_xids_cond.
Definition: binlog.h:191
my_off_t get_binlog_end_pos() const
Definition: binlog.h:1048
void lock_index()
Definition: binlog.h:995
PSI_mutex_key m_key_LOCK_flush_queue
The PFS instrumentation key for @ LOCK_flush_queue.
Definition: binlog.h:169
PSI_mutex_key m_key_LOCK_after_commit_queue
The PFS instrumentation key for @ LOCK_after_commit_queue.
Definition: binlog.h:165
int32 get_prep_xids()
Definition: binlog.h:267
std::atomic< enum_log_state > atomic_log_state
Definition: binlog.h:524
Gtid_set * previous_gtid_set_relaylog
Definition: binlog.h:527
PSI_cond_key m_key_update_cond
The instrumentation key to use for @ update_cond.
Definition: binlog.h:189
void set_psi_keys(PSI_mutex_key key_LOCK_index, PSI_mutex_key key_LOCK_commit, PSI_mutex_key key_LOCK_commit_queue, PSI_mutex_key key_LOCK_after_commit, PSI_mutex_key key_LOCK_after_commit_queue, PSI_mutex_key key_LOCK_done, PSI_mutex_key key_LOCK_flush_queue, PSI_mutex_key key_LOCK_log, PSI_mutex_key key_LOCK_binlog_end_pos, PSI_mutex_key key_LOCK_sync, PSI_mutex_key key_LOCK_sync_queue, PSI_mutex_key key_LOCK_xids, PSI_mutex_key key_LOCK_log_info, PSI_mutex_key key_LOCK_wait_for_group_turn, PSI_cond_key key_COND_done, PSI_cond_key key_COND_flush_queue, PSI_cond_key key_update_cond, PSI_cond_key key_prep_xids_cond, PSI_cond_key key_COND_wait_for_group_turn, PSI_file_key key_file_log, PSI_file_key key_file_log_index, PSI_file_key key_file_log_cache, PSI_file_key key_file_log_index_cache)
Definition: binlog.h:368
char * get_index_fname()
Definition: binlog.h:985
bool write_error
Definition: binlog.h:151
uint * sync_period_ptr
Definition: binlog.h:249
mysql_mutex_t * get_after_commit_lock()
Definition: binlog.h:991
PSI_mutex_key m_key_LOCK_done
The PFS instrumentation key for @ LOCK_done.
Definition: binlog.h:167
std::set< LOG_INFO * > log_info_set
Definition: binlog.h:1115
std::atomic< int32 > m_atomic_prep_xids
Definition: binlog.h:253
Binlog_ofile * m_binlog_file
Definition: binlog.h:152
PSI_mutex_key m_key_LOCK_sync
The instrumentation key to use for @ LOCK_sync.
Definition: binlog.h:183
void add_bytes_written(ulonglong inc)
Definition: binlog.h:708
bool inited
Definition: binlog.h:151
PSI_file_key m_key_file_log_index_cache
The instrumentation key to use for opening a log index cache file.
Definition: binlog.h:201
mysql_mutex_t * get_index_lock()
Definition: binlog.h:989
PSI_mutex_key m_key_LOCK_binlog_end_pos
The instrumentation key to use for @ LOCK_binlog_end_pos.
Definition: binlog.h:161
char index_file_name[FN_REFLEN]
Definition: binlog.h:215
IO_CACHE * get_index_file()
Definition: binlog.h:997
mysql_cond_t * get_log_cond()
Definition: binlog.h:992
mysql_mutex_t LOCK_log
Definition: binlog.h:147
ulong max_size
Definition: binlog.h:240
bool is_relay_log
Definition: binlog.h:327
PSI_mutex_key m_key_LOCK_index
The instrumentation key to use for @ LOCK_index.
Definition: binlog.h:159
uint get_sync_period()
Definition: binlog.h:269
PSI_cond_key m_key_COND_wait_for_group_turn
The PFS instrumentation key for @ COND_wait_for_group_turn.
Definition: binlog.h:193
PSI_mutex_key m_key_LOCK_log
The instrumentation key to use for @ LOCK_log.
Definition: binlog.h:157
PSI_mutex_key m_key_COND_flush_queue
The PFS instrumentation key for @ COND_flush_queue.
Definition: binlog.h:177
uint file_id
Definition: binlog.h:243
ulonglong bytes_written
Definition: binlog.h:213
mysql_cond_t update_cond
Definition: binlog.h:210
PSI_mutex_key m_key_LOCK_commit
The instrumentation key to use for @ LOCK_commit.
Definition: binlog.h:179
PSI_mutex_key m_key_LOCK_wait_for_group_turn
The PFS instrumentation key for @ LOCK_wait_for_group_turn.
Definition: binlog.h:173
void unlock_index()
Definition: binlog.h:996
PSI_file_key m_key_file_log
The instrumentation key to use for opening the log file.
Definition: binlog.h:195
PSI_mutex_key m_key_LOCK_sync_queue
The PFS instrumentation key for @ LOCK_sync_queue.
Definition: binlog.h:171
char * get_log_fname()
Definition: binlog.h:986
char purge_index_file_name[FN_REFLEN]
Definition: binlog.h:229
mysql::binlog::event::enum_binlog_checksum_alg relay_log_checksum_alg
Definition: binlog.h:363
Transaction_dependency_tracker m_dependency_tracker
Manage the MTS dependency tracking.
Definition: binlog.h:412
IO_CACHE index_file
Definition: binlog.h:214
mysql_mutex_t LOCK_xids
Definition: binlog.h:209
PSI_file_key m_key_file_log_cache
The instrumentation key to use for opening a log cache file.
Definition: binlog.h:199
uint sync_counter
Definition: binlog.h:250
PSI_file_key m_log_file_key
Instrumentation key to use for file io in log_file.
Definition: binlog.h:155
char * name
Definition: binlog.h:148
char log_file_name[FN_REFLEN]
Definition: binlog.h:149
uint8 checksum_alg_reset
Definition: binlog.h:329
PSI_mutex_key m_key_LOCK_log_info
The instrumentation key to use for @ m_key_LOCK_log_info.
Definition: binlog.h:187
char crash_safe_index_file_name[FN_REFLEN]
Definition: binlog.h:221
static const int MAX_RETRIES_FOR_DELETE_RENAME_FAILURE
Definition: binlog.h:1043
PSI_file_key m_key_file_log_index
The instrumentation key to use for opening the log index file.
Definition: binlog.h:197
Definition: rpl_mi.h:87
Definition: rpl_rli.h:203
Common base class for all row-containing log events.
Definition: log_event.h:2764
Transaction Coordinator Log.
Definition: tc_log.h:144
enum_result
Definition: tc_log.h:160
For each client connection we create a separate thread with THD serving as a thread/connection descri...
Definition: sql_lexer_thd.h:36
enum_trx_scope
Definition: transaction_info.h:56
Dependency tracker is a container singleton that dispatches between the three methods associated with...
Definition: rpl_trx_tracking.h:186
Represents a bidirectional map between TSID and SIDNO.
Definition: rpl_gtid.h:749
Caches for non-transactional and transactional data before writing it to the binary log.
Definition: binlog.cc:701
This is the base class for verifying transaction boundaries.
Definition: trx_boundary_parser.h:50
Error representation used internally in case final error code is unknown and error situation handling...
Definition: error.h:45
Definition: item_func.h:3021
#define mysql_mutex_lock(M)
Definition: mysql_mutex.h:50
#define mysql_mutex_unlock(M)
Definition: mysql_mutex.h:57
void harvest_bytes_written(Relay_log_info *rli, bool need_log_space_lock)
Adds bytes written in the current relay log into the variable handling the total number of bytes acqu...
Definition: binlog.cc:7823
bool mysql_show_binlog_events(THD *thd)
Execute a SHOW BINLOG EVENTS statement.
Definition: binlog.cc:3637
bool stmt_cannot_safely_rollback(const THD *thd)
This function checks if current statement cannot be rollded back safely.
Definition: binlog.cc:3319
bool normalize_binlog_name(char *to, const char *from, bool is_relay_log)
Turns a relative log binary log path into a full path, based on the opt_bin_logname or opt_relay_logn...
Definition: binlog.cc:245
int write_xa_to_cache(THD *thd)
Logging XA commit/rollback of a prepared transaction.
Definition: binlog.cc:2603
std::pair< int, std::list< std::string > > get_log_index(bool need_lock_index=true)
Retrieves the contents of the index file associated with this log object into an std::list<std::strin...
Definition: binlog.cc:5723
int close_purge_index_file()
Definition: binlog.cc:6240
std::pair< std::list< std::string >, mysql::utils::Error > get_filename_list()
Obtains the list of logs from the index file.
Definition: binlog.cc:1955
void set_max_size(ulong max_size_arg)
Definition: binlog.cc:7842
ulong rpl_read_size
Definition: binlog.cc:188
int flush_cache_to_file(my_off_t *flush_end_pos)
Flush the I/O cache to file.
Definition: binlog.cc:8685
void report_cache_write_error(THD *thd, bool is_transactional)
Definition: binlog.cc:5519
bool is_transaction_empty(THD *thd)
Check if the the transaction is empty.
Definition: binlog.cc:3210
int log_loaded_block(IO_CACHE *file)
Load data's io cache specific hook to be executed before a chunk of data is being read into the cache...
Definition: binlog.cc:3474
bool trans_cannot_safely_rollback(const THD *thd)
This function checks if a transaction cannot be rolled back safely.
Definition: binlog.cc:3306
THD * fetch_and_process_flush_stage_queue(const bool check_and_skip_flush_logs=false)
Fetch and empty BINLOG_FLUSH_STAGE and COMMIT_ORDER_FLUSH_STAGE flush queues and flush transactions t...
Definition: binlog.cc:8455
int rotate(bool force_rotate, bool *check_purge)
The method executes rotation when LOCK_log is already acquired by the caller.
Definition: binlog.cc:7320
void update_thd_next_event_pos(THD *thd)
Definition: binlog.cc:7100
int find_log_pos(LOG_INFO *linfo, const char *log_name, bool need_lock_index)
Find the position in the log-index-file for the given log name.
Definition: binlog.cc:5568
bool trans_has_updated_trans_table(const THD *thd)
This function checks if a transactional table was updated by the current transaction.
Definition: binlog.cc:3248
void close() override
This is called on shutdown, after ha_panic.
Definition: binlog.cc:8049
int new_file_without_locking(Format_description_log_event *extra_description_event)
Definition: binlog.cc:6627
void report_missing_purged_gtids(const Gtid_set *slave_executed_gtid_set, std::string &errmsg)
Function to report the missing GTIDs.
Definition: binlog.cc:9204
uint next_file_id()
Definition: binlog.cc:7442
void cleanup()
Definition: binlog.cc:3685
bool do_write_cache(Binlog_cache_storage *cache, class Binlog_event_writer *writer)
Write the contents of the given IO_CACHE to the binary log.
Definition: binlog.cc:7548
int rollback(THD *thd, bool all) override
Write a rollback record of the transaction to the binary log.
Definition: binlog.cc:2774
void init_pthread_objects()
Definition: binlog.cc:3710
bool reencrypt_logs()
Re-encrypt previous existent binary/relay logs as below.
Definition: binlog.cc:1978
void unregister_log_info(LOG_INFO *log_info)
Unregister LOG_INFO when it is no longer needed.
Definition: binlog.cc:7479
int log_in_use(const char *log_name)
Check if any threads use log name.
Definition: binlog.cc:7485
const char * log_bin_index
Definition: binlog.cc:184
int open_binlog(const char *opt_name)
Definition: binlog.cc:7888
~MYSQL_BIN_LOG() override
Definition: binlog.cc:3681
bool binlog_enabled()
Check whether binlog_hton has valid slot and enabled.
Definition: binlog.cc:1367
bool is_empty_transaction_in_binlog_cache(const THD *thd)
Check if at least one of transacaction and statement binlog caches contains an empty transaction,...
Definition: binlog.cc:3229
int register_purge_index_entry(const char *entry)
Definition: binlog.cc:6271
int sync_purge_index_file()
Definition: binlog.cc:6260
int get_gtid_executed(Tsid_map *tsid_map, Gtid_set *gtid_set)
Deep copy global_tsid_map and gtid_executed.
Definition: binlog.cc:7450
int gtid_end_transaction(THD *thd)
If the thread owns a GTID, this function generates an empty transaction and releases ownership of the...
Definition: binlog.cc:1833
void register_log_info(LOG_INFO *log_info)
Register LOG_INFO so that log_in_use and adjust_linfo_offsets can operate on all logs.
Definition: binlog.cc:7473
int set_purge_index_file_name(const char *base_file_name)
Definition: binlog.cc:6205
void process_commit_stage_queue(THD *thd, THD *queue)
Commit a sequence of sessions.
Definition: binlog.cc:8553
bool open(PSI_file_key log_file_key, const char *log_name, const char *new_name, uint32 new_index_number)
Open the logfile and init IO_CACHE.
Definition: binlog.cc:3940
bool write_buffer(const char *buf, uint len, Master_info *mi)
Definition: binlog.cc:7041
int open_purge_index_file(bool destroy)
Definition: binlog.cc:6217
int set_crash_safe_index_file_name(const char *base_file_name)
Set the name of crash safe index file.
Definition: binlog.cc:5932
const char * log_bin_basename
Definition: binlog.cc:185
int purge_logs(const char *to_log, bool included, bool need_lock_index, bool need_update_threads, ulonglong *decrease_log_space, bool auto_purge)
Remove all logs before the given log from disk and from the index file.
Definition: binlog.cc:6083
bool truncate_update_log_file(const char *log_name, my_off_t valid_pos, my_off_t binlog_size, bool update)
Truncte log file and clear LOG_EVENT_BINLOG_IN_USE_F when update is set.
Definition: binlog.cc:6982
bool truncate_relaylog_file(Master_info *mi, my_off_t valid_pos)
Truncate the active relay log file in the specified position.
Definition: binlog.cc:8010
void check_binlog_cache_size(THD *thd)
Checks if the BINLOG_CACHE_SIZE's value is greater than MAX_BINLOG_CACHE_SIZE.
Definition: binlog.cc:1328
bool is_current_stmt_binlog_enabled_and_caches_empty(const THD *thd) const
Checks whether binlog caches are disabled (binlog does not cache data) or empty in case binloggging i...
Definition: binlog.cc:3070
bool write_event_to_binlog_and_sync(Log_event *ev)
Definition: binlog.cc:7619
bool read_binlog_in_use_flag(Binlog_file_reader &binlog_file_reader)
Read binary log stream header and Format_desc event from binlog_file_reader.
Definition: binlog.cc:7858
bool is_active(const char *log_file_name) const
Check if we are writing/reading to the given log file.
Definition: binlog.cc:6579
void check_binlog_stmt_cache_size(THD *thd)
Checks if the BINLOG_STMT_CACHE_SIZE's value is greater than MAX_BINLOG_STMT_CACHE_SIZE.
Definition: binlog.cc:1348
std::pair< bool, bool > sync_binlog_file(bool force)
Call fsync() to sync the file to disk.
Definition: binlog.cc:8698
int find_next_relay_log(char log_name[FN_REFLEN+1])
Find the relay log name following the given name from relay log index file.
Definition: binlog.cc:5702
int generate_new_name(char *new_name, const char *log_name, uint32 new_index_number=0)
Definition: binlog.cc:3874
int flush_and_set_pending_rows_event(THD *thd, Rows_log_event *event, bool is_transactional)
Definition: binlog.cc:7116
int finish_commit(THD *thd)
Helper function executed when leaving ordered_commit.
Definition: binlog.cc:8741
bool write_stmt_directly(THD *thd, const char *stmt, size_t stmt_len, enum enum_sql_command sql_command)
Write a dml into statement cache and then flush it into binlog.
Definition: binlog.cc:7574
bool ending_single_stmt_trans(THD *thd, const bool all)
This function checks if a single statement transaction is about to commit or not.
Definition: binlog.cc:3295
int raw_get_current_log(LOG_INFO *linfo)
Definition: binlog.cc:5492
enum_result commit(THD *thd, bool all) override
Commit the transaction in the transaction coordinator.
Definition: binlog.cc:8114
bool check_write_error(const THD *thd)
Definition: binlog.cc:5500
bool purge_source_logs_to_file(THD *thd, const char *to_log)
Purges the binary log files up to the file name passed as a paramenter.
Definition: binlog.cc:3334
int process_flush_stage_queue(my_off_t *total_bytes_var, THD **out_queue_var)
Execute the flush stage.
Definition: binlog.cc:8497
int find_next_log(LOG_INFO *linfo, bool need_lock_index)
Find the position in the log-index-file for the given log name.
Definition: binlog.cc:5656
int wait_for_update()
Wait until we get a signal that the binary log has been updated.
Definition: binlog.cc:7706
void make_log_name(char *buf, const char *log_ident)
Create a new log file name.
Definition: binlog.cc:6568
bool change_stage(THD *thd, Commit_stage_manager::StageID stage, THD *queue, mysql_mutex_t *leave_mutex, mysql_mutex_t *enter_mutex)
Enter a stage of the ordered commit procedure.
Definition: binlog.cc:8654
bool find_first_log(std::string &binlog_file_name, std::string &errmsg)
Find the oldest binary log referenced by the index file.
Definition: binlog.cc:4585
bool write_cache(THD *thd, class binlog_cache_data *cache_data, class Binlog_event_writer *writer)
Write the contents of the statement or transaction cache to the binary log.
Definition: binlog.cc:7656
int remove_logs_outside_range_from_index(LOG_INFO *start_log_info, bool need_update_threads, LOG_INFO *last_log_info=nullptr)
Remove logs from index file, except files between 'start' and 'last'.
Definition: binlog.cc:6016
bool write_event(Log_event *event_info)
Write an event to the binary log cache.
Definition: binlog.cc:7157
void update_binlog_end_pos(bool need_lock=true)
Definition: binlog.cc:9335
int rotate_and_purge(THD *thd, bool force_rotate)
Execute a FLUSH LOGS statement.
Definition: binlog.cc:7410
int get_current_log(LOG_INFO *linfo, bool need_lock_log=true)
Definition: binlog.cc:5484
bool is_query_in_union(THD *thd, query_id_t query_id_param)
Definition: binlog.cc:7091
int new_file_impl(bool need_lock, Format_description_log_event *extra_description_event)
Start writing to a new log file or reopen the old file.
Definition: binlog.cc:6647
bool write_event_to_binlog(Log_event *ev)
Definition: binlog.cc:7598
bool reset_logs(THD *thd, bool delete_only=false)
Removes files, as part of a RESET BINARY LOGS AND GTIDS or RESET REPLICA statement,...
Definition: binlog.cc:5766
bool purge_source_logs_before_date(THD *thd, time_t purge_time)
Execute a PURGE BINARY LOGS BEFORE <date> command.
Definition: binlog.cc:3374
bool stmt_has_updated_trans_table(Ha_trx_info_list const &ha_list)
This function checks if a transactional table was updated by the current statement.
Definition: binlog.cc:3262
bool ending_trans(THD *thd, const bool all)
This function checks if a transaction, either a multi-statement or a single statement transaction is ...
Definition: binlog.cc:3280
int query_error_code(const THD *thd, bool not_killed)
Definition: binlog.cc:3402
void process_after_commit_stage_queue(THD *thd, THD *first)
Process after commit for a sequence of sessions.
Definition: binlog.cc:8626
std::pair< int, my_off_t > flush_thread_caches(THD *thd)
Flush caches for session.
Definition: binlog.cc:8403
bool write_transaction(THD *thd, binlog_cache_data *cache_data, Binlog_event_writer *writer, bool parallelization_barrier)
Write the Gtid_log_event to the binary log (prior to writing the statement or transaction cache).
Definition: binlog.cc:1675
int move_crash_safe_index_file_to_index_file(bool need_lock_index)
Move crash safe index file to index file.
Definition: binlog.cc:5283
void report_missing_gtids(const Gtid_set *previous_gtid_set, const Gtid_set *slave_executed_gtid_set, std::string &errmsg)
Function to report the missing GTIDs.
Definition: binlog.cc:9268
int purge_index_entry(THD *thd, ulonglong *decrease_log_space, bool need_lock_index)
Definition: binlog.cc:6288
bool init_and_set_log_file_name(const char *log_name, const char *new_name, uint32 new_index_number)
Definition: binlog.cc:3914
const char * generate_name(const char *log_name, const char *suffix, char *buff)
Definition: binlog.cc:3895
int purge_logs_before_date(time_t purge_time, bool auto_purge)
Remove all logs before the given file date from disk and from the index file.
Definition: binlog.cc:6452
bool opt_binlog_order_commits
Definition: binlog.cc:182
void init_thd_variables(THD *thd, bool all, bool skip_commit)
Set thread variables used while flushing a transaction.
Definition: binlog.cc:8420
int open_crash_safe_index_file()
Open a (new) crash safe index file.
Definition: binlog.cc:5956
void start_union_events(THD *thd, query_id_t query_id_param)
Definition: binlog.cc:7078
bool is_inited_purge_index_file()
Definition: binlog.cc:6255
bool init_gtid_sets(Gtid_set *all_gtids, Gtid_set *lost_gtids, bool verify_checksum, bool need_lock, mysql::binlog::event::Transaction_boundary_parser *trx_parser, Gtid_monitoring_info *partial_trx, bool is_server_starting=false)
Reads the set of all GTIDs in the binary/relay log, and the set of all lost GTIDs in the binary log,...
Definition: binlog.cc:4698
bool open_index_file(const char *index_file_name_arg, const char *log_name, bool need_lock_index)
Definition: binlog.cc:3993
bool assign_automatic_gtids_to_flush_group(THD *first_seen)
Assign automatic generated GTIDs for all commit group threads in the flush stage having gtid_next....
Definition: binlog.cc:1610
int register_create_index_entry(const char *entry)
Definition: binlog.cc:6283
int close_crash_safe_index_file()
Close the crash safe index file.
Definition: binlog.cc:5988
void auto_purge()
This function runs automatic purge if the conditions to meet automatic purge are met.
Definition: binlog.cc:7350
int prepare(THD *thd, bool all) override
Log a prepare record of the transaction to the storage engines.
Definition: binlog.cc:8061
void handle_binlog_flush_or_sync_error(THD *thd, bool need_lock_log, const char *message)
Helper function to handle flush or sync stage errors.
Definition: binlog.cc:8845
int ordered_commit(THD *thd, bool all, bool skip_commit=false)
Flush and commit the transaction.
Definition: binlog.cc:8893
int add_log_to_index(uchar *log_file_name, size_t name_len, bool need_lock_index)
Append log file name to index file.
Definition: binlog.cc:5441
void adjust_linfo_offsets(my_off_t purge_offset)
Adjust the position pointer in the binary log file for all running replicas.
Definition: binlog.cc:7511
MYSQL_BIN_LOG(uint *sync_period, bool relay_log=false)
Definition: binlog.cc:3658
bool flush_and_sync(const bool force=false)
Flush binlog cache and synchronize to disk.
Definition: binlog.cc:7068
int new_file(Format_description_log_event *extra_description_event)
Definition: binlog.cc:6618
bool show_binlog_events(THD *thd, MYSQL_BIN_LOG *binary_log)
Definition: binlog.cc:3509
void inc_prep_xids(THD *thd)
Increment the prepared XID counter.
Definition: binlog.cc:6583
void dec_prep_xids(THD *thd)
Decrement the prepared XID counter.
Definition: binlog.cc:6594
void stop_union_events(THD *thd)
Definition: binlog.cc:7086
bool flush()
Definition: binlog.cc:7064
void signal_update()
Notifies waiting threads that binary log has been updated.
Definition: binlog.cc:9327
int check_trx_rw_engines(THD *thd, Transaction_ctx::enum_trx_scope trx_scope)
Check if the transaction has no rw flag set for any of the storage engines.
Definition: binlog.cc:3217
bool find_first_log_not_in_gtid_set(char *binlog_file_name, const Gtid_set *gtid_set, Gtid *first_gtid, std::string &errmsg)
Find the oldest binary log that contains any GTID that is not in the given gtid set.
Definition: binlog.cc:4600
void report_binlog_write_error()
Definition: binlog.cc:7698
bool after_write_to_relay_log(Master_info *mi)
Called after an event has been written to the relay log by the IO thread.
Definition: binlog.cc:6886
void auto_purge_at_server_startup()
This member function is to be called at server startup.
Definition: binlog.cc:7338
bool write_incident_commit(THD *thd, std::string_view incident_message)
Write an incident and call commit.
Definition: binlog.cc:2631
#define log_info(...)
Definition: log_client.h:153
unsigned int PSI_cond_key
Instrumented cond key.
Definition: psi_cond_bits.h:44
unsigned int PSI_file_key
Instrumented file key.
Definition: psi_file_bits.h:48
unsigned int PSI_mutex_key
Instrumented mutex key.
Definition: psi_mutex_bits.h:52
#define mysql_mutex_assert_not_owner(M)
Wrapper, to use safe_mutex_assert_not_owner with instrumented mutexes.
Definition: mysql_mutex.h:126
Some integer typedefs for easier portability.
unsigned long long int ulonglong
Definition: my_inttypes.h:56
uint8_t uint8
Definition: my_inttypes.h:63
ulonglong my_off_t
Definition: my_inttypes.h:72
unsigned char uchar
Definition: my_inttypes.h:52
int64_t int64
Definition: my_inttypes.h:68
int32_t int32
Definition: my_inttypes.h:66
uint32_t uint32
Definition: my_inttypes.h:67
Common #defines and includes for file and socket I/O.
#define FN_REFLEN
Definition: my_io.h:83
Functions related to handling of plugins and other dynamically loaded libraries.
#define MYSQL_PLUGIN_IMPORT
Definition: my_sharedlib.h:71
enum_sql_command
Definition: my_sqlcommand.h:46
Common header for many mysys elements.
uint32 my_thread_id
Definition: my_thread_local.h:34
static int not_killed
Definition: myisamchk.cc:1619
static uint update
Definition: myisamlog.cc:94
static QUEUE queue
Definition: myisampack.cc:210
Common definition between mysql server & client.
#define NAME_LEN
Definition: mysql_com.h:67
Instrumentation helpers for conditions.
ABI for instrumented mutexes.
Type inc(Shards< COUNT > &shards, size_t id)
Increment the counter of a shard by 1.
Definition: ut0counter.h:293
Definition: base.h:75
Definition: buf0block_hint.cc:30
Definition: os0file.h:89
static bool timeout(bool(*wait_condition)())
Timeout function.
Definition: log0meb.cc:498
enum_binlog_checksum_alg
Enumeration spcifying checksum algorithm used to encode a binary log event.
Definition: binlog_event.h:462
Instrumentation helpers for conditions.
Instrumentation helpers for mutexes.
Performance schema instrumentation interface.
Performance schema instrumentation interface.
Instrumentation helpers for mutexes.
required string event
Definition: replication_group_member_actions.proto:32
Definition: binlog.h:89
Item_result type
Definition: binlog.h:93
ulong length
Definition: binlog.h:92
char * value
Definition: binlog.h:91
bool unsigned_flag
Definition: binlog.h:95
user_var_entry * user_var_event
Definition: binlog.h:90
uint charset_number
Definition: binlog.h:94
TODO: Move this structure to mysql/binlog/event/control_events.h when we start using C++11.
Definition: rpl_gtid.h:1100
Definition: my_sys.h:346
Definition: binlog.h:1118
bool log_delayed
Definition: binlog.h:1121
my_off_t last_pos_in_file
Definition: binlog.h:1120
bool logged_data_file
Definition: binlog.h:1121
THD * thd
Definition: binlog.h:1119
Definition: binlog.h:115
my_thread_id thread_id
Definition: binlog.h:122
my_off_t pos
Definition: binlog.h:118
my_off_t index_file_start_offset
Definition: binlog.h:117
LOG_INFO()
Definition: binlog.h:123
bool fatal
Definition: binlog.h:119
char log_file_name[FN_REFLEN]
Definition: binlog.h:116
my_off_t index_file_offset
Definition: binlog.h:117
int entry_index
Definition: binlog.h:120
int encrypted_header_size
Definition: binlog.h:121
Definition: completion_hash.h:35
An instrumented cond structure.
Definition: mysql_cond_bits.h:50
An instrumented mutex structure.
Definition: mysql_mutex_bits.h:50
MySQL mutex implementation.
Include file for Sun RPC to compile out of the box.
Transaction boundary parser definitions.
Item_result
Type of the user defined function return slot and arguments.
Definition: udf_registration_types.h:39
static int all(site_def const *s, node_no node)
Definition: xcom_transport.cc:885