NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
SEE ALSO
pmem2_config_new(), pmem2_config_delete() - allocate and free a configuration for a libpmem2 mapping
#include <libpmem2.h>
struct pmem2_config;
int pmem2_config_new(struct pmem2_config **cfg);
int pmem2_config_delete(struct pmem2_config **cfg);
The pmem2_config_new() function instantiates a new (opaque) configuration structure, pmem2_config, which is used to define mapping parameters for a pmem2_map() function, and returns it through the pointer in *cfg.
New configuration is always initialized with default values for all possible parameters, which are specified alongside the corresponding setter function.
The pmem2_config_delete() function frees *cfg returned by pmem2_config_new() and sets *cfg to NULL. If *cfg is NULL, no operation is performed.
The pmem2_config_new() function returns 0 on success or a negative error code on failure. pmem2_config_new() does set *cfg to NULL on failure.
The pmem2_config_delete() function returns 0.
pmem2_config_new() can fail with the following error:
errno(3), pmem2_map(3), pmem2_config_set_handle(3), pmem2_config_set_fd(3), pmem2_config_get_file_size(3), libpmem2(7) and http://pmem.io
The contents of this web site and the associated GitHub repositories are BSD-licensed open source.