1/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * Copyright(c) 2013-2015 Intel Corporation. All rights reserved.
4 */
5#ifndef __ND_CORE_H__
6#define __ND_CORE_H__
7#include <linux/libnvdimm.h>
8#include <linux/device.h>
9#include <linux/sizes.h>
10#include <linux/mutex.h>
11#include <linux/nd.h>
12#include "nd.h"
13
14extern struct list_head nvdimm_bus_list;
15extern struct mutex nvdimm_bus_list_mutex;
16extern int nvdimm_major;
17extern struct workqueue_struct *nvdimm_wq;
18
19struct nvdimm_bus {
20	struct nvdimm_bus_descriptor *nd_desc;
21	wait_queue_head_t wait;
22	struct list_head list;
23	struct device dev;
24	int id, probe_active;
25	atomic_t ioctl_active;
26	struct list_head mapping_list;
27	struct mutex reconfig_mutex;
28	struct badrange badrange;
29};
30
31struct nvdimm {
32	unsigned long flags;
33	void *provider_data;
34	unsigned long cmd_mask;
35	struct device dev;
36	atomic_t busy;
37	int id, num_flush;
38	struct resource *flush_wpq;
39	const char *dimm_id;
40	struct {
41		const struct nvdimm_security_ops *ops;
42		unsigned long flags;
43		unsigned long ext_flags;
44		unsigned int overwrite_tmo;
45		struct kernfs_node *overwrite_state;
46	} sec;
47	struct delayed_work dwork;
48	const struct nvdimm_fw_ops *fw_ops;
49};
50
51static inline unsigned long nvdimm_security_flags(
52		struct nvdimm *nvdimm, enum nvdimm_passphrase_type ptype)
53{
54	u64 flags;
55	const u64 state_flags = 1UL << NVDIMM_SECURITY_DISABLED
56		| 1UL << NVDIMM_SECURITY_LOCKED
57		| 1UL << NVDIMM_SECURITY_UNLOCKED
58		| 1UL << NVDIMM_SECURITY_OVERWRITE;
59
60	if (!nvdimm->sec.ops)
61		return 0;
62
63	flags = nvdimm->sec.ops->get_flags(nvdimm, ptype);
64	/* disabled, locked, unlocked, and overwrite are mutually exclusive */
65	dev_WARN_ONCE(&nvdimm->dev, hweight64(flags & state_flags) > 1,
66			"reported invalid security state: %#llx\n",
67			(unsigned long long) flags);
68	return flags;
69}
70int nvdimm_security_freeze(struct nvdimm *nvdimm);
71#if IS_ENABLED(CONFIG_NVDIMM_KEYS)
72ssize_t nvdimm_security_store(struct device *dev, const char *buf, size_t len);
73void nvdimm_security_overwrite_query(struct work_struct *work);
74#else
75static inline ssize_t nvdimm_security_store(struct device *dev,
76		const char *buf, size_t len)
77{
78	return -EOPNOTSUPP;
79}
80static inline void nvdimm_security_overwrite_query(struct work_struct *work)
81{
82}
83#endif
84
85bool is_nvdimm(const struct device *dev);
86bool is_nd_pmem(const struct device *dev);
87bool is_nd_volatile(const struct device *dev);
88static inline bool is_nd_region(const struct device *dev)
89{
90	return is_nd_pmem(dev) || is_nd_volatile(dev);
91}
92static inline bool is_memory(const struct device *dev)
93{
94	return is_nd_pmem(dev) || is_nd_volatile(dev);
95}
96struct nvdimm_bus *walk_to_nvdimm_bus(struct device *nd_dev);
97int __init nvdimm_bus_init(void);
98void nvdimm_bus_exit(void);
99void nvdimm_devs_exit(void);
100struct nd_region;
101void nd_region_advance_seeds(struct nd_region *nd_region, struct device *dev);
102void nd_region_create_ns_seed(struct nd_region *nd_region);
103void nd_region_create_btt_seed(struct nd_region *nd_region);
104void nd_region_create_pfn_seed(struct nd_region *nd_region);
105void nd_region_create_dax_seed(struct nd_region *nd_region);
106int nvdimm_bus_create_ndctl(struct nvdimm_bus *nvdimm_bus);
107void nvdimm_bus_destroy_ndctl(struct nvdimm_bus *nvdimm_bus);
108void nd_synchronize(void);
109void nd_device_register(struct device *dev);
110void nd_device_register_sync(struct device *dev);
111struct nd_label_id;
112char *nd_label_gen_id(struct nd_label_id *label_id, const uuid_t *uuid,
113		      u32 flags);
114bool nd_is_uuid_unique(struct device *dev, uuid_t *uuid);
115struct nd_region;
116struct nvdimm_drvdata;
117struct nd_mapping;
118void nd_mapping_free_labels(struct nd_mapping *nd_mapping);
119
120int __reserve_free_pmem(struct device *dev, void *data);
121void release_free_pmem(struct nvdimm_bus *nvdimm_bus,
122		       struct nd_mapping *nd_mapping);
123
124resource_size_t nd_pmem_max_contiguous_dpa(struct nd_region *nd_region,
125					   struct nd_mapping *nd_mapping);
126resource_size_t nd_region_allocatable_dpa(struct nd_region *nd_region);
127resource_size_t nd_pmem_available_dpa(struct nd_region *nd_region,
128				      struct nd_mapping *nd_mapping);
129resource_size_t nd_region_available_dpa(struct nd_region *nd_region);
130int nd_region_conflict(struct nd_region *nd_region, resource_size_t start,
131		resource_size_t size);
132resource_size_t nvdimm_allocated_dpa(struct nvdimm_drvdata *ndd,
133		struct nd_label_id *label_id);
134int nvdimm_num_label_slots(struct nvdimm_drvdata *ndd);
135void get_ndd(struct nvdimm_drvdata *ndd);
136resource_size_t __nvdimm_namespace_capacity(struct nd_namespace_common *ndns);
137void nd_detach_ndns(struct device *dev, struct nd_namespace_common **_ndns);
138void __nd_detach_ndns(struct device *dev, struct nd_namespace_common **_ndns);
139bool nd_attach_ndns(struct device *dev, struct nd_namespace_common *attach,
140		struct nd_namespace_common **_ndns);
141bool __nd_attach_ndns(struct device *dev, struct nd_namespace_common *attach,
142		struct nd_namespace_common **_ndns);
143ssize_t nd_namespace_store(struct device *dev,
144		struct nd_namespace_common **_ndns, const char *buf,
145		size_t len);
146struct nd_pfn *to_nd_pfn_safe(struct device *dev);
147bool is_nvdimm_bus(struct device *dev);
148
149#if IS_ENABLED(CONFIG_ND_CLAIM)
150int devm_nsio_enable(struct device *dev, struct nd_namespace_io *nsio,
151		resource_size_t size);
152void devm_nsio_disable(struct device *dev, struct nd_namespace_io *nsio);
153#else
154static inline int devm_nsio_enable(struct device *dev,
155		struct nd_namespace_io *nsio, resource_size_t size)
156{
157	return -ENXIO;
158}
159
160static inline void devm_nsio_disable(struct device *dev,
161		struct nd_namespace_io *nsio)
162{
163}
164#endif
165#endif /* __ND_CORE_H__ */
166