pmemblk API version 1.1

comment: <> (SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT) comment: <> (LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,) comment: <> (DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY) comment: <> (THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT) comment: <> ((INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE) comment: <> (OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.)

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
SEE ALSO

NAME

pmemblk_set_zero(), pmemblk_set_error() - 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 http://pmem.io

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