drivers/nvdimm/nd-core.h

   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__ */