1DAXCTL-MIGRATE-DEVICE-MODEL(1)   daxctl Manual  DAXCTL-MIGRATE-DEVICE-MODEL(1)
2
3
4

NAME

6       daxctl-migrate-device-model - Opt-in to the /sys/bus/dax device-model,
7       allow for alternative Device-DAX instance drivers.
8

SYNOPSIS

10       daxctl migrate-device-model
11
12       Arrange for modprobe to disable the dax_pmem_compat, if present, and
13       instead deploy the dax_pmem module to convert to the /sys/bus/dax
14       model. Kernel versions prior to v5.1 may not support /sys/bus/dax in
15       which case the result of this command is a nop until the kernel is
16       updated. The motivation for changing from /sys/class/dax to
17       /sys/bus/dax is to allow for alternative drivers for Device-DAX
18       instances, in particular the dax_kmem driver.
19
20       By default device-dax publishes a /dev/daxX.Y character device for
21       userspace to directly map performance differentiated memory. This is
22       fine if the memory is to be exclusively consumed / managed by
23       userspace. Alternatively an administrator may want the kernel to manage
24       the memory, make it available via malloc(), allow for
25       over-provisioning, and / or apply kernel-based resource control schemes
26       to the memory. In that case the memory fronted by a given Device-DAX
27       instance can be assigned to the dax_kmem driver which arranges for the
28       core-kernel memory-management sub-system to assume management of the
29       memory range.
30
31       This behavior is opt-in for consideration of existing applications /
32       scripts that may be hard coded to use /sys/class/dax. Fixes have been
33       submitted to applications known to have these direct dependencies FIO
34       <http://git.kernel.dk/cgit/fio/commit/?id=b08e7d6b18b4> PMDK <https://
35       github.com/pmem/pmdk/commit/91bc8620884e>, however, there may be others
36       and a system-owner should be aware of the potential for  regression  of
37       Device-DAX consuming scripts, applications, or older daxctl binaries.
38
39       The modprobe policy established by this utility becomes effective after
40       the next reboot, or after all DAX related modules have been removed and
41       re-loaded with "udevadm trigger"
42

44       Copyright  (c)  2016  - 2019, Intel Corporation. License GPLv2: GNU GPL
45       version 2 <http://gnu.org/licenses/gpl.html>. This  is  free  software:
46       you  are  free  to change and redistribute it. There is NO WARRANTY, to
47       the extent permitted by law.
48
49
50
51daxctl                            2019-05-10    DAXCTL-MIGRATE-DEVICE-MODEL(1)
Impressum