drizzle
C++ MySQL-protocol-compatible database server
Loading...
Searching...
No Matches
log0log.h File Reference
#include "univ.i"
#include "ut0byte.h"
#include "ut0lst.h"
#include "sync0sync.h"
#include "sync0rw.h"
Include dependency graph for log0log.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes

struct  log_group_struct
struct  log_struct

Macros

#define log0log_h
#define log_do_write   TRUE

Typedefs

typedef struct log_struct log_t
typedef struct log_group_struct log_group_t
#define LOG_NO_WAIT   91
#define LOG_WAIT_ONE_GROUP   92
#define LOG_WAIT_ALL_GROUPS   93
#define LOG_MAX_N_GROUPS   32
#define LOG_FLUSH   7652559
#define LOG_CHECKPOINT   78656949
#define LOG_RECOVER   98887331
#define LOG_START_LSN   ((ib_uint64_t) (16 * OS_FILE_LOG_BLOCK_SIZE))
#define LOG_BUFFER_SIZE   (srv_log_buffer_size * UNIV_PAGE_SIZE)
#define LOG_ARCHIVE_BUF_SIZE   (srv_log_buffer_size * UNIV_PAGE_SIZE / 4)
#define LOG_BLOCK_HDR_NO
#define LOG_BLOCK_FLUSH_BIT_MASK   0x80000000UL
#define LOG_BLOCK_HDR_DATA_LEN
#define LOG_BLOCK_FIRST_REC_GROUP
#define LOG_BLOCK_CHECKPOINT_NO
#define LOG_BLOCK_HDR_SIZE
#define LOG_BLOCK_CHECKSUM
#define LOG_BLOCK_TRL_SIZE   4 /* trailer size in bytes */
#define LOG_CHECKPOINT_NO   0
#define LOG_CHECKPOINT_LSN   8
#define LOG_CHECKPOINT_OFFSET   16
#define LOG_CHECKPOINT_LOG_BUF_SIZE   20
#define LOG_CHECKPOINT_ARCHIVED_LSN   24
#define LOG_CHECKPOINT_GROUP_ARRAY   32
#define LOG_CHECKPOINT_ARCHIVED_FILE_NO   0
#define LOG_CHECKPOINT_ARCHIVED_OFFSET   4
#define LOG_CHECKPOINT_ARRAY_END
#define LOG_CHECKPOINT_CHECKSUM_1   LOG_CHECKPOINT_ARRAY_END
#define LOG_CHECKPOINT_CHECKSUM_2   (4 + LOG_CHECKPOINT_ARRAY_END)
#define LOG_CHECKPOINT_FSP_FREE_LIMIT   (8 + LOG_CHECKPOINT_ARRAY_END)
#define LOG_CHECKPOINT_FSP_MAGIC_N   (12 + LOG_CHECKPOINT_ARRAY_END)
#define LOG_CHECKPOINT_SIZE   (16 + LOG_CHECKPOINT_ARRAY_END)
#define LOG_CHECKPOINT_FSP_MAGIC_N_VAL   1441231243
#define LOG_GROUP_ID   0 /* log group number */
#define LOG_FILE_START_LSN
#define LOG_FILE_NO
#define LOG_FILE_WAS_CREATED_BY_HOT_BACKUP   16
#define LOG_FILE_OS_FILE_LOG_BLOCK_SIZE   64
#define LOG_FILE_ARCH_COMPLETED   OS_FILE_LOG_BLOCK_SIZE
#define LOG_FILE_END_LSN   (OS_FILE_LOG_BLOCK_SIZE + 4)
#define LOG_CHECKPOINT_1   OS_FILE_LOG_BLOCK_SIZE
#define LOG_CHECKPOINT_2   (3 * OS_FILE_LOG_BLOCK_SIZE)
#define LOG_FILE_HDR_SIZE   (4 * OS_FILE_LOG_BLOCK_SIZE)
#define LOG_GROUP_OK   301
#define LOG_GROUP_CORRUPTED   302
#define log_flush_order_mutex_own()
#define log_flush_order_mutex_enter()
#define log_flush_order_mutex_exit()
log_t * log_sys
UNIV_INTERN void log_fsp_current_free_limit_set_and_checkpoint (ulint limit)
UNIV_INTERN ulint log_calc_where_lsn_is (ib_int64_t *log_file_offset, ib_uint64_t first_header_lsn, ib_uint64_t lsn, ulint n_log_files, ib_int64_t log_file_size)
UNIV_INLINE ib_uint64_t log_reserve_and_write_fast (const void *str, ulint len, ib_uint64_t *start_lsn)
UNIV_INLINE void log_release (void)
UNIV_INLINE void log_free_check (void)
UNIV_INTERN ib_uint64_t log_reserve_and_open (ulint len)
UNIV_INTERN void log_write_low (byte *str, ulint str_len)
UNIV_INTERN ib_uint64_t log_close (void)
UNIV_INLINE ib_uint64_t log_get_lsn (void)
UNIV_INLINE ulint log_get_capacity (void)
UNIV_INTERN void log_init (void)
UNIV_INTERN void log_group_init (ulint id, ulint n_files, ulint file_size, ulint space_id, ulint archive_space_id)
UNIV_INTERN void log_io_complete (log_group_t *group)
UNIV_INTERN void log_write_up_to (ib_uint64_t lsn, ulint wait, ibool flush_to_disk)
UNIV_INTERN void log_buffer_flush_to_disk (void)
UNIV_INTERN void log_buffer_sync_in_background (ibool flush)
UNIV_INTERN ibool log_preflush_pool_modified_pages (ib_uint64_t new_oldest, ibool sync)
UNIV_INTERN ibool log_checkpoint (ibool sync, ibool write_always)
UNIV_INTERN void log_make_checkpoint_at (ib_uint64_t lsn, ibool write_always)
UNIV_INTERN void logs_empty_and_mark_files_at_shutdown (void)
UNIV_INTERN void log_group_read_checkpoint_info (log_group_t *group, ulint field)
UNIV_INTERN void log_checkpoint_get_nth_group_info (const byte *buf, ulint n, ulint *file_no, ulint *offset)
UNIV_INTERN void log_groups_write_checkpoint_info (void)
UNIV_INTERN ibool log_archive_do (ibool sync, ulint *n_bytes)
UNIV_INTERN ulint log_archive_stop (void)
UNIV_INTERN ulint log_archive_start (void)
UNIV_INTERN ulint log_archive_noarchivelog (void)
UNIV_INTERN ulint log_archive_archivelog (void)
UNIV_INTERN void log_archived_file_name_gen (char *buf, ulint id, ulint file_no)
UNIV_INTERN void log_check_margins (void)
UNIV_INTERN void log_group_read_log_seg (ulint type, byte *buf, log_group_t *group, ib_uint64_t start_lsn, ib_uint64_t end_lsn)
UNIV_INTERN void log_group_write_buf (log_group_t *group, byte *buf, ulint len, ib_uint64_t start_lsn, ulint new_data_offset)
UNIV_INTERN void log_group_set_fields (log_group_t *group, ib_uint64_t lsn)
UNIV_INTERN ulint log_group_get_capacity (const log_group_t *group)
UNIV_INLINE ibool log_block_get_flush_bit (const byte *log_block)
UNIV_INLINE ulint log_block_get_hdr_no (const byte *log_block)
UNIV_INLINE ulint log_block_get_data_len (const byte *log_block)
UNIV_INLINE void log_block_set_data_len (byte *log_block, ulint len)
UNIV_INLINE ulint log_block_calc_checksum (const byte *block)
UNIV_INLINE ulint log_block_get_checksum (const byte *log_block)
UNIV_INLINE void log_block_set_checksum (byte *log_block, ulint checksum)
UNIV_INLINE ulint log_block_get_first_rec_group (const byte *log_block)
UNIV_INLINE void log_block_set_first_rec_group (byte *log_block, ulint offset)
UNIV_INLINE ulint log_block_get_checkpoint_no (const byte *log_block)
UNIV_INLINE void log_block_init (byte *log_block, ib_uint64_t lsn)
UNIV_INLINE void log_block_init_in_old_format (byte *log_block, ib_uint64_t lsn)
UNIV_INLINE ulint log_block_convert_lsn_to_no (ib_uint64_t lsn)
UNIV_INTERN void log_print (FILE *file)
UNIV_INTERN ibool log_peek_lsn (ib_uint64_t *lsn)
UNIV_INTERN void log_refresh_stats (void)
UNIV_INTERN void log_shutdown (void)
UNIV_INTERN void log_mem_free (void)

Detailed Description

Database log

Created 12/9/1995 Heikki Tuuri

Definition in file log0log.h.

Macro Definition Documentation

◆ log0log_h

#define log0log_h

Definition at line 35 of file log0log.h.

◆ LOG_ARCHIVE_BUF_SIZE

#define LOG_ARCHIVE_BUF_SIZE   (srv_log_buffer_size * UNIV_PAGE_SIZE / 4)

Definition at line 586 of file log0log.h.

◆ LOG_BLOCK_CHECKPOINT_NO

#define LOG_BLOCK_CHECKPOINT_NO
Value:
8 /* 4 lower bytes of the value of
log_sys->next_checkpoint_no when the
log block was last written to: if the
block has not yet been written full,
this value is only updated before a
log buffer flush */

Definition at line 595 of file log0log.h.

◆ LOG_BLOCK_CHECKSUM

#define LOG_BLOCK_CHECKSUM
Value:
4 /* 4 byte checksum of the log block
contents; in InnoDB versions
< 3.23.52 this did not contain the
checksum but the same value as
.._HDR_NO */

Definition at line 599 of file log0log.h.

◆ LOG_BLOCK_FIRST_REC_GROUP

#define LOG_BLOCK_FIRST_REC_GROUP
Value:
6 /* offset of the first start of an
mtr log record group in this log block,
0 if none; if the value is the same
as LOG_BLOCK_HDR_DATA_LEN, it means
that the first rec group has not yet
been catenated to this log block, but
if it will, it will start at this
offset; an archive recovery can
start parsing the log records starting
from this offset in this log block,
if value not 0 */

Definition at line 594 of file log0log.h.

◆ LOG_BLOCK_FLUSH_BIT_MASK

#define LOG_BLOCK_FLUSH_BIT_MASK   0x80000000UL

Definition at line 590 of file log0log.h.

◆ LOG_BLOCK_HDR_DATA_LEN

#define LOG_BLOCK_HDR_DATA_LEN
Value:
4 /* number of bytes of log written to
this block */

Definition at line 593 of file log0log.h.

◆ LOG_BLOCK_HDR_NO

#define LOG_BLOCK_HDR_NO
Value:
0 /* block number which must be > 0 and
is allowed to wrap around at 2G; the
highest bit is set to 1 if this is the
first log block in a log flush write
segment */

Definition at line 589 of file log0log.h.

◆ LOG_BLOCK_HDR_SIZE

#define LOG_BLOCK_HDR_SIZE
Value:
12 /* size of the log block header in
bytes */

Definition at line 596 of file log0log.h.

◆ LOG_BLOCK_TRL_SIZE

#define LOG_BLOCK_TRL_SIZE   4 /* trailer size in bytes */

Definition at line 600 of file log0log.h.

◆ LOG_BUFFER_SIZE

#define LOG_BUFFER_SIZE   (srv_log_buffer_size * UNIV_PAGE_SIZE)

Definition at line 585 of file log0log.h.

◆ LOG_CHECKPOINT

#define LOG_CHECKPOINT   78656949

Definition at line 576 of file log0log.h.

◆ LOG_CHECKPOINT_1

#define LOG_CHECKPOINT_1   OS_FILE_LOG_BLOCK_SIZE

Definition at line 664 of file log0log.h.

◆ LOG_CHECKPOINT_2

#define LOG_CHECKPOINT_2   (3 * OS_FILE_LOG_BLOCK_SIZE)

Definition at line 670 of file log0log.h.

◆ LOG_CHECKPOINT_ARCHIVED_FILE_NO

#define LOG_CHECKPOINT_ARCHIVED_FILE_NO   0

Definition at line 612 of file log0log.h.

◆ LOG_CHECKPOINT_ARCHIVED_LSN

#define LOG_CHECKPOINT_ARCHIVED_LSN   24

Definition at line 607 of file log0log.h.

◆ LOG_CHECKPOINT_ARCHIVED_OFFSET

#define LOG_CHECKPOINT_ARCHIVED_OFFSET   4

Definition at line 613 of file log0log.h.

◆ LOG_CHECKPOINT_ARRAY_END

#define LOG_CHECKPOINT_ARRAY_END
Value:
(LOG_CHECKPOINT_GROUP_ARRAY\
#define LOG_MAX_N_GROUPS
Definition log0log.h:66

Definition at line 615 of file log0log.h.

◆ LOG_CHECKPOINT_CHECKSUM_1

#define LOG_CHECKPOINT_CHECKSUM_1   LOG_CHECKPOINT_ARRAY_END

Definition at line 617 of file log0log.h.

◆ LOG_CHECKPOINT_CHECKSUM_2

#define LOG_CHECKPOINT_CHECKSUM_2   (4 + LOG_CHECKPOINT_ARRAY_END)

Definition at line 618 of file log0log.h.

◆ LOG_CHECKPOINT_FSP_FREE_LIMIT

#define LOG_CHECKPOINT_FSP_FREE_LIMIT   (8 + LOG_CHECKPOINT_ARRAY_END)

Definition at line 619 of file log0log.h.

◆ LOG_CHECKPOINT_FSP_MAGIC_N

#define LOG_CHECKPOINT_FSP_MAGIC_N   (12 + LOG_CHECKPOINT_ARRAY_END)

Definition at line 627 of file log0log.h.

◆ LOG_CHECKPOINT_FSP_MAGIC_N_VAL

#define LOG_CHECKPOINT_FSP_MAGIC_N_VAL   1441231243

Definition at line 634 of file log0log.h.

◆ LOG_CHECKPOINT_GROUP_ARRAY

#define LOG_CHECKPOINT_GROUP_ARRAY   32

Definition at line 608 of file log0log.h.

◆ LOG_CHECKPOINT_LOG_BUF_SIZE

#define LOG_CHECKPOINT_LOG_BUF_SIZE   20

Definition at line 606 of file log0log.h.

◆ LOG_CHECKPOINT_LSN

#define LOG_CHECKPOINT_LSN   8

Definition at line 604 of file log0log.h.

◆ LOG_CHECKPOINT_NO

#define LOG_CHECKPOINT_NO   0

Definition at line 603 of file log0log.h.

◆ LOG_CHECKPOINT_OFFSET

#define LOG_CHECKPOINT_OFFSET   16

Definition at line 605 of file log0log.h.

◆ LOG_CHECKPOINT_SIZE

#define LOG_CHECKPOINT_SIZE   (16 + LOG_CHECKPOINT_ARRAY_END)

Definition at line 632 of file log0log.h.

◆ log_do_write

#define log_do_write   TRUE

Write to log

Definition at line 57 of file log0log.h.

◆ LOG_FILE_ARCH_COMPLETED

#define LOG_FILE_ARCH_COMPLETED   OS_FILE_LOG_BLOCK_SIZE

Definition at line 651 of file log0log.h.

◆ LOG_FILE_END_LSN

#define LOG_FILE_END_LSN   (OS_FILE_LOG_BLOCK_SIZE + 4)

Definition at line 656 of file log0log.h.

◆ LOG_FILE_HDR_SIZE

#define LOG_FILE_HDR_SIZE   (4 * OS_FILE_LOG_BLOCK_SIZE)

Definition at line 673 of file log0log.h.

◆ LOG_FILE_NO

#define LOG_FILE_NO
Value:
12 /* 4-byte archived log file number;
this field is only defined in an
archived log file */

Definition at line 639 of file log0log.h.

◆ LOG_FILE_OS_FILE_LOG_BLOCK_SIZE

#define LOG_FILE_OS_FILE_LOG_BLOCK_SIZE   64

Definition at line 648 of file log0log.h.

◆ LOG_FILE_START_LSN

#define LOG_FILE_START_LSN
Value:
4 /* lsn of the start of data in this
log file */

Definition at line 638 of file log0log.h.

◆ LOG_FILE_WAS_CREATED_BY_HOT_BACKUP

#define LOG_FILE_WAS_CREATED_BY_HOT_BACKUP   16

Definition at line 640 of file log0log.h.

◆ LOG_FLUSH

#define LOG_FLUSH   7652559

Definition at line 575 of file log0log.h.

◆ log_flush_order_mutex_enter

#define log_flush_order_mutex_enter ( )
Value:
do { \
mutex_enter(&log_sys->log_flush_order_mutex); \
} while (0)

Acquire the flush order mutex.

Definition at line 945 of file log0log.h.

◆ log_flush_order_mutex_exit

#define log_flush_order_mutex_exit ( )
Value:
do { \
mutex_exit(&log_sys->log_flush_order_mutex); \
} while (0)

Release the flush order mutex.

Definition at line 949 of file log0log.h.

◆ log_flush_order_mutex_own

#define log_flush_order_mutex_own ( )
Value:
mutex_own(&log_sys->log_flush_order_mutex)

Test if flush order mutex is owned.

Definition at line 941 of file log0log.h.

◆ LOG_GROUP_CORRUPTED

#define LOG_GROUP_CORRUPTED   302

Definition at line 676 of file log0log.h.

◆ LOG_GROUP_ID

#define LOG_GROUP_ID   0 /* log group number */

Definition at line 637 of file log0log.h.

◆ LOG_GROUP_OK

#define LOG_GROUP_OK   301

Definition at line 675 of file log0log.h.

◆ LOG_MAX_N_GROUPS

#define LOG_MAX_N_GROUPS   32

Maximum number of log groups in log_group_struct::checkpoint_buf

Definition at line 66 of file log0log.h.

◆ LOG_NO_WAIT

#define LOG_NO_WAIT   91

Wait modes for log_write_up_to

Definition at line 61 of file log0log.h.

◆ LOG_RECOVER

#define LOG_RECOVER   98887331

Definition at line 580 of file log0log.h.

◆ LOG_START_LSN

#define LOG_START_LSN   ((ib_uint64_t) (16 * OS_FILE_LOG_BLOCK_SIZE))

Definition at line 583 of file log0log.h.

◆ LOG_WAIT_ALL_GROUPS

#define LOG_WAIT_ALL_GROUPS   93

Definition at line 63 of file log0log.h.

◆ LOG_WAIT_ONE_GROUP

#define LOG_WAIT_ONE_GROUP   92

Definition at line 62 of file log0log.h.

Typedef Documentation

◆ log_group_t

typedef struct log_group_struct log_group_t

Redo log group

Definition at line 48 of file log0log.h.

◆ log_t

typedef struct log_struct log_t

Redo log buffer

Definition at line 46 of file log0log.h.

Function Documentation

◆ log_archive_archivelog()

UNIV_INTERN ulint log_archive_archivelog ( void )

Start archiving the log so that a gap may occur in the archived log files.

Returns
DB_SUCCESS or DB_ERROR

◆ log_archive_do()

UNIV_INTERN ibool log_archive_do ( ibool sync,
ulint * n_bytes )

Starts an archiving operation.

Returns
TRUE if succeed, FALSE if an archiving operation was already running out: archive log buffer size, 0 if nothing to archive
Parameters
syncin: TRUE if synchronous operation is desired

◆ log_archive_noarchivelog()

UNIV_INTERN ulint log_archive_noarchivelog ( void )

Stop archiving the log so that a gap may occur in the archived log files.

Returns
DB_SUCCESS or DB_ERROR

◆ log_archive_start()

UNIV_INTERN ulint log_archive_start ( void )

Starts again archiving which has been stopped.

Returns
DB_SUCCESS or DB_ERROR

◆ log_archive_stop()

UNIV_INTERN ulint log_archive_stop ( void )

Writes the log contents to the archive up to the lsn when this function was called, and stops the archiving. When archiving is started again, the archived log file numbers start from a number one higher, so that the archiving will not write again to the archived log files which exist when this function returns.

Returns
DB_SUCCESS or DB_ERROR

◆ log_archived_file_name_gen()

UNIV_INTERN void log_archived_file_name_gen ( char * buf,
ulint id,
ulint file_no )

Generates an archived log file name. in: file number

Parameters
bufin: buffer where to write
idin: group id

◆ log_block_calc_checksum()

UNIV_INLINE ulint log_block_calc_checksum ( const byte * block)

Calculates the checksum for a log block.

Returns
checksum in: log block

◆ log_block_convert_lsn_to_no()

UNIV_INLINE ulint log_block_convert_lsn_to_no ( ib_uint64_t lsn)

Converts a lsn to a log block number.

Returns
log block number, it is > 0 and <= 1G in: lsn of a byte within the block

◆ log_block_get_checkpoint_no()

UNIV_INLINE ulint log_block_get_checkpoint_no ( const byte * log_block)

Gets a log block checkpoint number field (4 lowest bytes).

Returns
checkpoint no (4 lowest bytes) in: log block

◆ log_block_get_checksum()

UNIV_INLINE ulint log_block_get_checksum ( const byte * log_block)

Gets a log block checksum field value.

Returns
checksum in: log block

◆ log_block_get_data_len()

UNIV_INLINE ulint log_block_get_data_len ( const byte * log_block)

Gets a log block data length.

Returns
log block data length measured as a byte offset from the block start in: log block

◆ log_block_get_first_rec_group()

UNIV_INLINE ulint log_block_get_first_rec_group ( const byte * log_block)

Gets a log block first mtr log record group offset.

Returns
first mtr log record group byte offset from the block start, 0 if none in: log block

◆ log_block_get_flush_bit()

UNIV_INLINE ibool log_block_get_flush_bit ( const byte * log_block)

Gets a log block flush bit.

Returns
TRUE if this block was the first to be written in a log flush in: log block

◆ log_block_get_hdr_no()

UNIV_INLINE ulint log_block_get_hdr_no ( const byte * log_block)

Gets a log block number stored in the header.

Returns
log block number stored in the block header in: log block

◆ log_block_init()

UNIV_INLINE void log_block_init ( byte * log_block,
ib_uint64_t lsn )

Initializes a log block in the log buffer. in: lsn within the log block

Parameters
log_blockin: pointer to the log buffer

◆ log_block_init_in_old_format()

UNIV_INLINE void log_block_init_in_old_format ( byte * log_block,
ib_uint64_t lsn )

Initializes a log block in the log buffer in the old, < 3.23.52 format, where there was no checksum yet. in: lsn within the log block

Parameters
log_blockin: pointer to the log buffer

◆ log_block_set_checksum()

UNIV_INLINE void log_block_set_checksum ( byte * log_block,
ulint checksum )

Sets a log block checksum field value. in: checksum

Parameters
log_blockin/out: log block

◆ log_block_set_data_len()

UNIV_INLINE void log_block_set_data_len ( byte * log_block,
ulint len )

Sets the log block data length. in: data length

Parameters
log_blockin/out: log block

◆ log_block_set_first_rec_group()

UNIV_INLINE void log_block_set_first_rec_group ( byte * log_block,
ulint offset )

Sets the log block first mtr log record group offset. in: offset, 0 if none

Parameters
log_blockin/out: log block

◆ log_buffer_flush_to_disk()

UNIV_INTERN void log_buffer_flush_to_disk ( void )

Does a syncronous flush of the log buffer to disk.

Definition at line 1601 of file log0log.cc.

◆ log_buffer_sync_in_background()

UNIV_INTERN void log_buffer_sync_in_background ( ibool flush)

This functions writes the log buffer to the log file and if 'flush' is set it forces a flush of the log file as well. This is meant to be called from background master thread only as it does not wait for the write (+ possible flush) to finish.

Parameters
flushin: flush the logs to disk

Definition at line 1622 of file log0log.cc.

◆ log_calc_where_lsn_is()

UNIV_INTERN ulint log_calc_where_lsn_is ( ib_int64_t * log_file_offset,
ib_uint64_t first_header_lsn,
ib_uint64_t lsn,
ulint n_log_files,
ib_int64_t log_file_size )

Calculates where in log files we find a specified lsn.

Returns
log file number in: log file size (including the header)

Calculates where in log files we find a specified lsn.

Returns
log file number
Parameters
log_file_offsetout: offset in that file (including the header)
first_header_lsnin: first log file start lsn
lsnin: lsn whose position to determine
n_log_filesin: total number of log files
log_file_sizein: log file size (including the header)

Definition at line 634 of file log0log.cc.

◆ log_check_margins()

UNIV_INTERN void log_check_margins ( void )

Checks that there is enough free space in the log to start a new query step. Flushes the log buffer or makes a new checkpoint if necessary. NOTE: this function may only be called if the calling thread owns no synchronization objects!

Definition at line 3086 of file log0log.cc.

◆ log_checkpoint()

UNIV_INTERN ibool log_checkpoint ( ibool sync,
ibool write_always )

Makes a checkpoint. Note that this function does not flush dirty blocks from the buffer pool: it only checks what is lsn of the oldest modification in the pool, and writes information about the lsn in log files. Use log_make_checkpoint_at to flush also the pool.

Returns
TRUE if success, FALSE if a checkpoint write was already running in: the function normally checks if the the new checkpoint would have a greater lsn than the previous one: if not, then no physical write is done; by setting this parameter TRUE, a physical write will always be made to log files

Makes a checkpoint. Note that this function does not flush dirty blocks from the buffer pool: it only checks what is lsn of the oldest modification in the pool, and writes information about the lsn in log files. Use log_make_checkpoint_at to flush also the pool.

Returns
TRUE if success, FALSE if a checkpoint write was already running
Parameters
syncin: TRUE if synchronous operation is desired
write_alwaysin: the function normally checks if the the new checkpoint would have a greater lsn than the previous one: if not, then no physical write is done; by setting this parameter TRUE, a physical write will always be made to log files

Definition at line 2011 of file log0log.cc.

◆ log_checkpoint_get_nth_group_info()

UNIV_INTERN void log_checkpoint_get_nth_group_info ( const byte * buf,
ulint n,
ulint * file_no,
ulint * offset )

Gets info from a checkpoint about a log group. out: archived file offset

Gets info from a checkpoint about a log group.

Parameters
bufin: buffer containing checkpoint info
nin: nth slot
file_noout: archived file number
offsetout: archived file offset

Definition at line 1773 of file log0log.cc.

◆ log_close()

UNIV_INTERN ib_uint64_t log_close ( void )

Closes the log.

Returns
lsn

Definition at line 402 of file log0log.cc.

◆ log_free_check()

UNIV_INLINE void log_free_check ( void )

Checks if there is need for a log buffer flush or a new checkpoint, and does this if yes. Any database operation should call this when it has modified more than about 4 pages. NOTE that this function may only be called when the OS thread owns no synchronization objects except the dictionary mutex.

◆ log_fsp_current_free_limit_set_and_checkpoint()

UNIV_INTERN void log_fsp_current_free_limit_set_and_checkpoint ( ulint limit)

Sets the global variable log_fsp_current_free_limit. Also makes a checkpoint, so that we know that the limit has been written to a log checkpoint field on disk. in: limit to set

Sets the global variable log_fsp_current_free_limit. Also makes a checkpoint, so that we know that the limit has been written to a log checkpoint field on disk.

Parameters
limitin: limit to set

Definition at line 175 of file log0log.cc.

◆ log_get_lsn()

UNIV_INLINE ib_uint64_t log_get_lsn ( void )

Gets the current lsn.

Returns
current lsn

◆ log_group_get_capacity()

UNIV_INTERN ulint log_group_get_capacity ( const log_group_t * group)

Calculates the data capacity of a log group, when the log file headers are not included.

Returns
capacity in bytes in: log group

Calculates the data capacity of a log group, when the log file headers are not included.

Returns
capacity in bytes
Parameters
groupin: log group

Definition at line 527 of file log0log.cc.

◆ log_group_init()

UNIV_INTERN void log_group_init ( ulint id,
ulint n_files,
ulint file_size,
ulint space_id,
ulint archive_space_id )

Inits a log group to the log system. in: space id of the file space which contains some archived log files for this group; currently, only for the first log group this is used

Inits a log group to the log system.

Parameters
idin: group id
n_filesin: number of log files
file_sizein: log file size in bytes
space_idin: space id of the file space which contains the log files of this group
archive_space_idin: space id of the file space which contains some archived log files for this group; currently, only for the first log group this is used

Definition at line 925 of file log0log.cc.

◆ log_group_read_checkpoint_info()

UNIV_INTERN void log_group_read_checkpoint_info ( log_group_t * group,
ulint field )

Reads a checkpoint info from a log group header to log_sys->checkpoint_buf. in: LOG_CHECKPOINT_1 or LOG_CHECKPOINT_2

Reads a checkpoint info from a log group header to log_sys->checkpoint_buf.

Parameters
groupin: log group
fieldin: LOG_CHECKPOINT_1 or LOG_CHECKPOINT_2

Definition at line 1969 of file log0log.cc.

◆ log_group_read_log_seg()

UNIV_INTERN void log_group_read_log_seg ( ulint type,
byte * buf,
log_group_t * group,
ib_uint64_t start_lsn,
ib_uint64_t end_lsn )

Reads a specified log segment to a buffer. in: read area end

Reads a specified log segment to a buffer.

Parameters
typein: LOG_ARCHIVE or LOG_RECOVER
bufin: buffer where to read
groupin: log group
start_lsnin: read area start
end_lsnin: read area end

Definition at line 2229 of file log0log.cc.

◆ log_group_set_fields()

UNIV_INTERN void log_group_set_fields ( log_group_t * group,
ib_uint64_t lsn )

Sets the field values in group to correspond to a given lsn. For this function to work, the values must already be correctly initialized to correspond to some lsn, for instance, a checkpoint lsn. in: lsn for which the values should be set

Sets the field values in group to correspond to a given lsn. For this function to work, the values must already be correctly initialized to correspond to some lsn, for instance, a checkpoint lsn.

Parameters
groupin/out: group
lsnin: lsn for which the values should be set

Definition at line 676 of file log0log.cc.

◆ log_group_write_buf()

UNIV_INTERN void log_group_write_buf ( log_group_t * group,
byte * buf,
ulint len,
ib_uint64_t start_lsn,
ulint new_data_offset )

Writes a buffer to a log file group. in: start offset of new data in buf: this parameter is used to decide if we have to write a new log file header

Writes a buffer to a log file group.

Parameters
groupin: log group
bufin: buffer
lenin: buffer len; must be divisible by OS_FILE_LOG_BLOCK_SIZE
start_lsnin: start lsn of the buffer; must be divisible by OS_FILE_LOG_BLOCK_SIZE
new_data_offsetin: start offset of new data in buf: this parameter is used to decide if we have to write a new log file header

Definition at line 1255 of file log0log.cc.

◆ log_groups_write_checkpoint_info()

UNIV_INTERN void log_groups_write_checkpoint_info ( void )

Writes checkpoint info to groups.

Definition at line 1987 of file log0log.cc.

◆ log_init()

UNIV_INTERN void log_init ( void )

Initializes the log.

Definition at line 801 of file log0log.cc.

◆ log_io_complete()

UNIV_INTERN void log_io_complete ( log_group_t * group)

Completes an i/o to a log file. in: log group

Completes an i/o to a log file.

< We currently use synchronous writing of the logs and cannot end up here!

Parameters
groupin: log group or a dummy pointer

Definition at line 1117 of file log0log.cc.

◆ log_make_checkpoint_at()

UNIV_INTERN void log_make_checkpoint_at ( ib_uint64_t lsn,
ibool write_always )

Makes a checkpoint at a given lsn or later. in: the function normally checks if the the new checkpoint would have a greater lsn than the previous one: if not, then no physical write is done; by setting this parameter TRUE, a physical write will always be made to log files

Makes a checkpoint at a given lsn or later.

Parameters
lsnin: make a checkpoint at this or a later lsn, if IB_ULONGLONG_MAX, makes a checkpoint at the latest lsn
write_alwaysin: the function normally checks if the the new checkpoint would have a greater lsn than the previous one: if not, then no physical write is done; by setting this parameter TRUE, a physical write will always be made to log files

Definition at line 2102 of file log0log.cc.

◆ log_mem_free()

UNIV_INTERN void log_mem_free ( void )

Definition at line 3514 of file log0log.cc.

◆ log_peek_lsn()

UNIV_INTERN ibool log_peek_lsn ( ib_uint64_t * lsn)

Peeks the current lsn.

Returns
TRUE if success, FALSE if could not get the log system mutex out: if returns TRUE, current lsn is here

Peeks the current lsn.

Returns
TRUE if success, FALSE if could not get the log system mutex
Parameters
lsnout: if returns TRUE, current lsn is here

Definition at line 3358 of file log0log.cc.

◆ log_preflush_pool_modified_pages()

UNIV_INTERN ibool log_preflush_pool_modified_pages ( ib_uint64_t new_oldest,
ibool sync )

Advances the smallest lsn for which there are unflushed dirty blocks in the buffer pool and also may make a new checkpoint. NOTE: this function may only be called if the calling thread owns no synchronization objects!

Returns
FALSE if there was a flush batch of the same type running, which means that we could not start this flush batch in: TRUE if synchronous operation is desired

Advances the smallest lsn for which there are unflushed dirty blocks in the buffer pool. NOTE: this function may only be called if the calling thread owns no synchronization objects!

Returns
FALSE if there was a flush batch of the same type running, which means that we could not start this flush batch
Parameters
new_oldestin: try to advance oldest_modified_lsn at least to this lsn
syncin: TRUE if synchronous operation is desired

Definition at line 1676 of file log0log.cc.

◆ log_print()

UNIV_INTERN void log_print ( FILE * file)

Prints info of the log. in: file where to print

Prints info of the log.

Parameters
filein: file where to print

Definition at line 3377 of file log0log.cc.

◆ log_refresh_stats()

UNIV_INTERN void log_refresh_stats ( void )

Refreshes the statistics used to print per-second averages.

Definition at line 3427 of file log0log.cc.

◆ log_release()

UNIV_INLINE void log_release ( void )

Releases the log mutex.

◆ log_reserve_and_open()

UNIV_INTERN ib_uint64_t log_reserve_and_open ( ulint len)

Opens the log for log_write_low. The log must be closed with log_close and released with log_release.

Returns
start lsn of the log record in: length of data to be catenated

Opens the log for log_write_low. The log must be closed with log_close and released with log_release.

Returns
start lsn of the log record
Parameters
lenin: length of data to be catenated

Definition at line 225 of file log0log.cc.

◆ log_reserve_and_write_fast()

UNIV_INLINE ib_uint64_t log_reserve_and_write_fast ( const void * str,
ulint len,
ib_uint64_t * start_lsn )

Writes to the log the string given. The log must be released with log_release.

Returns
end lsn of the log record, zero if did not succeed out: start lsn of the log record
Parameters
strin: string
lenin: string length

◆ log_shutdown()

UNIV_INTERN void log_shutdown ( void )

Definition at line 3468 of file log0log.cc.

◆ log_write_low()

UNIV_INTERN void log_write_low ( byte * str,
ulint str_len )

Writes to the log the string given. It is assumed that the caller holds the log mutex. in: string length

Writes to the log the string given. It is assumed that the caller holds the log mutex.

Parameters
strin: string
str_lenin: string length

Definition at line 299 of file log0log.cc.

◆ log_write_up_to()

UNIV_INTERN void log_write_up_to ( ib_uint64_t lsn,
ulint wait,
ibool flush_to_disk )

This function is called, e.g., when a transaction wants to commit. It checks that the log has been written to the log file up to the last log entry written by the transaction. If there is a flush running, it waits and checks if the flush flushed enough. If not, starts a new flush. in: TRUE if we want the written log also to be flushed to disk

This function is called, e.g., when a transaction wants to commit. It checks that the log has been written to the log file up to the last log entry written by the transaction. If there is a flush running, it waits and checks if the flush flushed enough. If not, starts a new flush.

< We assume here that we have only one log group!

Parameters
lsnin: log sequence number up to which the log should be written, IB_ULONGLONG_MAX if not specified
waitin: LOG_NO_WAIT, LOG_WAIT_ONE_GROUP, or LOG_WAIT_ALL_GROUPS
flush_to_diskin: TRUE if we want the written log also to be flushed to disk

Definition at line 1376 of file log0log.cc.

◆ logs_empty_and_mark_files_at_shutdown()

UNIV_INTERN void logs_empty_and_mark_files_at_shutdown ( void )

Makes a checkpoint at the latest lsn and writes it to first page of each data file in the database, so that we know that the file spaces contain all modifications up to that lsn. This can only be called at database shutdown. This function also writes all log in log files to the log archive.

Definition at line 3118 of file log0log.cc.

Variable Documentation

◆ log_sys

log_t* log_sys
extern

Definition at line 86 of file log0log.cc.