Environment variables controlling the behavior of the library

While normally you would configure the library programmatically, there are some environment variables which may affect the library's behavior.

Environment variables are intended to aid in debugging and otherwise modifying the library's behavior on a temporary basis. Typically this may be used to increase logging, or to modify/enable a feature which has deliberately been hidden from the normal API.

Environment Variables

LCB_IOPS_NAME

Specify the name of the backend to load. This can be one of the built-in names, or it can be a path to a plugin which should be loaded dynamically.

The built-in names are:

libevent
libev
select
libuv
iocp (Windows only)

Stability

Committed

LCB_IOPS_SYMBOL

The symbol inside the shared object (specified as LCB_IOPS_NAME) that should contain the plugin initialization function. By default this is in the form of libcouchbase_create_${NAME}_io_opts

Stability

Committed

LCB_DLOPEN_DEBUG

Print verbose information to the screen when attempting to log the plugins. This can help determine why a specific plugin is not being loaded

Stability

Committed

LCB_NO_HTTP

Never bootstrap using the HTTP protocol.

Stability

Volatile

LCB_NO_CCCP

Never bootstrap using the memcached protocol

Stability

Volatile

LCB_LOGLEVEL

Enable the console logger and specify its verbosity level. The verbosity level is a number between 1-5 with higher numbers being more verbose

Stability

Committed

LCB_SSL_MODE

Specify the mode to use for SSL. Mode can either be 0 (for no SSL), 1 (for SSL with peer certificate verification), or 3 (for SSL with no certificate verification)

Stability

Volatile

LCB_SSL_CACERT

Specify the path to the CA certificate to be used in order to validate the server's certificate

Stability

Volatile

Internal Environment Variables

Note: This section will appear empty unless you have built internal documentation.

Stability

Internal

LCB_OPTIONS

A string containing extra options for the connection string. These options are processed right after the existing connection string options (if any).

Stability

Internal