pmem2 API version 1.0

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
SEE ALSO

NAME

pmem2_config_new(), pmem2_config_delete() - allocate and free a configuration for a libpmem2 mapping

SYNOPSIS

#include <libpmem2.h>

struct pmem2_config;
int pmem2_config_new(struct pmem2_config **cfg);
int pmem2_config_delete(struct pmem2_config **cfg);

DESCRIPTION

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.

RETURN VALUE

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.

ERRORS

pmem2_config_new() can fail with the following error:

  • -ENOMEM - out of memory

SEE ALSO

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.