emufs/tipo1.h

   1 /* vim: set noexpandtab tabstop=4 shiftwidth=4:
   2  *----------------------------------------------------------------------------
   3  *                                  emufs
   4  *----------------------------------------------------------------------------
   5  * This file is part of emufs.
   6  *
   7  * emufs is free software; you can redistribute it and/or modify it under the
   8  * terms of the GNU General Public License as published by the Free Software
   9  * Foundation; either version 2 of the License, or (at your option) any later
  10  * version.
  11  *
  12  * emufs is distributed in the hope that it will be useful, but WITHOUT ANY
  13  * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  14  * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
  15  * details.
  16  *
  17  * You should have received a copy of the GNU General Public License along
  18  * with emufs; if not, write to the Free Software Foundation, Inc., 59 Temple
  19  * Place, Suite 330, Boston, MA  02111-1307  USA
  20  *----------------------------------------------------------------------------
  21  * Creado:  vie abr  9 16:47:54 ART 2004
  22  * Autores: Leandro Lucarella <llucare@fi.uba.ar>
  23  *----------------------------------------------------------------------------
  24  *
  25  * $Id$
  26  *
  27  */
  28
  29 /** \file
  30  *
  31  * Archivo con bloque de longitud parametrizada, registro de longitud variable.
  32  *
  33  * Interfaz del archivo con bloques de longitud parametrizada y registros de
  34  * longitud variable.
  35  *
  36  */
  37
  38 #ifndef _EMUFS_TIPO1_H_
  39 #define _EMUFS_TIPO1_H_
  40
  41 #include "emufs.h"
  42 #include "indice_bplus.h"
  43
  44 /** Inicializa un EMUFS para poder ser utilizado como un archivo tipo1.
  45  *
  46  * \param efs Estructura a inicializar.
  47  * \return Código de error o EMUFS_OK si no hubo error.
  48  */
  49 int emufs_tipo1_inicializar(EMUFS* efs);
  50
  51 /** Lee el registro \c reg_id y devolviendo su contenido. */
  52 void* emufs_tipo1_leer_registro(EMUFS*, CLAVE, EMUFS_REG_SIZE*, int*);
  53
  54 /** Graba un registro en el archivo. */
  55 EMUFS_REG_ID emufs_tipo1_grabar_registro(EMUFS*, void*, EMUFS_REG_SIZE, int*);
  56
  57 /** Borra un registro de del archivo. */
  58 int emufs_tipo1_borrar_registro(EMUFS*, CLAVE, INDICE_DATO);
  59
  60 /** Método para modificar un registro. */
  61 EMUFS_REG_ID emufs_tipo1_modificar_registro(EMUFS *emu, CLAVE k, void*, EMUFS_REG_SIZE, int*, INDICE_DATO);
  62
  63 /** Método para leer un registro con todo su bloque asociado. */
  64 void* emufs_tipo1_leer_registro_raw(EMUFS *emu, EMUFS_REG_ID id, EMUFS_REG_SIZE *size, int *pos);
  65
  66 /** Obtiene estádisticas del archivo */
  67 EMUFS_Estadisticas emufs_tipo1_leer_estadisticas(EMUFS*);
  68
  69 /** Método para compactar el archivo reorganizándolo físicamente */
  70 void emufs_tipo1_compactar(EMUFS*);
  71
  72 /** Lee un bloque y su contexto, en bruto (con cabeceras). */
  73 void emufs_tipo1_leer_bloque_raw(EMUFS *efs, EMUFS_BLOCK_ID id, char **actual,
  74                 char **anterior, char **siguiente, EMUFS_BLOCK_SIZE *size1,
  75                 EMUFS_BLOCK_SIZE *size2, EMUFS_BLOCK_SIZE *size3);
  76
  77 /** Inserta un registro en el archivo, ordenado por clave principal*/
  78 int emufs_tipo1_insertar_ordenado(EMUFS *emu, void *ptr, EMUFS_REG_SIZE size, int *err);
  79
  80 /** Elimina un registro de clave CLAVE del archivo con ayuda del arbol B+*/
  81 int emufs_tipo1_eliminar_ordenado(EMUFS *emu, CLAVE clave, int *err);
  82 #endif /* _EMUFS_TIPO1_H_ */