mirror of
https://github.com/MariaDB/server.git
synced 2025-01-22 23:04:20 +01:00
1601bdc38a
------------------------------------------------------------------------
r5092 | marko | 2009-05-25 09:54:17 +0300 (Mon, 25 May 2009) | 1 line
branches/zip: Adjust some function comments after r5091.
------------------------------------------------------------------------
r5100 | marko | 2009-05-25 12:09:45 +0300 (Mon, 25 May 2009) | 1 line
branches/zip: Split some long lines that were introduced in r5091.
------------------------------------------------------------------------
r5101 | marko | 2009-05-25 12:42:47 +0300 (Mon, 25 May 2009) | 2 lines
branches/zip: Introduce the macro TEMP_INDEX_PREFIX_STR.
This is to avoid triggering an error in Doxygen.
------------------------------------------------------------------------
r5102 | marko | 2009-05-25 13:47:14 +0300 (Mon, 25 May 2009) | 1 line
branches/zip: Add missing file comments.
------------------------------------------------------------------------
r5103 | marko | 2009-05-25 13:52:29 +0300 (Mon, 25 May 2009) | 10 lines
branches/zip: Add @file comments, and convert decorative
/*********************************
comments to Doxygen /** style like this:
/*****************************//**
This conversion was performed by the following command:
perl -i -e 'while(<ARGV>){if (m|^/\*{30}\**$|) {
s|\*{4}$|//**| if ++$com>1; $_ .= "\@file $ARGV\n" if $com==2}
print; if(eof){$.=0;undef $com}}' */*[ch] include/univ.i
------------------------------------------------------------------------
r5104 | marko | 2009-05-25 14:39:07 +0300 (Mon, 25 May 2009) | 2 lines
branches/zip: Revert ut0auxconf_* to r5102,
that is, make Doxygen ignore these test programs.
------------------------------------------------------------------------
r5105 | marko | 2009-05-25 14:52:20 +0300 (Mon, 25 May 2009) | 2 lines
branches/zip: Enclose some #error checks inside #ifndef DOXYGEN
to prevent bogus Doxygen errors.
------------------------------------------------------------------------
r5106 | marko | 2009-05-25 16:09:24 +0300 (Mon, 25 May 2009) | 2 lines
branches/zip: Add some Doxygen comments, mainly to structs, typedefs,
macros and global variables. Many more to go.
------------------------------------------------------------------------
r5108 | marko | 2009-05-26 00:32:35 +0300 (Tue, 26 May 2009) | 2 lines
branches/zip: lexyy.c: Remove the inadvertently added @file directive.
There is nothing for Doxygen to see in this file, move along.
------------------------------------------------------------------------
r5125 | marko | 2009-05-26 16:28:49 +0300 (Tue, 26 May 2009) | 3 lines
branches/zip: Add some Doxygen comments for many structs, typedefs,
#defines and global variables. Many are still missing.
------------------------------------------------------------------------
r5134 | marko | 2009-05-27 09:08:43 +0300 (Wed, 27 May 2009) | 1 line
branches/zip: Add some Doxygen @return comments.
------------------------------------------------------------------------
r5139 | marko | 2009-05-27 10:01:40 +0300 (Wed, 27 May 2009) | 1 line
branches/zip: Add Doxyfile.
------------------------------------------------------------------------
r5143 | marko | 2009-05-27 10:57:25 +0300 (Wed, 27 May 2009) | 3 lines
branches/zip: buf0buf.h, Doxyfile: Fix the Doxygen translation.
@defgroup is for source code modules, not for field groups.
Tell Doxygen to expand the UT_LIST declarations.
------------------------------------------------------------------------
127 lines
4.1 KiB
Text
127 lines
4.1 KiB
Text
/*****************************************************************************
|
|
|
|
Copyright (c) 2006, 2009, Innobase Oy. All Rights Reserved.
|
|
|
|
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., 59 Temple
|
|
Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
*****************************************************************************/
|
|
|
|
/**************************************************//**
|
|
@file include/buf0buddy.ic
|
|
Binary buddy allocator for compressed pages
|
|
|
|
Created December 2006 by Marko Makela
|
|
*******************************************************/
|
|
|
|
#ifdef UNIV_MATERIALIZE
|
|
# undef UNIV_INLINE
|
|
# define UNIV_INLINE
|
|
#endif
|
|
|
|
#include "buf0buf.h"
|
|
#include "buf0buddy.h"
|
|
#include "ut0ut.h"
|
|
#include "sync0sync.h"
|
|
|
|
/**********************************************************************//**
|
|
Allocate a block. The thread calling this function must hold
|
|
buf_pool_mutex and must not hold buf_pool_zip_mutex or any block->mutex.
|
|
The buf_pool_mutex may only be released and reacquired if lru != NULL.
|
|
@return allocated block, possibly NULL if lru==NULL */
|
|
UNIV_INTERN
|
|
void*
|
|
buf_buddy_alloc_low(
|
|
/*================*/
|
|
ulint i, /*!< in: index of buf_pool->zip_free[],
|
|
or BUF_BUDDY_SIZES */
|
|
ibool* lru) /*!< in: pointer to a variable that will be assigned
|
|
TRUE if storage was allocated from the LRU list
|
|
and buf_pool_mutex was temporarily released,
|
|
or NULL if the LRU list should not be used */
|
|
__attribute__((malloc));
|
|
|
|
/**********************************************************************//**
|
|
Deallocate a block. */
|
|
UNIV_INTERN
|
|
void
|
|
buf_buddy_free_low(
|
|
/*===============*/
|
|
void* buf, /*!< in: block to be freed, must not be
|
|
pointed to by the buffer pool */
|
|
ulint i) /*!< in: index of buf_pool->zip_free[],
|
|
or BUF_BUDDY_SIZES */
|
|
__attribute__((nonnull));
|
|
|
|
/**********************************************************************//**
|
|
Get the index of buf_pool->zip_free[] for a given block size.
|
|
@return index of buf_pool->zip_free[], or BUF_BUDDY_SIZES */
|
|
UNIV_INLINE
|
|
ulint
|
|
buf_buddy_get_slot(
|
|
/*===============*/
|
|
ulint size) /*!< in: block size */
|
|
{
|
|
ulint i;
|
|
ulint s;
|
|
|
|
for (i = 0, s = BUF_BUDDY_LOW; s < size; i++, s <<= 1) {
|
|
}
|
|
|
|
ut_ad(i <= BUF_BUDDY_SIZES);
|
|
return(i);
|
|
}
|
|
|
|
/**********************************************************************//**
|
|
Allocate a block. The thread calling this function must hold
|
|
buf_pool_mutex and must not hold buf_pool_zip_mutex or any
|
|
block->mutex. The buf_pool_mutex may only be released and reacquired
|
|
if lru != NULL. This function should only be used for allocating
|
|
compressed page frames or control blocks (buf_page_t). Allocated
|
|
control blocks must be properly initialized immediately after
|
|
buf_buddy_alloc() has returned the memory, before releasing
|
|
buf_pool_mutex.
|
|
@return allocated block, possibly NULL if lru == NULL */
|
|
UNIV_INLINE
|
|
void*
|
|
buf_buddy_alloc(
|
|
/*============*/
|
|
ulint size, /*!< in: block size, up to UNIV_PAGE_SIZE */
|
|
ibool* lru) /*!< in: pointer to a variable that will be assigned
|
|
TRUE if storage was allocated from the LRU list
|
|
and buf_pool_mutex was temporarily released,
|
|
or NULL if the LRU list should not be used */
|
|
{
|
|
ut_ad(buf_pool_mutex_own());
|
|
|
|
return(buf_buddy_alloc_low(buf_buddy_get_slot(size), lru));
|
|
}
|
|
|
|
/**********************************************************************//**
|
|
Deallocate a block. */
|
|
UNIV_INLINE
|
|
void
|
|
buf_buddy_free(
|
|
/*===========*/
|
|
void* buf, /*!< in: block to be freed, must not be
|
|
pointed to by the buffer pool */
|
|
ulint size) /*!< in: block size, up to UNIV_PAGE_SIZE */
|
|
{
|
|
ut_ad(buf_pool_mutex_own());
|
|
|
|
buf_buddy_free_low(buf, buf_buddy_get_slot(size));
|
|
}
|
|
|
|
#ifdef UNIV_MATERIALIZE
|
|
# undef UNIV_INLINE
|
|
# define UNIV_INLINE UNIV_INLINE_ORIGINAL
|
|
#endif
|