DB->set_bt_minkey()

#include <db.h>

int
DB->set_bt_minkey(DB *db, u_int32_t bt_minkey);  

Set the minimum number of key/data pairs intended to be stored on any single Btree leaf page.

This value is used to determine if key or data items will be stored on overflow pages instead of Btree leaf pages. For more information on the specific algorithm used, see Minimum keys per page. The bt_minkey value specified must be at least 2; if bt_minkey is not explicitly set, a value of 2 is used.

The DB->set_bt_minkey() method configures a database, not only operations performed using the specified DB handle.

The DB->set_bt_minkey() method may not be called after the DB->open() method is called. If the database already exists when DB->open() is called, the information specified to DB->set_bt_minkey() will be ignored.

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

Parameters

bt_minkey

The bt_minkey parameter is the minimum number of key/data pairs intended to be stored on any single Btree leaf page.

Errors

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

EINVAL

If the method was called after DB->open() was called; or if an invalid flag value or parameter was specified.

Class

DB

See Also

Database and Related Methods