/*
 * Copyright (c) 2008 Jakub Jermar
 * 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 fs
 * @{
 */ 

#ifndef FAT_FAT_FAT_H_
#define FAT_FAT_FAT_H_

#include "../../vfs/vfs.h"
#include <stdint.h>
#include <libblock.h>

#define FAT1		0

#define FAT_CLST_RES0	0x0000
#define FAT_CLST_RES1	0x0001
#define FAT_CLST_FIRST	0x0002
#define FAT_CLST_BAD	0xfff7
#define FAT_CLST_LAST1	0xfff8
#define FAT_CLST_LAST8  0xffff

/* internally used to mark root directory's parent */
#define FAT_CLST_ROOTPAR	FAT_CLST_RES0
/* internally used to mark root directory */
#define FAT_CLST_ROOT		FAT_CLST_RES1

/* forward declarations */
struct block;
struct fat_node;
struct fat_bs;

typedef uint16_t fat_cluster_t;

#define fat_clusters_get(numc, bs, dh, fc) \
    fat_cluster_walk((bs), (dh), (fc), NULL, (numc), (uint16_t) -1)
extern int fat_cluster_walk(struct fat_bs *, dev_handle_t, fat_cluster_t,
    fat_cluster_t *, uint16_t *, uint16_t);

#define fat_block_get(b, bs, np, bn, flags) \
    _fat_block_get((b), (bs), (np)->idx->dev_handle, (np)->firstc, (bn), \
    (flags))

extern int _fat_block_get(block_t **, struct fat_bs *, dev_handle_t,
    fat_cluster_t, bn_t, int);
  
extern int fat_append_clusters(struct fat_bs *, struct fat_node *,
    fat_cluster_t);
extern int fat_chop_clusters(struct fat_bs *, struct fat_node *,
    fat_cluster_t);
extern int fat_alloc_clusters(struct fat_bs *, dev_handle_t, unsigned,
    fat_cluster_t *, fat_cluster_t *);
extern int fat_free_clusters(struct fat_bs *, dev_handle_t, fat_cluster_t);
extern int fat_alloc_shadow_clusters(struct fat_bs *, dev_handle_t,
    fat_cluster_t *, unsigned);
extern int fat_get_cluster(struct fat_bs *, dev_handle_t, unsigned,
    fat_cluster_t, fat_cluster_t *);
extern int fat_set_cluster(struct fat_bs *, dev_handle_t, unsigned,
    fat_cluster_t, fat_cluster_t);
extern int fat_fill_gap(struct fat_bs *, struct fat_node *, fat_cluster_t,
    off_t);
extern int fat_zero_cluster(struct fat_bs *, dev_handle_t, fat_cluster_t);
extern int fat_sanity_check(struct fat_bs *, dev_handle_t);

#endif

/**
 * @}
 */