mirror of
https://github.com/MariaDB/server.git
synced 2025-01-31 11:01:52 +01:00
16d308e21d
This bug affects both writing and reading encrypted redo log in MariaDB 10.1, starting from version 10.1.3 which added support for innodb_encrypt_log. That is, InnoDB crash recovery and Mariabackup will sometimes fail when innodb_encrypt_log is used. MariaDB 10.2 or Mariabackup 10.2 or later versions are not affected. log_block_get_start_lsn(): Remove. This function would cause trouble if a log segment that is being read is crossing a 32-bit boundary of the LSN, because this function does not allow the most significant 32 bits of the LSN to change. log_blocks_crypt(), log_encrypt_before_write(), log_decrypt_after_read(): Add the parameter "lsn" for the start LSN of the block. log_blocks_encrypt(): Remove (unused function).
174 lines
5.6 KiB
C
174 lines
5.6 KiB
C
/*****************************************************************************
|
|
|
|
Copyright (C) 2013, 2015, Google Inc. All Rights Reserved.
|
|
Copyright (C) 2014, 2018, MariaDB Corporation.
|
|
|
|
This program is free software; you can redistribute it and/or modify it under
|
|
the terms of the GNU General Public License as published by the Free Software
|
|
Foundation; version 2 of the License.
|
|
|
|
This program is distributed in the hope that it will be useful, but WITHOUT
|
|
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
|
|
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License along with
|
|
this program; if not, write to the Free Software Foundation, Inc.,
|
|
51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
|
|
*****************************************************************************/
|
|
/**************************************************//**
|
|
@file include/log0crypt.h
|
|
Innodb log encrypt/decrypt
|
|
|
|
Created 11/25/2013 Minli Zhu
|
|
Modified Jan Lindström jan.lindstrom@mariadb.com
|
|
*******************************************************/
|
|
#ifndef log0crypt_h
|
|
#define log0crypt_h
|
|
|
|
#include "univ.i"
|
|
#include "ut0byte.h"
|
|
#include "my_crypt.h"
|
|
#include "os0file.h"
|
|
|
|
typedef int Crypt_result;
|
|
|
|
/* If true, enable redo log encryption. */
|
|
extern my_bool srv_encrypt_log;
|
|
|
|
/***********************************************************************
|
|
Set next checkpoint's key version to latest one, and generate new key */
|
|
UNIV_INTERN
|
|
void
|
|
log_crypt_set_ver_and_key(
|
|
/*======================*/
|
|
ib_uint64_t next_checkpoint_no);/*!< in: next checkpoint no */
|
|
|
|
|
|
/*********************************************************************//**
|
|
Writes the crypto (version, msg and iv) info, which has been used for
|
|
log blocks with lsn <= this checkpoint's lsn, to a log header's
|
|
checkpoint buf. */
|
|
UNIV_INTERN
|
|
void
|
|
log_crypt_write_checkpoint_buf(
|
|
/*===========================*/
|
|
byte* buf); /*!< in/out: checkpoint buffer */
|
|
|
|
/*********************************************************************//**
|
|
Read the crypto (version, msg and iv) info, which has been used for
|
|
log blocks with lsn <= this checkpoint's lsn, from a log header's
|
|
checkpoint buf. */
|
|
UNIV_INTERN
|
|
bool
|
|
log_crypt_read_checkpoint_buf(
|
|
/*===========================*/
|
|
const byte* buf); /*!< in: checkpoint buffer */
|
|
|
|
/********************************************************
|
|
Encrypt one or more log block before it is flushed to disk */
|
|
UNIV_INTERN
|
|
void
|
|
log_encrypt_before_write(
|
|
/*=====================*/
|
|
ib_uint64_t next_checkpoint_no, /*!< in: log group to be flushed */
|
|
byte* block, /*!< in/out: pointer to a log block */
|
|
lsn_t lsn, /*!< in: log sequence number of
|
|
the start of the buffer */
|
|
const ulint size); /*!< in: size of log blocks */
|
|
|
|
/********************************************************
|
|
Decrypt a specified log segment after they are read from a log file to a buffer.
|
|
*/
|
|
UNIV_INTERN
|
|
void
|
|
log_decrypt_after_read(
|
|
/*===================*/
|
|
byte* frame, /*!< in/out: log segment */
|
|
lsn_t lsn, /*!< in: log sequence number of the start
|
|
of the buffer */
|
|
const ulint size); /*!< in: log segment size */
|
|
|
|
/* Error codes for crypt info */
|
|
typedef enum {
|
|
LOG_UNENCRYPTED = 0,
|
|
LOG_CRYPT_KEY_NOT_FOUND = 1,
|
|
LOG_DECRYPT_MAYBE_FAILED = 2
|
|
} log_crypt_err_t;
|
|
|
|
/********************************************************
|
|
Check is the checkpoint information encrypted. This check
|
|
is based on fact has log group crypt info and based
|
|
on this crypt info was the key version different from
|
|
unencrypted key version. There is no realible way to
|
|
distinguish encrypted log block from corrupted log block,
|
|
but if log block corruption is found this function is
|
|
used to find out if log block is maybe encrypted but
|
|
encryption key, key management plugin or encryption
|
|
algorithm does not match.
|
|
@return TRUE, if log block may be encrypted */
|
|
UNIV_INTERN
|
|
ibool
|
|
log_crypt_block_maybe_encrypted(
|
|
/*============================*/
|
|
const byte* log_block, /*!< in: log block */
|
|
log_crypt_err_t* err_info); /*!< out: error info */
|
|
|
|
/********************************************************
|
|
Print crypt error message to error log */
|
|
UNIV_INTERN
|
|
void
|
|
log_crypt_print_error(
|
|
/*==================*/
|
|
log_crypt_err_t err_info); /*!< out: error info */
|
|
|
|
/*********************************************************************//**
|
|
Print checkpoint no from log block and all encryption keys from
|
|
checkpoints if they are present. Used for problem analysis. */
|
|
void
|
|
log_crypt_print_checkpoint_keys(
|
|
/*============================*/
|
|
const byte* log_block);
|
|
|
|
/** Encrypt temporary log block.
|
|
@param[in] src_block block to encrypt or decrypt
|
|
@param[in] size size of the block
|
|
@param[out] dst_block destination block
|
|
@param[in] offs offset to block
|
|
@param[in] space_id tablespace id
|
|
@return true if successfull, false in case of failure
|
|
*/
|
|
UNIV_INTERN
|
|
bool
|
|
log_tmp_block_encrypt(
|
|
const byte* src_block,
|
|
ulint size,
|
|
byte* dst_block,
|
|
os_offset_t offs,
|
|
ulint space_id)
|
|
MY_ATTRIBUTE((warn_unused_result));
|
|
|
|
/** Decrypt temporary log block.
|
|
@param[in] src_block block to encrypt or decrypt
|
|
@param[in] size size of the block
|
|
@param[out] dst_block destination block
|
|
@param[in] offs offset to block
|
|
@param[in] space_id tablespace id
|
|
@return true if successfull, false in case of failure
|
|
*/
|
|
UNIV_INTERN
|
|
bool
|
|
log_tmp_block_decrypt(
|
|
const byte* src_block,
|
|
ulint size,
|
|
byte* dst_block,
|
|
os_offset_t offs,
|
|
ulint space_id)
|
|
MY_ATTRIBUTE((warn_unused_result));
|
|
|
|
/** Find out is temporary log files encrypted.
|
|
@return true if temporary log file should be encrypted, false if not */
|
|
UNIV_INTERN
|
|
bool
|
|
log_tmp_is_encrypted() MY_ATTRIBUTE((warn_unused_result));
|
|
#endif // log0crypt.h
|