src/vfile/vfile.h

   1 /* vim: set noexpandtab tabstop=4 shiftwidth=4 wrap:
   2  *----------------------------------------------------------------------------
   3  *                                  jacu
   4  *----------------------------------------------------------------------------
   5  * This file is part of jacu.
   6  *
   7  * jacu 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  * jacu 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 jacu; if not, write to the Free Software Foundation, Inc., 59 Temple
  19  * Place, Suite 330, Boston, MA  02111-1307  USA
  20  *----------------------------------------------------------------------------
  21  * Creado:  mié jun 16 14:04:55 ART 2004
  22  * Autores: Leandro Lucarella <llucare@fi.uba.ar>
  23  *----------------------------------------------------------------------------
  24  *
  25  * $Id: bufford.c 624 2004-05-30 20:18:04Z llucare $
  26  *
  27  */
  28
  29 #include <stdio.h>
  30
  31 /** \file
  32  *
  33  * Archivo virtual divisible en volúmenes.
  34  *
  35  * Interfaz de un archivo virtual divisible en volúmenes.
  36  * Provee algunas funciones compatibles con la stdio de ANSI C para utilizar
  37  * de forma transparente archivos virtuales divididos en varios volúmenes.
  38  *
  39  */
  40
  41 /** Mínimo tamaño de un volumen. */
  42 #define VFMINVOLSIZE 512
  43
  44 /** Esquema del nombre a utilizar en los volumenes. */
  45 #define VFNAMETEMPLATE "%s-%d"
  46
  47 /** Modo de uso del archivo virtual. */
  48 typedef enum
  49 {
  50         VFREAD, /**< Modo lectura. */
  51         VFWRITE /**< Modo escritura. */
  52 }
  53 VFMODE;
  54
  55 /**
  56  * Archivo virtual divisible en volúmenes.
  57  */
  58 typedef struct
  59 {
  60         FILE*  fp;      /**< Puntero al archivo actual. */
  61         char*  name;    /**< Nombre base del archivo. */
  62         VFMODE mode;    /**< Modo de uso del archivo. */
  63         long   volsize; /**< Tamaño de cada volumen. */
  64         int    lastvol; /**< 0 hay más volumenes para leer; 1 es el último. */
  65         int    currvol; /**< Volumen utilizado actualmente. */
  66         long   room;    /**< Cantidad de bytes Posición actual del archivo virtual. */
  67 }
  68 VFILE;
  69
  70 /**
  71  * Abre un archivo virtual multivolumen.
  72  *
  73  * \param path Ruta del archivo a abrir.
  74  * \param mode Modo con el cual abrir el archivo. Son iguales a los modos de
  75  *             <tt>fopen()</tt> pero no se pueden usar modos de lectura y
  76  *             escritura simultánea (<tt>r+</tt>, <tt>w+</tt>, <tt>a+</tt>).
  77  * \param size Tamaño de los volúmenes. Si es menor a VFILE_MIN_VOLSIZE bytes
  78  *             no se divide el archivo.
  79  *
  80  * \return Puntero al archivo multivolumen abierto o 0 si no se pudo abrir.
  81  *
  82  */
  83 VFILE* vfopen(const char* path, const char* mode, long size);
  84
  85 /** Cierra un archivo virtual multivolumen. */
  86 int vfclose(VFILE* vfp);
  87
  88 /** Obtiene un caracter de un archivo virtual multivolumen. */
  89 int vfgetc(VFILE* vfp);
  90
  91 /** Pone un caracter en un archivo virtual multivolumen. */
  92 int vfputc(int c, VFILE* vfp);
  93
  94 /** Lee un conjunto de bytes de un archivo virtual multivolumen. */
  95 size_t vfread(void* ptr, size_t size, size_t nmemb, VFILE* vfp);
  96
  97 /** Escribe un conjunto de bytes en un archivo virtual multivolumen. */
  98 size_t vfwrite(const void *ptr, size_t size, size_t nmemb, VFILE* vfp);
  99