X-Git-Url: https://git.llucax.com/z.facultad/75.06/emufs.git/blobdiff_plain/e47297a011fb5230c79464af7cd72e78b266fc48..6380d182cdde008560bc1381da208ce98bcb836a:/emufs/tipo3.h diff --git a/emufs/tipo3.h b/emufs/tipo3.h index ad84d81..12ed732 100644 --- a/emufs/tipo3.h +++ b/emufs/tipo3.h @@ -47,26 +47,52 @@ #include "idx.h" #include "fsc.h" +/** 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); -/** Lee el registro \param id_reg y lo almacena en \param ptr */ -int emufs_tipo3_leer_registro(EMUFS *emu, int id_reg, void *ptr, unsigned long tam_reg); +/** 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*); -/** Lee el bloque \param num_bloque y lo almacena en \param ptr */ -int emufs_tipo3_leer_bloque(EMUFS *emu, int num_bloque, void *ptr); +/** 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*); -/** Graba el registro apuntado por \param ptr en el archivo */ -int emufs_tipo3_grabar_registro(EMUFS *emu, void *ptr, unsigned long tam_reg); +/** Graba el bloque apuntado por \c ptr en el archivo */ +int emufs_tipo3_grabar_bloque(EMUFS *emu, void *ptr, EMUFS_BLOCK_ID num_bloque); -/** Graba el bloque apuntado por \param ptr en el archivo */ -int emufs_tipo3_grabar_bloque(EMUFS *emu, void *ptr, int num_bloque); +/** 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 emufs_tipo3_get_id(EMUFS *emu); +/** Método para modificar un registro */ +EMUFS_REG_ID emufs_tipo3_modificar_registro(EMUFS *emu, EMUFS_REG_ID, void*, EMUFS_REG_SIZE, int*); -int emufs_tipo3_buscar_registro(EMUFS *emu, int id_reg); +/** 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 emufs_tipo3_buscar_lugar(EMUFS *emu, unsigned long tam_reg, int *free_space); +/** 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 emufs_tipo3_borrar_registro(EMUFS *emu, int id_reg, unsigned long tam_reg); +/** Elimina los espacios libres que hay en el archivo */ +void emufs_tipo3_compactar(EMUFS *emu); +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); #endif /* _EMUFS_TIPO3_H_ */