Berkeley DB

DB→upgrade

						#include <db.h>
						int
						DB→upgrade(DB *db, const char *file, u_int32_t flags);
					

Description

The DB→upgrade function upgrades all of the databases included in the file file, if necessary. If no upgrade is necessary, DB→upgrade always returns success.

Database upgrades are done in place and are destructive. For example, if pages need to be allocated and no disk space is available, the database may be left corrupted. Backups should be made before databases are upgraded. See “Upgrading Databases” for more information.

Unlike all other database operations, DB→upgrade may only be done on a system with the same byte-order as the database.

The flags parameter must be set to 0 or one of the following values:

• DB_DUPSORT This flag is only meaningful ...