1 /* SPDX-License-Identifier: BSD-3-Clause 2 * Copyright (c) Intel Corporation. 3 * All rights reserved. 4 */ 5 6 #include "ftl_core.h" 7 #include "ftl_mngt.h" 8 #include "ftl_mngt_steps.h" 9 10 static const struct ftl_mngt_process_desc desc_startup; 11 static const struct ftl_mngt_process_desc desc_first_start; 12 13 static void 14 ftl_mngt_select_startup_mode(struct spdk_ftl_dev *dev, 15 struct ftl_mngt_process *mngt) 16 { 17 if (dev->conf.mode & SPDK_FTL_MODE_CREATE) { 18 ftl_mngt_call_process(mngt, &desc_first_start); 19 } else { 20 ftl_mngt_fail_step(mngt); 21 } 22 } 23 24 /* 25 * Common startup steps required by FTL in all cases (creation, load, dirty shutdown recovery). 26 * Includes actions like opening the devices, calculating the expected size and version of metadata, etc. 27 */ 28 static const struct ftl_mngt_process_desc desc_startup = { 29 .name = "FTL startup", 30 .steps = { 31 { 32 .name = "Check configuration", 33 .action = ftl_mngt_check_conf, 34 }, 35 { 36 .name = "Open base bdev", 37 .action = ftl_mngt_open_base_bdev, 38 .cleanup = ftl_mngt_close_base_bdev 39 }, 40 { 41 .name = "Open cache bdev", 42 .action = ftl_mngt_open_cache_bdev, 43 .cleanup = ftl_mngt_close_cache_bdev 44 }, 45 #ifdef SPDK_FTL_VSS_EMU 46 { 47 .name = "Initialize VSS emu", 48 .action = ftl_mngt_md_init_vss_emu, 49 .cleanup = ftl_mngt_md_deinit_vss_emu 50 }, 51 #endif 52 { 53 .name = "Initialize superblock", 54 .action = ftl_mngt_superblock_init, 55 .cleanup = ftl_mngt_superblock_deinit 56 }, 57 { 58 .name = "Initialize memory pools", 59 .action = ftl_mngt_init_mem_pools, 60 .cleanup = ftl_mngt_deinit_mem_pools 61 }, 62 { 63 .name = "Initialize bands", 64 .action = ftl_mngt_init_bands, 65 .cleanup = ftl_mngt_deinit_bands 66 }, 67 { 68 .name = "Register IO device", 69 .action = ftl_mngt_register_io_device, 70 .cleanup = ftl_mngt_unregister_io_device 71 }, 72 { 73 .name = "Initialize core IO channel", 74 .action = ftl_mngt_init_io_channel, 75 .cleanup = ftl_mngt_deinit_io_channel 76 }, 77 { 78 .name = "Decorate bands", 79 .action = ftl_mngt_decorate_bands 80 }, 81 { 82 .name = "Initialize layout", 83 .action = ftl_mngt_init_layout 84 }, 85 { 86 .name = "Initialize metadata", 87 .action = ftl_mngt_init_md, 88 .cleanup = ftl_mngt_deinit_md 89 }, 90 { 91 .name = "Initialize NV cache", 92 .action = ftl_mngt_init_nv_cache, 93 .cleanup = ftl_mngt_deinit_nv_cache 94 }, 95 { 96 .name = "Initialize valid map", 97 .action = ftl_mngt_init_vld_map, 98 .cleanup = ftl_mngt_deinit_vld_map 99 }, 100 { 101 .name = "Initialize bands metadata", 102 .action = ftl_mngt_init_bands_md, 103 .cleanup = ftl_mngt_deinit_bands_md 104 }, 105 { 106 .name = "Initialize reloc", 107 .action = ftl_mngt_init_reloc, 108 .cleanup = ftl_mngt_deinit_reloc 109 }, 110 { 111 .name = "Select startup mode", 112 .action = ftl_mngt_select_startup_mode 113 }, 114 {} 115 } 116 }; 117 118 /* 119 * Steps executed when creating FTL for the first time - most important being scrubbing 120 * old data/metadata (so it's not leaked during dirty shutdown recovery) and laying out 121 * regions for the new metadata (initializing band states, etc). 122 */ 123 static const struct ftl_mngt_process_desc desc_first_start = { 124 .name = "FTL first start", 125 .steps = { 126 { 127 .name = "Initialize L2P", 128 .action = ftl_mngt_init_l2p, 129 .cleanup = ftl_mngt_deinit_l2p 130 }, 131 { 132 .name = "Clear L2P", 133 .action = ftl_mngt_clear_l2p, 134 .cleanup = ftl_mngt_clear_l2p 135 }, 136 { 137 .name = "Scrub NV cache", 138 .action = ftl_mngt_scrub_nv_cache, 139 }, 140 { 141 .name = "Finalize band initialization", 142 .action = ftl_mngt_finalize_init_bands, 143 }, 144 { 145 .name = "Save initial band info metadata", 146 .action = ftl_mngt_persist_band_info_metadata, 147 }, 148 { 149 .name = "Save initial chunk info metadata", 150 .action = ftl_mngt_persist_nv_cache_metadata, 151 }, 152 { 153 .name = "Set FTL dirty state", 154 .action = ftl_mngt_set_dirty, 155 }, 156 { 157 .name = "Start core poller", 158 .action = ftl_mngt_start_core_poller, 159 .cleanup = ftl_mngt_stop_core_poller 160 }, 161 { 162 .name = "Finalize initialization", 163 .action = ftl_mngt_finalize_startup, 164 }, 165 {} 166 } 167 }; 168 169 int 170 ftl_mngt_call_dev_startup(struct spdk_ftl_dev *dev, ftl_mngt_completion cb, void *cb_cntx) 171 { 172 return ftl_mngt_process_execute(dev, &desc_startup, cb, cb_cntx); 173 } 174 175 void 176 ftl_mngt_rollback_device(struct spdk_ftl_dev *dev, struct ftl_mngt_process *mngt) 177 { 178 ftl_mngt_call_process_rollback(mngt, &desc_startup); 179 } 180