lwext4/ext4_balloc.h

   1 /*
   2  * Copyright (c) 2013 Grzegorz Kostka (kostka.grzegorz@gmail.com)
   3  *
   4  *
   5  * HelenOS:
   6  * Copyright (c) 2012 Martin Sucha
   7  * Copyright (c) 2012 Frantisek Princ
   8  * All rights reserved.
   9  *
  10  * Redistribution and use in source and binary forms, with or without
  11  * modification, are permitted provided that the following conditions
  12  * are met:
  13  *
  14  * - Redistributions of source code must retain the above copyright
  15  *   notice, this list of conditions and the following disclaimer.
  16  * - Redistributions in binary form must reproduce the above copyright
  17  *   notice, this list of conditions and the following disclaimer in the
  18  *   documentation and/or other materials provided with the distribution.
  19  * - The name of the author may not be used to endorse or promote products
  20  *   derived from this software without specific prior written permission.
  21  *
  22  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  23  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  24  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  25  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  26  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  27  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  28  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  29  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  30  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  31  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  32  */
  33
  34 /** @addtogroup lwext4
  35  * @{
  36  */
  37 /**
  38  * @file  ext4_balloc.h
  39  * @brief Physical block allocator.
  40  */
  41
  42 #ifndef EXT4_BALLOC_H_
  43 #define EXT4_BALLOC_H_
  44
  45 #include "ext4_config.h"
  46 #include "ext4_types.h"
  47
  48 #include <stdint.h>
  49 #include <stdbool.h>
  50
  51 /**@brief Compute number of block group from block address.
  52  * @param sb superblock pointer.
  53  * @param baddr Absolute address of block.
  54  * @return Block group index
  55  */
  56 uint32_t ext4_balloc_get_bgid_of_block(struct ext4_sblock *s,
  57                                        ext4_fsblk_t baddr);
  58
  59 /**@brief Compute the starting block address of a block group
  60  * @param sb   superblock pointer.
  61  * @param bgid block group index
  62  * @return Block address
  63  */
  64 ext4_fsblk_t ext4_balloc_get_block_of_bgid(struct ext4_sblock *s,
  65                                        uint32_t bgid);
  66
  67 /**@brief Calculate and set checksum of block bitmap.
  68  * @param sb superblock pointer.
  69  * @param bg block group
  70  * @param bitmap bitmap buffer
  71  */
  72 void ext4_balloc_set_bitmap_csum(struct ext4_sblock *sb,
  73                                  struct ext4_bgroup *bg,
  74                                  void *bitmap);
  75
  76 /**@brief   Free block from inode.
  77  * @param   inode_ref inode reference
  78  * @param   baddr block address
  79  * @return  standard error code*/
  80 int ext4_balloc_free_block(struct ext4_inode_ref *inode_ref, ext4_fsblk_t baddr);
  81
  82 /**@brief   Free blocks from inode.
  83  * @param   inode_ref inode reference
  84  * @param   baddr block address
  85  * @return  standard error code*/
  86 int ext4_balloc_free_blocks(struct ext4_inode_ref *inode_ref, ext4_fsblk_t first,
  87                             uint32_t count);
  88
  89 /**@brief   Allocate block procedure.
  90  * @param   inode_ref inode reference
  91  * @param   goal
  92  * @param   baddr allocated block address
  93  * @return  standard error code*/
  94 int ext4_balloc_alloc_block(struct ext4_inode_ref *inode_ref,
  95                             ext4_fsblk_t goal,
  96                             ext4_fsblk_t *baddr);
  97
  98 /**@brief   Try allocate selected block.
  99  * @param   inode_ref inode reference
 100  * @param   baddr block address to allocate
 101  * @param   free if baddr is not allocated
 102  * @return  standard error code*/
 103 int ext4_balloc_try_alloc_block(struct ext4_inode_ref *inode_ref,
 104                                 ext4_fsblk_t baddr, bool *free);
 105
 106 #endif /* EXT4_BALLOC_H_ */
 107
 108 /**
 109  * @}
 110  */