PMDK man page

pmemblk_ctl_get

NAME
SYNOPSIS
DESCRIPTION
CTL NAMESPACE
CTL EXTERNAL CONFIGURATION
SEE ALSO

NAME

pmemblk_ctl_getU()/pmemblk_ctl_getW(), pmemblk_ctl_setU()/pmemblk_ctl_setW(), pmemblk_ctl_execU()/pmemblk_ctl_execW()

SYNOPSIS

#include <libpmemblk.h>

int pmemblk_ctl_getU(PMEMblkpool *pbp, const char *name, void *arg); (EXPERIMENTAL)
int pmemblk_ctl_getW(PMEMblkpool *pbp, const wchar_t *name, void *arg); (EXPERIMENTAL)
int pmemblk_ctl_setU(PMEMblkpool *pbp, const char *name, void *arg); (EXPERIMENTAL)
int pmemblk_ctl_setW(PMEMblkpool *pbp, const wchar_t *name, void *arg); (EXPERIMENTAL)
int pmemblk_ctl_execU(PMEMblkpool *pbp, const char *name, void *arg); (EXPERIMENTAL)
int pmemblk_ctl_execW(PMEMblkpool *pbp, const wchar_t *name, void *arg); (EXPERIMENTAL)

NOTE: The PMDK API supports UNICODE. If the PMDK_UTF8_API macro is defined, basic API functions are expanded to the UTF-8 API with postfix U. Otherwise they are expanded to the UNICODE API with postfix W.

DESCRIPTION

The pmemblk_ctl_getU()/pmemblk_ctl_getW(), pmemblk_ctl_setU()/pmemblk_ctl_setW() and pmemblk_ctl_execU()/pmemblk_ctl_execW() functions provide a uniform interface for querying and modifying the internal behavior of libpmemblk(7) through the control (CTL) namespace.

See more in pmem_ctl(5) man page.

CTL NAMESPACE

prefault.at_create rw global int int - boolean

If set, every page of the pool will be touched and written to when the pool is created, in order to trigger page allocation and minimize the performance impact of pagefaults. Affects only the pmemblk_createU()/pmemblk_createW() function.

Always returns 0.

prefault.at_open rw global int int - boolean

If set, every page of the pool will be touched and written to when the pool is opened, in order to trigger page allocation and minimize the performance impact of pagefaults. Affects only the pmemblk_openU()/pmemblk_openW() function.

Always returns 0.

sds.at_create rw global int int - boolean

If set, force-enables or force-disables SDS feature during pool creation. Affects only the pmemblk_createU()/pmemblk_createW() function. See pmempool_feature_query(3) for informations about SDS (SHUTDOWN_STATE) feature.

Always returns 0.

CTL EXTERNAL CONFIGURATION

In addition to direct function call, each write entry point can also be set using two alternative methods.

The first method is to load a configuration directly from the PMEMBLK_CONF environment variable.

The second method of loading an external configuration is to set the PMEMBLK_CONF_FILE environment variable to point to a file that contains a sequence of ctl queries.

See more in pmem_ctl(5) man page.

SEE ALSO

libpmemblk(7), pmem_ctl(5) and http://pmem.io