1PMEMBLK_CTL_GET(3)         PMDK Programmer's Manual         PMEMBLK_CTL_GET(3)
2
3
4

NAME

6       pmemblk_ctl_get(),  pmemblk_ctl_set(),  pmemblk_ctl_exec()  - Query and
7       modify libpmemblk internal behavior (EXPERIMENTAL)
8

SYNOPSIS

10              #include <libpmemblk.h>
11
12              int pmemblk_ctl_get(PMEMblkpool *pbp, const char *name, void *arg); (EXPERIMENTAL)
13              int pmemblk_ctl_set(PMEMblkpool *pbp, const char *name, void *arg); (EXPERIMENTAL)
14              int pmemblk_ctl_exec(PMEMblkpool *pbp, const char *name, void *arg); (EXPERIMENTAL)
15

DESCRIPTION

17       The pmemblk_ctl_get(), pmemblk_ctl_set() and  pmemblk_ctl_exec()  func‐
18       tions provide a uniform interface for querying and modifying the inter‐
19       nal behavior of libpmemblk(7) through the control (CTL) namespace.
20
21       See more in pmem_ctl(5) man page.
22

CTL NAMESPACE

24       prefault.at_create | rw | global | int | int | - | boolean
25
26       If set, every page of the pool will be touched and written to when  the
27       pool  is  created, in order to trigger page allocation and minimize the
28       performance impact of pagefaults.  Affects  only  the  pmemblk_create()
29       function.
30
31       Always returns 0.
32
33       prefault.at_open | rw | global | int | int | - | boolean
34
35       If  set, every page of the pool will be touched and written to when the
36       pool is opened, in order to trigger page allocation  and  minimize  the
37       performance  impact  of  pagefaults.   Affects  only the pmemblk_open()
38       function.
39
40       Always returns 0.
41
42       sds.at_create | rw | global | int | int | - | boolean
43
44       If set, force-enables or force-disables SDS feature  during  pool  cre‐
45       ation.   Affects only the pmemblk_create() function.  See pmempool_fea‐
46       ture_query(3) for informations about SDS (SHUTDOWN_STATE) feature.
47
48       Always returns 0.
49

CTL EXTERNAL CONFIGURATION

51       In addition to direct function call, each write entry point can also be
52       set using two alternative methods.
53
54       The  first  method  is  to load a configuration directly from the PMEM‐
55       BLK_CONF environment variable.
56
57       The second method of loading an external configuration is  to  set  the
58       PMEMBLK_CONF_FILE environment variable to point to a file that contains
59       a sequence of ctl queries.
60
61       See more in pmem_ctl(5) man page.
62

SEE ALSO

64       libpmemblk(7), pmem_ctl(5) and <http://pmem.io>
65
66
67
68PMDK - pmemblk API version 1.1    2018-10-23                PMEMBLK_CTL_GET(3)
Impressum