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

Go to the source code of this file.

Classes

struct  recv_data_struct
struct  recv_struct
struct  recv_addr_struct
struct  recv_sys_struct

Macros

#define log0recv_h
#define recv_recover_page(jri, block)
#define recv_recovery_from_checkpoint_start(type, lim, min, max)
#define RECV_PARSING_BUF_SIZE   (2 * 1024 * 1024)
#define RECV_SCAN_SIZE   (4 * UNIV_PAGE_SIZE)

Typedefs

typedef struct recv_data_struct recv_data_t
typedef struct recv_struct recv_t
typedef struct recv_addr_struct recv_addr_t
typedef struct recv_sys_struct recv_sys_t

Enumerations

enum  recv_addr_state { RECV_NOT_PROCESSED , RECV_BEING_READ , RECV_BEING_PROCESSED , RECV_PROCESSED }

Functions

UNIV_INLINE ibool recv_recovery_is_on (void)
UNIV_INTERN void recv_recover_page_func (ibool just_read_in, buf_block_t *block)
UNIV_INTERN ulint recv_recovery_from_checkpoint_start_func (ib_uint64_t min_flushed_lsn, ib_uint64_t max_flushed_lsn)
UNIV_INTERN void recv_recovery_from_checkpoint_finish (void)
UNIV_INTERN void recv_recovery_rollback_active (void)
UNIV_INTERN ibool recv_scan_log_recs (ulint available_memory, ibool store_to_hash, const byte *buf, ulint len, ib_uint64_t start_lsn, ib_uint64_t *contiguous_lsn, ib_uint64_t *group_scanned_lsn)
UNIV_INTERN void recv_reset_logs (ib_uint64_t lsn, ibool new_logs_created)
UNIV_INTERN void recv_sys_create (void)
UNIV_INTERN void recv_sys_close (void)
UNIV_INTERN void recv_sys_mem_free (void)
UNIV_INTERN void recv_sys_init (ulint available_memory)
UNIV_INTERN void recv_sys_var_init (void)
UNIV_INTERN void recv_apply_hashed_log_recs (ibool allow_ibuf)

Variables

recv_sys_t * recv_sys
ibool recv_recovery_on
ibool recv_no_ibuf_operations
ibool recv_needed_recovery
ibool recv_lsn_checks_on
ulint recv_max_parsed_page_no
ulint recv_n_pool_free_frames

Detailed Description

Recovery

Created 9/20/1997 Heikki Tuuri

Definition in file log0recv.h.

Macro Definition Documentation

◆ log0recv_h

#define log0recv_h

Definition at line 28 of file log0recv.h.

◆ RECV_PARSING_BUF_SIZE

#define RECV_PARSING_BUF_SIZE   (2 * 1024 * 1024)

Size of the parsing buffer; it must accommodate RECV_SCAN_SIZE many times!

Definition at line 482 of file log0recv.h.

◆ recv_recover_page

#define recv_recover_page ( jri,
block )
Value:
UNIV_INTERN void recv_recover_page_func(ibool just_read_in, buf_block_t *block)
Definition log0recv.cc:1468

Wrapper for recv_recover_page_func(). Applies the hashed log records to the page, if the page lsn is less than the lsn of a log record. This can be called when a buffer page has just been read in, or also for a page already in the buffer pool.

Parameters
jriin: TRUE if just read in (the i/o handler calls this for a freshly read page)
blockin/out: the buffer block

Definition at line 115 of file log0recv.h.

◆ recv_recovery_from_checkpoint_start

#define recv_recovery_from_checkpoint_start ( type,
lim,
min,
max )
Value:
UNIV_INTERN ulint recv_recovery_from_checkpoint_start_func(ib_uint64_t min_flushed_lsn, ib_uint64_t max_flushed_lsn)
Definition log0recv.cc:2882

Wrapper for recv_recovery_from_checkpoint_start_func(). Recovers from a checkpoint. When this function returns, the database is able to start processing of new user transactions, but the function recv_recovery_from_checkpoint_finish should be called later to complete the recovery and free the resources used in it.

Parameters
typeignored: LOG_CHECKPOINT or LOG_ARCHIVE
limignored: recover up to this log sequence number if possible
minin: minimum flushed log sequence number from data files
maxin: maximum flushed log sequence number from data files
Returns
error code or DB_SUCCESS

Definition at line 171 of file log0recv.h.

◆ RECV_SCAN_SIZE

#define RECV_SCAN_SIZE   (4 * UNIV_PAGE_SIZE)

Size of block reads when the log groups are scanned forward to do a roll-forward

Definition at line 486 of file log0recv.h.

Typedef Documentation

◆ recv_addr_t

typedef struct recv_addr_struct recv_addr_t

Hashed page file address struct

Definition at line 367 of file log0recv.h.

◆ recv_data_t

typedef struct recv_data_struct recv_data_t

Block of log record data

Definition at line 324 of file log0recv.h.

◆ recv_sys_t

typedef struct recv_sys_struct recv_sys_t

Recovery system data structure

Definition at line 380 of file log0recv.h.

◆ recv_t

typedef struct recv_struct recv_t

Stored log record struct

Definition at line 334 of file log0recv.h.

Enumeration Type Documentation

◆ recv_addr_state

States of recv_addr_struct

Enumerator
RECV_NOT_PROCESSED 

not yet processed

RECV_BEING_READ 

page is being read

RECV_BEING_PROCESSED 

log records are being applied on the page

RECV_PROCESSED 

log records have been applied on the page, or they have been discarded because the tablespace does not exist

Definition at line 354 of file log0recv.h.

Function Documentation

◆ recv_apply_hashed_log_recs()

UNIV_INTERN void recv_apply_hashed_log_recs ( ibool allow_ibuf)

Empties the hash table of stored log records, applying them to appropriate pages. in: if TRUE, also ibuf operations are allowed during the application; if FALSE, no ibuf operations are allowed, and after the application all file pages are flushed to disk and invalidated in buffer pool: this alternative means that no new log records can be generated during the application

Empties the hash table of stored log records, applying them to appropriate pages.

Parameters
allow_ibufin: if TRUE, also ibuf operations are allowed during the application; if FALSE, no ibuf operations are allowed, and after the application all file pages are flushed to disk and invalidated in buffer pool: this alternative means that no new log records can be generated during the application; the caller must in this case own the log mutex

Definition at line 1738 of file log0recv.cc.

◆ recv_recover_page_func()

UNIV_INTERN void recv_recover_page_func ( ibool just_read_in,
buf_block_t * block )

Applies the hashed log records to the page, if the page lsn is less than the lsn of a log record. This can be called when a buffer page has just been read in, or also for a page already in the buffer pool. in/out: buffer block

Applies the hashed log records to the page, if the page lsn is less than the lsn of a log record. This can be called when a buffer page has just been read in, or also for a page already in the buffer pool.

Parameters
just_read_inin: TRUE if the i/o handler calls this for a freshly read page
blockin/out: buffer block

Definition at line 1468 of file log0recv.cc.

◆ recv_recovery_from_checkpoint_finish()

UNIV_INTERN void recv_recovery_from_checkpoint_finish ( void )

Completes recovery from a checkpoint.

Definition at line 3255 of file log0recv.cc.

◆ recv_recovery_from_checkpoint_start_func()

UNIV_INTERN ulint recv_recovery_from_checkpoint_start_func ( ib_uint64_t min_flushed_lsn,
ib_uint64_t max_flushed_lsn )

Recovers from a checkpoint. When this function returns, the database is able to start processing of new user transactions, but the function recv_recovery_from_checkpoint_finish should be called later to complete the recovery and free the resources used in it.

Returns
error code or DB_SUCCESS in: max flushed lsn from data files

Recovers from a checkpoint. When this function returns, the database is able to start processing of new user transactions, but the function recv_recovery_from_checkpoint_finish should be called later to complete the recovery and free the resources used in it.

Returns
error code or DB_SUCCESS

TRUE when recovering from a checkpoint

Recover up to this log sequence number

Parameters
min_flushed_lsnin: min flushed lsn from data files
max_flushed_lsnin: max flushed lsn from data files

Definition at line 2882 of file log0recv.cc.

◆ recv_recovery_is_on()

UNIV_INLINE ibool recv_recovery_is_on ( void )

Returns TRUE if recovery is currently running.

Returns
recv_recovery_on

◆ recv_recovery_rollback_active()

UNIV_INTERN void recv_recovery_rollback_active ( void )

Initiates the rollback of active transactions.

Definition at line 3299 of file log0recv.cc.

◆ recv_reset_logs()

UNIV_INTERN void recv_reset_logs ( ib_uint64_t lsn,
ibool new_logs_created )

Resets the logs. The contents of log files will be lost! in: TRUE if resetting logs is done at the log creation; FALSE if it is done after archive recovery

Resets the logs. The contents of log files will be lost!

Parameters
lsnin: reset to this lsn rounded up to be divisible by OS_FILE_LOG_BLOCK_SIZE, after which we add LOG_BLOCK_HDR_SIZE
new_logs_createdin: TRUE if resetting logs is done at the log creation; FALSE if it is done after archive recovery

Definition at line 3330 of file log0recv.cc.

◆ recv_scan_log_recs()

UNIV_INTERN ibool recv_scan_log_recs ( ulint available_memory,
ibool store_to_hash,
const byte * buf,
ulint len,
ib_uint64_t start_lsn,
ib_uint64_t * contiguous_lsn,
ib_uint64_t * group_scanned_lsn )

Scans log from a buffer and stores new log data to the parsing buffer. Parses and hashes the log records if new data found. Unless UNIV_HOTBACKUP is defined, this function will apply log records automatically when the hash table becomes full.

Returns
TRUE if limit_lsn has been reached, or not able to scan any more in this log group out: scanning succeeded up to this lsn

Scans log from a buffer and stores new log data to the parsing buffer. Parses and hashes the log records if new data found. Unless UNIV_HOTBACKUP is defined, this function will apply log records automatically when the hash table becomes full.

Returns
TRUE if limit_lsn has been reached, or not able to scan any more in this log group
Parameters
available_memoryin: we let the hash table of recs to grow to this size, at the maximum
store_to_hashin: TRUE if the records should be stored to the hash table; this is set to FALSE if just debug checking is needed
bufin: buffer containing a log segment or garbage
lenin: buffer length
start_lsnin: buffer start lsn
contiguous_lsnin/out: it is known that all log groups contain contiguous log data up to this lsn
group_scanned_lsnout: scanning succeeded up to this lsn

Definition at line 2562 of file log0recv.cc.

◆ recv_sys_close()

UNIV_INTERN void recv_sys_close ( void )

Release recovery system mutexes.

Definition at line 201 of file log0recv.cc.

◆ recv_sys_create()

UNIV_INTERN void recv_sys_create ( void )

Creates the recovery system.

Definition at line 180 of file log0recv.cc.

◆ recv_sys_init()

UNIV_INTERN void recv_sys_init ( ulint available_memory)

Inits the recovery system for a recovery operation. in: available memory in bytes

Parameters
available_memoryin: available memory in bytes

Definition at line 303 of file log0recv.cc.

◆ recv_sys_mem_free()

UNIV_INTERN void recv_sys_mem_free ( void )

Frees the recovery system memory.

Definition at line 232 of file log0recv.cc.

◆ recv_sys_var_init()

UNIV_INTERN void recv_sys_var_init ( void )

Reset the state of the recovery system variables.

Definition at line 262 of file log0recv.cc.

Variable Documentation

◆ recv_lsn_checks_on

ibool recv_lsn_checks_on
extern

TRUE if buf_page_is_corrupted() should check if the log sequence number (FIL_PAGE_LSN) is in the future. Initially FALSE, and set by recv_recovery_from_checkpoint_start_func().

Definition at line 95 of file log0recv.cc.

◆ recv_max_parsed_page_no

ulint recv_max_parsed_page_no
extern

Maximum page number encountered in the redo log

Definition at line 141 of file log0recv.cc.

◆ recv_n_pool_free_frames

ulint recv_n_pool_free_frames
extern

This many frames must be left free in the buffer pool when we scan the log and store the scanned log records in the buffer pool: we will use these free frames to read in pages when we start applying the log records to the database.

This many frames must be left free in the buffer pool when we scan the log and store the scanned log records in the buffer pool: we will use these free frames to read in pages when we start applying the log records to the database. This is the default value. If the actual size of the buffer pool is larger than 10 MB we'll set this value to 512.

Definition at line 149 of file log0recv.cc.

◆ recv_needed_recovery

ibool recv_needed_recovery
extern

TRUE when recv_init_crash_recovery() has been called.

Definition at line 85 of file log0recv.cc.

◆ recv_no_ibuf_operations

ibool recv_no_ibuf_operations
extern

If the following is TRUE, the buffer pool file pages must be invalidated after recovery and no ibuf operations are allowed; this becomes TRUE if the log record hash table becomes too full, and log records must be merged to file pages already before the recovery is finished: in this case no ibuf operations are allowed, as they could modify the pages read in the buffer pool before the pages have been recovered to the up-to-date state.

TRUE means that recovery is running and no operations on the log files are allowed yet: the variable name is misleading.

Definition at line 116 of file log0recv.cc.

◆ recv_recovery_on

ibool recv_recovery_on
extern

TRUE when applying redo log records during crash recovery; FALSE otherwise. Note that this is FALSE while a background thread is rolling back incomplete transactions.

Definition at line 77 of file log0recv.cc.

◆ recv_sys

recv_sys_t* recv_sys
extern

The recovery system

Definition at line 73 of file log0recv.cc.