xref: /openbmc/linux/drivers/nvdimm/nd-core.h (revision 0c874100)
1 /*
2  * Copyright(c) 2013-2015 Intel Corporation. All rights reserved.
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of version 2 of the GNU General Public License as
6  * published by the Free Software Foundation.
7  *
8  * This program is distributed in the hope that it will be useful, but
9  * WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
11  * General Public License for more details.
12  */
13 #ifndef __ND_CORE_H__
14 #define __ND_CORE_H__
15 #include <linux/libnvdimm.h>
16 #include <linux/device.h>
17 #include <linux/sizes.h>
18 #include <linux/mutex.h>
19 #include <linux/nd.h>
20 
21 extern struct list_head nvdimm_bus_list;
22 extern struct mutex nvdimm_bus_list_mutex;
23 extern int nvdimm_major;
24 
25 struct nvdimm_bus {
26 	struct nvdimm_bus_descriptor *nd_desc;
27 	wait_queue_head_t probe_wait;
28 	struct list_head list;
29 	struct device dev;
30 	int id, probe_active;
31 	struct list_head mapping_list;
32 	struct mutex reconfig_mutex;
33 	struct badrange badrange;
34 };
35 
36 struct nvdimm {
37 	unsigned long flags;
38 	void *provider_data;
39 	unsigned long cmd_mask;
40 	struct device dev;
41 	atomic_t busy;
42 	int id, num_flush;
43 	struct resource *flush_wpq;
44 };
45 
46 /**
47  * struct blk_alloc_info - tracking info for BLK dpa scanning
48  * @nd_mapping: blk region mapping boundaries
49  * @available: decremented in alias_dpa_busy as aliased PMEM is scanned
50  * @busy: decremented in blk_dpa_busy to account for ranges already
51  * 	  handled by alias_dpa_busy
52  * @res: alias_dpa_busy interprets this a free space range that needs to
53  * 	 be truncated to the valid BLK allocation starting DPA, blk_dpa_busy
54  * 	 treats it as a busy range that needs the aliased PMEM ranges
55  * 	 truncated.
56  */
57 struct blk_alloc_info {
58 	struct nd_mapping *nd_mapping;
59 	resource_size_t available, busy;
60 	struct resource *res;
61 };
62 
63 bool is_nvdimm(struct device *dev);
64 bool is_nd_pmem(struct device *dev);
65 bool is_nd_volatile(struct device *dev);
66 bool is_nd_blk(struct device *dev);
67 static inline bool is_nd_region(struct device *dev)
68 {
69 	return is_nd_pmem(dev) || is_nd_blk(dev) || is_nd_volatile(dev);
70 }
71 static inline bool is_memory(struct device *dev)
72 {
73 	return is_nd_pmem(dev) || is_nd_volatile(dev);
74 }
75 struct nvdimm_bus *walk_to_nvdimm_bus(struct device *nd_dev);
76 int __init nvdimm_bus_init(void);
77 void nvdimm_bus_exit(void);
78 void nvdimm_devs_exit(void);
79 void nd_region_devs_exit(void);
80 void nd_region_probe_success(struct nvdimm_bus *nvdimm_bus, struct device *dev);
81 struct nd_region;
82 void nd_region_create_ns_seed(struct nd_region *nd_region);
83 void nd_region_create_btt_seed(struct nd_region *nd_region);
84 void nd_region_create_pfn_seed(struct nd_region *nd_region);
85 void nd_region_create_dax_seed(struct nd_region *nd_region);
86 void nd_region_disable(struct nvdimm_bus *nvdimm_bus, struct device *dev);
87 int nvdimm_bus_create_ndctl(struct nvdimm_bus *nvdimm_bus);
88 void nvdimm_bus_destroy_ndctl(struct nvdimm_bus *nvdimm_bus);
89 void nd_synchronize(void);
90 int nvdimm_bus_register_dimms(struct nvdimm_bus *nvdimm_bus);
91 int nvdimm_bus_register_regions(struct nvdimm_bus *nvdimm_bus);
92 int nvdimm_bus_init_interleave_sets(struct nvdimm_bus *nvdimm_bus);
93 void __nd_device_register(struct device *dev);
94 int nd_match_dimm(struct device *dev, void *data);
95 struct nd_label_id;
96 char *nd_label_gen_id(struct nd_label_id *label_id, u8 *uuid, u32 flags);
97 bool nd_is_uuid_unique(struct device *dev, u8 *uuid);
98 struct nd_region;
99 struct nvdimm_drvdata;
100 struct nd_mapping;
101 void nd_mapping_free_labels(struct nd_mapping *nd_mapping);
102 
103 int __reserve_free_pmem(struct device *dev, void *data);
104 void release_free_pmem(struct nvdimm_bus *nvdimm_bus,
105 		       struct nd_mapping *nd_mapping);
106 
107 resource_size_t nd_pmem_max_contiguous_dpa(struct nd_region *nd_region,
108 					   struct nd_mapping *nd_mapping);
109 resource_size_t nd_region_allocatable_dpa(struct nd_region *nd_region);
110 resource_size_t nd_pmem_available_dpa(struct nd_region *nd_region,
111 		struct nd_mapping *nd_mapping, resource_size_t *overlap);
112 resource_size_t nd_blk_available_dpa(struct nd_region *nd_region);
113 resource_size_t nd_region_available_dpa(struct nd_region *nd_region);
114 resource_size_t nvdimm_allocated_dpa(struct nvdimm_drvdata *ndd,
115 		struct nd_label_id *label_id);
116 int alias_dpa_busy(struct device *dev, void *data);
117 struct resource *nsblk_add_resource(struct nd_region *nd_region,
118 		struct nvdimm_drvdata *ndd, struct nd_namespace_blk *nsblk,
119 		resource_size_t start);
120 int nvdimm_num_label_slots(struct nvdimm_drvdata *ndd);
121 void get_ndd(struct nvdimm_drvdata *ndd);
122 resource_size_t __nvdimm_namespace_capacity(struct nd_namespace_common *ndns);
123 void nd_detach_ndns(struct device *dev, struct nd_namespace_common **_ndns);
124 void __nd_detach_ndns(struct device *dev, struct nd_namespace_common **_ndns);
125 bool nd_attach_ndns(struct device *dev, struct nd_namespace_common *attach,
126 		struct nd_namespace_common **_ndns);
127 bool __nd_attach_ndns(struct device *dev, struct nd_namespace_common *attach,
128 		struct nd_namespace_common **_ndns);
129 ssize_t nd_namespace_store(struct device *dev,
130 		struct nd_namespace_common **_ndns, const char *buf,
131 		size_t len);
132 struct nd_pfn *to_nd_pfn_safe(struct device *dev);
133 #endif /* __ND_CORE_H__ */
134