DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

DB->sync

API Ref

#include <db.h>

int DB->sync(DB *db, u_int32_t flags);


Description: DB->sync

The DB->sync method flushes any cached information to disk.

If the database is in memory only, the DB->sync method has no effect and will always succeed.

It is important to understand that flushing cached information to disk only minimizes the window of opportunity for corrupted data. Although unlikely, it is possible for database corruption to happen if a system or application crash occurs while writing data to the database. To ensure that database corruption never occurs, applications must either: use transactions and logging with automatic recovery; use logging and application-specific recovery; or edit a copy of the database, and once all applications using the database have successfully called DB->close, atomically replace the original database with the updated copy.

The DB->sync method returns a non-zero error value on failure and 0 on success.

Parameters

flags
The flags parameter is currently unused, and must be set to 0.

Errors

The DB->sync method may fail and return one of the following non-zero errors:

DB_REP_HANDLE_DEAD
The database handle has been invalidated because a replication election unrolled a committed transaction.
DB_REP_LOCKOUT
The operation was blocked by client/master synchronization.
EINVAL
An invalid flag value or parameter was specified.

Class

DB

See Also

Databases and Related Methods

APIRef

Copyright (c) 1996-2005 Sleepycat Software, Inc. - All rights reserved.