#include "fil0types.h"
#include "univ.i"

Classes
class	fseg_header
	A wrapper class to print the file segment header information. More...

Macros
#define	FSP_EXTENT_SIZE
	File space extent size in pages page size \| file space extent size -------—+--------------------— 4 KiB \| 256 pages = 1 MiB 8 KiB \| 128 pages = 1 MiB 16 KiB \| 64 pages = 1 MiB 32 KiB \| 64 pages = 2 MiB 64 KiB \| 64 pages = 4 MiB. More...

Enumerations
enum	fsp_reserve_t { FSP_NORMAL , FSP_UNDO , FSP_CLEANING , FSP_BLOB }
	Flags for fsp_reserve_free_extents. More...

Functions
std::ostream &	operator<< (std::ostream &out, const fseg_header &header)

bool	fsp_flags_is_valid (uint32_t flags)
	Validate the tablespace flags. More...

bool	fsp_is_system_temporary (space_id_t space_id)
	Check if tablespace is system temporary. More...

bool	fsp_is_session_temporary (space_id_t space_id)
	Check if the tablespace is session temporary. More...

bool	fsp_is_global_temporary (space_id_t space_id)
	Check if tablespace is global temporary. More...

bool	fsp_is_checksum_disabled (space_id_t space_id)
	Check if checksum is disabled for the given space. More...

bool	fsp_skip_sanity_check (space_id_t space_id)
	Skip some of the sanity checks that are time consuming even in debug mode and can affect frequent verification runs that are done to ensure stability of the product. More...

constexpr uint32_t	FSP_FLAGS_GET_POST_ANTELOPE (uint32_t flags)
	Return the value of the POST_ANTELOPE field. More...

constexpr uint32_t	FSP_FLAGS_GET_ZIP_SSIZE (uint32_t flags)
	Return the value of the ZIP_SSIZE field. More...

constexpr uint32_t	FSP_FLAGS_HAS_ATOMIC_BLOBS (uint32_t flags)
	Return the value of the ATOMIC_BLOBS field. More...

constexpr uint32_t	FSP_FLAGS_GET_PAGE_SSIZE (uint32_t flags)
	Return the value of the PAGE_SSIZE field. More...

constexpr uint32_t	FSP_FLAGS_HAS_DATA_DIR (uint32_t flags)
	Return the value of the DATA_DIR field. More...

constexpr uint32_t	FSP_FLAGS_GET_SHARED (uint32_t flags)
	Return the contents of the SHARED field. More...

constexpr uint32_t	FSP_FLAGS_GET_TEMPORARY (uint32_t flags)
	Return the contents of the TEMPORARY field. More...

constexpr uint32_t	FSP_FLAGS_GET_ENCRYPTION (uint32_t flags)
	Return the contents of the ENCRYPTION field. More...

constexpr uint32_t	FSP_FLAGS_HAS_SDI (uint32_t flags)
	Return the value of the SDI field. More...

constexpr uint32_t	FSP_FLAGS_GET_UNUSED (uint32_t flags)
	Return the contents of the UNUSED bits. More...

constexpr bool	FSP_FLAGS_ARE_NOT_SET (uint32_t flags)
	Return true if flags are not set. More...

constexpr void	fsp_flags_set_encryption (uint32_t &flags)
	Set ENCRYPTION bit in tablespace flags. More...

constexpr void	fsp_flags_unset_encryption (uint32_t &flags)
	Set ENCRYPTION bit in tablespace flags. More...

constexpr void	fsp_flags_set_sdi (uint32_t &flags)
	Set SDI Index bit in tablespace flags. More...

constexpr void	fsp_flags_unset_sdi (uint32_t &flags)
	Set SDI Index bit in tablespace flags. More...

constexpr uint32_t	fsp_is_shared_tablespace (uint32_t flags)
	Use an alias in the code for FSP_FLAGS_GET_SHARED() More...

Variables
constexpr size_t	FSP_EXTENT_SIZE_MAX = 4194304 / UNIV_PAGE_SIZE_MAX
	File space extent size (four megabyte) in pages for MAX page size. More...

constexpr size_t	FSP_EXTENT_SIZE_MIN = 1048576 / UNIV_PAGE_SIZE_MIN
	File space extent size (one megabyte) in pages for MIN page size. More...

constexpr uint32_t	FSEG_PAGE_DATA = FIL_PAGE_DATA
	On a page of any file segment, data may be put starting from this offset. More...

constexpr uint32_t	FSP_FLAGS_WIDTH_POST_ANTELOPE = 1
	Width of the POST_ANTELOPE flag. More...

constexpr uint32_t	FSP_FLAGS_WIDTH_ZIP_SSIZE = 4
	Number of flag bits used to indicate the tablespace zip page size. More...

constexpr uint32_t	FSP_FLAGS_WIDTH_ATOMIC_BLOBS = 1
	Width of the ATOMIC_BLOBS flag. More...

constexpr uint32_t	FSP_FLAGS_WIDTH_PAGE_SSIZE = 4
	Number of flag bits used to indicate the tablespace page size. More...

constexpr uint32_t	FSP_FLAGS_WIDTH_DATA_DIR = 1
	Width of the DATA_DIR flag. More...

constexpr uint32_t	FSP_FLAGS_WIDTH_SHARED = 1
	Width of the SHARED flag. More...

constexpr uint32_t	FSP_FLAGS_WIDTH_TEMPORARY = 1
	Width of the TEMPORARY flag. More...

constexpr uint32_t	FSP_FLAGS_WIDTH_ENCRYPTION = 1
	Width of the encryption flag. More...

constexpr uint32_t	FSP_FLAGS_WIDTH_SDI = 1
	Width of the SDI flag. More...

constexpr uint32_t	FSP_FLAGS_WIDTH
	Width of all the currently known tablespace flags. More...

constexpr uint32_t	FSP_FLAGS_MASK = ~(~0U << FSP_FLAGS_WIDTH)
	A mask of all the known/used bits in tablespace flags. More...

constexpr uint32_t	FSP_FLAGS_POS_POST_ANTELOPE = 0
	Zero relative shift position of the POST_ANTELOPE field. More...

constexpr uint32_t	FSP_FLAGS_POS_ZIP_SSIZE
	Zero relative shift position of the ZIP_SSIZE field. More...

constexpr uint32_t	FSP_FLAGS_POS_ATOMIC_BLOBS
	Zero relative shift position of the ATOMIC_BLOBS field. More...

constexpr uint32_t	FSP_FLAGS_POS_PAGE_SSIZE
	Zero relative shift position of the PAGE_SSIZE field. More...

constexpr uint32_t	FSP_FLAGS_POS_DATA_DIR
	Zero relative shift position of the start of the DATA_DIR bit. More...

constexpr uint32_t	FSP_FLAGS_POS_SHARED
	Zero relative shift position of the start of the SHARED bit. More...

constexpr uint32_t	FSP_FLAGS_POS_TEMPORARY
	Zero relative shift position of the start of the TEMPORARY bit. More...

constexpr uint32_t	FSP_FLAGS_POS_ENCRYPTION
	Zero relative shift position of the start of the ENCRYPTION bit. More...

constexpr uint32_t	FSP_FLAGS_POS_SDI
	Zero relative shift position of the start of the SDI bits. More...

constexpr uint32_t	FSP_FLAGS_POS_UNUSED
	Zero relative shift position of the start of the UNUSED bits. More...

constexpr uint32_t	FSP_FLAGS_MASK_POST_ANTELOPE
	Bit mask of the POST_ANTELOPE field. More...

constexpr uint32_t	FSP_FLAGS_MASK_ZIP_SSIZE
	Bit mask of the ZIP_SSIZE field. More...

constexpr uint32_t	FSP_FLAGS_MASK_ATOMIC_BLOBS
	Bit mask of the ATOMIC_BLOBS field. More...

constexpr uint32_t	FSP_FLAGS_MASK_PAGE_SSIZE
	Bit mask of the PAGE_SSIZE field. More...

constexpr uint32_t	FSP_FLAGS_MASK_DATA_DIR
	Bit mask of the DATA_DIR field. More...

constexpr uint32_t	FSP_FLAGS_MASK_SHARED
	Bit mask of the SHARED field. More...

constexpr uint32_t	FSP_FLAGS_MASK_TEMPORARY
	Bit mask of the TEMPORARY field. More...

constexpr uint32_t	FSP_FLAGS_MASK_ENCRYPTION
	Bit mask of the ENCRYPTION field. More...

constexpr uint32_t	FSP_FLAGS_MASK_SDI
	Bit mask of the SDI field. More...

constexpr size_t	TRX_SYS_N_RSEGS = 128
	Max number of rollback segments: the number of segment specification slots in the transaction system array; rollback segment id must fit in one (signed) byte, therefore 128; each slot is currently 8 bytes in size. More...

constexpr size_t	FSP_MIN_UNDO_TABLESPACES = 2
	Minimum and Maximum number of implicit undo tablespaces. More...

constexpr size_t	FSP_MAX_UNDO_TABLESPACES = TRX_SYS_N_RSEGS - 1

constexpr size_t	FSP_IMPLICIT_UNDO_TABLESPACES = 2

constexpr size_t	FSP_MAX_ROLLBACK_SEGMENTS = TRX_SYS_N_RSEGS

Flags for inserting records in order
If records are inserted in order, there are the following flags to tell this (their type is made byte for the compiler to warn if direction and hint parameters are switched in fseg_alloc_free_page)
constexpr byte	FSP_UP = 111
	alphabetically upwards More...

constexpr byte	FSP_DOWN = 112
	alphabetically downwards More...

constexpr byte	FSP_NO_DIR = 113
	no order More...

The space low address page map
The pages at FSP_XDES_OFFSET and FSP_IBUF_BITMAP_OFFSET are repeated every XDES_DESCRIBED_PER_PAGE pages in every tablespace.
constexpr uint32_t	FSP_XDES_OFFSET = 0
	extent descriptor More...

constexpr uint32_t	FSP_IBUF_BITMAP_OFFSET = 1
	insert buffer bitmap; The ibuf bitmap pages are the ones whose page number is the number above plus a multiple of XDES_DESCRIBED_PER_PAGE More...

constexpr uint32_t	FSP_FIRST_INODE_PAGE_NO = 2
	in every tablespace More...

constexpr uint32_t	FSP_IBUF_HEADER_PAGE_NO = 3
	The following pages exist in the system tablespace (space 0). More...

constexpr uint32_t	FSP_IBUF_TREE_ROOT_PAGE_NO = 4
	insert buffer B-tree root page in tablespace 0; The ibuf tree root page number in tablespace 0; its fseg inode is on the page number FSP_FIRST_INODE_PAGE_NO More...

constexpr uint32_t	FSP_TRX_SYS_PAGE_NO = 5
	transaction system header, in tablespace 0 More...

constexpr uint32_t	FSP_FIRST_RSEG_PAGE_NO = 6
	first rollback segment page, in tablespace 0 More...

constexpr uint32_t	FSP_DICT_HDR_PAGE_NO = 7
	data dictionary header page, in tablespace 0 More...

constexpr uint32_t	FSP_RSEG_ARRAY_PAGE_NO = 3
	rollback segment directory page number in each undo tablespace More...

File segment header
The file segment header points to the inode describing the file segment.
typedef byte	fseg_header_t
	Data type for file segment header. More...

constexpr uint32_t	FSEG_HDR_SPACE = 0
	space id of the inode More...

constexpr uint32_t	FSEG_HDR_PAGE_NO = 4
	page number of the inode More...

constexpr uint32_t	FSEG_HDR_OFFSET = 8
	byte offset of the inode More...

constexpr uint32_t	FSEG_HEADER_SIZE = 10
	Length of the file system header, in bytes. More...

Macro Definition Documentation

◆ FSP_EXTENT_SIZE

#define FSP_EXTENT_SIZE

Value:

  static_cast<page_no_t>(                                               \
      ((UNIV_PAGE_SIZE <= (16384)                                       \
            ? (1048576 / UNIV_PAGE_SIZE)                                \
            : ((UNIV_PAGE_SIZE <= (32768)) ? (2097152 / UNIV_PAGE_SIZE) \
                                           : (4194304 / UNIV_PAGE_SIZE)))))

Typedef Documentation

◆ fseg_header_t

typedef byte fseg_header_t

Data type for file segment header.

Enumeration Type Documentation

◆ fsp_reserve_t

enum fsp_reserve_t

Flags for fsp_reserve_free_extents.

Enumerator
FSP_NORMAL
FSP_UNDO
FSP_CLEANING
FSP_BLOB

Function Documentation

◆ fsp_flags_is_valid()

bool fsp_flags_is_valid ( uint32_t flags )

inline

Validate the tablespace flags.

These flags are stored in the tablespace header at offset FSP_SPACE_FLAGS. They should be 0 for ROW_FORMAT=COMPACT and ROW_FORMAT=REDUNDANT. The newer row formats, COMPRESSED and DYNAMIC, will have at least the DICT_TF_COMPACT bit set.

Parameters

[in] flags Tablespace flags

Returns: true if valid, false if not

◆ fsp_is_checksum_disabled()

bool fsp_is_checksum_disabled ( space_id_t space_id )

Check if checksum is disabled for the given space.

Parameters

[in] space_id tablespace ID

Returns: true if checksum is disabled for given space.

◆ fsp_is_global_temporary()

bool fsp_is_global_temporary ( space_id_t space_id )

Check if tablespace is global temporary.

Parameters

[in] space_id tablespace ID

Returns: true if tablespace is global temporary.

◆ fsp_is_session_temporary()

bool fsp_is_session_temporary ( space_id_t space_id )

Check if the tablespace is session temporary.

Parameters

[in] space_id tablespace ID

Returns: true if tablespace is a session temporary tablespace.

◆ fsp_is_system_temporary()

bool fsp_is_system_temporary ( space_id_t space_id )

Check if tablespace is system temporary.

Parameters

[in] space_id tablespace ID

Returns: true if tablespace is system temporary.

◆ fsp_skip_sanity_check()

bool fsp_skip_sanity_check ( space_id_t space_id )

Skip some of the sanity checks that are time consuming even in debug mode and can affect frequent verification runs that are done to ensure stability of the product.

Returns: true if check should be skipped for given space.

◆ operator<<()

std::ostream & operator<<	(	std::ostream &	out,
		const fseg_header &	header
	)

inline

Variable Documentation

◆ FSEG_HDR_OFFSET

constexpr uint32_t FSEG_HDR_OFFSET = 8

constexpr

byte offset of the inode

◆ FSEG_HDR_PAGE_NO

constexpr uint32_t FSEG_HDR_PAGE_NO = 4

constexpr

page number of the inode

◆ FSEG_HDR_SPACE

constexpr uint32_t FSEG_HDR_SPACE = 0

constexpr

space id of the inode

◆ FSEG_HEADER_SIZE

constexpr uint32_t FSEG_HEADER_SIZE = 10

constexpr

Length of the file system header, in bytes.

◆ FSEG_PAGE_DATA

constexpr uint32_t FSEG_PAGE_DATA = FIL_PAGE_DATA

constexpr

On a page of any file segment, data may be put starting from this offset.

◆ FSP_DICT_HDR_PAGE_NO

constexpr uint32_t FSP_DICT_HDR_PAGE_NO = 7

constexpr

data dictionary header page, in tablespace 0

◆ FSP_DOWN

constexpr byte FSP_DOWN = 112

constexpr

alphabetically downwards

◆ FSP_EXTENT_SIZE_MAX

constexpr size_t FSP_EXTENT_SIZE_MAX = 4194304 / UNIV_PAGE_SIZE_MAX

constexpr

File space extent size (four megabyte) in pages for MAX page size.

◆ FSP_EXTENT_SIZE_MIN

constexpr size_t FSP_EXTENT_SIZE_MIN = 1048576 / UNIV_PAGE_SIZE_MIN

constexpr

File space extent size (one megabyte) in pages for MIN page size.

◆ FSP_FIRST_INODE_PAGE_NO

constexpr uint32_t FSP_FIRST_INODE_PAGE_NO = 2

constexpr

in every tablespace

◆ FSP_FIRST_RSEG_PAGE_NO

constexpr uint32_t FSP_FIRST_RSEG_PAGE_NO = 6

constexpr

first rollback segment page, in tablespace 0

◆ FSP_IBUF_BITMAP_OFFSET

constexpr uint32_t FSP_IBUF_BITMAP_OFFSET = 1

constexpr

insert buffer bitmap; The ibuf bitmap pages are the ones whose page number is the number above plus a multiple of XDES_DESCRIBED_PER_PAGE

◆ FSP_IBUF_HEADER_PAGE_NO

constexpr uint32_t FSP_IBUF_HEADER_PAGE_NO = 3

constexpr

The following pages exist in the system tablespace (space 0).

insert buffer header page, in tablespace 0

◆ FSP_IBUF_TREE_ROOT_PAGE_NO

constexpr uint32_t FSP_IBUF_TREE_ROOT_PAGE_NO = 4

constexpr

insert buffer B-tree root page in tablespace 0; The ibuf tree root page number in tablespace 0; its fseg inode is on the page number FSP_FIRST_INODE_PAGE_NO

◆ FSP_IMPLICIT_UNDO_TABLESPACES

constexpr size_t FSP_IMPLICIT_UNDO_TABLESPACES = 2

constexpr

◆ FSP_MAX_ROLLBACK_SEGMENTS

constexpr size_t FSP_MAX_ROLLBACK_SEGMENTS = TRX_SYS_N_RSEGS

constexpr

◆ FSP_MAX_UNDO_TABLESPACES

constexpr size_t FSP_MAX_UNDO_TABLESPACES = TRX_SYS_N_RSEGS - 1

constexpr

◆ FSP_MIN_UNDO_TABLESPACES

constexpr size_t FSP_MIN_UNDO_TABLESPACES = 2

constexpr

Minimum and Maximum number of implicit undo tablespaces.

This kind of undo tablespace is always created and found in –innodb-undo-directory.

◆ FSP_NO_DIR

constexpr byte FSP_NO_DIR = 113

constexpr

no order

◆ FSP_RSEG_ARRAY_PAGE_NO

constexpr uint32_t FSP_RSEG_ARRAY_PAGE_NO = 3

constexpr

rollback segment directory page number in each undo tablespace

◆ FSP_TRX_SYS_PAGE_NO

constexpr uint32_t FSP_TRX_SYS_PAGE_NO = 5

constexpr

transaction system header, in tablespace 0

◆ FSP_UP

constexpr byte FSP_UP = 111

constexpr

alphabetically upwards

◆ FSP_XDES_OFFSET

constexpr uint32_t FSP_XDES_OFFSET = 0

constexpr

extent descriptor

◆ TRX_SYS_N_RSEGS

constexpr size_t TRX_SYS_N_RSEGS = 128

constexpr

Max number of rollback segments: the number of segment specification slots in the transaction system array; rollback segment id must fit in one (signed) byte, therefore 128; each slot is currently 8 bytes in size.

If you want to raise the level to 256 then you will need to fix some assertions that impose the 7 bit restriction. e.g., mach_write_to_3()

Classes

Macros

Enumerations

Functions

Variables

File segment header

Macro Definition Documentation

◆ FSP_EXTENT_SIZE

Typedef Documentation

◆ fseg_header_t

Enumeration Type Documentation

◆ fsp_reserve_t

Function Documentation

◆ fsp_flags_is_valid()

◆ fsp_is_checksum_disabled()

◆ fsp_is_global_temporary()

◆ fsp_is_session_temporary()

◆ fsp_is_system_temporary()

◆ fsp_skip_sanity_check()

◆ operator<<()

Variable Documentation

◆ FSEG_HDR_OFFSET

◆ FSEG_HDR_PAGE_NO

◆ FSEG_HDR_SPACE

◆ FSEG_HEADER_SIZE

◆ FSEG_PAGE_DATA

◆ FSP_DICT_HDR_PAGE_NO

◆ FSP_DOWN

◆ FSP_EXTENT_SIZE_MAX

◆ FSP_EXTENT_SIZE_MIN

◆ FSP_FIRST_INODE_PAGE_NO

◆ FSP_FIRST_RSEG_PAGE_NO

◆ FSP_IBUF_BITMAP_OFFSET

◆ FSP_IBUF_HEADER_PAGE_NO

◆ FSP_IBUF_TREE_ROOT_PAGE_NO

◆ FSP_IMPLICIT_UNDO_TABLESPACES

◆ FSP_MAX_ROLLBACK_SEGMENTS

◆ FSP_MAX_UNDO_TABLESPACES

◆ FSP_MIN_UNDO_TABLESPACES

◆ FSP_NO_DIR

◆ FSP_RSEG_ARRAY_PAGE_NO

◆ FSP_TRX_SYS_PAGE_NO

◆ FSP_UP

◆ FSP_XDES_OFFSET

◆ TRX_SYS_N_RSEGS