pmempool API version 1.3

The PMDK repository on GitHub is the ultimate source of information on PMDK from release 2.0! For all questions and to submit eventual issues please follow to that repository. The PMDK documentation collected here should be valid up to the 1.13.1 release but is maintained only on a best-effort basis and may not reflect the latest state of the art.

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
SEE ALSO

NAME

pmempool_rm() - remove persistent memory pool

SYNOPSIS

#include <libpmempool.h>

int pmempool_rm(const char *path, int flags);

DESCRIPTION

The pmempool_rm() function removes the pool pointed to by path. The path can point to a regular file, device dax or pool set file. If path is a pool set file, pmempool_rm() will remove all part files from replicas using unlink(2) before removing the pool set file itself.

The flags argument determines the behavior of pmempool_rm(). It is either 0 or the bitwise OR of one or more of the following flags:

  • PMEMPOOL_RM_FORCE - Ignore all errors when removing part files from replicas.

  • PMEMPOOL_RM_POOLSET_LOCAL - Also remove local pool set file.

RETURN VALUE

On success, pmempool_rm() returns 0. On error, it returns -1 and sets errno accordingly.

SEE ALSO

unlink(3), libpmemlog(7), libpmemobj(7) and https://pmem.io

The contents of this web site and the associated GitHub repositories are BSD-licensed open source.