Chapter 1. STLdb 1.0

Bob Walters

Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

Table of Contents

Introduction

Acid Compliance
Summary of features

Building STLdb

Quick Start Guide

Architecture of an STLdb database

Example of a Memory-Resident database
Example of a paged database
Rationale: recovery processing design

Using Databases

Connecting to a Database
Resizing Database Regions
Removing Regions and Databases
Database Containers

Using Transactions

Creating and Destroying Transactions
Completing Transactions
Threads and Transactions
Exclusive Transactions

Using stldb::trans_map

Locking Maps
Entry-level locks
Updating Entries
Blocking on row-level locks
Iterator Safety

Logging Options

Diskless STLdb databases
Using checkpointing without logging
Asynchronous Logging
Synchronous Logging
Write Aggregation

STLdb Reference

Header </Users/bobw/workspace/stldb_lib/stldb/cachetypes.h>
Header </Users/bobw/workspace/stldb_lib/stldb/commit_buffer.h>
Header </Users/bobw/workspace/stldb_lib/stldb/container_proxy.h>
Header </Users/bobw/workspace/stldb_lib/stldb/containers/concurrent_trans_assoc_iterator.h>
Header </Users/bobw/workspace/stldb_lib/stldb/containers/concurrent_trans_map.h>
Header </Users/bobw/workspace/stldb_lib/stldb/containers/iter_less.h>
Header </Users/bobw/workspace/stldb_lib/stldb/containers/string_compare.h>
Header </Users/bobw/workspace/stldb_lib/stldb/containers/string_serialize.h>
Header </Users/bobw/workspace/stldb_lib/stldb/containers/trans_assoc_iterator.h>
Header </Users/bobw/workspace/stldb_lib/stldb/containers/trans_map.h>
Header </Users/bobw/workspace/stldb_lib/stldb/containers/trans_map_entry.h>
Header </Users/bobw/workspace/stldb_lib/stldb/containers/trans_vector.h>
Header </Users/bobw/workspace/stldb_lib/stldb/creation_tags.h>
Header </Users/bobw/workspace/stldb_lib/stldb/Database.h>
Header </Users/bobw/workspace/stldb_lib/stldb/database_registry.h>
Header </Users/bobw/workspace/stldb_lib/stldb/exceptions.h>
Header </Users/bobw/workspace/stldb_lib/stldb/log_reader.h>
Header </Users/bobw/workspace/stldb_lib/stldb/logger.h>
Header </Users/bobw/workspace/stldb_lib/stldb/logging.h>
Header </Users/bobw/workspace/stldb_lib/stldb/recovery_manager.h>
Header </Users/bobw/workspace/stldb_lib/stldb/statistics.h>
Header </Users/bobw/workspace/stldb_lib/stldb/sync/bounded_interprocess_mutex.h>
Header </Users/bobw/workspace/stldb_lib/stldb/sync/file_lock.h>
Header </Users/bobw/workspace/stldb_lib/stldb/sync/picket_lock_set.h>
Header </Users/bobw/workspace/stldb_lib/stldb/sync/wait_policy.h>
Header </Users/bobw/workspace/stldb_lib/stldb/trace.h>
Header </Users/bobw/workspace/stldb_lib/stldb/transaction.h>