pmem2: set async as deprecated

README.md

@@ -45,6 +45,10 @@ Libraries available in this repository:
 
 - [libpmem2](https://pmem.io/pmdk/libpmem2/):  provides low level persistent memory support, is a new version of libpmem.
 
+> NOTICE:
+Support for async functions is deprecated since PMDK 1.13.0 release
+and will be removed in the PMDK 1.14.0 release along with the miniasync dependency.
+
 - [libpmemobj](https://pmem.io/pmdk/libpmemobj/):  provides a transactional object store, providing memory allocation, transactions, and general facilities for persistent memory programming.
 
 - [libpmemblk](https://pmem.io/pmdk/libpmemblk/):  supports arrays of pmem-resident blocks, all the same size, that are atomically updated.

doc/libpmem2/pmem2_async.3.md

@@ -20,7 +20,12 @@ header: "pmem2 API version 1.0"
 [SEE ALSO](#see-also)<br />
 
 # NAME #
-**pmem2_config_set_vdm**(), **pmem2_memcpy_async**(), **pmem2_memmove_async**(), **pmem2_memset_async**() - asynchronous data movement operations
+**pmem2_config_set_vdm**()(DEPRECATED), **pmem2_memcpy_async**()(DEPRECATED), **pmem2_memmove_async**()(DEPRECATED),
+**pmem2_memset_async**()(DEPRECATED) - asynchronous data movement operations
+
+> NOTICE:
+Support for async functions is deprecated since PMDK 1.13.0 release
+and will be removed in the PMDK 1.14.0 release along with the miniasync dependency.
 
 # SYNOPSIS #
 

src/deps/README.md

@@ -10,3 +10,6 @@ Use git sub-tree to pull changes for the pmem/miniasync repository.
 This copy is intended to be removed when miniasync will be released,
 and uploaded to the vcpkg repository.
 
+> NOTICE:
+Support for async functions is deprecated since PMDK 1.13.0 release
+and will be removed in the PMDK 1.14.0 release along with the miniasync dependency.

src/include/libpmem2/async.h

@@ -1,5 +1,5 @@
 /* SPDX-License-Identifier: BSD-3-Clause */
-/* Copyright 2022, Intel Corporation */
+/* Copyright 2022-2023, Intel Corporation */
 
 /*
  * libpmem2/async.h -- definitions of libpmem2 functions and structs for
@@ -18,6 +18,14 @@
 extern "C" {
 #endif
 
+#define ASYNC_DEPR_STR "Async support for libpmem2 is deprecated."
+#ifdef _WIN32
+#define ASYNC_DEPR_ATTR __declspec(deprecated(ASYNC_DEPR_STR))
+#else
+#define ASYNC_DEPR_ATTR __attribute__((deprecated(ASYNC_DEPR_STR)))
+#endif
+
+ASYNC_DEPR_ATTR
 int pmem2_config_set_vdm(struct pmem2_config *cfg, struct vdm *vdm);
 
 /*
@@ -104,12 +112,15 @@ struct pmem2_future_output {
 FUTURE(pmem2_future, struct pmem2_future_data,
 	struct pmem2_future_output);
 
+ASYNC_DEPR_ATTR
 struct pmem2_future pmem2_memcpy_async(struct pmem2_map *map,
 	void *pmemdest, const void *src, size_t len, unsigned flags);
 
+ASYNC_DEPR_ATTR
 struct pmem2_future pmem2_memmove_async(struct pmem2_map *map,
 	void *pmemdest, const void *src, size_t len, unsigned flags);
 
+ASYNC_DEPR_ATTR
 struct pmem2_future pmem2_memset_async(struct pmem2_map *map,
 	void *str, int c, size_t n, unsigned flags);
 

src/test/pmem2_future/Makefile

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: BSD-3-Clause
-# Copyright 2022, Intel Corporation
+# Copyright 2022-2023, Intel Corporation
 #
 
 #
@@ -19,3 +19,8 @@ OBJS = pmem2_future.o\
 LIBPMEM2=y
 LIBMINIASYNC=y
 include ../Makefile.inc
+
+# Miniasync support is deprecated.
+# This flag allows to build tests, examples and benchmarks
+# using miniasync despite the deprecated state.
+CFLAGS += -Wno-deprecated-declarations

src/test/pmem2_mover/Makefile

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: BSD-3-Clause
-# Copyright 2022, Intel Corporation
+# Copyright 2022-2023, Intel Corporation
 
 #
 # src/test/pmem2_mover/Makefile -- build pmem2_mover test
@@ -18,3 +18,8 @@ OBJS = pmem2_mover.o\
 LIBPMEM2=y
 LIBMINIASYNC=y
 include ../Makefile.inc
+
+# Miniasync support is deprecated.
+# This flag allows to build tests, examples and benchmarks
+# using miniasync despite the deprecated state.
+CFLAGS += -Wno-deprecated-declarations