pmemset API version 1.0

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

pmemset_deep_flush() - performs deep flush on the range

SYNOPSIS

#include <libpmemset.h>

int pmemset_deep_flush(struct pmemset *set, const void *ptr, size_t size);

DESCRIPTION

The pmemset_deep_flush() function forces any changes in the range [ptr, ptr+size) from the set to be stored durably in the most reliable persistence domain available to software. In particular, on supported platforms, this enables the code not to rely on automatic cache or WPQ (write pending queue) flush on power failure (ADR/eADR).

Since this operation is usually much more expensive than regular persist, it should be used sparingly. Typically, the application should only ever use this function as a precaution against hardware failures, e.g., in code that detects silent data corruption caused by unsafe shutdown.

RETURN VALUE

The pmemset_deep_flush() function returns 0 on success or a negative error code on failure.

ERRORS

The pmemset_deep_flush() can fail with the following errors:

  • PMEMSET_E_DEEP_FLUSH_FAIL - the underlying device region id cannot be detected or cannot perform msync on a regular DAX volume.

SEE ALSO

pmem2_get_persist_fn(3), libpmemset(7), libpmem2(7), and https://pmem.io

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