* Ver registros de Notas agregado

[z.facultad/75.06/emufs.git] / emufs / tipo3.h

diff --git a/emufs/tipo3.h b/emufs/tipo3.h
index 47b25687b17f43ad4471734efe137b2d20213310..12ed7321bd00190d37d10d337f9315c0e3f1cb35 100644 (file)
--- a/emufs/tipo3.h
+++ b/emufs/tipo3.h
@@ -1,36 +1,98 @@
-#ifndef _PARAM_CTE_H_
-#define _PARAM_CTE_H_
+/* vim: set noexpandtab tabstop=4 shiftwidth=4:
+ *----------------------------------------------------------------------------
+ *                                  emufs
+ *----------------------------------------------------------------------------
+ * This file is part of emufs.
+ *
+ * emufs 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 2 of the License, or (at your option) any later
+ * version.
+ *
+ * emufs 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 emufs; if not, write to the Free Software Foundation, Inc., 59 Temple
+ * Place, Suite 330, Boston, MA  02111-1307  USA
+ *----------------------------------------------------------------------------
+ * Creado:  mié mar 31 17:26:46 ART 2004
+ * Autores: Nicolás Dimov <sagardua@uolsinectis.com.ar>
+ *----------------------------------------------------------------------------
+ *
+ * $Id$
+ *
+ */
+
+/** \file
+ *
+ * Archivo con bloques y registros de longitud parametrizada.
+ * 
+ * Implementación del archivo con bloques y registros de longitud
+ * parametrizada.
+ *
+ */
+
+#ifndef _EMUFS_TIPO3_H_
+#define _EMUFS_TIPO3_H_
+

 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
 #include <unistd.h>
 #include "emufs.h"
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
 #include <unistd.h>
 #include "emufs.h"

+#include "did.h"
+#include "idx.h"
+#include "fsc.h"

 
 

-typedef struct block_free_t{
-       int block;
-       int free_space;
-}BLOCK_FREE_T;
+/** Devuelve un puntero con la memoria reservada que contiene al registro solicitado
+  * por el segundo parámetro \c ID, y almacena en \c reg_size el tamaño del
+  * registro leido, que en este caso no es necesario pues es constante y es conocicdo de antemano.
+  * Para realizar esta acción, busca en el archivo .idx el bloque al cual pertenece el registro.
+  */
+void* emufs_tipo3_leer_registro(EMUFS *emu, EMUFS_REG_ID ID, EMUFS_REG_SIZE* reg_size, int* err);

 
 

-typedef struct block_reg_t{
-       int block;
-       long int id_reg;
-}BLOCK_REG_T;
+/** Devuelve un puntero con la memoria reservada que contiene el bloque solicitado por
+  * el segundo parámetro \c num_bloque. Como la numeración de los bloques es virtual,
+  * el acceso al archivo para levantar un bloque es directo, es decir, se posiciona directamente
+  * en en número de bloque multiplicado por el tamaño del mismo, salteando antes el encabezado del archivo.
+  */
+void* emufs_tipo3_leer_bloque(EMUFS*, EMUFS_BLOCK_ID, int*);

 
 

-int leer_registro(EMUFS *, int , void *, unsigned long);
+/** Graba un registro en un bloque donde haya espacio suficiente, y si no 
+  * crea un nuevo bloque y lo agrega al final del archivo. 
+  * El registro a grabar es apuntado por el segundo parámetro \param ptr 
+  * y el tamaño viene indicado en \c tam.
+  * Luego de realizar la grabación, actualiza los archivos índice con los
+  * valores correspondientes.
+  */
+EMUFS_REG_ID emufs_tipo3_grabar_registro(EMUFS *emu, void *ptr, EMUFS_REG_SIZE, int*);

 
 

-int leer_bloque(EMUFS *, int , void *);
+/** Graba el bloque apuntado por \c ptr en el archivo */
+int emufs_tipo3_grabar_bloque(EMUFS *emu, void *ptr, EMUFS_BLOCK_ID num_bloque);

 
 

-int grabar_registro(EMUFS *, void *, unsigned long );
+/** Borra el registro \c id_reg del archivo de datos, y actualiza los archivos
+  *    de índice para mantener la coherencia en las próximas modificaciones.
+  */
+int emufs_tipo3_borrar_registro(EMUFS *emu, EMUFS_REG_ID id_reg);

 
 

-int existe_registro(EMUFS *, int);
+/** Método para modificar un registro */
+EMUFS_REG_ID emufs_tipo3_modificar_registro(EMUFS *emu, EMUFS_REG_ID, void*, EMUFS_REG_SIZE, int*);

 
 

-int buscar_registro(EMUFS *, int);
+/** Completa una estructura del tipo EMUFS_Estadisticas con las estadísticas del
+  * archivo de datos, espacio libre total, cantidad de registros, cantidad de bloques,
+  * tamaño del archivo en bytes, relaciones entre tamaños y espacios libres, etc.
+  */
+EMUFS_Estadisticas emufs_tipo3_leer_estadisticas(EMUFS *);

 
 

-int buscar_lugar(EMUFS *, unsigned long , int *);
+/** Lee un registro con su informacion de control */
+void* emufs_tipo3_leer_registro_raw(struct _emu_fs_t*, EMUFS_REG_ID, EMUFS_REG_SIZE*, int *);

 
 

-int get_id(EMUFS *);
+/** Elimina los espacios libres que hay en el archivo */
+void emufs_tipo3_compactar(EMUFS *emu);

 
 

-int grabar_bloque(EMUFS *, void *, int);
+void emufs_tipo3_leer_bloque_raw(EMUFS *efs, EMUFS_BLOCK_ID id, char **actual, char **anterior, char **siguiente, EMUFS_BLOCK_SIZE *size1, EMUFS_BLOCK_SIZE *size2, EMUFS_BLOCK_SIZE *size3);

 
 

-int borrar_registro(EMUFS*, int, int);
-#endif
+#endif /* _EMUFS_TIPO3_H_ */