From 780b92ada9afcf1d58085a83a0b9e6bc982203d1 Mon Sep 17 00:00:00 2001 From: Lorry Tar Creator Date: Tue, 17 Feb 2015 17:25:57 +0000 Subject: Imported from /home/lorry/working-area/delta_berkeleydb/db-6.1.23.tar.gz. --- docs/api_reference/C/envset_blob_threshold.html | 201 ++++++++++++++++++++++++ 1 file changed, 201 insertions(+) create mode 100644 docs/api_reference/C/envset_blob_threshold.html (limited to 'docs/api_reference/C/envset_blob_threshold.html') diff --git a/docs/api_reference/C/envset_blob_threshold.html b/docs/api_reference/C/envset_blob_threshold.html new file mode 100644 index 00000000..46e5ce5b --- /dev/null +++ b/docs/api_reference/C/envset_blob_threshold.html @@ -0,0 +1,201 @@ + + + + + + DB_ENV->set_blob_threshold() + + + + + + + + +
+
+

Library Version 12.1.6.1

+
+ + + + + + + + + +
DB_ENV->set_blob_threshold()
Prev Chapter 13.  + Binary Large Objects +  Next
+
+
+
+
+
+
+

DB_ENV->set_blob_threshold()

+
+
+
+ 
#include <db.h>
+
+int
+DB_ENV->set_blob_threshold(DB_ENV *dbenv, u_int32_t bytes, 
+                           u_int32_t flags);
+

+ The DB_ENV->set_blob_threshold() method sets + a default size for the environment which is used to determine when + a data item will be stored as a BLOB. Data items sized less than + this threshold are stored as normal data within the database. Data + items larger than this size are stored on-disk in a subdirectory + set aside for the purpose. +

+

+ If this threshold value is set to 0, then BLOB + support is turned off by default for databases created in the + environment. If this method is never called, then the default BLOB + threshold is 0. +

+

+ This method only sets the default BLOB threshold for the + environment. The BLOB threshold can be set for individual + databases created within the environment using + DB->set_blob_threshold(). +

+

+ It is illegal to set a BLOB threshold if replication is enabled + for the environment. That is, if the + DB_INIT_REP + flag is specified to DB_ENV->open(). +

+

+ This method configures operations performed using the specified + DB_ENV handle, not all operations + performed on the underlying database environment. +

+

+ You may call this method at any time after the DB_ENV handle + has been created. +

+

+ Unless otherwise specified, the + DB_ENV->set_blob_threshold() + + method returns a non-zero error value on failure and 0 on success. + + + +

+
+
+
+
+

Parameters

+
+
+
+
+
+
+
+

bytes

+
+
+
+

+ The bytes parameter + identifies the threshold size, in bytes, beyond which a + data item is stored as a BLOB. +

+
+
+
+
+
+

flags

+
+
+
+

+ The flags parameter must be set to 0. +

+
+
+
+
+
+
+

Errors

+
+
+
+

+ The DB_ENV->set_blob_threshold() + + method may fail and return one of the following non-zero errors: + + + +

+
+
+
+
+

EINVAL

+
+
+
+

+ If an invalid flag or parameter was specified. +

+
+
+
+
+
+
+

Class

+
+
+
+

+ DB_ENV +

+
+
+
+
+
+

See Also

+
+
+
+

+ BLOBs and Related Methods +

+
+
+
+
+ + + + + + + + + + + +
Prev  + Up +  Next
DB_ENV->set_blob_dir()  + Home +  Appendix A.  + Berkeley DB Command Line Utilities +
+
+ + -- cgit v1.2.1