pmemblk_set_zero - Man Page

block management functions

Synopsis

#include <libpmemblk.h>

int pmemblk_set_zero(PMEMblkpool *pbp, long long blockno);
int pmemblk_set_error(PMEMblkpool *pbp, long long blockno);

Description

The pmemblk_set_zero() function writes zeros to block number blockno in persistent memory resident array of blocks pbp. Using this function is faster than actually writing a block of zeros since libpmemblk(7) uses metadata to indicate the block should read back as zero.

The pmemblk_set_error() function sets the error state for block number blockno in persistent memory resident array of blocks pbp. A block in the error state returns errno EIO when read. Writing the block clears the error state and returns the block to normal use.

Return Value

On success, pmemblk_set_zero() and pmemblk_set_error() return 0. On error, they return -1 and set errno appropriately.

See Also

libpmemblk(7) and <https://pmem.io>

Referenced By

libpmemblk(7).

The man page pmemblk_set_error(3) is an alias of pmemblk_set_zero(3).

2020-10-28 PMDK - pmemblk API version 1.1 PMDK Programmer's Manual