1PMEMBLK_READ(3)            PMDK Programmer's Manual            PMEMBLK_READ(3)
2
3
4

NAME

6       pmemblk_read(),  pmemblk_write()  -- read or write a block from a block
7       memory pool
8

SYNOPSIS

10              #include <libpmemblk.h>
11
12              int pmemblk_read(PMEMblkpool *pbp, void *buf, long long blockno);
13              int pmemblk_write(PMEMblkpool *pbp, const void *buf, long long blockno);
14

DESCRIPTION

16       The pmemblk_read() function reads the block with block  number  blockno
17       from  memory  pool  pbp  into the buffer buf.  Reading a block that has
18       never been written by pmemblk_write() will return a block of zeroes.
19
20       The pmemblk_write() function writes a block from buf  to  block  number
21       blockno  in  the  memory pool pbp.  The write is atomic with respect to
22       other reads and writes.  In addition, the write cannot be torn by  pro‐
23       gram  failure  or  system crash; on recovery the block is guaranteed to
24       contain either the old data or the new data, never a mixture of both.
25

RETURN VALUE

27       On success, the pmemblk_read() and pmemblk_write() functions return  0.
28       On error, they return -1 and set errno appropriately.
29

SEE ALSO

31       libpmemblk(7) and <http://pmem.io>
32
33
34
35PMDK - pmemblk API version 1.1    2018-03-13                   PMEMBLK_READ(3)
Impressum