Commit b2ef9f5a authored by Ralph Campbell's avatar Ralph Campbell Committed by Jason Gunthorpe
Browse files

mm/hmm/test: add selftest driver for HMM 

This driver is for testing device private memory migration and devices
which use hmm_range_fault() to access system memory via device page tables.

Link: https://lore.kernel.org/r/20200422195028.3684-2-rcampbell@nvidia.com
Link: https://lore.kernel.org/r/20200516010424.2013-1-rcampbell@nvidia.com


Signed-off-by: default avatarRalph Campbell <rcampbell@nvidia.com>
Signed-off-by: default avatarJérôme Glisse <jglisse@redhat.com>
Link: https://lore.kernel.org/r/20200509030225.14592-1-weiyongjun1@huawei.com
Link: https://lore.kernel.org/r/20200509030234.14747-1-weiyongjun1@huawei.com


Signed-off-by: default avatarWei Yongjun <weiyongjun1@huawei.com>
Link: https://lore.kernel.org/r/20200511183704.GA225608@mwanda


Signed-off-by: default avatarDan Carpenter <dan.carpenter@oracle.com>
Signed-off-by: default avatarJason Gunthorpe <jgg@mellanox.com>
parent 2733ea14

lib/Kconfig.debug

+13 −0
Original line number Diff line number Diff line
@@ -2201,6 +2201,19 @@ config TEST_MEMINIT 


	  If unsure, say N.



config TEST_HMM

	tristate "Test HMM (Heterogeneous Memory Management)"

	depends on TRANSPARENT_HUGEPAGE

	depends on DEVICE_PRIVATE

	select HMM_MIRROR

	select MMU_NOTIFIER

	help

	  This is a pseudo device driver solely for testing HMM.

	  Say M here if you want to build the HMM test module.

	  Doing so will allow you to run tools/testing/selftest/vm/hmm-tests.



	  If unsure, say N.



endif # RUNTIME_TESTING_MENU



config MEMTEST

lib/Makefile

+1 −0
Original line number Diff line number Diff line
@@ -92,6 +92,7 @@ obj-$(CONFIG_TEST_STACKINIT) += test_stackinit.o 
obj-$(CONFIG_TEST_BLACKHOLE_DEV) += test_blackhole_dev.o

obj-$(CONFIG_TEST_MEMINIT) += test_meminit.o

obj-$(CONFIG_TEST_LOCKUP) += test_lockup.o

obj-$(CONFIG_TEST_HMM) += test_hmm.o



obj-$(CONFIG_TEST_LIVEPATCH) += livepatch/

lib/test_hmm.c

0 → 100644
+1164 −0

File added.

Preview size limit exceeded, changes collapsed.

lib/test_hmm_uapi.h

0 → 100644
+59 −0
Original line number Diff line number Diff line 
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */

/*

 * This is a module to test the HMM (Heterogeneous Memory Management) API

 * of the kernel. It allows a userspace program to expose its entire address

 * space through the HMM test module device file.

 */

#ifndef _LIB_TEST_HMM_UAPI_H

#define _LIB_TEST_HMM_UAPI_H



#include <linux/types.h>

#include <linux/ioctl.h>



/*

 * Structure to pass to the HMM test driver to mimic a device accessing

 * system memory and ZONE_DEVICE private memory through device page tables.

 *

 * @addr: (in) user address the device will read/write

 * @ptr: (in) user address where device data is copied to/from

 * @npages: (in) number of pages to read/write

 * @cpages: (out) number of pages copied

 * @faults: (out) number of device page faults seen

 */

struct hmm_dmirror_cmd {

	__u64		addr;

	__u64		ptr;

	__u64		npages;

	__u64		cpages;

	__u64		faults;

};



/* Expose the address space of the calling process through hmm device file */

#define HMM_DMIRROR_READ		_IOWR('H', 0x00, struct hmm_dmirror_cmd)

#define HMM_DMIRROR_WRITE		_IOWR('H', 0x01, struct hmm_dmirror_cmd)

#define HMM_DMIRROR_MIGRATE		_IOWR('H', 0x02, struct hmm_dmirror_cmd)

#define HMM_DMIRROR_SNAPSHOT		_IOWR('H', 0x03, struct hmm_dmirror_cmd)



/*

 * Values returned in hmm_dmirror_cmd.ptr for HMM_DMIRROR_SNAPSHOT.

 * HMM_DMIRROR_PROT_ERROR: no valid mirror PTE for this page

 * HMM_DMIRROR_PROT_NONE: unpopulated PTE or PTE with no access

 * HMM_DMIRROR_PROT_READ: read-only PTE

 * HMM_DMIRROR_PROT_WRITE: read/write PTE

 * HMM_DMIRROR_PROT_ZERO: special read-only zero page

 * HMM_DMIRROR_PROT_DEV_PRIVATE_LOCAL: Migrated device private page on the

 *					device the ioctl() is made

 * HMM_DMIRROR_PROT_DEV_PRIVATE_REMOTE: Migrated device private page on some

 *					other device

 */

enum {

	HMM_DMIRROR_PROT_ERROR			= 0xFF,

	HMM_DMIRROR_PROT_NONE			= 0x00,

	HMM_DMIRROR_PROT_READ			= 0x01,

	HMM_DMIRROR_PROT_WRITE			= 0x02,

	HMM_DMIRROR_PROT_ZERO			= 0x10,

	HMM_DMIRROR_PROT_DEV_PRIVATE_LOCAL	= 0x20,

	HMM_DMIRROR_PROT_DEV_PRIVATE_REMOTE	= 0x30,

};



#endif /* _LIB_TEST_HMM_UAPI_H */