GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
dbh_erase(3) DBHashTables Programmers' Manual dbh_erase(3)
-

dbh_erase, dbh_unerase, dbh_prune.3, dbh_unprune.3 - erase/unerase records or prune/unprune entire branches

#include <dbh.h>

int dbh_erase (DBHashTable *dbh);
int dbh_unerase (DBHashTable *dbh);
int dbh_prune (DBHashTable *dbh, unsigned char *key, unsigned char subtree_length);
int dbh_unprune (DBHashTable *dbh, unsigned char *key, unsigned char subtree_length);

Mark the record currently loaded into memory as erased. If no record is currently loaded, behaviour is undefined.

This is the opposite of dbh_erase (). Mark the record currently loaded into memory as unerased. If no record is currently loaded, behaviour is undefined.

Erases a whole subtree from the record currently loaded into memory. Records are not really removed fisically, but rather marked erased so they may be recovered (if not overwritten later on). Records are permanently removed after DBHashTable is reconstructed with dbh_regen_sweep () or dbh_regen_fanout ().

Does the opposite of dbh_prune (), marking entire subtree as unerased. May fail to work if records have been overwritten since the dbh_prune () instruction was issued.

In the dbh_prune and dbh_unprune routines, key is the key of top level record of subtree to erase and subtree_length is the number of branches to erase.

0 on error, 1 otherwise.

dbh (0), dbh_find (3), dbh_load (3), dbh_sweep (3), dbh_regen_sweep (3)

Edscott Wilson Garcia <edscott@xfce.org>
DBH DBHashTables

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.