-/*
- * Copyright (C) 1995-1998, Index Data
- * All rights reserved.
- * Sebastian Hammer, Adam Dickmeiss
- *
- * $Log: cfile.h,v $
- * Revision 1.10 1998-10-15 13:09:31 adam
- * Minor changes.
- *
- * Revision 1.9 1998/08/07 15:07:15 adam
- * Fixed but in cf_commit_flat.
- *
- * Revision 1.8 1996/04/18 16:02:56 adam
- * Changed logging a bit.
- * Removed warning message when commiting flat shadow files.
- *
- * Revision 1.7 1996/02/07 14:03:48 adam
- * Work on flat indexed shadow files.
- *
- * Revision 1.6 1996/02/07 10:08:45 adam
- * Work on flat shadow (not finished yet).
- *
- * Revision 1.5 1995/12/15 12:36:52 adam
- * Moved hash file information to union.
- * Renamed commit files.
- *
- * Revision 1.4 1995/12/11 09:03:54 adam
- * New function: cf_unlink.
- * New member of commit file head: state (0) deleted, (1) hash file.
- *
- * Revision 1.3 1995/12/01 16:24:29 adam
- * Commit files use separate meta file area.
- *
- * Revision 1.2 1995/12/01 11:37:23 adam
- * Cached/commit files implemented as meta-files.
- *
- * Revision 1.1 1995/11/30 08:33:12 adam
- * Started work on commit facility.
- *
- */
+/* This file is part of the Zebra server.
+ Copyright (C) 1994-2011 Index Data
+
+Zebra 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, or (at your option) any later
+version.
+
+Zebra 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 this program; if not, write to the Free Software
+Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+
+*/
+
+
#ifndef CFILE_H
#define CFILE_H
+#include <yaz/yconfig.h>
+
+YAZ_BEGIN_CDECL
+
+/** \brief number of blocks in hash bucket */
#define HASH_BUCKET 15
-struct CFile_ph_bucket { /* structure on disc */
- int no[HASH_BUCKET]; /* block number in original file */
- int vno[HASH_BUCKET]; /* block number in shadow file */
- int this_bucket; /* this bucket number */
- int next_bucket; /* next bucket number */
+/** \brief CFile hash structure on disc */
+struct CFile_ph_bucket {
+ zint no[HASH_BUCKET]; /**< block number in original file */
+ zint vno[HASH_BUCKET];/**< block number in shadow file */
+ zint this_bucket; /**< this bucket number */
+ zint next_bucket; /**< next bucket number */
};
+/** \brief CFile hash structure info in memory */
struct CFile_hash_bucket {
struct CFile_ph_bucket ph;
int dirty;
#define HASH_BSIZE sizeof(struct CFile_ph_bucket)
-#define CFILE_FLAT 1
+/** \brief state of CFile is a hash structure */
+#define CFILE_STATE_HASH 1
+/** \brief state of CFile is a flat file file */
+#define CFILE_STATE_FLAT 2
+
+/** \brief CFile file header */
+struct CFile_head {
+ int state; /**< CFILE_STATE_HASH, CFILE_STATE_FLAT, .. */
+ zint next_block; /**< next free block / last block */
+ int block_size; /**< mfile/bfile block size */
+ int hash_size; /**< no of chains in hash table */
+ zint first_bucket; /**< first hash bucket */
+ zint next_bucket; /**< last hash bucket + 1 = first flat bucket */
+ zint flat_bucket; /**< last flat bucket + 1 */
+};
+
+/** \brief All in-memory information per CFile */
typedef struct CFile_struct
{
- struct CFile_head {
- int state; /* 1 = hash, 2 = flat */
- int next_block; /* next free block / last block */
- int block_size; /* mfile/bfile block size */
- int hash_size; /* no of chains in hash table */
- int first_bucket; /* first hash bucket */
- int next_bucket; /* last hash bucket + 1 = first flat bucket */
- int flat_bucket; /* last flat bucket + 1 */
- } head;
- MFile block_mf;
- MFile hash_mf;
- int *array;
- struct CFile_hash_bucket **parray;
- struct CFile_hash_bucket *bucket_lru_front, *bucket_lru_back;
- int dirty;
- int bucket_in_memory;
- int max_bucket_in_memory;
- char *iobuf;
- MFile rmf;
- int no_hits;
- int no_miss;
+ struct CFile_head head;
+
+ MFile block_mf; /**< block meta file */
+ MFile hash_mf; /**< hash or index file (depending on state) */
+ zint *array; /**< array for hash */
+ struct CFile_hash_bucket **parray; /**< holds all hash bucket in memory */
+ struct CFile_hash_bucket *bucket_lru_front; /**< LRU front for hash */
+ struct CFile_hash_bucket *bucket_lru_back; /**< LRU back for hash */
+ int dirty; /**< whether CFile is dirty / header must be rewritten */
+ zint bucket_in_memory; /**< number of buckets in memory */
+ zint max_bucket_in_memory; /**< max number of buckets in memory */
+ char *iobuf; /**< data block .. of size block size */
+ MFile rmf; /**< read meta file (original data / not dirty) */
+ int no_hits; /**< number of bucket cache hits */
+ int no_miss; /**< number of bucket cache misses */
+ Zebra_mutex mutex;
} *CFile;
int cf_close (CFile cf);
+
CFile cf_open (MFile mf, MFile_area area, const char *fname, int block_size,
int wflag, int *firstp);
-int cf_read (CFile cf, int no, int offset, int num, void *buf);
-int cf_write (CFile cf, int no, int offset, int num, const void *buf);
-void cf_unlink (CFile cf);
-void cf_commit (CFile cf);
+int cf_read (CFile cf, zint no, int offset, int nbytes, void *buf);
+int cf_write (CFile cf, zint no, int offset, int nbytes, const void *buf);
+int cf_commit (CFile cf) ZEBRA_GCC_ATTR((warn_unused_result));
+
+YAZ_END_CDECL
#endif
+/*
+ * Local variables:
+ * c-basic-offset: 4
+ * c-file-style: "Stroustrup"
+ * indent-tabs-mode: nil
+ * End:
+ * vim: shiftwidth=4 tabstop=8 expandtab
+ */
+