MySQL 5.6.14 Source Code Document
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
log0recv.h File Reference
#include "univ.i"
#include "ut0byte.h"
#include "buf0types.h"
#include "hash0hash.h"
#include "log0log.h"
#include "log0recv.ic"
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_t
struct  recv_t
struct  recv_addr_t
struct  recv_sys_t

Macros

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

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 dberr_t recv_recovery_from_checkpoint_start_func (lsn_t min_flushed_lsn, lsn_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, lsn_t start_lsn, lsn_t *contiguous_lsn, lsn_t *group_scanned_lsn)
UNIV_INTERN void recv_reset_logs (lsn_t lsn)
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_trecv_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

#define RECV_PARSING_BUF_SIZE   (2 * 1024 * 1024)
Size of the parsing buffer; it must accommodate RECV_SCAN_SIZE many

times!

Definition at line 474 of file log0recv.h.

#define recv_recover_page (   jri,
  block 
)    recv_recover_page_func(jri, block)
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 112 of file log0recv.h.

#define recv_recovery_from_checkpoint_start (   type,
  lim,
  min,
  max 
)    recv_recovery_from_checkpoint_start_func(min,max)
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 168 of file log0recv.h.

#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 478 of file log0recv.h.

Enumeration Type Documentation

States of recv_addr_t

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 347 of file log0recv.h.

Function Documentation

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 1819 of file log0recv.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

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 1552 of file log0recv.cc.

Here is the call graph for this function:

UNIV_INTERN void recv_recovery_from_checkpoint_finish ( void  )

Completes recovery from a checkpoint.

Definition at line 3364 of file log0recv.cc.

Here is the call graph for this function:

UNIV_INTERN dberr_t recv_recovery_from_checkpoint_start_func ( lsn_t  min_flushed_lsn,
lsn_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 2988 of file log0recv.cc.

Here is the call graph for this function:

UNIV_INLINE ibool recv_recovery_is_on ( void  )

Returns TRUE if recovery is currently running.

Returns
recv_recovery_on

Here is the caller graph for this function:

UNIV_INTERN void recv_recovery_rollback_active ( void  )

Initiates the rollback of active transactions.

Definition at line 3447 of file log0recv.cc.

Here is the call graph for this function:

UNIV_INTERN void recv_reset_logs ( lsn_t  lsn)

Resets the logs. The contents of log files will be lost! in: reset to this lsn rounded up to be divisible by OS_FILE_LOG_BLOCK_SIZE, after which we add LOG_BLOCK_HDR_SIZE

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

Definition at line 3488 of file log0recv.cc.

Here is the call graph for this function:

UNIV_INTERN ibool recv_scan_log_recs ( ulint  available_memory,
ibool  store_to_hash,
const byte *  buf,
ulint  len,
lsn_t  start_lsn,
lsn_t *  contiguous_lsn,
lsn_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 2653 of file log0recv.cc.

Here is the call graph for this function:

UNIV_INTERN void recv_sys_close ( void  )

Release recovery system mutexes.

Definition at line 215 of file log0recv.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

UNIV_INTERN void recv_sys_create ( void  )

Creates the recovery system.

Definition at line 190 of file log0recv.cc.

Here is the caller graph for this function:

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 374 of file log0recv.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

UNIV_INTERN void recv_sys_mem_free ( void  )

Frees the recovery system memory.

Definition at line 251 of file log0recv.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

UNIV_INTERN void recv_sys_var_init ( void  )

Reset the state of the recovery system variables.

Definition at line 281 of file log0recv.cc.

Here is the caller graph for this function:

Variable Documentation

ibool recv_lsn_checks_on
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 91 of file log0recv.cc.

ulint recv_max_parsed_page_no

Maximum page number encountered in the redo log

Definition at line 137 of file log0recv.cc.

ulint recv_n_pool_free_frames
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 145 of file log0recv.cc.

ibool recv_needed_recovery

TRUE when recv_init_crash_recovery() has been called.

Definition at line 81 of file log0recv.cc.

ibool recv_no_ibuf_operations
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 112 of file log0recv.cc.

ibool recv_recovery_on
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 73 of file log0recv.cc.

recv_sys_t* recv_sys

The recovery system

Definition at line 69 of file log0recv.cc.