db_index_c.x revision 7c478bd95313f5f23a4c958a745db2134aa03244
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License, Version 1.0 only
* (the "License"). You may not use this file except in compliance
* with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* db_index_c.x
*
* Copyright 1988-2002 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
%#pragma ident "%Z%%M% %I% %E% SMI"
#if RPC_HDR
%#ifndef _DB_INDEX_H
%#define _DB_INDEX_H
%
%/* db_index is a hash table with separate overflow buckets. */
%
#ifdef USINGC
%#include "db_item_c.h"
%#include "db_index_entry_c.h"
%#include "db_table_c.h"
%#include "db_scheme_c.h"
#else
%#include "db_item.h"
%#include "db_index_entry.h"
%#include "db_table.h"
%#include "db_scheme.h"
#endif USINGC
#endif RPC_HDR
%
%#include "nisdb_rw.h"
%
#ifdef USINGC
struct db_index {
int count;
bool case_insens;
};
typedef struct db_index * db_index_p;
#endif USINGC
#endif RPC_HDR
#ifndef USINGC
#ifdef RPC_HDR
% long table_size;
% db_index_entry_p *tab;
% int count;
% STRUCTRWLOCK(index);
%
%/* Grow the current hashtable upto the next size.
% The contents of the existing hashtable is copied to the new one and
% relocated according to its hashvalue relative to the new size.
% Old table is deleted after the relocation. */
% void grow();
%
%/* Clear the chains created in db_index_entrys */
%/* void clear_results();*/
% public:
%
%/* Constructor: creates empty index. */
% db_index();
%
%/* Constructor: creates index by loading it from the specified file.
% If loading fails, creates empty index. */
% db_index( char *);
%
%/* Destructor: deletes index, including all associated db_index_entry. */
% ~db_index();
%
%/* Empty table (deletes index, including all associated db_index_entry) */
% void reset();
%
%/* Initialize index according to the specification of the key descriptor.
% Currently, only affects case_insens flag of index. */
% void init( db_key_desc * );
%
%/* Moves an index from an xdr index */
%
%/* Dumps this index to named file. */
% int dump( char *);
%
%
%/* Look up given index value in hashtable.
% Return pointer to db_index_entries that match the given value, linked
% via the 'next_result' pointer. Return in 'how_many_found' the size
% of this list. Return NULL if not found. */
%
%/* Remove the entry with the given index value and location 'recnum'.
% If successful, return DB_SUCCESS; otherwise DB_NOTUNIQUE if index_value
% is null; DB_NOTFOUND if entry is not found.
% If successful, decrement count of number of entries in hash table. */
%
%/* Add a new index entry with the given index value and location 'recnum'.
% Return DB_NOTUNIQUE, if entry with identical index_value and recnum
% already exists. If entry is added, return DB_SUCCESS.
% Increment count of number of entries in index table and grow table
% if table is more than half full.
% Note that a copy of index_value is made for new entry. */
%
%/* Return in 'tsize' the table_size, and 'tcount' the number of entries
% in the table. */
%
%
%/* Print all entries in the table. */
% void print();
%
%/* Locking methods */
%
% int acqexcl(void) {
% }
%
% int relexcl(void) {
% }
%
% int acqnonexcl(void) {
% }
%
% int relnonexcl(void) {
% }
%};
%#ifdef __cplusplus
%#endif
#endif RPC_HDR
#endif USINGC
#if RPC_HDR
%#endif _DB_INDEX_H
#endif RPC_HDR