Skip to content

Commit 6c97ec1

Browse files
Christoph Hellwigdjbw
authored andcommitted
fsdax: improve the FS_DAX Kconfig description and help text
Rename the main option text to clarify it is for file system access, and add a bit of text that explains how to actually switch a nvdimm to a fsdax capable state. Signed-off-by: Christoph Hellwig <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Dan Williams <[email protected]>
1 parent 7c60610 commit 6c97ec1

File tree

1 file changed

+18
-3
lines changed

1 file changed

+18
-3
lines changed

fs/Kconfig

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ source "fs/f2fs/Kconfig"
4343
source "fs/zonefs/Kconfig"
4444

4545
config FS_DAX
46-
bool "Direct Access (DAX) support"
46+
bool "File system based Direct Access (DAX) support"
4747
depends on MMU
4848
depends on !(ARM || MIPS || SPARC)
4949
select DEV_PAGEMAP_OPS if (ZONE_DEVICE && !FS_DAX_LIMITED)
@@ -53,8 +53,23 @@ config FS_DAX
5353
Direct Access (DAX) can be used on memory-backed block devices.
5454
If the block device supports DAX and the filesystem supports DAX,
5555
then you can avoid using the pagecache to buffer I/Os. Turning
56-
on this option will compile in support for DAX; you will need to
57-
mount the filesystem using the -o dax option.
56+
on this option will compile in support for DAX.
57+
58+
For a DAX device to support file system access it needs to have
59+
struct pages. For the nfit based NVDIMMs this can be enabled
60+
using the ndctl utility:
61+
62+
# ndctl create-namespace --force --reconfig=namespace0.0 \
63+
--mode=fsdax --map=mem
64+
65+
See the 'create-namespace' man page for details on the overhead of
66+
--map=mem:
67+
https://docs.pmem.io/ndctl-user-guide/ndctl-man-pages/ndctl-create-namespace
68+
69+
For ndctl to work CONFIG_DEV_DAX needs to be enabled as well. For most
70+
file systems DAX support needs to be manually enabled globally or
71+
per-inode using a mount option as well. See the file documentation in
72+
Documentation/filesystems/dax.rst for details.
5873

5974
If you do not have a block device that is capable of using this,
6075
or if unsure, say N. Saying Y will increase the size of the kernel

0 commit comments

Comments
 (0)