pmem2_source_device_id - Man Page

returns the unique identifier of a device


#include <libpmem2.h>

struct pmem2_source;
int pmem2_source_device_id(const struct pmem2_source *source, char *id, size_t *len);


The pmem2_source_device_id() function retrieves a unique identifier of all NVDIMMs backing the data source. This function has two operating modes:

For details on how to use the unique identifier for detecting the unsafe shutdown please refer to libpmem2_unsafe_shutdown(7) manual page.

Return Value

The pmem2_source_device_id() function returns 0 on success. If the function fails, the *id and *len variables contents are left unmodified and a negative error code is returned.


The pmem2_source_device_id() can fail with the following errors:

On all systems:

On Windows:

On Linux:

See Also

fstat(2), errno(3), malloc(3), libpmem2_unsafe_shutdown(7), and <>

Referenced By

libpmem2(7), libpmem2_unsafe_shutdown(7).

2020-10-28 PMDK - pmem2 API version 1.0 PMDK Programmer's Manual