URL: http://www.firstbasesoftware.com/man/man3/openidx.htm
Last modified: 12 September 1995
Copyright © by FirstBase Software.
[ Index of Contents] [ FirstBase RDBMS Overview]


NAME

openidx, closeidx, createidx - index manipulation mechanisms

SYNOPSIS

#include <firstbase/fb.h>

fb_openidx(iname, db)
char *iname;
fb_database *db;

fb_closeidx(db)
fb_database *db;

fb_createidx(iname, db)
char *iname;
fb_database *db;

DESCRIPTION

As explained in the database(4) manual page, a database structure contains all of the elements needed for an entire database, including a set of descriptors for a FirstBase index.

Fb_openidx will initialize the index portion of database structure db using iname as the index name. Since opendb(3) can initialize an index also, openidx(3) is used mainly to switch indexes on an already opened database.

To properly close a database index, use fb_closeidx. This routine will close the file descriptors associated with an index. Note that fb_closedb does this as well, so specifically closing the index needs doing only when looping through many fb_openidx calls.

The fb_createidx routine will create an index, either a Btree index or a Flat index. All needed files will be created and initialized, but the index will not be opened.

CLIENT/SERVER

Each of these routines will transparently call the RPC mechanism of the similar name when the global FirstBase variable cdb_use_rpc is set to one. See fb_clnt_create(3) for more details.

SEE ALSO

database(4), index(4), btree(4), dballoc(3), dbargs(3), opendb(3), useidx(3), autoindex(5).


URL: http://www.firstbasesoftware.com/man/man3/openidx.htm
Last modified: 12 September 1995
Copyright © by FirstBase Software.
[ Index of Contents] [ FirstBase RDBMS Overview]