table of contents
PMEM2_SOURCE_FROM_ANON(3) | PMDK Programmer's Manual | PMEM2_SOURCE_FROM_ANON(3) |
NAME¶
pmem2_source_from_anon() - creates data source backed by anonymous memory pages
SYNOPSIS¶
-
#include <libpmem2.h> int pmem2_source_from_anon(struct pmem2_source **src, size_t size);
DESCRIPTION¶
The pmem2_source_from_anon() function instantiates a new struct pmem2_source object describing an anonymous data source. Mappings created using this function are not backed by any file and are zero-initialized.
The size argument for the function defines the length in bytes of the anonymous source, as returned by pmem2_source_size(3). The application should set this value so that it's greater than or equal to the size of any mapping created with the anonymous source.
The offset value for mapping is ignored.
RETURN VALUE¶
The pmem2_source_from_anon() function returns 0 on success or a negative error code on failure.
ERRORS¶
The pmem2_source_form_anon() can fail with the following errors:
- •
- -ENOMEM - in case of insufficient memory to allocate an instance of struct pmem2_source.
SEE ALSO¶
errno(3), pmem2_config_set_length(3), pmem2_map_new(3), pmem2_source_size(3), pmem2_config_set_length(3), libpmem2(7) and <https://pmem.io>
2022-08-25 | PMDK - pmem2 API version 1.0 |