1PMEMLOG_CTL_GET(3) PMDK Programmer's Manual PMEMLOG_CTL_GET(3)
2
3
4
6 pmemlog_ctl_get(), pmemlog_ctl_set(), pmemlog_ctl_exec() – Query and
7 modify libpmemlog internal behavior (EXPERIMENTAL)
8
10 #include <libpmemlog.h>
11
12 int pmemlog_ctl_get(PMEMlogpool *plp, const char *name, void *arg); (EXPERIMENTAL)
13 int pmemlog_ctl_set(PMEMlogpool *plp, const char *name, void *arg); (EXPERIMENTAL)
14 int pmemlog_ctl_exec(PMEMlogpool *plp, const char *name, void *arg); (EXPERIMENTAL)
15
17 The pmemlog_ctl_get(), pmemlog_ctl_set() and pmemlog_ctl_exec() func‐
18 tions provide a uniform interface for querying and modifying the inter‐
19 nal behavior of libpmemlog(7) through the control (CTL) namespace.
20
21 See more in pmem_ctl(5) man page.
22
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 pmemlog_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 pmemlog_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 pmemlog_create() function. See pmempool_fea‐
46 ture_query(3) for informations about SDS (SHUTDOWN_STATE) feature.
47
48 Always returns 0.
49
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 LOG_CONF environment variable.
56
57 The second method of loading an external configuration is to set the
58 PMEMLOG_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
64 libpmemlog(7), pmem_ctl(5) and <http://pmem.io>
65
66
67
68PMDK - pmemlog API version 1.1 2018-10-23 PMEMLOG_CTL_GET(3)