Dan Williams | 18da2c9 | 2015-06-09 14:13:37 -0400 | [diff] [blame] | 1 | menuconfig LIBNVDIMM |
Dan Williams | b94d523 | 2015-05-19 22:54:31 -0400 | [diff] [blame] | 2 | tristate "NVDIMM (Non-Volatile Memory Device) Support" |
| 3 | depends on PHYS_ADDR_T_64BIT |
Dan Williams | 29b9aa0 | 2016-06-06 17:42:38 -0700 | [diff] [blame] | 4 | depends on HAS_IOMEM |
Dan Williams | b94d523 | 2015-05-19 22:54:31 -0400 | [diff] [blame] | 5 | depends on BLK_DEV |
| 6 | help |
| 7 | Generic support for non-volatile memory devices including |
| 8 | ACPI-6-NFIT defined resources. On platforms that define an |
| 9 | NFIT, or otherwise can discover NVDIMM resources, a libnvdimm |
| 10 | bus is registered to advertise PMEM (persistent memory) |
| 11 | namespaces (/dev/pmemX) and BLK (sliding mmio window(s)) |
Vishal Verma | 5212e11 | 2015-06-25 04:20:32 -0400 | [diff] [blame] | 12 | namespaces (/dev/ndblkX.Y). A PMEM namespace refers to a |
| 13 | memory resource that may span multiple DIMMs and support DAX |
| 14 | (see CONFIG_DAX). A BLK namespace refers to an NVDIMM control |
| 15 | region which exposes an mmio register set for windowed access |
| 16 | mode to non-volatile memory. |
Dan Williams | 18da2c9 | 2015-06-09 14:13:37 -0400 | [diff] [blame] | 17 | |
| 18 | if LIBNVDIMM |
| 19 | |
| 20 | config BLK_DEV_PMEM |
| 21 | tristate "PMEM: Persistent memory block device support" |
| 22 | default LIBNVDIMM |
Vishal Verma | 5212e11 | 2015-06-25 04:20:32 -0400 | [diff] [blame] | 23 | select ND_BTT if BTT |
Dan Williams | e145574 | 2015-07-30 17:57:47 -0400 | [diff] [blame] | 24 | select ND_PFN if NVDIMM_PFN |
Dan Williams | 18da2c9 | 2015-06-09 14:13:37 -0400 | [diff] [blame] | 25 | help |
| 26 | Memory ranges for PMEM are described by either an NFIT |
| 27 | (NVDIMM Firmware Interface Table, see CONFIG_NFIT_ACPI), a |
| 28 | non-standard OEM-specific E820 memory type (type-12, see |
| 29 | CONFIG_X86_PMEM_LEGACY), or it is manually specified by the |
| 30 | 'memmap=nn[KMG]!ss[KMG]' kernel command line (see |
Mauro Carvalho Chehab | 8c27ceff3 | 2016-10-18 10:12:27 -0200 | [diff] [blame] | 31 | Documentation/admin-guide/kernel-parameters.rst). This driver converts |
Dan Williams | 18da2c9 | 2015-06-09 14:13:37 -0400 | [diff] [blame] | 32 | these persistent memory ranges into block devices that are |
| 33 | capable of DAX (direct-access) file system mappings. See |
| 34 | Documentation/nvdimm/nvdimm.txt for more details. |
| 35 | |
| 36 | Say Y if you want to use an NVDIMM |
| 37 | |
Ross Zwisler | 047fc8a | 2015-06-25 04:21:02 -0400 | [diff] [blame] | 38 | config ND_BLK |
| 39 | tristate "BLK: Block data window (aperture) device support" |
| 40 | default LIBNVDIMM |
| 41 | select ND_BTT if BTT |
| 42 | help |
| 43 | Support NVDIMMs, or other devices, that implement a BLK-mode |
| 44 | access capability. BLK-mode access uses memory-mapped-i/o |
| 45 | apertures to access persistent media. |
| 46 | |
| 47 | Say Y if your platform firmware emits an ACPI.NFIT table |
| 48 | (CONFIG_ACPI_NFIT), or otherwise exposes BLK-mode |
| 49 | capabilities. |
| 50 | |
Dan Williams | e145574 | 2015-07-30 17:57:47 -0400 | [diff] [blame] | 51 | config ND_CLAIM |
| 52 | bool |
| 53 | |
Vishal Verma | 5212e11 | 2015-06-25 04:20:32 -0400 | [diff] [blame] | 54 | config ND_BTT |
| 55 | tristate |
| 56 | |
Dan Williams | 8c2f7e8 | 2015-06-25 04:20:04 -0400 | [diff] [blame] | 57 | config BTT |
Vishal Verma | 5212e11 | 2015-06-25 04:20:32 -0400 | [diff] [blame] | 58 | bool "BTT: Block Translation Table (atomic sector updates)" |
| 59 | default y if LIBNVDIMM |
Dan Williams | e145574 | 2015-07-30 17:57:47 -0400 | [diff] [blame] | 60 | select ND_CLAIM |
Vishal Verma | 5212e11 | 2015-06-25 04:20:32 -0400 | [diff] [blame] | 61 | help |
| 62 | The Block Translation Table (BTT) provides atomic sector |
| 63 | update semantics for persistent memory devices, so that |
| 64 | applications that rely on sector writes not being torn (a |
| 65 | guarantee that typical disks provide) can continue to do so. |
| 66 | The BTT manifests itself as an alternate personality for an |
| 67 | NVDIMM namespace, i.e. a namespace can be in raw mode (pmemX, |
| 68 | ndblkX.Y, etc...), or 'sectored' mode, (pmemXs, ndblkX.Ys, |
| 69 | etc...). |
| 70 | |
| 71 | Select Y if unsure |
Dan Williams | 8c2f7e8 | 2015-06-25 04:20:04 -0400 | [diff] [blame] | 72 | |
Dan Williams | e145574 | 2015-07-30 17:57:47 -0400 | [diff] [blame] | 73 | config ND_PFN |
| 74 | tristate |
| 75 | |
| 76 | config NVDIMM_PFN |
| 77 | bool "PFN: Map persistent (device) memory" |
| 78 | default LIBNVDIMM |
Dan Williams | 32ab0a3f | 2015-08-01 02:16:37 -0400 | [diff] [blame] | 79 | depends on ZONE_DEVICE |
Dan Williams | e145574 | 2015-07-30 17:57:47 -0400 | [diff] [blame] | 80 | select ND_CLAIM |
| 81 | help |
| 82 | Map persistent memory, i.e. advertise it to the memory |
| 83 | management sub-system. By default persistent memory does |
| 84 | not support direct I/O, RDMA, or any other usage that |
| 85 | requires a 'struct page' to mediate an I/O request. This |
| 86 | driver allocates and initializes the infrastructure needed |
| 87 | to support those use cases. |
| 88 | |
| 89 | Select Y if unsure |
| 90 | |
Dan Williams | cd03412 | 2016-03-11 10:15:36 -0800 | [diff] [blame] | 91 | config NVDIMM_DAX |
Arnd Bergmann | 867dfe3 | 2016-10-25 17:52:04 +0200 | [diff] [blame] | 92 | bool "NVDIMM DAX: Raw access to persistent memory" |
Dan Williams | cd03412 | 2016-03-11 10:15:36 -0800 | [diff] [blame] | 93 | default LIBNVDIMM |
| 94 | depends on NVDIMM_PFN |
| 95 | help |
| 96 | Support raw device dax access to a persistent memory |
| 97 | namespace. For environments that want to hard partition |
| 98 | peristent memory, this capability provides a mechanism to |
| 99 | sub-divide a namespace into character devices that can only be |
| 100 | accessed via DAX (mmap(2)). |
| 101 | |
| 102 | Select Y if unsure |
| 103 | |
Dan Williams | 18da2c9 | 2015-06-09 14:13:37 -0400 | [diff] [blame] | 104 | endif |