cf90bb5d33
2001-10-28 <NotZed@Ximian.com> * ibex_block.c (ibex_move): New api entry to move an ibex file in an atomic way. svn path=/trunk/; revision=14293
109 lines
3.2 KiB
C
109 lines
3.2 KiB
C
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
|
|
/*
|
|
* Copyright (C) 2000 Ximian, Inc.
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of version 2 of the GNU General Public
|
|
* License as published by the Free Software Foundation.
|
|
*
|
|
* This program 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., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
#ifndef IBEX_H
|
|
#define IBEX_H
|
|
|
|
#include <sys/types.h>
|
|
#include <sys/stat.h>
|
|
#include <fcntl.h>
|
|
#include <glib.h>
|
|
|
|
struct ibex;
|
|
typedef struct ibex ibex;
|
|
|
|
/* All functions that can fail set errno and return NULL or -1 on
|
|
* failure.
|
|
*/
|
|
|
|
/* Open the named ibex index file. If CREATE is true, create the file
|
|
* if it doesn't already exist.
|
|
*/
|
|
ibex *ibex_open (char *file, int flags, int mode);
|
|
|
|
/* Write the ibex to disk. */
|
|
int ibex_write (ibex *ib);
|
|
|
|
/* only save if ibex has changed. */
|
|
int ibex_save (ibex *ib);
|
|
|
|
/* rename an ibex file to a new location */
|
|
int ibex_move (ibex *ib, const char *newname);
|
|
|
|
/* Write the ibex to disk if it has changed, and free all memory
|
|
* associated with it.
|
|
*/
|
|
int ibex_close (ibex *ib);
|
|
|
|
|
|
|
|
/* Index the named file. (If the FILENAME is already in the index,
|
|
* remove the old copy.
|
|
*/
|
|
int ibex_index_file (ibex *ib, char *filename);
|
|
|
|
/* Index LEN bytes off FD, using NAME as the filename in the index.
|
|
* (If NAME already exists in the index, this adds more data to it.)
|
|
*/
|
|
int ibex_index_fd (ibex *ib, char *name, int fd, size_t len);
|
|
|
|
/* Like ibex_index_fd, but with a buffer rather than a file descriptor.
|
|
* The buffer does not need to be '\0'-terminated. If UNREAD is not
|
|
* NULL, then the indexer won't assume that the buffer ends on a word
|
|
* boundary, and will return (in UNREAD) the number of bytes from the
|
|
* end of the buffer that it didn't use, if any.
|
|
*/
|
|
int ibex_index_buffer (ibex *ib, char *name, char *buffer,
|
|
size_t len, size_t *unread);
|
|
|
|
/* Remove entries for a given file from the index. (Most of the removal
|
|
* isn't actually done until the file is written out to disk, so this
|
|
* is very fast.)
|
|
*/
|
|
void ibex_unindex (ibex *ib, char *name);
|
|
|
|
/* Rename a file in the index. (This is also fast.) */
|
|
void ibex_rename (ibex *ib, char *oldfilename, char *newfilename);
|
|
|
|
|
|
|
|
/* Find a word in the index. Returns an array of strings: the caller
|
|
* should free the array, but should not free or modify the strings.
|
|
*/
|
|
GPtrArray *ibex_find (ibex *ib, char *word);
|
|
|
|
/* Find if a word is contained in a specific name reference.
|
|
*/
|
|
gboolean ibex_find_name (ibex *ib, char *name, char *word);
|
|
|
|
/* has a file been indexed?
|
|
*/
|
|
gboolean ibex_contains_name(ibex *ib, char *name);
|
|
|
|
/* Return all the files containing all of the words in the given
|
|
* array. Returned data is like with ibex_find.
|
|
*/
|
|
GPtrArray *ibex_find_all (ibex *ib, GPtrArray *words);
|
|
|
|
/* Debug function, dumps the whole index tree, showing removed files as well */
|
|
void ibex_dump_all (ibex *ib);
|
|
|
|
#endif /* ! IBEX_H */
|
|
|