From 7aa4abfb152bb70d6f26762ea0ab2fd86dfa71a2 Mon Sep 17 00:00:00 2001 From: Olasoji Denloye Date: Thu, 19 Dec 2019 12:17:27 -0800 Subject: [PATCH] Update README.md --- README.md | 29 +++++++++++++---------------- 1 file changed, 13 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 2f7a1ba..44d384a 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ The Low Level Persistence Library offers access to persistent memory using `MemoryBlocks` allocated from a persistent Heap. -This Java library uses the **libpmemobj** library from the Persistent Memory Development Kit (PMDK). +This Java library uses the Persistent Memory Development Kit (PMDK). For more information on PMDK, please visit http://pmem.io and https://github.com/pmem/pmdk. ## HOW TO BUILD & RUN ## @@ -13,10 +13,10 @@ For more information on PMDK, please visit http://pmem.io and https://github.com ### PREREQUISITES TO BUILD ### The following are the prerequisites for building this Java library: -1. Linux operating system (tested on CentOS 7.2) +1. Linux operating system 2. Persistent Memory Development Kit (PMDK) 3. Java 8 or above -4. Build tools - `g++` compiler and `make` +4. Build tools - `g++` compiler, `CMake` and `Maven` ### PREREQUISITES TO RUN ### This library assumes the availability of hardware persistent memory or emulated persistent memory. Instructions for creating emulated persistent memory are shown below. @@ -29,7 +29,7 @@ greater. Please follow the steps at: Alternatively, for use with older kernels, create a tmpfs partition as follows (as root): ``` - $ mount -t tmpfs -o size=8G tmpfs /mnt/mem # creates a 8GB tmpfs partition + $ mount -t tmpfs -o size=4G tmpfs /mnt/mem # creates a 4GB tmpfs partition $ chmod -R a+rw /mnt/mem # enables read/write permissions to all users ``` ### STEPS TO BUILD AND RUN TESTS ### @@ -37,15 +37,15 @@ Once all the prerequisites have been satisfied: ``` $ git clone https://github.com/pmem/llpl.git $ cd llpl - $ make && make tests + $ mvn compile + $ mvn test -Dtest.heap.path= ``` -Available Makefile targets include: +Available Maven commands include: - - `sources` - builds only sources - - `examples` - builds the sources and examples - - `tests` - builds and runs tests - - `docs` - builds javadocs - - `jar` - builds jar file into ```target``` directory + - `compile` - builds sources + - `test` - builds and runs tests + - `javadoc:javadoc` - builds javadocs into ```target/site/apidocs``` + - `package` - builds jar file into ```target``` directory ### USING THIS LIBRARY IN EXISTING JAVA APPLICATIONS ### To import this library into an existing Java application, include the project's target/classes @@ -57,12 +57,9 @@ directory in your Java classpath and the project's ```target/cppbuild``` directo ``` ## CONTRIBUTING ## -Thanks for your interest! Right now, architectural changes are still happening in the -project. This makes it difficult to contribute code and difficult to effectively process pull -requests. We expect these changes to settle out around March of this year and we look forward to -code contributions once this happens. We will update this README then. +Thanks for your interest! Please see the CONTRIBUTING.md document for information on how to contribute. -In the meantime, we would love to hear your comments and suggestions via https://github.com/pmem/llpl/issues. +We would love to hear your comments and suggestions via https://github.com/pmem/llpl/issues. ## Contacts ## For more information on this library, contact Olasoji Denloye (olasoji.denloye@intel.com) or Steve Dohrmann