mirror of
https://github.com/MariaDB/server.git
synced 2025-02-02 20:11:42 +01:00
e49dee377b
This patch was created by running the following commands:
for i in */*[ch]; do doxygenify.pl $i; done
perl -i -pe 's#\*{3} \*/$#****/#' */*[ch]
where doxygenify.pl is
https://svn.innodb.com/svn/misc/trunk/tools/doxygenify.pl r510
Verified the consistency as follows:
(0) not too many /* in: */ or /* out: */ comments left in the code:
grep -l '/\*\s*\(in\|out\)[,:/]' */*[ch]
(1) no difference when ignoring blank lines, after stripping all
C90-style /* comments */, including multi-line ones, before and after
applying this patch:
perl -i -e 'undef $/;while(<ARGV>){s#/\*(.*?)\*/##gs;print}' */*[ch]
diff -I'^\s*$' --exclude .svn -ru TREE1 TREE2
(2) after stripping @return comments and !<, generated a diff and omitted
the hunks where /* out: */ function return comments were removed:
perl -i -e'undef $/;while(<ARGV>){s#!<##g;s#\n\@return\t.*?\*/# \*/#gs;print}'\
*/*[ch]
svn diff|
perl -e 'undef $/;$_=<>;s#\n-\s*/\* out[:,]([^\n]*?)(\n-[^\n]*?)*\*/##gs;print'
Some unintended changes were left. These will be removed in a
subsequent patch.
126 lines
4.1 KiB
Text
126 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
|
|
|
|
*****************************************************************************/
|
|
|
|
/******************************************************
|
|
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
|