/* fshelp.h -- Filesystem helper functions */
/*
 *  VAS_EBOOT  --  GRand Unified Bootloader
 *  Copyright (C) 2004,2005,2006,2007,2008  Free Software Foundation, Inc.
 *
 *  VAS_EBOOT 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, either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  VAS_EBOOT 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 VAS_EBOOT.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef VAS_EBOOT_FSHELP_HEADER
#define VAS_EBOOT_FSHELP_HEADER	1

#include <VasEBoot/types.h>
#include <VasEBoot/symbol.h>
#include <VasEBoot/err.h>
#include <VasEBoot/disk.h>

typedef struct VasEBoot_fshelp_node *VasEBoot_fshelp_node_t;

#define VAS_EBOOT_FSHELP_CASE_INSENSITIVE	0x100
#define VAS_EBOOT_FSHELP_TYPE_MASK	0xff
#define VAS_EBOOT_FSHELP_FLAGS_MASK	0x100

enum VasEBoot_fshelp_filetype
  {
    VAS_EBOOT_FSHELP_UNKNOWN,
    VAS_EBOOT_FSHELP_REG,
    VAS_EBOOT_FSHELP_DIR,
    VAS_EBOOT_FSHELP_SYMLINK
  };

typedef int (*VasEBoot_fshelp_iterate_dir_hook_t) (const char *filename,
					       enum VasEBoot_fshelp_filetype filetype,
					       VasEBoot_fshelp_node_t node,
					       void *data);

/* Lookup the node PATH.  The node ROOTNODE describes the root of the
   directory tree.  The node found is returned in FOUNDNODE, which is
   either a ROOTNODE or a new malloc'ed node.  ITERATE_DIR is used to
   iterate over all directory entries in the current node.
   READ_SYMLINK is used to read the symlink if a node is a symlink.
   EXPECTTYPE is the type node that is expected by the called, an
   error is generated if the node is not of the expected type.  */
VasEBoot_err_t
EXPORT_FUNC(VasEBoot_fshelp_find_file) (const char *path,
				    VasEBoot_fshelp_node_t rootnode,
				    VasEBoot_fshelp_node_t *foundnode,
				    int (*iterate_dir) (VasEBoot_fshelp_node_t dir,
							VasEBoot_fshelp_iterate_dir_hook_t hook,
							void *hook_data),
				    char *(*read_symlink) (VasEBoot_fshelp_node_t node),
				    enum VasEBoot_fshelp_filetype expect);


VasEBoot_err_t
EXPORT_FUNC(VasEBoot_fshelp_find_file_lookup) (const char *path,
					   VasEBoot_fshelp_node_t rootnode,
					   VasEBoot_fshelp_node_t *foundnode,
					   VasEBoot_err_t (*lookup_file) (VasEBoot_fshelp_node_t dir,
								      const char *name,
								      VasEBoot_fshelp_node_t *foundnode,
								      enum VasEBoot_fshelp_filetype *foundtype),
					   char *(*read_symlink) (VasEBoot_fshelp_node_t node),
					   enum VasEBoot_fshelp_filetype expect);

/* Read LEN bytes from the file NODE on disk DISK into the buffer BUF,
   beginning with the block POS.  READ_HOOK should be set before
   reading a block from the file.  GET_BLOCK is used to translate file
   blocks to disk blocks.  The file is FILESIZE bytes big and the
   blocks have a size of LOG2BLOCKSIZE (in log2).  */
VasEBoot_ssize_t
EXPORT_FUNC(VasEBoot_fshelp_read_file) (VasEBoot_disk_t disk, VasEBoot_fshelp_node_t node,
				    VasEBoot_disk_read_hook_t read_hook,
				    void *read_hook_data,
				    VasEBoot_off_t pos, VasEBoot_size_t len, char *buf,
				    VasEBoot_disk_addr_t (*get_block) (VasEBoot_fshelp_node_t node,
                                                                   VasEBoot_disk_addr_t block),
				    VasEBoot_off_t filesize, int log2blocksize,
				    VasEBoot_disk_addr_t blocks_start);

#endif /* ! VAS_EBOOT_FSHELP_HEADER */