source: mainline/uspace/lib/ext2/libext2_superblock.c@ c00e729

/*
 * Copyright (c) 2011 Martin Sucha
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * - Redistributions of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in the
 *   documentation and/or other materials provided with the distribution.
 * - The name of the author may not be used to endorse or promote products
 *   derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

/** @addtogroup libext2
 * @{
 */
/**
 * @file
 */

#include "libext2.h"
#include <errno.h>
#include <malloc.h>
#include <libblock.h>

/**
 * Return a magic number from ext2 superblock, this should be equal to
 * EXT_SUPERBLOCK_MAGIC for valid ext2 superblock
 * 
 * @param sb pointer to superblock
 */
inline uint16_t ext2_superblock_get_magic(ext2_superblock_t *sb)
{
        return uint16_t_le2host(sb->magic);
}

/**
 * Get the position of first ext2 data block (i.e. the block number
 * containing main superblock)
 * 
 * @param sb pointer to superblock
 */
inline uint32_t ext2_superblock_get_first_block(ext2_superblock_t *sb)
{
        return uint32_t_le2host(sb->first_block);
}

/**
 * Get the number of bits to shift a value of 1024 to the left necessary
 * to get the size of a block
 * 
 * @param sb pointer to superblock
 */
inline uint32_t ext2_superblock_get_block_size_log2(ext2_superblock_t *sb)
{
        return uint32_t_le2host(sb->block_size_log2);
}

/**
 * Get the size of a block, in bytes 
 * 
 * @param sb pointer to superblock
 */
inline uint32_t ext2_superblock_get_block_size(ext2_superblock_t *sb)
{
        return 1024 << ext2_superblock_get_block_size_log2(sb);
}

/**
 * Get the number of bits to shift a value of 1024 to the left necessary
 * to get the size of a fragment (note that this is a signed integer and
 * if negative, the value should be shifted to the right instead)
 * 
 * @param sb pointer to superblock
 */
inline int32_t ext2_superblock_get_fragment_size_log2(ext2_superblock_t *sb)
{
        return uint32_t_le2host(sb->fragment_size_log2);
}

/**
 * Get the size of a fragment, in bytes 
 * 
 * @param sb pointer to superblock
 */
inline uint32_t ext2_superblock_get_fragment_size(ext2_superblock_t *sb)
{
        int32_t log = ext2_superblock_get_fragment_size_log2(sb);
        if (log >= 0) {
                return 1024 << log;
        }
        else {
                return 1024 >> -log;
        }
}

/**
 * Get number of blocks per block group
 * 
 * @param sb pointer to superblock
 */
inline uint32_t ext2_superblock_get_blocks_per_group(ext2_superblock_t *sb)
{
        return uint32_t_le2host(sb->blocks_per_group);
}

/**
 * Get number of fragments per block group
 * 
 * @param sb pointer to superblock
 */
inline uint32_t ext2_superblock_get_fragments_per_group(ext2_superblock_t *sb)
{
        return uint32_t_le2host(sb->fragments_per_group);
}

/**
 * Get filesystem state
 * 
 * @param sb pointer to superblock
 */
inline uint16_t ext2_superblock_get_state(ext2_superblock_t *sb)
{
        return uint16_t_le2host(sb->state);
}

/**
 * Get minor revision number
 * 
 * @param sb pointer to superblock
 */
inline uint16_t ext2_superblock_get_rev_minor(ext2_superblock_t *sb)
{
        return uint16_t_le2host(sb->rev_minor);
}

/**
 * Get major revision number
 * 
 * @param sb pointer to superblock
 */
inline uint32_t ext2_superblock_get_rev_major(ext2_superblock_t *sb)
{
        return uint32_t_le2host(sb->rev_major);
}

/**
 * Get index of first regular inode
 * 
 * @param sb pointer to superblock
 */
inline uint32_t ext2_superblock_get_first_inode(ext2_superblock_t *sb)
{
        if (ext2_superblock_get_rev_major(sb) == 0) {
                return EXT2_REV0_FIRST_INODE;
        }
        return uint32_t_le2host(sb->first_inode);
}

/**
 * Get size of inode
 * 
 * @param sb pointer to superblock
 */
inline uint16_t ext2_superblock_get_inode_size(ext2_superblock_t *sb)
{
        if (ext2_superblock_get_rev_major(sb) == 0) {
                return EXT2_REV0_INODE_SIZE;
        }
        return uint32_t_le2host(sb->inode_size);
}


/** Read a superblock directly from device (i.e. no libblock cache)
 * 
 * @param devmap_handle Device handle of the block device.
 * @param superblock    Pointer where to store pointer to new superblock
 * 
 * @return              EOK on success or negative error code on failure.
 */
int ext2_superblock_read_direct(devmap_handle_t devmap_handle,
    ext2_superblock_t **superblock)
{
        void *data;
        int rc;
        
        data = malloc(EXT2_SUPERBLOCK_SIZE);
        if (data == NULL) {
                return ENOMEM;
        }
        
        rc = block_read_bytes_direct(devmap_handle, EXT2_SUPERBLOCK_OFFSET,
            EXT2_SUPERBLOCK_SIZE, data);
        if (rc != EOK) {
                free(data);
                return rc;
        }
        
        (*superblock) = data;
        return EOK;
}


/** @}
 */