Loading...
1// SPDX-License-Identifier: GPL-2.0-only
2/*
3 * Block Translation Table
4 * Copyright (c) 2014-2015, Intel Corporation.
5 */
6#include <linux/highmem.h>
7#include <linux/debugfs.h>
8#include <linux/blkdev.h>
9#include <linux/pagemap.h>
10#include <linux/module.h>
11#include <linux/device.h>
12#include <linux/mutex.h>
13#include <linux/hdreg.h>
14#include <linux/sizes.h>
15#include <linux/ndctl.h>
16#include <linux/fs.h>
17#include <linux/nd.h>
18#include <linux/backing-dev.h>
19#include <linux/cleanup.h>
20#include "btt.h"
21#include "nd.h"
22
23enum log_ent_request {
24 LOG_NEW_ENT = 0,
25 LOG_OLD_ENT
26};
27
28static struct device *to_dev(struct arena_info *arena)
29{
30 return &arena->nd_btt->dev;
31}
32
33static u64 adjust_initial_offset(struct nd_btt *nd_btt, u64 offset)
34{
35 return offset + nd_btt->initial_offset;
36}
37
38static int arena_read_bytes(struct arena_info *arena, resource_size_t offset,
39 void *buf, size_t n, unsigned long flags)
40{
41 struct nd_btt *nd_btt = arena->nd_btt;
42 struct nd_namespace_common *ndns = nd_btt->ndns;
43
44 /* arena offsets may be shifted from the base of the device */
45 offset = adjust_initial_offset(nd_btt, offset);
46 return nvdimm_read_bytes(ndns, offset, buf, n, flags);
47}
48
49static int arena_write_bytes(struct arena_info *arena, resource_size_t offset,
50 void *buf, size_t n, unsigned long flags)
51{
52 struct nd_btt *nd_btt = arena->nd_btt;
53 struct nd_namespace_common *ndns = nd_btt->ndns;
54
55 /* arena offsets may be shifted from the base of the device */
56 offset = adjust_initial_offset(nd_btt, offset);
57 return nvdimm_write_bytes(ndns, offset, buf, n, flags);
58}
59
60static int btt_info_write(struct arena_info *arena, struct btt_sb *super)
61{
62 int ret;
63
64 /*
65 * infooff and info2off should always be at least 512B aligned.
66 * We rely on that to make sure rw_bytes does error clearing
67 * correctly, so make sure that is the case.
68 */
69 dev_WARN_ONCE(to_dev(arena), !IS_ALIGNED(arena->infooff, 512),
70 "arena->infooff: %#llx is unaligned\n", arena->infooff);
71 dev_WARN_ONCE(to_dev(arena), !IS_ALIGNED(arena->info2off, 512),
72 "arena->info2off: %#llx is unaligned\n", arena->info2off);
73
74 ret = arena_write_bytes(arena, arena->info2off, super,
75 sizeof(struct btt_sb), 0);
76 if (ret)
77 return ret;
78
79 return arena_write_bytes(arena, arena->infooff, super,
80 sizeof(struct btt_sb), 0);
81}
82
83static int btt_info_read(struct arena_info *arena, struct btt_sb *super)
84{
85 return arena_read_bytes(arena, arena->infooff, super,
86 sizeof(struct btt_sb), 0);
87}
88
89/*
90 * 'raw' version of btt_map write
91 * Assumptions:
92 * mapping is in little-endian
93 * mapping contains 'E' and 'Z' flags as desired
94 */
95static int __btt_map_write(struct arena_info *arena, u32 lba, __le32 mapping,
96 unsigned long flags)
97{
98 u64 ns_off = arena->mapoff + (lba * MAP_ENT_SIZE);
99
100 if (unlikely(lba >= arena->external_nlba))
101 dev_err_ratelimited(to_dev(arena),
102 "%s: lba %#x out of range (max: %#x)\n",
103 __func__, lba, arena->external_nlba);
104 return arena_write_bytes(arena, ns_off, &mapping, MAP_ENT_SIZE, flags);
105}
106
107static int btt_map_write(struct arena_info *arena, u32 lba, u32 mapping,
108 u32 z_flag, u32 e_flag, unsigned long rwb_flags)
109{
110 u32 ze;
111 __le32 mapping_le;
112
113 /*
114 * This 'mapping' is supposed to be just the LBA mapping, without
115 * any flags set, so strip the flag bits.
116 */
117 mapping = ent_lba(mapping);
118
119 ze = (z_flag << 1) + e_flag;
120 switch (ze) {
121 case 0:
122 /*
123 * We want to set neither of the Z or E flags, and
124 * in the actual layout, this means setting the bit
125 * positions of both to '1' to indicate a 'normal'
126 * map entry
127 */
128 mapping |= MAP_ENT_NORMAL;
129 break;
130 case 1:
131 mapping |= (1 << MAP_ERR_SHIFT);
132 break;
133 case 2:
134 mapping |= (1 << MAP_TRIM_SHIFT);
135 break;
136 default:
137 /*
138 * The case where Z and E are both sent in as '1' could be
139 * construed as a valid 'normal' case, but we decide not to,
140 * to avoid confusion
141 */
142 dev_err_ratelimited(to_dev(arena),
143 "Invalid use of Z and E flags\n");
144 return -EIO;
145 }
146
147 mapping_le = cpu_to_le32(mapping);
148 return __btt_map_write(arena, lba, mapping_le, rwb_flags);
149}
150
151static int btt_map_read(struct arena_info *arena, u32 lba, u32 *mapping,
152 int *trim, int *error, unsigned long rwb_flags)
153{
154 int ret;
155 __le32 in;
156 u32 raw_mapping, postmap, ze, z_flag, e_flag;
157 u64 ns_off = arena->mapoff + (lba * MAP_ENT_SIZE);
158
159 if (unlikely(lba >= arena->external_nlba))
160 dev_err_ratelimited(to_dev(arena),
161 "%s: lba %#x out of range (max: %#x)\n",
162 __func__, lba, arena->external_nlba);
163
164 ret = arena_read_bytes(arena, ns_off, &in, MAP_ENT_SIZE, rwb_flags);
165 if (ret)
166 return ret;
167
168 raw_mapping = le32_to_cpu(in);
169
170 z_flag = ent_z_flag(raw_mapping);
171 e_flag = ent_e_flag(raw_mapping);
172 ze = (z_flag << 1) + e_flag;
173 postmap = ent_lba(raw_mapping);
174
175 /* Reuse the {z,e}_flag variables for *trim and *error */
176 z_flag = 0;
177 e_flag = 0;
178
179 switch (ze) {
180 case 0:
181 /* Initial state. Return postmap = premap */
182 *mapping = lba;
183 break;
184 case 1:
185 *mapping = postmap;
186 e_flag = 1;
187 break;
188 case 2:
189 *mapping = postmap;
190 z_flag = 1;
191 break;
192 case 3:
193 *mapping = postmap;
194 break;
195 default:
196 return -EIO;
197 }
198
199 if (trim)
200 *trim = z_flag;
201 if (error)
202 *error = e_flag;
203
204 return ret;
205}
206
207static int btt_log_group_read(struct arena_info *arena, u32 lane,
208 struct log_group *log)
209{
210 return arena_read_bytes(arena,
211 arena->logoff + (lane * LOG_GRP_SIZE), log,
212 LOG_GRP_SIZE, 0);
213}
214
215static struct dentry *debugfs_root;
216
217static void arena_debugfs_init(struct arena_info *a, struct dentry *parent,
218 int idx)
219{
220 char dirname[32];
221 struct dentry *d;
222
223 /* If for some reason, parent bttN was not created, exit */
224 if (!parent)
225 return;
226
227 snprintf(dirname, 32, "arena%d", idx);
228 d = debugfs_create_dir(dirname, parent);
229 if (IS_ERR_OR_NULL(d))
230 return;
231 a->debugfs_dir = d;
232
233 debugfs_create_x64("size", S_IRUGO, d, &a->size);
234 debugfs_create_x64("external_lba_start", S_IRUGO, d,
235 &a->external_lba_start);
236 debugfs_create_x32("internal_nlba", S_IRUGO, d, &a->internal_nlba);
237 debugfs_create_u32("internal_lbasize", S_IRUGO, d,
238 &a->internal_lbasize);
239 debugfs_create_x32("external_nlba", S_IRUGO, d, &a->external_nlba);
240 debugfs_create_u32("external_lbasize", S_IRUGO, d,
241 &a->external_lbasize);
242 debugfs_create_u32("nfree", S_IRUGO, d, &a->nfree);
243 debugfs_create_u16("version_major", S_IRUGO, d, &a->version_major);
244 debugfs_create_u16("version_minor", S_IRUGO, d, &a->version_minor);
245 debugfs_create_x64("nextoff", S_IRUGO, d, &a->nextoff);
246 debugfs_create_x64("infooff", S_IRUGO, d, &a->infooff);
247 debugfs_create_x64("dataoff", S_IRUGO, d, &a->dataoff);
248 debugfs_create_x64("mapoff", S_IRUGO, d, &a->mapoff);
249 debugfs_create_x64("logoff", S_IRUGO, d, &a->logoff);
250 debugfs_create_x64("info2off", S_IRUGO, d, &a->info2off);
251 debugfs_create_x32("flags", S_IRUGO, d, &a->flags);
252 debugfs_create_u32("log_index_0", S_IRUGO, d, &a->log_index[0]);
253 debugfs_create_u32("log_index_1", S_IRUGO, d, &a->log_index[1]);
254}
255
256static void btt_debugfs_init(struct btt *btt)
257{
258 int i = 0;
259 struct arena_info *arena;
260
261 btt->debugfs_dir = debugfs_create_dir(dev_name(&btt->nd_btt->dev),
262 debugfs_root);
263 if (IS_ERR_OR_NULL(btt->debugfs_dir))
264 return;
265
266 list_for_each_entry(arena, &btt->arena_list, list) {
267 arena_debugfs_init(arena, btt->debugfs_dir, i);
268 i++;
269 }
270}
271
272static u32 log_seq(struct log_group *log, int log_idx)
273{
274 return le32_to_cpu(log->ent[log_idx].seq);
275}
276
277/*
278 * This function accepts two log entries, and uses the
279 * sequence number to find the 'older' entry.
280 * It also updates the sequence number in this old entry to
281 * make it the 'new' one if the mark_flag is set.
282 * Finally, it returns which of the entries was the older one.
283 *
284 * TODO The logic feels a bit kludge-y. make it better..
285 */
286static int btt_log_get_old(struct arena_info *a, struct log_group *log)
287{
288 int idx0 = a->log_index[0];
289 int idx1 = a->log_index[1];
290 int old;
291
292 /*
293 * the first ever time this is seen, the entry goes into [0]
294 * the next time, the following logic works out to put this
295 * (next) entry into [1]
296 */
297 if (log_seq(log, idx0) == 0) {
298 log->ent[idx0].seq = cpu_to_le32(1);
299 return 0;
300 }
301
302 if (log_seq(log, idx0) == log_seq(log, idx1))
303 return -EINVAL;
304 if (log_seq(log, idx0) + log_seq(log, idx1) > 5)
305 return -EINVAL;
306
307 if (log_seq(log, idx0) < log_seq(log, idx1)) {
308 if ((log_seq(log, idx1) - log_seq(log, idx0)) == 1)
309 old = 0;
310 else
311 old = 1;
312 } else {
313 if ((log_seq(log, idx0) - log_seq(log, idx1)) == 1)
314 old = 1;
315 else
316 old = 0;
317 }
318
319 return old;
320}
321
322/*
323 * This function copies the desired (old/new) log entry into ent if
324 * it is not NULL. It returns the sub-slot number (0 or 1)
325 * where the desired log entry was found. Negative return values
326 * indicate errors.
327 */
328static int btt_log_read(struct arena_info *arena, u32 lane,
329 struct log_entry *ent, int old_flag)
330{
331 int ret;
332 int old_ent, ret_ent;
333 struct log_group log;
334
335 ret = btt_log_group_read(arena, lane, &log);
336 if (ret)
337 return -EIO;
338
339 old_ent = btt_log_get_old(arena, &log);
340 if (old_ent < 0 || old_ent > 1) {
341 dev_err(to_dev(arena),
342 "log corruption (%d): lane %d seq [%d, %d]\n",
343 old_ent, lane, log.ent[arena->log_index[0]].seq,
344 log.ent[arena->log_index[1]].seq);
345 /* TODO set error state? */
346 return -EIO;
347 }
348
349 ret_ent = (old_flag ? old_ent : (1 - old_ent));
350
351 if (ent != NULL)
352 memcpy(ent, &log.ent[arena->log_index[ret_ent]], LOG_ENT_SIZE);
353
354 return ret_ent;
355}
356
357/*
358 * This function commits a log entry to media
359 * It does _not_ prepare the freelist entry for the next write
360 * btt_flog_write is the wrapper for updating the freelist elements
361 */
362static int __btt_log_write(struct arena_info *arena, u32 lane,
363 u32 sub, struct log_entry *ent, unsigned long flags)
364{
365 int ret;
366 u32 group_slot = arena->log_index[sub];
367 unsigned int log_half = LOG_ENT_SIZE / 2;
368 void *src = ent;
369 u64 ns_off;
370
371 ns_off = arena->logoff + (lane * LOG_GRP_SIZE) +
372 (group_slot * LOG_ENT_SIZE);
373 /* split the 16B write into atomic, durable halves */
374 ret = arena_write_bytes(arena, ns_off, src, log_half, flags);
375 if (ret)
376 return ret;
377
378 ns_off += log_half;
379 src += log_half;
380 return arena_write_bytes(arena, ns_off, src, log_half, flags);
381}
382
383static int btt_flog_write(struct arena_info *arena, u32 lane, u32 sub,
384 struct log_entry *ent)
385{
386 int ret;
387
388 ret = __btt_log_write(arena, lane, sub, ent, NVDIMM_IO_ATOMIC);
389 if (ret)
390 return ret;
391
392 /* prepare the next free entry */
393 arena->freelist[lane].sub = 1 - arena->freelist[lane].sub;
394 if (++(arena->freelist[lane].seq) == 4)
395 arena->freelist[lane].seq = 1;
396 if (ent_e_flag(le32_to_cpu(ent->old_map)))
397 arena->freelist[lane].has_err = 1;
398 arena->freelist[lane].block = ent_lba(le32_to_cpu(ent->old_map));
399
400 return ret;
401}
402
403/*
404 * This function initializes the BTT map to the initial state, which is
405 * all-zeroes, and indicates an identity mapping
406 */
407static int btt_map_init(struct arena_info *arena)
408{
409 int ret = -EINVAL;
410 void *zerobuf;
411 size_t offset = 0;
412 size_t chunk_size = SZ_2M;
413 size_t mapsize = arena->logoff - arena->mapoff;
414
415 zerobuf = kzalloc(chunk_size, GFP_KERNEL);
416 if (!zerobuf)
417 return -ENOMEM;
418
419 /*
420 * mapoff should always be at least 512B aligned. We rely on that to
421 * make sure rw_bytes does error clearing correctly, so make sure that
422 * is the case.
423 */
424 dev_WARN_ONCE(to_dev(arena), !IS_ALIGNED(arena->mapoff, 512),
425 "arena->mapoff: %#llx is unaligned\n", arena->mapoff);
426
427 while (mapsize) {
428 size_t size = min(mapsize, chunk_size);
429
430 dev_WARN_ONCE(to_dev(arena), size < 512,
431 "chunk size: %#zx is unaligned\n", size);
432 ret = arena_write_bytes(arena, arena->mapoff + offset, zerobuf,
433 size, 0);
434 if (ret)
435 goto free;
436
437 offset += size;
438 mapsize -= size;
439 cond_resched();
440 }
441
442 free:
443 kfree(zerobuf);
444 return ret;
445}
446
447/*
448 * This function initializes the BTT log with 'fake' entries pointing
449 * to the initial reserved set of blocks as being free
450 */
451static int btt_log_init(struct arena_info *arena)
452{
453 size_t logsize = arena->info2off - arena->logoff;
454 size_t chunk_size = SZ_4K, offset = 0;
455 struct log_entry ent;
456 void *zerobuf;
457 int ret;
458 u32 i;
459
460 zerobuf = kzalloc(chunk_size, GFP_KERNEL);
461 if (!zerobuf)
462 return -ENOMEM;
463 /*
464 * logoff should always be at least 512B aligned. We rely on that to
465 * make sure rw_bytes does error clearing correctly, so make sure that
466 * is the case.
467 */
468 dev_WARN_ONCE(to_dev(arena), !IS_ALIGNED(arena->logoff, 512),
469 "arena->logoff: %#llx is unaligned\n", arena->logoff);
470
471 while (logsize) {
472 size_t size = min(logsize, chunk_size);
473
474 dev_WARN_ONCE(to_dev(arena), size < 512,
475 "chunk size: %#zx is unaligned\n", size);
476 ret = arena_write_bytes(arena, arena->logoff + offset, zerobuf,
477 size, 0);
478 if (ret)
479 goto free;
480
481 offset += size;
482 logsize -= size;
483 cond_resched();
484 }
485
486 for (i = 0; i < arena->nfree; i++) {
487 ent.lba = cpu_to_le32(i);
488 ent.old_map = cpu_to_le32(arena->external_nlba + i);
489 ent.new_map = cpu_to_le32(arena->external_nlba + i);
490 ent.seq = cpu_to_le32(LOG_SEQ_INIT);
491 ret = __btt_log_write(arena, i, 0, &ent, 0);
492 if (ret)
493 goto free;
494 }
495
496 free:
497 kfree(zerobuf);
498 return ret;
499}
500
501static u64 to_namespace_offset(struct arena_info *arena, u64 lba)
502{
503 return arena->dataoff + ((u64)lba * arena->internal_lbasize);
504}
505
506static int arena_clear_freelist_error(struct arena_info *arena, u32 lane)
507{
508 int ret = 0;
509
510 if (arena->freelist[lane].has_err) {
511 void *zero_page = page_address(ZERO_PAGE(0));
512 u32 lba = arena->freelist[lane].block;
513 u64 nsoff = to_namespace_offset(arena, lba);
514 unsigned long len = arena->sector_size;
515
516 mutex_lock(&arena->err_lock);
517
518 while (len) {
519 unsigned long chunk = min(len, PAGE_SIZE);
520
521 ret = arena_write_bytes(arena, nsoff, zero_page,
522 chunk, 0);
523 if (ret)
524 break;
525 len -= chunk;
526 nsoff += chunk;
527 if (len == 0)
528 arena->freelist[lane].has_err = 0;
529 }
530 mutex_unlock(&arena->err_lock);
531 }
532 return ret;
533}
534
535static int btt_freelist_init(struct arena_info *arena)
536{
537 int new, ret;
538 struct log_entry log_new;
539 u32 i, map_entry, log_oldmap, log_newmap;
540
541 arena->freelist = kcalloc(arena->nfree, sizeof(struct free_entry),
542 GFP_KERNEL);
543 if (!arena->freelist)
544 return -ENOMEM;
545
546 for (i = 0; i < arena->nfree; i++) {
547 new = btt_log_read(arena, i, &log_new, LOG_NEW_ENT);
548 if (new < 0)
549 return new;
550
551 /* old and new map entries with any flags stripped out */
552 log_oldmap = ent_lba(le32_to_cpu(log_new.old_map));
553 log_newmap = ent_lba(le32_to_cpu(log_new.new_map));
554
555 /* sub points to the next one to be overwritten */
556 arena->freelist[i].sub = 1 - new;
557 arena->freelist[i].seq = nd_inc_seq(le32_to_cpu(log_new.seq));
558 arena->freelist[i].block = log_oldmap;
559
560 /*
561 * FIXME: if error clearing fails during init, we want to make
562 * the BTT read-only
563 */
564 if (ent_e_flag(le32_to_cpu(log_new.old_map)) &&
565 !ent_normal(le32_to_cpu(log_new.old_map))) {
566 arena->freelist[i].has_err = 1;
567 ret = arena_clear_freelist_error(arena, i);
568 if (ret)
569 dev_err_ratelimited(to_dev(arena),
570 "Unable to clear known errors\n");
571 }
572
573 /* This implies a newly created or untouched flog entry */
574 if (log_oldmap == log_newmap)
575 continue;
576
577 /* Check if map recovery is needed */
578 ret = btt_map_read(arena, le32_to_cpu(log_new.lba), &map_entry,
579 NULL, NULL, 0);
580 if (ret)
581 return ret;
582
583 /*
584 * The map_entry from btt_read_map is stripped of any flag bits,
585 * so use the stripped out versions from the log as well for
586 * testing whether recovery is needed. For restoration, use the
587 * 'raw' version of the log entries as that captured what we
588 * were going to write originally.
589 */
590 if ((log_newmap != map_entry) && (log_oldmap == map_entry)) {
591 /*
592 * Last transaction wrote the flog, but wasn't able
593 * to complete the map write. So fix up the map.
594 */
595 ret = btt_map_write(arena, le32_to_cpu(log_new.lba),
596 le32_to_cpu(log_new.new_map), 0, 0, 0);
597 if (ret)
598 return ret;
599 }
600 }
601
602 return 0;
603}
604
605static bool ent_is_padding(struct log_entry *ent)
606{
607 return (ent->lba == 0) && (ent->old_map == 0) && (ent->new_map == 0)
608 && (ent->seq == 0);
609}
610
611/*
612 * Detecting valid log indices: We read a log group (see the comments in btt.h
613 * for a description of a 'log_group' and its 'slots'), and iterate over its
614 * four slots. We expect that a padding slot will be all-zeroes, and use this
615 * to detect a padding slot vs. an actual entry.
616 *
617 * If a log_group is in the initial state, i.e. hasn't been used since the
618 * creation of this BTT layout, it will have three of the four slots with
619 * zeroes. We skip over these log_groups for the detection of log_index. If
620 * all log_groups are in the initial state (i.e. the BTT has never been
621 * written to), it is safe to assume the 'new format' of log entries in slots
622 * (0, 1).
623 */
624static int log_set_indices(struct arena_info *arena)
625{
626 bool idx_set = false, initial_state = true;
627 int ret, log_index[2] = {-1, -1};
628 u32 i, j, next_idx = 0;
629 struct log_group log;
630 u32 pad_count = 0;
631
632 for (i = 0; i < arena->nfree; i++) {
633 ret = btt_log_group_read(arena, i, &log);
634 if (ret < 0)
635 return ret;
636
637 for (j = 0; j < 4; j++) {
638 if (!idx_set) {
639 if (ent_is_padding(&log.ent[j])) {
640 pad_count++;
641 continue;
642 } else {
643 /* Skip if index has been recorded */
644 if ((next_idx == 1) &&
645 (j == log_index[0]))
646 continue;
647 /* valid entry, record index */
648 log_index[next_idx] = j;
649 next_idx++;
650 }
651 if (next_idx == 2) {
652 /* two valid entries found */
653 idx_set = true;
654 } else if (next_idx > 2) {
655 /* too many valid indices */
656 return -ENXIO;
657 }
658 } else {
659 /*
660 * once the indices have been set, just verify
661 * that all subsequent log groups are either in
662 * their initial state or follow the same
663 * indices.
664 */
665 if (j == log_index[0]) {
666 /* entry must be 'valid' */
667 if (ent_is_padding(&log.ent[j]))
668 return -ENXIO;
669 } else if (j == log_index[1]) {
670 ;
671 /*
672 * log_index[1] can be padding if the
673 * lane never got used and it is still
674 * in the initial state (three 'padding'
675 * entries)
676 */
677 } else {
678 /* entry must be invalid (padding) */
679 if (!ent_is_padding(&log.ent[j]))
680 return -ENXIO;
681 }
682 }
683 }
684 /*
685 * If any of the log_groups have more than one valid,
686 * non-padding entry, then the we are no longer in the
687 * initial_state
688 */
689 if (pad_count < 3)
690 initial_state = false;
691 pad_count = 0;
692 }
693
694 if (!initial_state && !idx_set)
695 return -ENXIO;
696
697 /*
698 * If all the entries in the log were in the initial state,
699 * assume new padding scheme
700 */
701 if (initial_state)
702 log_index[1] = 1;
703
704 /*
705 * Only allow the known permutations of log/padding indices,
706 * i.e. (0, 1), and (0, 2)
707 */
708 if ((log_index[0] == 0) && ((log_index[1] == 1) || (log_index[1] == 2)))
709 ; /* known index possibilities */
710 else {
711 dev_err(to_dev(arena), "Found an unknown padding scheme\n");
712 return -ENXIO;
713 }
714
715 arena->log_index[0] = log_index[0];
716 arena->log_index[1] = log_index[1];
717 dev_dbg(to_dev(arena), "log_index_0 = %d\n", log_index[0]);
718 dev_dbg(to_dev(arena), "log_index_1 = %d\n", log_index[1]);
719 return 0;
720}
721
722static int btt_rtt_init(struct arena_info *arena)
723{
724 arena->rtt = kcalloc(arena->nfree, sizeof(u32), GFP_KERNEL);
725 if (arena->rtt == NULL)
726 return -ENOMEM;
727
728 return 0;
729}
730
731static int btt_maplocks_init(struct arena_info *arena)
732{
733 u32 i;
734
735 arena->map_locks = kcalloc(arena->nfree, sizeof(struct aligned_lock),
736 GFP_KERNEL);
737 if (!arena->map_locks)
738 return -ENOMEM;
739
740 for (i = 0; i < arena->nfree; i++)
741 spin_lock_init(&arena->map_locks[i].lock);
742
743 return 0;
744}
745
746static struct arena_info *alloc_arena(struct btt *btt, size_t size,
747 size_t start, size_t arena_off)
748{
749 struct arena_info *arena;
750 u64 logsize, mapsize, datasize;
751 u64 available = size;
752
753 arena = kzalloc(sizeof(struct arena_info), GFP_KERNEL);
754 if (!arena)
755 return NULL;
756 arena->nd_btt = btt->nd_btt;
757 arena->sector_size = btt->sector_size;
758 mutex_init(&arena->err_lock);
759
760 if (!size)
761 return arena;
762
763 arena->size = size;
764 arena->external_lba_start = start;
765 arena->external_lbasize = btt->lbasize;
766 arena->internal_lbasize = roundup(arena->external_lbasize,
767 INT_LBASIZE_ALIGNMENT);
768 arena->nfree = BTT_DEFAULT_NFREE;
769 arena->version_major = btt->nd_btt->version_major;
770 arena->version_minor = btt->nd_btt->version_minor;
771
772 if (available % BTT_PG_SIZE)
773 available -= (available % BTT_PG_SIZE);
774
775 /* Two pages are reserved for the super block and its copy */
776 available -= 2 * BTT_PG_SIZE;
777
778 /* The log takes a fixed amount of space based on nfree */
779 logsize = roundup(arena->nfree * LOG_GRP_SIZE, BTT_PG_SIZE);
780 available -= logsize;
781
782 /* Calculate optimal split between map and data area */
783 arena->internal_nlba = div_u64(available - BTT_PG_SIZE,
784 arena->internal_lbasize + MAP_ENT_SIZE);
785 arena->external_nlba = arena->internal_nlba - arena->nfree;
786
787 mapsize = roundup((arena->external_nlba * MAP_ENT_SIZE), BTT_PG_SIZE);
788 datasize = available - mapsize;
789
790 /* 'Absolute' values, relative to start of storage space */
791 arena->infooff = arena_off;
792 arena->dataoff = arena->infooff + BTT_PG_SIZE;
793 arena->mapoff = arena->dataoff + datasize;
794 arena->logoff = arena->mapoff + mapsize;
795 arena->info2off = arena->logoff + logsize;
796
797 /* Default log indices are (0,1) */
798 arena->log_index[0] = 0;
799 arena->log_index[1] = 1;
800 return arena;
801}
802
803static void free_arenas(struct btt *btt)
804{
805 struct arena_info *arena, *next;
806
807 list_for_each_entry_safe(arena, next, &btt->arena_list, list) {
808 list_del(&arena->list);
809 kfree(arena->rtt);
810 kfree(arena->map_locks);
811 kfree(arena->freelist);
812 debugfs_remove_recursive(arena->debugfs_dir);
813 kfree(arena);
814 }
815}
816
817/*
818 * This function reads an existing valid btt superblock and
819 * populates the corresponding arena_info struct
820 */
821static void parse_arena_meta(struct arena_info *arena, struct btt_sb *super,
822 u64 arena_off)
823{
824 arena->internal_nlba = le32_to_cpu(super->internal_nlba);
825 arena->internal_lbasize = le32_to_cpu(super->internal_lbasize);
826 arena->external_nlba = le32_to_cpu(super->external_nlba);
827 arena->external_lbasize = le32_to_cpu(super->external_lbasize);
828 arena->nfree = le32_to_cpu(super->nfree);
829 arena->version_major = le16_to_cpu(super->version_major);
830 arena->version_minor = le16_to_cpu(super->version_minor);
831
832 arena->nextoff = (super->nextoff == 0) ? 0 : (arena_off +
833 le64_to_cpu(super->nextoff));
834 arena->infooff = arena_off;
835 arena->dataoff = arena_off + le64_to_cpu(super->dataoff);
836 arena->mapoff = arena_off + le64_to_cpu(super->mapoff);
837 arena->logoff = arena_off + le64_to_cpu(super->logoff);
838 arena->info2off = arena_off + le64_to_cpu(super->info2off);
839
840 arena->size = (le64_to_cpu(super->nextoff) > 0)
841 ? (le64_to_cpu(super->nextoff))
842 : (arena->info2off - arena->infooff + BTT_PG_SIZE);
843
844 arena->flags = le32_to_cpu(super->flags);
845}
846
847static int discover_arenas(struct btt *btt)
848{
849 int ret = 0;
850 struct arena_info *arena;
851 size_t remaining = btt->rawsize;
852 u64 cur_nlba = 0;
853 size_t cur_off = 0;
854 int num_arenas = 0;
855
856 struct btt_sb *super __free(kfree) = kzalloc(sizeof(*super), GFP_KERNEL);
857 if (!super)
858 return -ENOMEM;
859
860 while (remaining) {
861 /* Alloc memory for arena */
862 arena = alloc_arena(btt, 0, 0, 0);
863 if (!arena)
864 return -ENOMEM;
865
866 arena->infooff = cur_off;
867 ret = btt_info_read(arena, super);
868 if (ret)
869 goto out;
870
871 if (!nd_btt_arena_is_valid(btt->nd_btt, super)) {
872 if (remaining == btt->rawsize) {
873 btt->init_state = INIT_NOTFOUND;
874 dev_info(to_dev(arena), "No existing arenas\n");
875 goto out;
876 } else {
877 dev_err(to_dev(arena),
878 "Found corrupted metadata!\n");
879 ret = -ENODEV;
880 goto out;
881 }
882 }
883
884 arena->external_lba_start = cur_nlba;
885 parse_arena_meta(arena, super, cur_off);
886
887 ret = log_set_indices(arena);
888 if (ret) {
889 dev_err(to_dev(arena),
890 "Unable to deduce log/padding indices\n");
891 goto out;
892 }
893
894 ret = btt_freelist_init(arena);
895 if (ret)
896 goto out;
897
898 ret = btt_rtt_init(arena);
899 if (ret)
900 goto out;
901
902 ret = btt_maplocks_init(arena);
903 if (ret)
904 goto out;
905
906 list_add_tail(&arena->list, &btt->arena_list);
907
908 remaining -= arena->size;
909 cur_off += arena->size;
910 cur_nlba += arena->external_nlba;
911 num_arenas++;
912
913 if (arena->nextoff == 0)
914 break;
915 }
916 btt->num_arenas = num_arenas;
917 btt->nlba = cur_nlba;
918 btt->init_state = INIT_READY;
919
920 return ret;
921
922 out:
923 kfree(arena);
924 free_arenas(btt);
925 return ret;
926}
927
928static int create_arenas(struct btt *btt)
929{
930 size_t remaining = btt->rawsize;
931 size_t cur_off = 0;
932
933 while (remaining) {
934 struct arena_info *arena;
935 size_t arena_size = min_t(u64, ARENA_MAX_SIZE, remaining);
936
937 remaining -= arena_size;
938 if (arena_size < ARENA_MIN_SIZE)
939 break;
940
941 arena = alloc_arena(btt, arena_size, btt->nlba, cur_off);
942 if (!arena) {
943 free_arenas(btt);
944 return -ENOMEM;
945 }
946 btt->nlba += arena->external_nlba;
947 if (remaining >= ARENA_MIN_SIZE)
948 arena->nextoff = arena->size;
949 else
950 arena->nextoff = 0;
951 cur_off += arena_size;
952 list_add_tail(&arena->list, &btt->arena_list);
953 }
954
955 return 0;
956}
957
958/*
959 * This function completes arena initialization by writing
960 * all the metadata.
961 * It is only called for an uninitialized arena when a write
962 * to that arena occurs for the first time.
963 */
964static int btt_arena_write_layout(struct arena_info *arena)
965{
966 int ret;
967 u64 sum;
968 struct btt_sb *super;
969 struct nd_btt *nd_btt = arena->nd_btt;
970 const uuid_t *parent_uuid = nd_dev_to_uuid(&nd_btt->ndns->dev);
971
972 ret = btt_map_init(arena);
973 if (ret)
974 return ret;
975
976 ret = btt_log_init(arena);
977 if (ret)
978 return ret;
979
980 super = kzalloc(sizeof(struct btt_sb), GFP_NOIO);
981 if (!super)
982 return -ENOMEM;
983
984 strscpy(super->signature, BTT_SIG, sizeof(super->signature));
985 export_uuid(super->uuid, nd_btt->uuid);
986 export_uuid(super->parent_uuid, parent_uuid);
987 super->flags = cpu_to_le32(arena->flags);
988 super->version_major = cpu_to_le16(arena->version_major);
989 super->version_minor = cpu_to_le16(arena->version_minor);
990 super->external_lbasize = cpu_to_le32(arena->external_lbasize);
991 super->external_nlba = cpu_to_le32(arena->external_nlba);
992 super->internal_lbasize = cpu_to_le32(arena->internal_lbasize);
993 super->internal_nlba = cpu_to_le32(arena->internal_nlba);
994 super->nfree = cpu_to_le32(arena->nfree);
995 super->infosize = cpu_to_le32(sizeof(struct btt_sb));
996 super->nextoff = cpu_to_le64(arena->nextoff);
997 /*
998 * Subtract arena->infooff (arena start) so numbers are relative
999 * to 'this' arena
1000 */
1001 super->dataoff = cpu_to_le64(arena->dataoff - arena->infooff);
1002 super->mapoff = cpu_to_le64(arena->mapoff - arena->infooff);
1003 super->logoff = cpu_to_le64(arena->logoff - arena->infooff);
1004 super->info2off = cpu_to_le64(arena->info2off - arena->infooff);
1005
1006 super->flags = 0;
1007 sum = nd_sb_checksum((struct nd_gen_sb *) super);
1008 super->checksum = cpu_to_le64(sum);
1009
1010 ret = btt_info_write(arena, super);
1011
1012 kfree(super);
1013 return ret;
1014}
1015
1016/*
1017 * This function completes the initialization for the BTT namespace
1018 * such that it is ready to accept IOs
1019 */
1020static int btt_meta_init(struct btt *btt)
1021{
1022 int ret = 0;
1023 struct arena_info *arena;
1024
1025 mutex_lock(&btt->init_lock);
1026 list_for_each_entry(arena, &btt->arena_list, list) {
1027 ret = btt_arena_write_layout(arena);
1028 if (ret)
1029 goto unlock;
1030
1031 ret = btt_freelist_init(arena);
1032 if (ret)
1033 goto unlock;
1034
1035 ret = btt_rtt_init(arena);
1036 if (ret)
1037 goto unlock;
1038
1039 ret = btt_maplocks_init(arena);
1040 if (ret)
1041 goto unlock;
1042 }
1043
1044 btt->init_state = INIT_READY;
1045
1046 unlock:
1047 mutex_unlock(&btt->init_lock);
1048 return ret;
1049}
1050
1051static u32 btt_meta_size(struct btt *btt)
1052{
1053 return btt->lbasize - btt->sector_size;
1054}
1055
1056/*
1057 * This function calculates the arena in which the given LBA lies
1058 * by doing a linear walk. This is acceptable since we expect only
1059 * a few arenas. If we have backing devices that get much larger,
1060 * we can construct a balanced binary tree of arenas at init time
1061 * so that this range search becomes faster.
1062 */
1063static int lba_to_arena(struct btt *btt, sector_t sector, __u32 *premap,
1064 struct arena_info **arena)
1065{
1066 struct arena_info *arena_list;
1067 __u64 lba = div_u64(sector << SECTOR_SHIFT, btt->sector_size);
1068
1069 list_for_each_entry(arena_list, &btt->arena_list, list) {
1070 if (lba < arena_list->external_nlba) {
1071 *arena = arena_list;
1072 *premap = lba;
1073 return 0;
1074 }
1075 lba -= arena_list->external_nlba;
1076 }
1077
1078 return -EIO;
1079}
1080
1081/*
1082 * The following (lock_map, unlock_map) are mostly just to improve
1083 * readability, since they index into an array of locks
1084 */
1085static void lock_map(struct arena_info *arena, u32 premap)
1086 __acquires(&arena->map_locks[idx].lock)
1087{
1088 u32 idx = (premap * MAP_ENT_SIZE / L1_CACHE_BYTES) % arena->nfree;
1089
1090 spin_lock(&arena->map_locks[idx].lock);
1091}
1092
1093static void unlock_map(struct arena_info *arena, u32 premap)
1094 __releases(&arena->map_locks[idx].lock)
1095{
1096 u32 idx = (premap * MAP_ENT_SIZE / L1_CACHE_BYTES) % arena->nfree;
1097
1098 spin_unlock(&arena->map_locks[idx].lock);
1099}
1100
1101static int btt_data_read(struct arena_info *arena, struct page *page,
1102 unsigned int off, u32 lba, u32 len)
1103{
1104 int ret;
1105 u64 nsoff = to_namespace_offset(arena, lba);
1106 void *mem = kmap_atomic(page);
1107
1108 ret = arena_read_bytes(arena, nsoff, mem + off, len, NVDIMM_IO_ATOMIC);
1109 kunmap_atomic(mem);
1110
1111 return ret;
1112}
1113
1114static int btt_data_write(struct arena_info *arena, u32 lba,
1115 struct page *page, unsigned int off, u32 len)
1116{
1117 int ret;
1118 u64 nsoff = to_namespace_offset(arena, lba);
1119 void *mem = kmap_atomic(page);
1120
1121 ret = arena_write_bytes(arena, nsoff, mem + off, len, NVDIMM_IO_ATOMIC);
1122 kunmap_atomic(mem);
1123
1124 return ret;
1125}
1126
1127static void zero_fill_data(struct page *page, unsigned int off, u32 len)
1128{
1129 void *mem = kmap_atomic(page);
1130
1131 memset(mem + off, 0, len);
1132 kunmap_atomic(mem);
1133}
1134
1135#ifdef CONFIG_BLK_DEV_INTEGRITY
1136static int btt_rw_integrity(struct btt *btt, struct bio_integrity_payload *bip,
1137 struct arena_info *arena, u32 postmap, int rw)
1138{
1139 unsigned int len = btt_meta_size(btt);
1140 u64 meta_nsoff;
1141 int ret = 0;
1142
1143 if (bip == NULL)
1144 return 0;
1145
1146 meta_nsoff = to_namespace_offset(arena, postmap) + btt->sector_size;
1147
1148 while (len) {
1149 unsigned int cur_len;
1150 struct bio_vec bv;
1151 void *mem;
1152
1153 bv = bvec_iter_bvec(bip->bip_vec, bip->bip_iter);
1154 /*
1155 * The 'bv' obtained from bvec_iter_bvec has its .bv_len and
1156 * .bv_offset already adjusted for iter->bi_bvec_done, and we
1157 * can use those directly
1158 */
1159
1160 cur_len = min(len, bv.bv_len);
1161 mem = bvec_kmap_local(&bv);
1162 if (rw)
1163 ret = arena_write_bytes(arena, meta_nsoff, mem, cur_len,
1164 NVDIMM_IO_ATOMIC);
1165 else
1166 ret = arena_read_bytes(arena, meta_nsoff, mem, cur_len,
1167 NVDIMM_IO_ATOMIC);
1168
1169 kunmap_local(mem);
1170 if (ret)
1171 return ret;
1172
1173 len -= cur_len;
1174 meta_nsoff += cur_len;
1175 if (!bvec_iter_advance(bip->bip_vec, &bip->bip_iter, cur_len))
1176 return -EIO;
1177 }
1178
1179 return ret;
1180}
1181
1182#else /* CONFIG_BLK_DEV_INTEGRITY */
1183static int btt_rw_integrity(struct btt *btt, struct bio_integrity_payload *bip,
1184 struct arena_info *arena, u32 postmap, int rw)
1185{
1186 return 0;
1187}
1188#endif
1189
1190static int btt_read_pg(struct btt *btt, struct bio_integrity_payload *bip,
1191 struct page *page, unsigned int off, sector_t sector,
1192 unsigned int len)
1193{
1194 int ret = 0;
1195 int t_flag, e_flag;
1196 struct arena_info *arena = NULL;
1197 u32 lane = 0, premap, postmap;
1198
1199 while (len) {
1200 u32 cur_len;
1201
1202 lane = nd_region_acquire_lane(btt->nd_region);
1203
1204 ret = lba_to_arena(btt, sector, &premap, &arena);
1205 if (ret)
1206 goto out_lane;
1207
1208 cur_len = min(btt->sector_size, len);
1209
1210 ret = btt_map_read(arena, premap, &postmap, &t_flag, &e_flag,
1211 NVDIMM_IO_ATOMIC);
1212 if (ret)
1213 goto out_lane;
1214
1215 /*
1216 * We loop to make sure that the post map LBA didn't change
1217 * from under us between writing the RTT and doing the actual
1218 * read.
1219 */
1220 while (1) {
1221 u32 new_map;
1222 int new_t, new_e;
1223
1224 if (t_flag) {
1225 zero_fill_data(page, off, cur_len);
1226 goto out_lane;
1227 }
1228
1229 if (e_flag) {
1230 ret = -EIO;
1231 goto out_lane;
1232 }
1233
1234 arena->rtt[lane] = RTT_VALID | postmap;
1235 /*
1236 * Barrier to make sure this write is not reordered
1237 * to do the verification map_read before the RTT store
1238 */
1239 barrier();
1240
1241 ret = btt_map_read(arena, premap, &new_map, &new_t,
1242 &new_e, NVDIMM_IO_ATOMIC);
1243 if (ret)
1244 goto out_rtt;
1245
1246 if ((postmap == new_map) && (t_flag == new_t) &&
1247 (e_flag == new_e))
1248 break;
1249
1250 postmap = new_map;
1251 t_flag = new_t;
1252 e_flag = new_e;
1253 }
1254
1255 ret = btt_data_read(arena, page, off, postmap, cur_len);
1256 if (ret) {
1257 /* Media error - set the e_flag */
1258 if (btt_map_write(arena, premap, postmap, 0, 1, NVDIMM_IO_ATOMIC))
1259 dev_warn_ratelimited(to_dev(arena),
1260 "Error persistently tracking bad blocks at %#x\n",
1261 premap);
1262 goto out_rtt;
1263 }
1264
1265 if (bip) {
1266 ret = btt_rw_integrity(btt, bip, arena, postmap, READ);
1267 if (ret)
1268 goto out_rtt;
1269 }
1270
1271 arena->rtt[lane] = RTT_INVALID;
1272 nd_region_release_lane(btt->nd_region, lane);
1273
1274 len -= cur_len;
1275 off += cur_len;
1276 sector += btt->sector_size >> SECTOR_SHIFT;
1277 }
1278
1279 return 0;
1280
1281 out_rtt:
1282 arena->rtt[lane] = RTT_INVALID;
1283 out_lane:
1284 nd_region_release_lane(btt->nd_region, lane);
1285 return ret;
1286}
1287
1288/*
1289 * Normally, arena_{read,write}_bytes will take care of the initial offset
1290 * adjustment, but in the case of btt_is_badblock, where we query is_bad_pmem,
1291 * we need the final, raw namespace offset here
1292 */
1293static bool btt_is_badblock(struct btt *btt, struct arena_info *arena,
1294 u32 postmap)
1295{
1296 u64 nsoff = adjust_initial_offset(arena->nd_btt,
1297 to_namespace_offset(arena, postmap));
1298 sector_t phys_sector = nsoff >> 9;
1299
1300 return is_bad_pmem(btt->phys_bb, phys_sector, arena->internal_lbasize);
1301}
1302
1303static int btt_write_pg(struct btt *btt, struct bio_integrity_payload *bip,
1304 sector_t sector, struct page *page, unsigned int off,
1305 unsigned int len)
1306{
1307 int ret = 0;
1308 struct arena_info *arena = NULL;
1309 u32 premap = 0, old_postmap, new_postmap, lane = 0, i;
1310 struct log_entry log;
1311 int sub;
1312
1313 while (len) {
1314 u32 cur_len;
1315 int e_flag;
1316
1317 retry:
1318 lane = nd_region_acquire_lane(btt->nd_region);
1319
1320 ret = lba_to_arena(btt, sector, &premap, &arena);
1321 if (ret)
1322 goto out_lane;
1323 cur_len = min(btt->sector_size, len);
1324
1325 if ((arena->flags & IB_FLAG_ERROR_MASK) != 0) {
1326 ret = -EIO;
1327 goto out_lane;
1328 }
1329
1330 if (btt_is_badblock(btt, arena, arena->freelist[lane].block))
1331 arena->freelist[lane].has_err = 1;
1332
1333 if (mutex_is_locked(&arena->err_lock)
1334 || arena->freelist[lane].has_err) {
1335 nd_region_release_lane(btt->nd_region, lane);
1336
1337 ret = arena_clear_freelist_error(arena, lane);
1338 if (ret)
1339 return ret;
1340
1341 /* OK to acquire a different lane/free block */
1342 goto retry;
1343 }
1344
1345 new_postmap = arena->freelist[lane].block;
1346
1347 /* Wait if the new block is being read from */
1348 for (i = 0; i < arena->nfree; i++)
1349 while (arena->rtt[i] == (RTT_VALID | new_postmap))
1350 cpu_relax();
1351
1352
1353 if (new_postmap >= arena->internal_nlba) {
1354 ret = -EIO;
1355 goto out_lane;
1356 }
1357
1358 ret = btt_data_write(arena, new_postmap, page, off, cur_len);
1359 if (ret)
1360 goto out_lane;
1361
1362 if (bip) {
1363 ret = btt_rw_integrity(btt, bip, arena, new_postmap,
1364 WRITE);
1365 if (ret)
1366 goto out_lane;
1367 }
1368
1369 lock_map(arena, premap);
1370 ret = btt_map_read(arena, premap, &old_postmap, NULL, &e_flag,
1371 NVDIMM_IO_ATOMIC);
1372 if (ret)
1373 goto out_map;
1374 if (old_postmap >= arena->internal_nlba) {
1375 ret = -EIO;
1376 goto out_map;
1377 }
1378 if (e_flag)
1379 set_e_flag(old_postmap);
1380
1381 log.lba = cpu_to_le32(premap);
1382 log.old_map = cpu_to_le32(old_postmap);
1383 log.new_map = cpu_to_le32(new_postmap);
1384 log.seq = cpu_to_le32(arena->freelist[lane].seq);
1385 sub = arena->freelist[lane].sub;
1386 ret = btt_flog_write(arena, lane, sub, &log);
1387 if (ret)
1388 goto out_map;
1389
1390 ret = btt_map_write(arena, premap, new_postmap, 0, 0,
1391 NVDIMM_IO_ATOMIC);
1392 if (ret)
1393 goto out_map;
1394
1395 unlock_map(arena, premap);
1396 nd_region_release_lane(btt->nd_region, lane);
1397
1398 if (e_flag) {
1399 ret = arena_clear_freelist_error(arena, lane);
1400 if (ret)
1401 return ret;
1402 }
1403
1404 len -= cur_len;
1405 off += cur_len;
1406 sector += btt->sector_size >> SECTOR_SHIFT;
1407 }
1408
1409 return 0;
1410
1411 out_map:
1412 unlock_map(arena, premap);
1413 out_lane:
1414 nd_region_release_lane(btt->nd_region, lane);
1415 return ret;
1416}
1417
1418static int btt_do_bvec(struct btt *btt, struct bio_integrity_payload *bip,
1419 struct page *page, unsigned int len, unsigned int off,
1420 enum req_op op, sector_t sector)
1421{
1422 int ret;
1423
1424 if (!op_is_write(op)) {
1425 ret = btt_read_pg(btt, bip, page, off, sector, len);
1426 flush_dcache_page(page);
1427 } else {
1428 flush_dcache_page(page);
1429 ret = btt_write_pg(btt, bip, sector, page, off, len);
1430 }
1431
1432 return ret;
1433}
1434
1435static void btt_submit_bio(struct bio *bio)
1436{
1437 struct bio_integrity_payload *bip = bio_integrity(bio);
1438 struct btt *btt = bio->bi_bdev->bd_disk->private_data;
1439 struct bvec_iter iter;
1440 unsigned long start;
1441 struct bio_vec bvec;
1442 int err = 0;
1443 bool do_acct;
1444
1445 if (!bio_integrity_prep(bio))
1446 return;
1447
1448 do_acct = blk_queue_io_stat(bio->bi_bdev->bd_disk->queue);
1449 if (do_acct)
1450 start = bio_start_io_acct(bio);
1451 bio_for_each_segment(bvec, bio, iter) {
1452 unsigned int len = bvec.bv_len;
1453
1454 if (len > PAGE_SIZE || len < btt->sector_size ||
1455 len % btt->sector_size) {
1456 dev_err_ratelimited(&btt->nd_btt->dev,
1457 "unaligned bio segment (len: %d)\n", len);
1458 bio->bi_status = BLK_STS_IOERR;
1459 break;
1460 }
1461
1462 err = btt_do_bvec(btt, bip, bvec.bv_page, len, bvec.bv_offset,
1463 bio_op(bio), iter.bi_sector);
1464 if (err) {
1465 dev_err(&btt->nd_btt->dev,
1466 "io error in %s sector %lld, len %d,\n",
1467 (op_is_write(bio_op(bio))) ? "WRITE" :
1468 "READ",
1469 (unsigned long long) iter.bi_sector, len);
1470 bio->bi_status = errno_to_blk_status(err);
1471 break;
1472 }
1473 }
1474 if (do_acct)
1475 bio_end_io_acct(bio, start);
1476
1477 bio_endio(bio);
1478}
1479
1480static int btt_getgeo(struct block_device *bd, struct hd_geometry *geo)
1481{
1482 /* some standard values */
1483 geo->heads = 1 << 6;
1484 geo->sectors = 1 << 5;
1485 geo->cylinders = get_capacity(bd->bd_disk) >> 11;
1486 return 0;
1487}
1488
1489static const struct block_device_operations btt_fops = {
1490 .owner = THIS_MODULE,
1491 .submit_bio = btt_submit_bio,
1492 .getgeo = btt_getgeo,
1493};
1494
1495static int btt_blk_init(struct btt *btt)
1496{
1497 struct nd_btt *nd_btt = btt->nd_btt;
1498 struct nd_namespace_common *ndns = nd_btt->ndns;
1499 int rc = -ENOMEM;
1500
1501 btt->btt_disk = blk_alloc_disk(NUMA_NO_NODE);
1502 if (!btt->btt_disk)
1503 return -ENOMEM;
1504
1505 nvdimm_namespace_disk_name(ndns, btt->btt_disk->disk_name);
1506 btt->btt_disk->first_minor = 0;
1507 btt->btt_disk->fops = &btt_fops;
1508 btt->btt_disk->private_data = btt;
1509
1510 blk_queue_logical_block_size(btt->btt_disk->queue, btt->sector_size);
1511 blk_queue_max_hw_sectors(btt->btt_disk->queue, UINT_MAX);
1512 blk_queue_flag_set(QUEUE_FLAG_NONROT, btt->btt_disk->queue);
1513 blk_queue_flag_set(QUEUE_FLAG_SYNCHRONOUS, btt->btt_disk->queue);
1514
1515 if (btt_meta_size(btt)) {
1516 rc = nd_integrity_init(btt->btt_disk, btt_meta_size(btt));
1517 if (rc)
1518 goto out_cleanup_disk;
1519 }
1520
1521 set_capacity(btt->btt_disk, btt->nlba * btt->sector_size >> 9);
1522 rc = device_add_disk(&btt->nd_btt->dev, btt->btt_disk, NULL);
1523 if (rc)
1524 goto out_cleanup_disk;
1525
1526 btt->nd_btt->size = btt->nlba * (u64)btt->sector_size;
1527 nvdimm_check_and_set_ro(btt->btt_disk);
1528
1529 return 0;
1530
1531out_cleanup_disk:
1532 put_disk(btt->btt_disk);
1533 return rc;
1534}
1535
1536static void btt_blk_cleanup(struct btt *btt)
1537{
1538 del_gendisk(btt->btt_disk);
1539 put_disk(btt->btt_disk);
1540}
1541
1542/**
1543 * btt_init - initialize a block translation table for the given device
1544 * @nd_btt: device with BTT geometry and backing device info
1545 * @rawsize: raw size in bytes of the backing device
1546 * @lbasize: lba size of the backing device
1547 * @uuid: A uuid for the backing device - this is stored on media
1548 * @nd_region: &struct nd_region for the REGION device
1549 *
1550 * Initialize a Block Translation Table on a backing device to provide
1551 * single sector power fail atomicity.
1552 *
1553 * Context:
1554 * Might sleep.
1555 *
1556 * Returns:
1557 * Pointer to a new struct btt on success, NULL on failure.
1558 */
1559static struct btt *btt_init(struct nd_btt *nd_btt, unsigned long long rawsize,
1560 u32 lbasize, uuid_t *uuid,
1561 struct nd_region *nd_region)
1562{
1563 int ret;
1564 struct btt *btt;
1565 struct nd_namespace_io *nsio;
1566 struct device *dev = &nd_btt->dev;
1567
1568 btt = devm_kzalloc(dev, sizeof(struct btt), GFP_KERNEL);
1569 if (!btt)
1570 return NULL;
1571
1572 btt->nd_btt = nd_btt;
1573 btt->rawsize = rawsize;
1574 btt->lbasize = lbasize;
1575 btt->sector_size = ((lbasize >= 4096) ? 4096 : 512);
1576 INIT_LIST_HEAD(&btt->arena_list);
1577 mutex_init(&btt->init_lock);
1578 btt->nd_region = nd_region;
1579 nsio = to_nd_namespace_io(&nd_btt->ndns->dev);
1580 btt->phys_bb = &nsio->bb;
1581
1582 ret = discover_arenas(btt);
1583 if (ret) {
1584 dev_err(dev, "init: error in arena_discover: %d\n", ret);
1585 return NULL;
1586 }
1587
1588 if (btt->init_state != INIT_READY && nd_region->ro) {
1589 dev_warn(dev, "%s is read-only, unable to init btt metadata\n",
1590 dev_name(&nd_region->dev));
1591 return NULL;
1592 } else if (btt->init_state != INIT_READY) {
1593 btt->num_arenas = (rawsize / ARENA_MAX_SIZE) +
1594 ((rawsize % ARENA_MAX_SIZE) ? 1 : 0);
1595 dev_dbg(dev, "init: %d arenas for %llu rawsize\n",
1596 btt->num_arenas, rawsize);
1597
1598 ret = create_arenas(btt);
1599 if (ret) {
1600 dev_info(dev, "init: create_arenas: %d\n", ret);
1601 return NULL;
1602 }
1603
1604 ret = btt_meta_init(btt);
1605 if (ret) {
1606 dev_err(dev, "init: error in meta_init: %d\n", ret);
1607 return NULL;
1608 }
1609 }
1610
1611 ret = btt_blk_init(btt);
1612 if (ret) {
1613 dev_err(dev, "init: error in blk_init: %d\n", ret);
1614 return NULL;
1615 }
1616
1617 btt_debugfs_init(btt);
1618
1619 return btt;
1620}
1621
1622/**
1623 * btt_fini - de-initialize a BTT
1624 * @btt: the BTT handle that was generated by btt_init
1625 *
1626 * De-initialize a Block Translation Table on device removal
1627 *
1628 * Context:
1629 * Might sleep.
1630 */
1631static void btt_fini(struct btt *btt)
1632{
1633 if (btt) {
1634 btt_blk_cleanup(btt);
1635 free_arenas(btt);
1636 debugfs_remove_recursive(btt->debugfs_dir);
1637 }
1638}
1639
1640int nvdimm_namespace_attach_btt(struct nd_namespace_common *ndns)
1641{
1642 struct nd_btt *nd_btt = to_nd_btt(ndns->claim);
1643 struct nd_region *nd_region;
1644 struct btt_sb *btt_sb;
1645 struct btt *btt;
1646 size_t size, rawsize;
1647 int rc;
1648
1649 if (!nd_btt->uuid || !nd_btt->ndns || !nd_btt->lbasize) {
1650 dev_dbg(&nd_btt->dev, "incomplete btt configuration\n");
1651 return -ENODEV;
1652 }
1653
1654 btt_sb = devm_kzalloc(&nd_btt->dev, sizeof(*btt_sb), GFP_KERNEL);
1655 if (!btt_sb)
1656 return -ENOMEM;
1657
1658 size = nvdimm_namespace_capacity(ndns);
1659 rc = devm_namespace_enable(&nd_btt->dev, ndns, size);
1660 if (rc)
1661 return rc;
1662
1663 /*
1664 * If this returns < 0, that is ok as it just means there wasn't
1665 * an existing BTT, and we're creating a new one. We still need to
1666 * call this as we need the version dependent fields in nd_btt to be
1667 * set correctly based on the holder class
1668 */
1669 nd_btt_version(nd_btt, ndns, btt_sb);
1670
1671 rawsize = size - nd_btt->initial_offset;
1672 if (rawsize < ARENA_MIN_SIZE) {
1673 dev_dbg(&nd_btt->dev, "%s must be at least %ld bytes\n",
1674 dev_name(&ndns->dev),
1675 ARENA_MIN_SIZE + nd_btt->initial_offset);
1676 return -ENXIO;
1677 }
1678 nd_region = to_nd_region(nd_btt->dev.parent);
1679 btt = btt_init(nd_btt, rawsize, nd_btt->lbasize, nd_btt->uuid,
1680 nd_region);
1681 if (!btt)
1682 return -ENOMEM;
1683 nd_btt->btt = btt;
1684
1685 return 0;
1686}
1687EXPORT_SYMBOL(nvdimm_namespace_attach_btt);
1688
1689int nvdimm_namespace_detach_btt(struct nd_btt *nd_btt)
1690{
1691 struct btt *btt = nd_btt->btt;
1692
1693 btt_fini(btt);
1694 nd_btt->btt = NULL;
1695
1696 return 0;
1697}
1698EXPORT_SYMBOL(nvdimm_namespace_detach_btt);
1699
1700static int __init nd_btt_init(void)
1701{
1702 int rc = 0;
1703
1704 debugfs_root = debugfs_create_dir("btt", NULL);
1705 if (IS_ERR_OR_NULL(debugfs_root))
1706 rc = -ENXIO;
1707
1708 return rc;
1709}
1710
1711static void __exit nd_btt_exit(void)
1712{
1713 debugfs_remove_recursive(debugfs_root);
1714}
1715
1716MODULE_ALIAS_ND_DEVICE(ND_DEVICE_BTT);
1717MODULE_AUTHOR("Vishal Verma <vishal.l.verma@linux.intel.com>");
1718MODULE_LICENSE("GPL v2");
1719module_init(nd_btt_init);
1720module_exit(nd_btt_exit);
1// SPDX-License-Identifier: GPL-2.0-only
2/*
3 * Block Translation Table
4 * Copyright (c) 2014-2015, Intel Corporation.
5 */
6#include <linux/highmem.h>
7#include <linux/debugfs.h>
8#include <linux/blkdev.h>
9#include <linux/module.h>
10#include <linux/device.h>
11#include <linux/mutex.h>
12#include <linux/hdreg.h>
13#include <linux/genhd.h>
14#include <linux/sizes.h>
15#include <linux/ndctl.h>
16#include <linux/fs.h>
17#include <linux/nd.h>
18#include <linux/backing-dev.h>
19#include "btt.h"
20#include "nd.h"
21
22enum log_ent_request {
23 LOG_NEW_ENT = 0,
24 LOG_OLD_ENT
25};
26
27static struct device *to_dev(struct arena_info *arena)
28{
29 return &arena->nd_btt->dev;
30}
31
32static u64 adjust_initial_offset(struct nd_btt *nd_btt, u64 offset)
33{
34 return offset + nd_btt->initial_offset;
35}
36
37static int arena_read_bytes(struct arena_info *arena, resource_size_t offset,
38 void *buf, size_t n, unsigned long flags)
39{
40 struct nd_btt *nd_btt = arena->nd_btt;
41 struct nd_namespace_common *ndns = nd_btt->ndns;
42
43 /* arena offsets may be shifted from the base of the device */
44 offset = adjust_initial_offset(nd_btt, offset);
45 return nvdimm_read_bytes(ndns, offset, buf, n, flags);
46}
47
48static int arena_write_bytes(struct arena_info *arena, resource_size_t offset,
49 void *buf, size_t n, unsigned long flags)
50{
51 struct nd_btt *nd_btt = arena->nd_btt;
52 struct nd_namespace_common *ndns = nd_btt->ndns;
53
54 /* arena offsets may be shifted from the base of the device */
55 offset = adjust_initial_offset(nd_btt, offset);
56 return nvdimm_write_bytes(ndns, offset, buf, n, flags);
57}
58
59static int btt_info_write(struct arena_info *arena, struct btt_sb *super)
60{
61 int ret;
62
63 /*
64 * infooff and info2off should always be at least 512B aligned.
65 * We rely on that to make sure rw_bytes does error clearing
66 * correctly, so make sure that is the case.
67 */
68 dev_WARN_ONCE(to_dev(arena), !IS_ALIGNED(arena->infooff, 512),
69 "arena->infooff: %#llx is unaligned\n", arena->infooff);
70 dev_WARN_ONCE(to_dev(arena), !IS_ALIGNED(arena->info2off, 512),
71 "arena->info2off: %#llx is unaligned\n", arena->info2off);
72
73 ret = arena_write_bytes(arena, arena->info2off, super,
74 sizeof(struct btt_sb), 0);
75 if (ret)
76 return ret;
77
78 return arena_write_bytes(arena, arena->infooff, super,
79 sizeof(struct btt_sb), 0);
80}
81
82static int btt_info_read(struct arena_info *arena, struct btt_sb *super)
83{
84 return arena_read_bytes(arena, arena->infooff, super,
85 sizeof(struct btt_sb), 0);
86}
87
88/*
89 * 'raw' version of btt_map write
90 * Assumptions:
91 * mapping is in little-endian
92 * mapping contains 'E' and 'Z' flags as desired
93 */
94static int __btt_map_write(struct arena_info *arena, u32 lba, __le32 mapping,
95 unsigned long flags)
96{
97 u64 ns_off = arena->mapoff + (lba * MAP_ENT_SIZE);
98
99 if (unlikely(lba >= arena->external_nlba))
100 dev_err_ratelimited(to_dev(arena),
101 "%s: lba %#x out of range (max: %#x)\n",
102 __func__, lba, arena->external_nlba);
103 return arena_write_bytes(arena, ns_off, &mapping, MAP_ENT_SIZE, flags);
104}
105
106static int btt_map_write(struct arena_info *arena, u32 lba, u32 mapping,
107 u32 z_flag, u32 e_flag, unsigned long rwb_flags)
108{
109 u32 ze;
110 __le32 mapping_le;
111
112 /*
113 * This 'mapping' is supposed to be just the LBA mapping, without
114 * any flags set, so strip the flag bits.
115 */
116 mapping = ent_lba(mapping);
117
118 ze = (z_flag << 1) + e_flag;
119 switch (ze) {
120 case 0:
121 /*
122 * We want to set neither of the Z or E flags, and
123 * in the actual layout, this means setting the bit
124 * positions of both to '1' to indicate a 'normal'
125 * map entry
126 */
127 mapping |= MAP_ENT_NORMAL;
128 break;
129 case 1:
130 mapping |= (1 << MAP_ERR_SHIFT);
131 break;
132 case 2:
133 mapping |= (1 << MAP_TRIM_SHIFT);
134 break;
135 default:
136 /*
137 * The case where Z and E are both sent in as '1' could be
138 * construed as a valid 'normal' case, but we decide not to,
139 * to avoid confusion
140 */
141 dev_err_ratelimited(to_dev(arena),
142 "Invalid use of Z and E flags\n");
143 return -EIO;
144 }
145
146 mapping_le = cpu_to_le32(mapping);
147 return __btt_map_write(arena, lba, mapping_le, rwb_flags);
148}
149
150static int btt_map_read(struct arena_info *arena, u32 lba, u32 *mapping,
151 int *trim, int *error, unsigned long rwb_flags)
152{
153 int ret;
154 __le32 in;
155 u32 raw_mapping, postmap, ze, z_flag, e_flag;
156 u64 ns_off = arena->mapoff + (lba * MAP_ENT_SIZE);
157
158 if (unlikely(lba >= arena->external_nlba))
159 dev_err_ratelimited(to_dev(arena),
160 "%s: lba %#x out of range (max: %#x)\n",
161 __func__, lba, arena->external_nlba);
162
163 ret = arena_read_bytes(arena, ns_off, &in, MAP_ENT_SIZE, rwb_flags);
164 if (ret)
165 return ret;
166
167 raw_mapping = le32_to_cpu(in);
168
169 z_flag = ent_z_flag(raw_mapping);
170 e_flag = ent_e_flag(raw_mapping);
171 ze = (z_flag << 1) + e_flag;
172 postmap = ent_lba(raw_mapping);
173
174 /* Reuse the {z,e}_flag variables for *trim and *error */
175 z_flag = 0;
176 e_flag = 0;
177
178 switch (ze) {
179 case 0:
180 /* Initial state. Return postmap = premap */
181 *mapping = lba;
182 break;
183 case 1:
184 *mapping = postmap;
185 e_flag = 1;
186 break;
187 case 2:
188 *mapping = postmap;
189 z_flag = 1;
190 break;
191 case 3:
192 *mapping = postmap;
193 break;
194 default:
195 return -EIO;
196 }
197
198 if (trim)
199 *trim = z_flag;
200 if (error)
201 *error = e_flag;
202
203 return ret;
204}
205
206static int btt_log_group_read(struct arena_info *arena, u32 lane,
207 struct log_group *log)
208{
209 return arena_read_bytes(arena,
210 arena->logoff + (lane * LOG_GRP_SIZE), log,
211 LOG_GRP_SIZE, 0);
212}
213
214static struct dentry *debugfs_root;
215
216static void arena_debugfs_init(struct arena_info *a, struct dentry *parent,
217 int idx)
218{
219 char dirname[32];
220 struct dentry *d;
221
222 /* If for some reason, parent bttN was not created, exit */
223 if (!parent)
224 return;
225
226 snprintf(dirname, 32, "arena%d", idx);
227 d = debugfs_create_dir(dirname, parent);
228 if (IS_ERR_OR_NULL(d))
229 return;
230 a->debugfs_dir = d;
231
232 debugfs_create_x64("size", S_IRUGO, d, &a->size);
233 debugfs_create_x64("external_lba_start", S_IRUGO, d,
234 &a->external_lba_start);
235 debugfs_create_x32("internal_nlba", S_IRUGO, d, &a->internal_nlba);
236 debugfs_create_u32("internal_lbasize", S_IRUGO, d,
237 &a->internal_lbasize);
238 debugfs_create_x32("external_nlba", S_IRUGO, d, &a->external_nlba);
239 debugfs_create_u32("external_lbasize", S_IRUGO, d,
240 &a->external_lbasize);
241 debugfs_create_u32("nfree", S_IRUGO, d, &a->nfree);
242 debugfs_create_u16("version_major", S_IRUGO, d, &a->version_major);
243 debugfs_create_u16("version_minor", S_IRUGO, d, &a->version_minor);
244 debugfs_create_x64("nextoff", S_IRUGO, d, &a->nextoff);
245 debugfs_create_x64("infooff", S_IRUGO, d, &a->infooff);
246 debugfs_create_x64("dataoff", S_IRUGO, d, &a->dataoff);
247 debugfs_create_x64("mapoff", S_IRUGO, d, &a->mapoff);
248 debugfs_create_x64("logoff", S_IRUGO, d, &a->logoff);
249 debugfs_create_x64("info2off", S_IRUGO, d, &a->info2off);
250 debugfs_create_x32("flags", S_IRUGO, d, &a->flags);
251 debugfs_create_u32("log_index_0", S_IRUGO, d, &a->log_index[0]);
252 debugfs_create_u32("log_index_1", S_IRUGO, d, &a->log_index[1]);
253}
254
255static void btt_debugfs_init(struct btt *btt)
256{
257 int i = 0;
258 struct arena_info *arena;
259
260 btt->debugfs_dir = debugfs_create_dir(dev_name(&btt->nd_btt->dev),
261 debugfs_root);
262 if (IS_ERR_OR_NULL(btt->debugfs_dir))
263 return;
264
265 list_for_each_entry(arena, &btt->arena_list, list) {
266 arena_debugfs_init(arena, btt->debugfs_dir, i);
267 i++;
268 }
269}
270
271static u32 log_seq(struct log_group *log, int log_idx)
272{
273 return le32_to_cpu(log->ent[log_idx].seq);
274}
275
276/*
277 * This function accepts two log entries, and uses the
278 * sequence number to find the 'older' entry.
279 * It also updates the sequence number in this old entry to
280 * make it the 'new' one if the mark_flag is set.
281 * Finally, it returns which of the entries was the older one.
282 *
283 * TODO The logic feels a bit kludge-y. make it better..
284 */
285static int btt_log_get_old(struct arena_info *a, struct log_group *log)
286{
287 int idx0 = a->log_index[0];
288 int idx1 = a->log_index[1];
289 int old;
290
291 /*
292 * the first ever time this is seen, the entry goes into [0]
293 * the next time, the following logic works out to put this
294 * (next) entry into [1]
295 */
296 if (log_seq(log, idx0) == 0) {
297 log->ent[idx0].seq = cpu_to_le32(1);
298 return 0;
299 }
300
301 if (log_seq(log, idx0) == log_seq(log, idx1))
302 return -EINVAL;
303 if (log_seq(log, idx0) + log_seq(log, idx1) > 5)
304 return -EINVAL;
305
306 if (log_seq(log, idx0) < log_seq(log, idx1)) {
307 if ((log_seq(log, idx1) - log_seq(log, idx0)) == 1)
308 old = 0;
309 else
310 old = 1;
311 } else {
312 if ((log_seq(log, idx0) - log_seq(log, idx1)) == 1)
313 old = 1;
314 else
315 old = 0;
316 }
317
318 return old;
319}
320
321/*
322 * This function copies the desired (old/new) log entry into ent if
323 * it is not NULL. It returns the sub-slot number (0 or 1)
324 * where the desired log entry was found. Negative return values
325 * indicate errors.
326 */
327static int btt_log_read(struct arena_info *arena, u32 lane,
328 struct log_entry *ent, int old_flag)
329{
330 int ret;
331 int old_ent, ret_ent;
332 struct log_group log;
333
334 ret = btt_log_group_read(arena, lane, &log);
335 if (ret)
336 return -EIO;
337
338 old_ent = btt_log_get_old(arena, &log);
339 if (old_ent < 0 || old_ent > 1) {
340 dev_err(to_dev(arena),
341 "log corruption (%d): lane %d seq [%d, %d]\n",
342 old_ent, lane, log.ent[arena->log_index[0]].seq,
343 log.ent[arena->log_index[1]].seq);
344 /* TODO set error state? */
345 return -EIO;
346 }
347
348 ret_ent = (old_flag ? old_ent : (1 - old_ent));
349
350 if (ent != NULL)
351 memcpy(ent, &log.ent[arena->log_index[ret_ent]], LOG_ENT_SIZE);
352
353 return ret_ent;
354}
355
356/*
357 * This function commits a log entry to media
358 * It does _not_ prepare the freelist entry for the next write
359 * btt_flog_write is the wrapper for updating the freelist elements
360 */
361static int __btt_log_write(struct arena_info *arena, u32 lane,
362 u32 sub, struct log_entry *ent, unsigned long flags)
363{
364 int ret;
365 u32 group_slot = arena->log_index[sub];
366 unsigned int log_half = LOG_ENT_SIZE / 2;
367 void *src = ent;
368 u64 ns_off;
369
370 ns_off = arena->logoff + (lane * LOG_GRP_SIZE) +
371 (group_slot * LOG_ENT_SIZE);
372 /* split the 16B write into atomic, durable halves */
373 ret = arena_write_bytes(arena, ns_off, src, log_half, flags);
374 if (ret)
375 return ret;
376
377 ns_off += log_half;
378 src += log_half;
379 return arena_write_bytes(arena, ns_off, src, log_half, flags);
380}
381
382static int btt_flog_write(struct arena_info *arena, u32 lane, u32 sub,
383 struct log_entry *ent)
384{
385 int ret;
386
387 ret = __btt_log_write(arena, lane, sub, ent, NVDIMM_IO_ATOMIC);
388 if (ret)
389 return ret;
390
391 /* prepare the next free entry */
392 arena->freelist[lane].sub = 1 - arena->freelist[lane].sub;
393 if (++(arena->freelist[lane].seq) == 4)
394 arena->freelist[lane].seq = 1;
395 if (ent_e_flag(le32_to_cpu(ent->old_map)))
396 arena->freelist[lane].has_err = 1;
397 arena->freelist[lane].block = ent_lba(le32_to_cpu(ent->old_map));
398
399 return ret;
400}
401
402/*
403 * This function initializes the BTT map to the initial state, which is
404 * all-zeroes, and indicates an identity mapping
405 */
406static int btt_map_init(struct arena_info *arena)
407{
408 int ret = -EINVAL;
409 void *zerobuf;
410 size_t offset = 0;
411 size_t chunk_size = SZ_2M;
412 size_t mapsize = arena->logoff - arena->mapoff;
413
414 zerobuf = kzalloc(chunk_size, GFP_KERNEL);
415 if (!zerobuf)
416 return -ENOMEM;
417
418 /*
419 * mapoff should always be at least 512B aligned. We rely on that to
420 * make sure rw_bytes does error clearing correctly, so make sure that
421 * is the case.
422 */
423 dev_WARN_ONCE(to_dev(arena), !IS_ALIGNED(arena->mapoff, 512),
424 "arena->mapoff: %#llx is unaligned\n", arena->mapoff);
425
426 while (mapsize) {
427 size_t size = min(mapsize, chunk_size);
428
429 dev_WARN_ONCE(to_dev(arena), size < 512,
430 "chunk size: %#zx is unaligned\n", size);
431 ret = arena_write_bytes(arena, arena->mapoff + offset, zerobuf,
432 size, 0);
433 if (ret)
434 goto free;
435
436 offset += size;
437 mapsize -= size;
438 cond_resched();
439 }
440
441 free:
442 kfree(zerobuf);
443 return ret;
444}
445
446/*
447 * This function initializes the BTT log with 'fake' entries pointing
448 * to the initial reserved set of blocks as being free
449 */
450static int btt_log_init(struct arena_info *arena)
451{
452 size_t logsize = arena->info2off - arena->logoff;
453 size_t chunk_size = SZ_4K, offset = 0;
454 struct log_entry ent;
455 void *zerobuf;
456 int ret;
457 u32 i;
458
459 zerobuf = kzalloc(chunk_size, GFP_KERNEL);
460 if (!zerobuf)
461 return -ENOMEM;
462 /*
463 * logoff should always be at least 512B aligned. We rely on that to
464 * make sure rw_bytes does error clearing correctly, so make sure that
465 * is the case.
466 */
467 dev_WARN_ONCE(to_dev(arena), !IS_ALIGNED(arena->logoff, 512),
468 "arena->logoff: %#llx is unaligned\n", arena->logoff);
469
470 while (logsize) {
471 size_t size = min(logsize, chunk_size);
472
473 dev_WARN_ONCE(to_dev(arena), size < 512,
474 "chunk size: %#zx is unaligned\n", size);
475 ret = arena_write_bytes(arena, arena->logoff + offset, zerobuf,
476 size, 0);
477 if (ret)
478 goto free;
479
480 offset += size;
481 logsize -= size;
482 cond_resched();
483 }
484
485 for (i = 0; i < arena->nfree; i++) {
486 ent.lba = cpu_to_le32(i);
487 ent.old_map = cpu_to_le32(arena->external_nlba + i);
488 ent.new_map = cpu_to_le32(arena->external_nlba + i);
489 ent.seq = cpu_to_le32(LOG_SEQ_INIT);
490 ret = __btt_log_write(arena, i, 0, &ent, 0);
491 if (ret)
492 goto free;
493 }
494
495 free:
496 kfree(zerobuf);
497 return ret;
498}
499
500static u64 to_namespace_offset(struct arena_info *arena, u64 lba)
501{
502 return arena->dataoff + ((u64)lba * arena->internal_lbasize);
503}
504
505static int arena_clear_freelist_error(struct arena_info *arena, u32 lane)
506{
507 int ret = 0;
508
509 if (arena->freelist[lane].has_err) {
510 void *zero_page = page_address(ZERO_PAGE(0));
511 u32 lba = arena->freelist[lane].block;
512 u64 nsoff = to_namespace_offset(arena, lba);
513 unsigned long len = arena->sector_size;
514
515 mutex_lock(&arena->err_lock);
516
517 while (len) {
518 unsigned long chunk = min(len, PAGE_SIZE);
519
520 ret = arena_write_bytes(arena, nsoff, zero_page,
521 chunk, 0);
522 if (ret)
523 break;
524 len -= chunk;
525 nsoff += chunk;
526 if (len == 0)
527 arena->freelist[lane].has_err = 0;
528 }
529 mutex_unlock(&arena->err_lock);
530 }
531 return ret;
532}
533
534static int btt_freelist_init(struct arena_info *arena)
535{
536 int new, ret;
537 struct log_entry log_new;
538 u32 i, map_entry, log_oldmap, log_newmap;
539
540 arena->freelist = kcalloc(arena->nfree, sizeof(struct free_entry),
541 GFP_KERNEL);
542 if (!arena->freelist)
543 return -ENOMEM;
544
545 for (i = 0; i < arena->nfree; i++) {
546 new = btt_log_read(arena, i, &log_new, LOG_NEW_ENT);
547 if (new < 0)
548 return new;
549
550 /* old and new map entries with any flags stripped out */
551 log_oldmap = ent_lba(le32_to_cpu(log_new.old_map));
552 log_newmap = ent_lba(le32_to_cpu(log_new.new_map));
553
554 /* sub points to the next one to be overwritten */
555 arena->freelist[i].sub = 1 - new;
556 arena->freelist[i].seq = nd_inc_seq(le32_to_cpu(log_new.seq));
557 arena->freelist[i].block = log_oldmap;
558
559 /*
560 * FIXME: if error clearing fails during init, we want to make
561 * the BTT read-only
562 */
563 if (ent_e_flag(le32_to_cpu(log_new.old_map)) &&
564 !ent_normal(le32_to_cpu(log_new.old_map))) {
565 arena->freelist[i].has_err = 1;
566 ret = arena_clear_freelist_error(arena, i);
567 if (ret)
568 dev_err_ratelimited(to_dev(arena),
569 "Unable to clear known errors\n");
570 }
571
572 /* This implies a newly created or untouched flog entry */
573 if (log_oldmap == log_newmap)
574 continue;
575
576 /* Check if map recovery is needed */
577 ret = btt_map_read(arena, le32_to_cpu(log_new.lba), &map_entry,
578 NULL, NULL, 0);
579 if (ret)
580 return ret;
581
582 /*
583 * The map_entry from btt_read_map is stripped of any flag bits,
584 * so use the stripped out versions from the log as well for
585 * testing whether recovery is needed. For restoration, use the
586 * 'raw' version of the log entries as that captured what we
587 * were going to write originally.
588 */
589 if ((log_newmap != map_entry) && (log_oldmap == map_entry)) {
590 /*
591 * Last transaction wrote the flog, but wasn't able
592 * to complete the map write. So fix up the map.
593 */
594 ret = btt_map_write(arena, le32_to_cpu(log_new.lba),
595 le32_to_cpu(log_new.new_map), 0, 0, 0);
596 if (ret)
597 return ret;
598 }
599 }
600
601 return 0;
602}
603
604static bool ent_is_padding(struct log_entry *ent)
605{
606 return (ent->lba == 0) && (ent->old_map == 0) && (ent->new_map == 0)
607 && (ent->seq == 0);
608}
609
610/*
611 * Detecting valid log indices: We read a log group (see the comments in btt.h
612 * for a description of a 'log_group' and its 'slots'), and iterate over its
613 * four slots. We expect that a padding slot will be all-zeroes, and use this
614 * to detect a padding slot vs. an actual entry.
615 *
616 * If a log_group is in the initial state, i.e. hasn't been used since the
617 * creation of this BTT layout, it will have three of the four slots with
618 * zeroes. We skip over these log_groups for the detection of log_index. If
619 * all log_groups are in the initial state (i.e. the BTT has never been
620 * written to), it is safe to assume the 'new format' of log entries in slots
621 * (0, 1).
622 */
623static int log_set_indices(struct arena_info *arena)
624{
625 bool idx_set = false, initial_state = true;
626 int ret, log_index[2] = {-1, -1};
627 u32 i, j, next_idx = 0;
628 struct log_group log;
629 u32 pad_count = 0;
630
631 for (i = 0; i < arena->nfree; i++) {
632 ret = btt_log_group_read(arena, i, &log);
633 if (ret < 0)
634 return ret;
635
636 for (j = 0; j < 4; j++) {
637 if (!idx_set) {
638 if (ent_is_padding(&log.ent[j])) {
639 pad_count++;
640 continue;
641 } else {
642 /* Skip if index has been recorded */
643 if ((next_idx == 1) &&
644 (j == log_index[0]))
645 continue;
646 /* valid entry, record index */
647 log_index[next_idx] = j;
648 next_idx++;
649 }
650 if (next_idx == 2) {
651 /* two valid entries found */
652 idx_set = true;
653 } else if (next_idx > 2) {
654 /* too many valid indices */
655 return -ENXIO;
656 }
657 } else {
658 /*
659 * once the indices have been set, just verify
660 * that all subsequent log groups are either in
661 * their initial state or follow the same
662 * indices.
663 */
664 if (j == log_index[0]) {
665 /* entry must be 'valid' */
666 if (ent_is_padding(&log.ent[j]))
667 return -ENXIO;
668 } else if (j == log_index[1]) {
669 ;
670 /*
671 * log_index[1] can be padding if the
672 * lane never got used and it is still
673 * in the initial state (three 'padding'
674 * entries)
675 */
676 } else {
677 /* entry must be invalid (padding) */
678 if (!ent_is_padding(&log.ent[j]))
679 return -ENXIO;
680 }
681 }
682 }
683 /*
684 * If any of the log_groups have more than one valid,
685 * non-padding entry, then the we are no longer in the
686 * initial_state
687 */
688 if (pad_count < 3)
689 initial_state = false;
690 pad_count = 0;
691 }
692
693 if (!initial_state && !idx_set)
694 return -ENXIO;
695
696 /*
697 * If all the entries in the log were in the initial state,
698 * assume new padding scheme
699 */
700 if (initial_state)
701 log_index[1] = 1;
702
703 /*
704 * Only allow the known permutations of log/padding indices,
705 * i.e. (0, 1), and (0, 2)
706 */
707 if ((log_index[0] == 0) && ((log_index[1] == 1) || (log_index[1] == 2)))
708 ; /* known index possibilities */
709 else {
710 dev_err(to_dev(arena), "Found an unknown padding scheme\n");
711 return -ENXIO;
712 }
713
714 arena->log_index[0] = log_index[0];
715 arena->log_index[1] = log_index[1];
716 dev_dbg(to_dev(arena), "log_index_0 = %d\n", log_index[0]);
717 dev_dbg(to_dev(arena), "log_index_1 = %d\n", log_index[1]);
718 return 0;
719}
720
721static int btt_rtt_init(struct arena_info *arena)
722{
723 arena->rtt = kcalloc(arena->nfree, sizeof(u32), GFP_KERNEL);
724 if (arena->rtt == NULL)
725 return -ENOMEM;
726
727 return 0;
728}
729
730static int btt_maplocks_init(struct arena_info *arena)
731{
732 u32 i;
733
734 arena->map_locks = kcalloc(arena->nfree, sizeof(struct aligned_lock),
735 GFP_KERNEL);
736 if (!arena->map_locks)
737 return -ENOMEM;
738
739 for (i = 0; i < arena->nfree; i++)
740 spin_lock_init(&arena->map_locks[i].lock);
741
742 return 0;
743}
744
745static struct arena_info *alloc_arena(struct btt *btt, size_t size,
746 size_t start, size_t arena_off)
747{
748 struct arena_info *arena;
749 u64 logsize, mapsize, datasize;
750 u64 available = size;
751
752 arena = kzalloc(sizeof(struct arena_info), GFP_KERNEL);
753 if (!arena)
754 return NULL;
755 arena->nd_btt = btt->nd_btt;
756 arena->sector_size = btt->sector_size;
757 mutex_init(&arena->err_lock);
758
759 if (!size)
760 return arena;
761
762 arena->size = size;
763 arena->external_lba_start = start;
764 arena->external_lbasize = btt->lbasize;
765 arena->internal_lbasize = roundup(arena->external_lbasize,
766 INT_LBASIZE_ALIGNMENT);
767 arena->nfree = BTT_DEFAULT_NFREE;
768 arena->version_major = btt->nd_btt->version_major;
769 arena->version_minor = btt->nd_btt->version_minor;
770
771 if (available % BTT_PG_SIZE)
772 available -= (available % BTT_PG_SIZE);
773
774 /* Two pages are reserved for the super block and its copy */
775 available -= 2 * BTT_PG_SIZE;
776
777 /* The log takes a fixed amount of space based on nfree */
778 logsize = roundup(arena->nfree * LOG_GRP_SIZE, BTT_PG_SIZE);
779 available -= logsize;
780
781 /* Calculate optimal split between map and data area */
782 arena->internal_nlba = div_u64(available - BTT_PG_SIZE,
783 arena->internal_lbasize + MAP_ENT_SIZE);
784 arena->external_nlba = arena->internal_nlba - arena->nfree;
785
786 mapsize = roundup((arena->external_nlba * MAP_ENT_SIZE), BTT_PG_SIZE);
787 datasize = available - mapsize;
788
789 /* 'Absolute' values, relative to start of storage space */
790 arena->infooff = arena_off;
791 arena->dataoff = arena->infooff + BTT_PG_SIZE;
792 arena->mapoff = arena->dataoff + datasize;
793 arena->logoff = arena->mapoff + mapsize;
794 arena->info2off = arena->logoff + logsize;
795
796 /* Default log indices are (0,1) */
797 arena->log_index[0] = 0;
798 arena->log_index[1] = 1;
799 return arena;
800}
801
802static void free_arenas(struct btt *btt)
803{
804 struct arena_info *arena, *next;
805
806 list_for_each_entry_safe(arena, next, &btt->arena_list, list) {
807 list_del(&arena->list);
808 kfree(arena->rtt);
809 kfree(arena->map_locks);
810 kfree(arena->freelist);
811 debugfs_remove_recursive(arena->debugfs_dir);
812 kfree(arena);
813 }
814}
815
816/*
817 * This function reads an existing valid btt superblock and
818 * populates the corresponding arena_info struct
819 */
820static void parse_arena_meta(struct arena_info *arena, struct btt_sb *super,
821 u64 arena_off)
822{
823 arena->internal_nlba = le32_to_cpu(super->internal_nlba);
824 arena->internal_lbasize = le32_to_cpu(super->internal_lbasize);
825 arena->external_nlba = le32_to_cpu(super->external_nlba);
826 arena->external_lbasize = le32_to_cpu(super->external_lbasize);
827 arena->nfree = le32_to_cpu(super->nfree);
828 arena->version_major = le16_to_cpu(super->version_major);
829 arena->version_minor = le16_to_cpu(super->version_minor);
830
831 arena->nextoff = (super->nextoff == 0) ? 0 : (arena_off +
832 le64_to_cpu(super->nextoff));
833 arena->infooff = arena_off;
834 arena->dataoff = arena_off + le64_to_cpu(super->dataoff);
835 arena->mapoff = arena_off + le64_to_cpu(super->mapoff);
836 arena->logoff = arena_off + le64_to_cpu(super->logoff);
837 arena->info2off = arena_off + le64_to_cpu(super->info2off);
838
839 arena->size = (le64_to_cpu(super->nextoff) > 0)
840 ? (le64_to_cpu(super->nextoff))
841 : (arena->info2off - arena->infooff + BTT_PG_SIZE);
842
843 arena->flags = le32_to_cpu(super->flags);
844}
845
846static int discover_arenas(struct btt *btt)
847{
848 int ret = 0;
849 struct arena_info *arena;
850 struct btt_sb *super;
851 size_t remaining = btt->rawsize;
852 u64 cur_nlba = 0;
853 size_t cur_off = 0;
854 int num_arenas = 0;
855
856 super = kzalloc(sizeof(*super), GFP_KERNEL);
857 if (!super)
858 return -ENOMEM;
859
860 while (remaining) {
861 /* Alloc memory for arena */
862 arena = alloc_arena(btt, 0, 0, 0);
863 if (!arena) {
864 ret = -ENOMEM;
865 goto out_super;
866 }
867
868 arena->infooff = cur_off;
869 ret = btt_info_read(arena, super);
870 if (ret)
871 goto out;
872
873 if (!nd_btt_arena_is_valid(btt->nd_btt, super)) {
874 if (remaining == btt->rawsize) {
875 btt->init_state = INIT_NOTFOUND;
876 dev_info(to_dev(arena), "No existing arenas\n");
877 goto out;
878 } else {
879 dev_err(to_dev(arena),
880 "Found corrupted metadata!\n");
881 ret = -ENODEV;
882 goto out;
883 }
884 }
885
886 arena->external_lba_start = cur_nlba;
887 parse_arena_meta(arena, super, cur_off);
888
889 ret = log_set_indices(arena);
890 if (ret) {
891 dev_err(to_dev(arena),
892 "Unable to deduce log/padding indices\n");
893 goto out;
894 }
895
896 ret = btt_freelist_init(arena);
897 if (ret)
898 goto out;
899
900 ret = btt_rtt_init(arena);
901 if (ret)
902 goto out;
903
904 ret = btt_maplocks_init(arena);
905 if (ret)
906 goto out;
907
908 list_add_tail(&arena->list, &btt->arena_list);
909
910 remaining -= arena->size;
911 cur_off += arena->size;
912 cur_nlba += arena->external_nlba;
913 num_arenas++;
914
915 if (arena->nextoff == 0)
916 break;
917 }
918 btt->num_arenas = num_arenas;
919 btt->nlba = cur_nlba;
920 btt->init_state = INIT_READY;
921
922 kfree(super);
923 return ret;
924
925 out:
926 kfree(arena);
927 free_arenas(btt);
928 out_super:
929 kfree(super);
930 return ret;
931}
932
933static int create_arenas(struct btt *btt)
934{
935 size_t remaining = btt->rawsize;
936 size_t cur_off = 0;
937
938 while (remaining) {
939 struct arena_info *arena;
940 size_t arena_size = min_t(u64, ARENA_MAX_SIZE, remaining);
941
942 remaining -= arena_size;
943 if (arena_size < ARENA_MIN_SIZE)
944 break;
945
946 arena = alloc_arena(btt, arena_size, btt->nlba, cur_off);
947 if (!arena) {
948 free_arenas(btt);
949 return -ENOMEM;
950 }
951 btt->nlba += arena->external_nlba;
952 if (remaining >= ARENA_MIN_SIZE)
953 arena->nextoff = arena->size;
954 else
955 arena->nextoff = 0;
956 cur_off += arena_size;
957 list_add_tail(&arena->list, &btt->arena_list);
958 }
959
960 return 0;
961}
962
963/*
964 * This function completes arena initialization by writing
965 * all the metadata.
966 * It is only called for an uninitialized arena when a write
967 * to that arena occurs for the first time.
968 */
969static int btt_arena_write_layout(struct arena_info *arena)
970{
971 int ret;
972 u64 sum;
973 struct btt_sb *super;
974 struct nd_btt *nd_btt = arena->nd_btt;
975 const u8 *parent_uuid = nd_dev_to_uuid(&nd_btt->ndns->dev);
976
977 ret = btt_map_init(arena);
978 if (ret)
979 return ret;
980
981 ret = btt_log_init(arena);
982 if (ret)
983 return ret;
984
985 super = kzalloc(sizeof(struct btt_sb), GFP_NOIO);
986 if (!super)
987 return -ENOMEM;
988
989 strncpy(super->signature, BTT_SIG, BTT_SIG_LEN);
990 memcpy(super->uuid, nd_btt->uuid, 16);
991 memcpy(super->parent_uuid, parent_uuid, 16);
992 super->flags = cpu_to_le32(arena->flags);
993 super->version_major = cpu_to_le16(arena->version_major);
994 super->version_minor = cpu_to_le16(arena->version_minor);
995 super->external_lbasize = cpu_to_le32(arena->external_lbasize);
996 super->external_nlba = cpu_to_le32(arena->external_nlba);
997 super->internal_lbasize = cpu_to_le32(arena->internal_lbasize);
998 super->internal_nlba = cpu_to_le32(arena->internal_nlba);
999 super->nfree = cpu_to_le32(arena->nfree);
1000 super->infosize = cpu_to_le32(sizeof(struct btt_sb));
1001 super->nextoff = cpu_to_le64(arena->nextoff);
1002 /*
1003 * Subtract arena->infooff (arena start) so numbers are relative
1004 * to 'this' arena
1005 */
1006 super->dataoff = cpu_to_le64(arena->dataoff - arena->infooff);
1007 super->mapoff = cpu_to_le64(arena->mapoff - arena->infooff);
1008 super->logoff = cpu_to_le64(arena->logoff - arena->infooff);
1009 super->info2off = cpu_to_le64(arena->info2off - arena->infooff);
1010
1011 super->flags = 0;
1012 sum = nd_sb_checksum((struct nd_gen_sb *) super);
1013 super->checksum = cpu_to_le64(sum);
1014
1015 ret = btt_info_write(arena, super);
1016
1017 kfree(super);
1018 return ret;
1019}
1020
1021/*
1022 * This function completes the initialization for the BTT namespace
1023 * such that it is ready to accept IOs
1024 */
1025static int btt_meta_init(struct btt *btt)
1026{
1027 int ret = 0;
1028 struct arena_info *arena;
1029
1030 mutex_lock(&btt->init_lock);
1031 list_for_each_entry(arena, &btt->arena_list, list) {
1032 ret = btt_arena_write_layout(arena);
1033 if (ret)
1034 goto unlock;
1035
1036 ret = btt_freelist_init(arena);
1037 if (ret)
1038 goto unlock;
1039
1040 ret = btt_rtt_init(arena);
1041 if (ret)
1042 goto unlock;
1043
1044 ret = btt_maplocks_init(arena);
1045 if (ret)
1046 goto unlock;
1047 }
1048
1049 btt->init_state = INIT_READY;
1050
1051 unlock:
1052 mutex_unlock(&btt->init_lock);
1053 return ret;
1054}
1055
1056static u32 btt_meta_size(struct btt *btt)
1057{
1058 return btt->lbasize - btt->sector_size;
1059}
1060
1061/*
1062 * This function calculates the arena in which the given LBA lies
1063 * by doing a linear walk. This is acceptable since we expect only
1064 * a few arenas. If we have backing devices that get much larger,
1065 * we can construct a balanced binary tree of arenas at init time
1066 * so that this range search becomes faster.
1067 */
1068static int lba_to_arena(struct btt *btt, sector_t sector, __u32 *premap,
1069 struct arena_info **arena)
1070{
1071 struct arena_info *arena_list;
1072 __u64 lba = div_u64(sector << SECTOR_SHIFT, btt->sector_size);
1073
1074 list_for_each_entry(arena_list, &btt->arena_list, list) {
1075 if (lba < arena_list->external_nlba) {
1076 *arena = arena_list;
1077 *premap = lba;
1078 return 0;
1079 }
1080 lba -= arena_list->external_nlba;
1081 }
1082
1083 return -EIO;
1084}
1085
1086/*
1087 * The following (lock_map, unlock_map) are mostly just to improve
1088 * readability, since they index into an array of locks
1089 */
1090static void lock_map(struct arena_info *arena, u32 premap)
1091 __acquires(&arena->map_locks[idx].lock)
1092{
1093 u32 idx = (premap * MAP_ENT_SIZE / L1_CACHE_BYTES) % arena->nfree;
1094
1095 spin_lock(&arena->map_locks[idx].lock);
1096}
1097
1098static void unlock_map(struct arena_info *arena, u32 premap)
1099 __releases(&arena->map_locks[idx].lock)
1100{
1101 u32 idx = (premap * MAP_ENT_SIZE / L1_CACHE_BYTES) % arena->nfree;
1102
1103 spin_unlock(&arena->map_locks[idx].lock);
1104}
1105
1106static int btt_data_read(struct arena_info *arena, struct page *page,
1107 unsigned int off, u32 lba, u32 len)
1108{
1109 int ret;
1110 u64 nsoff = to_namespace_offset(arena, lba);
1111 void *mem = kmap_atomic(page);
1112
1113 ret = arena_read_bytes(arena, nsoff, mem + off, len, NVDIMM_IO_ATOMIC);
1114 kunmap_atomic(mem);
1115
1116 return ret;
1117}
1118
1119static int btt_data_write(struct arena_info *arena, u32 lba,
1120 struct page *page, unsigned int off, u32 len)
1121{
1122 int ret;
1123 u64 nsoff = to_namespace_offset(arena, lba);
1124 void *mem = kmap_atomic(page);
1125
1126 ret = arena_write_bytes(arena, nsoff, mem + off, len, NVDIMM_IO_ATOMIC);
1127 kunmap_atomic(mem);
1128
1129 return ret;
1130}
1131
1132static void zero_fill_data(struct page *page, unsigned int off, u32 len)
1133{
1134 void *mem = kmap_atomic(page);
1135
1136 memset(mem + off, 0, len);
1137 kunmap_atomic(mem);
1138}
1139
1140#ifdef CONFIG_BLK_DEV_INTEGRITY
1141static int btt_rw_integrity(struct btt *btt, struct bio_integrity_payload *bip,
1142 struct arena_info *arena, u32 postmap, int rw)
1143{
1144 unsigned int len = btt_meta_size(btt);
1145 u64 meta_nsoff;
1146 int ret = 0;
1147
1148 if (bip == NULL)
1149 return 0;
1150
1151 meta_nsoff = to_namespace_offset(arena, postmap) + btt->sector_size;
1152
1153 while (len) {
1154 unsigned int cur_len;
1155 struct bio_vec bv;
1156 void *mem;
1157
1158 bv = bvec_iter_bvec(bip->bip_vec, bip->bip_iter);
1159 /*
1160 * The 'bv' obtained from bvec_iter_bvec has its .bv_len and
1161 * .bv_offset already adjusted for iter->bi_bvec_done, and we
1162 * can use those directly
1163 */
1164
1165 cur_len = min(len, bv.bv_len);
1166 mem = kmap_atomic(bv.bv_page);
1167 if (rw)
1168 ret = arena_write_bytes(arena, meta_nsoff,
1169 mem + bv.bv_offset, cur_len,
1170 NVDIMM_IO_ATOMIC);
1171 else
1172 ret = arena_read_bytes(arena, meta_nsoff,
1173 mem + bv.bv_offset, cur_len,
1174 NVDIMM_IO_ATOMIC);
1175
1176 kunmap_atomic(mem);
1177 if (ret)
1178 return ret;
1179
1180 len -= cur_len;
1181 meta_nsoff += cur_len;
1182 if (!bvec_iter_advance(bip->bip_vec, &bip->bip_iter, cur_len))
1183 return -EIO;
1184 }
1185
1186 return ret;
1187}
1188
1189#else /* CONFIG_BLK_DEV_INTEGRITY */
1190static int btt_rw_integrity(struct btt *btt, struct bio_integrity_payload *bip,
1191 struct arena_info *arena, u32 postmap, int rw)
1192{
1193 return 0;
1194}
1195#endif
1196
1197static int btt_read_pg(struct btt *btt, struct bio_integrity_payload *bip,
1198 struct page *page, unsigned int off, sector_t sector,
1199 unsigned int len)
1200{
1201 int ret = 0;
1202 int t_flag, e_flag;
1203 struct arena_info *arena = NULL;
1204 u32 lane = 0, premap, postmap;
1205
1206 while (len) {
1207 u32 cur_len;
1208
1209 lane = nd_region_acquire_lane(btt->nd_region);
1210
1211 ret = lba_to_arena(btt, sector, &premap, &arena);
1212 if (ret)
1213 goto out_lane;
1214
1215 cur_len = min(btt->sector_size, len);
1216
1217 ret = btt_map_read(arena, premap, &postmap, &t_flag, &e_flag,
1218 NVDIMM_IO_ATOMIC);
1219 if (ret)
1220 goto out_lane;
1221
1222 /*
1223 * We loop to make sure that the post map LBA didn't change
1224 * from under us between writing the RTT and doing the actual
1225 * read.
1226 */
1227 while (1) {
1228 u32 new_map;
1229 int new_t, new_e;
1230
1231 if (t_flag) {
1232 zero_fill_data(page, off, cur_len);
1233 goto out_lane;
1234 }
1235
1236 if (e_flag) {
1237 ret = -EIO;
1238 goto out_lane;
1239 }
1240
1241 arena->rtt[lane] = RTT_VALID | postmap;
1242 /*
1243 * Barrier to make sure this write is not reordered
1244 * to do the verification map_read before the RTT store
1245 */
1246 barrier();
1247
1248 ret = btt_map_read(arena, premap, &new_map, &new_t,
1249 &new_e, NVDIMM_IO_ATOMIC);
1250 if (ret)
1251 goto out_rtt;
1252
1253 if ((postmap == new_map) && (t_flag == new_t) &&
1254 (e_flag == new_e))
1255 break;
1256
1257 postmap = new_map;
1258 t_flag = new_t;
1259 e_flag = new_e;
1260 }
1261
1262 ret = btt_data_read(arena, page, off, postmap, cur_len);
1263 if (ret) {
1264 /* Media error - set the e_flag */
1265 if (btt_map_write(arena, premap, postmap, 0, 1, NVDIMM_IO_ATOMIC))
1266 dev_warn_ratelimited(to_dev(arena),
1267 "Error persistently tracking bad blocks at %#x\n",
1268 premap);
1269 goto out_rtt;
1270 }
1271
1272 if (bip) {
1273 ret = btt_rw_integrity(btt, bip, arena, postmap, READ);
1274 if (ret)
1275 goto out_rtt;
1276 }
1277
1278 arena->rtt[lane] = RTT_INVALID;
1279 nd_region_release_lane(btt->nd_region, lane);
1280
1281 len -= cur_len;
1282 off += cur_len;
1283 sector += btt->sector_size >> SECTOR_SHIFT;
1284 }
1285
1286 return 0;
1287
1288 out_rtt:
1289 arena->rtt[lane] = RTT_INVALID;
1290 out_lane:
1291 nd_region_release_lane(btt->nd_region, lane);
1292 return ret;
1293}
1294
1295/*
1296 * Normally, arena_{read,write}_bytes will take care of the initial offset
1297 * adjustment, but in the case of btt_is_badblock, where we query is_bad_pmem,
1298 * we need the final, raw namespace offset here
1299 */
1300static bool btt_is_badblock(struct btt *btt, struct arena_info *arena,
1301 u32 postmap)
1302{
1303 u64 nsoff = adjust_initial_offset(arena->nd_btt,
1304 to_namespace_offset(arena, postmap));
1305 sector_t phys_sector = nsoff >> 9;
1306
1307 return is_bad_pmem(btt->phys_bb, phys_sector, arena->internal_lbasize);
1308}
1309
1310static int btt_write_pg(struct btt *btt, struct bio_integrity_payload *bip,
1311 sector_t sector, struct page *page, unsigned int off,
1312 unsigned int len)
1313{
1314 int ret = 0;
1315 struct arena_info *arena = NULL;
1316 u32 premap = 0, old_postmap, new_postmap, lane = 0, i;
1317 struct log_entry log;
1318 int sub;
1319
1320 while (len) {
1321 u32 cur_len;
1322 int e_flag;
1323
1324 retry:
1325 lane = nd_region_acquire_lane(btt->nd_region);
1326
1327 ret = lba_to_arena(btt, sector, &premap, &arena);
1328 if (ret)
1329 goto out_lane;
1330 cur_len = min(btt->sector_size, len);
1331
1332 if ((arena->flags & IB_FLAG_ERROR_MASK) != 0) {
1333 ret = -EIO;
1334 goto out_lane;
1335 }
1336
1337 if (btt_is_badblock(btt, arena, arena->freelist[lane].block))
1338 arena->freelist[lane].has_err = 1;
1339
1340 if (mutex_is_locked(&arena->err_lock)
1341 || arena->freelist[lane].has_err) {
1342 nd_region_release_lane(btt->nd_region, lane);
1343
1344 ret = arena_clear_freelist_error(arena, lane);
1345 if (ret)
1346 return ret;
1347
1348 /* OK to acquire a different lane/free block */
1349 goto retry;
1350 }
1351
1352 new_postmap = arena->freelist[lane].block;
1353
1354 /* Wait if the new block is being read from */
1355 for (i = 0; i < arena->nfree; i++)
1356 while (arena->rtt[i] == (RTT_VALID | new_postmap))
1357 cpu_relax();
1358
1359
1360 if (new_postmap >= arena->internal_nlba) {
1361 ret = -EIO;
1362 goto out_lane;
1363 }
1364
1365 ret = btt_data_write(arena, new_postmap, page, off, cur_len);
1366 if (ret)
1367 goto out_lane;
1368
1369 if (bip) {
1370 ret = btt_rw_integrity(btt, bip, arena, new_postmap,
1371 WRITE);
1372 if (ret)
1373 goto out_lane;
1374 }
1375
1376 lock_map(arena, premap);
1377 ret = btt_map_read(arena, premap, &old_postmap, NULL, &e_flag,
1378 NVDIMM_IO_ATOMIC);
1379 if (ret)
1380 goto out_map;
1381 if (old_postmap >= arena->internal_nlba) {
1382 ret = -EIO;
1383 goto out_map;
1384 }
1385 if (e_flag)
1386 set_e_flag(old_postmap);
1387
1388 log.lba = cpu_to_le32(premap);
1389 log.old_map = cpu_to_le32(old_postmap);
1390 log.new_map = cpu_to_le32(new_postmap);
1391 log.seq = cpu_to_le32(arena->freelist[lane].seq);
1392 sub = arena->freelist[lane].sub;
1393 ret = btt_flog_write(arena, lane, sub, &log);
1394 if (ret)
1395 goto out_map;
1396
1397 ret = btt_map_write(arena, premap, new_postmap, 0, 0,
1398 NVDIMM_IO_ATOMIC);
1399 if (ret)
1400 goto out_map;
1401
1402 unlock_map(arena, premap);
1403 nd_region_release_lane(btt->nd_region, lane);
1404
1405 if (e_flag) {
1406 ret = arena_clear_freelist_error(arena, lane);
1407 if (ret)
1408 return ret;
1409 }
1410
1411 len -= cur_len;
1412 off += cur_len;
1413 sector += btt->sector_size >> SECTOR_SHIFT;
1414 }
1415
1416 return 0;
1417
1418 out_map:
1419 unlock_map(arena, premap);
1420 out_lane:
1421 nd_region_release_lane(btt->nd_region, lane);
1422 return ret;
1423}
1424
1425static int btt_do_bvec(struct btt *btt, struct bio_integrity_payload *bip,
1426 struct page *page, unsigned int len, unsigned int off,
1427 unsigned int op, sector_t sector)
1428{
1429 int ret;
1430
1431 if (!op_is_write(op)) {
1432 ret = btt_read_pg(btt, bip, page, off, sector, len);
1433 flush_dcache_page(page);
1434 } else {
1435 flush_dcache_page(page);
1436 ret = btt_write_pg(btt, bip, sector, page, off, len);
1437 }
1438
1439 return ret;
1440}
1441
1442static blk_qc_t btt_submit_bio(struct bio *bio)
1443{
1444 struct bio_integrity_payload *bip = bio_integrity(bio);
1445 struct btt *btt = bio->bi_disk->private_data;
1446 struct bvec_iter iter;
1447 unsigned long start;
1448 struct bio_vec bvec;
1449 int err = 0;
1450 bool do_acct;
1451
1452 if (!bio_integrity_prep(bio))
1453 return BLK_QC_T_NONE;
1454
1455 do_acct = blk_queue_io_stat(bio->bi_disk->queue);
1456 if (do_acct)
1457 start = bio_start_io_acct(bio);
1458 bio_for_each_segment(bvec, bio, iter) {
1459 unsigned int len = bvec.bv_len;
1460
1461 if (len > PAGE_SIZE || len < btt->sector_size ||
1462 len % btt->sector_size) {
1463 dev_err_ratelimited(&btt->nd_btt->dev,
1464 "unaligned bio segment (len: %d)\n", len);
1465 bio->bi_status = BLK_STS_IOERR;
1466 break;
1467 }
1468
1469 err = btt_do_bvec(btt, bip, bvec.bv_page, len, bvec.bv_offset,
1470 bio_op(bio), iter.bi_sector);
1471 if (err) {
1472 dev_err(&btt->nd_btt->dev,
1473 "io error in %s sector %lld, len %d,\n",
1474 (op_is_write(bio_op(bio))) ? "WRITE" :
1475 "READ",
1476 (unsigned long long) iter.bi_sector, len);
1477 bio->bi_status = errno_to_blk_status(err);
1478 break;
1479 }
1480 }
1481 if (do_acct)
1482 bio_end_io_acct(bio, start);
1483
1484 bio_endio(bio);
1485 return BLK_QC_T_NONE;
1486}
1487
1488static int btt_rw_page(struct block_device *bdev, sector_t sector,
1489 struct page *page, unsigned int op)
1490{
1491 struct btt *btt = bdev->bd_disk->private_data;
1492 int rc;
1493
1494 rc = btt_do_bvec(btt, NULL, page, thp_size(page), 0, op, sector);
1495 if (rc == 0)
1496 page_endio(page, op_is_write(op), 0);
1497
1498 return rc;
1499}
1500
1501
1502static int btt_getgeo(struct block_device *bd, struct hd_geometry *geo)
1503{
1504 /* some standard values */
1505 geo->heads = 1 << 6;
1506 geo->sectors = 1 << 5;
1507 geo->cylinders = get_capacity(bd->bd_disk) >> 11;
1508 return 0;
1509}
1510
1511static const struct block_device_operations btt_fops = {
1512 .owner = THIS_MODULE,
1513 .submit_bio = btt_submit_bio,
1514 .rw_page = btt_rw_page,
1515 .getgeo = btt_getgeo,
1516 .revalidate_disk = nvdimm_revalidate_disk,
1517};
1518
1519static int btt_blk_init(struct btt *btt)
1520{
1521 struct nd_btt *nd_btt = btt->nd_btt;
1522 struct nd_namespace_common *ndns = nd_btt->ndns;
1523
1524 /* create a new disk and request queue for btt */
1525 btt->btt_queue = blk_alloc_queue(NUMA_NO_NODE);
1526 if (!btt->btt_queue)
1527 return -ENOMEM;
1528
1529 btt->btt_disk = alloc_disk(0);
1530 if (!btt->btt_disk) {
1531 blk_cleanup_queue(btt->btt_queue);
1532 return -ENOMEM;
1533 }
1534
1535 nvdimm_namespace_disk_name(ndns, btt->btt_disk->disk_name);
1536 btt->btt_disk->first_minor = 0;
1537 btt->btt_disk->fops = &btt_fops;
1538 btt->btt_disk->private_data = btt;
1539 btt->btt_disk->queue = btt->btt_queue;
1540 btt->btt_disk->flags = GENHD_FL_EXT_DEVT;
1541 btt->btt_disk->queue->backing_dev_info->capabilities |=
1542 BDI_CAP_SYNCHRONOUS_IO;
1543
1544 blk_queue_logical_block_size(btt->btt_queue, btt->sector_size);
1545 blk_queue_max_hw_sectors(btt->btt_queue, UINT_MAX);
1546 blk_queue_flag_set(QUEUE_FLAG_NONROT, btt->btt_queue);
1547
1548 if (btt_meta_size(btt)) {
1549 int rc = nd_integrity_init(btt->btt_disk, btt_meta_size(btt));
1550
1551 if (rc) {
1552 del_gendisk(btt->btt_disk);
1553 put_disk(btt->btt_disk);
1554 blk_cleanup_queue(btt->btt_queue);
1555 return rc;
1556 }
1557 }
1558 set_capacity(btt->btt_disk, btt->nlba * btt->sector_size >> 9);
1559 device_add_disk(&btt->nd_btt->dev, btt->btt_disk, NULL);
1560 btt->nd_btt->size = btt->nlba * (u64)btt->sector_size;
1561 revalidate_disk(btt->btt_disk);
1562
1563 return 0;
1564}
1565
1566static void btt_blk_cleanup(struct btt *btt)
1567{
1568 del_gendisk(btt->btt_disk);
1569 put_disk(btt->btt_disk);
1570 blk_cleanup_queue(btt->btt_queue);
1571}
1572
1573/**
1574 * btt_init - initialize a block translation table for the given device
1575 * @nd_btt: device with BTT geometry and backing device info
1576 * @rawsize: raw size in bytes of the backing device
1577 * @lbasize: lba size of the backing device
1578 * @uuid: A uuid for the backing device - this is stored on media
1579 * @maxlane: maximum number of parallel requests the device can handle
1580 *
1581 * Initialize a Block Translation Table on a backing device to provide
1582 * single sector power fail atomicity.
1583 *
1584 * Context:
1585 * Might sleep.
1586 *
1587 * Returns:
1588 * Pointer to a new struct btt on success, NULL on failure.
1589 */
1590static struct btt *btt_init(struct nd_btt *nd_btt, unsigned long long rawsize,
1591 u32 lbasize, u8 *uuid, struct nd_region *nd_region)
1592{
1593 int ret;
1594 struct btt *btt;
1595 struct nd_namespace_io *nsio;
1596 struct device *dev = &nd_btt->dev;
1597
1598 btt = devm_kzalloc(dev, sizeof(struct btt), GFP_KERNEL);
1599 if (!btt)
1600 return NULL;
1601
1602 btt->nd_btt = nd_btt;
1603 btt->rawsize = rawsize;
1604 btt->lbasize = lbasize;
1605 btt->sector_size = ((lbasize >= 4096) ? 4096 : 512);
1606 INIT_LIST_HEAD(&btt->arena_list);
1607 mutex_init(&btt->init_lock);
1608 btt->nd_region = nd_region;
1609 nsio = to_nd_namespace_io(&nd_btt->ndns->dev);
1610 btt->phys_bb = &nsio->bb;
1611
1612 ret = discover_arenas(btt);
1613 if (ret) {
1614 dev_err(dev, "init: error in arena_discover: %d\n", ret);
1615 return NULL;
1616 }
1617
1618 if (btt->init_state != INIT_READY && nd_region->ro) {
1619 dev_warn(dev, "%s is read-only, unable to init btt metadata\n",
1620 dev_name(&nd_region->dev));
1621 return NULL;
1622 } else if (btt->init_state != INIT_READY) {
1623 btt->num_arenas = (rawsize / ARENA_MAX_SIZE) +
1624 ((rawsize % ARENA_MAX_SIZE) ? 1 : 0);
1625 dev_dbg(dev, "init: %d arenas for %llu rawsize\n",
1626 btt->num_arenas, rawsize);
1627
1628 ret = create_arenas(btt);
1629 if (ret) {
1630 dev_info(dev, "init: create_arenas: %d\n", ret);
1631 return NULL;
1632 }
1633
1634 ret = btt_meta_init(btt);
1635 if (ret) {
1636 dev_err(dev, "init: error in meta_init: %d\n", ret);
1637 return NULL;
1638 }
1639 }
1640
1641 ret = btt_blk_init(btt);
1642 if (ret) {
1643 dev_err(dev, "init: error in blk_init: %d\n", ret);
1644 return NULL;
1645 }
1646
1647 btt_debugfs_init(btt);
1648
1649 return btt;
1650}
1651
1652/**
1653 * btt_fini - de-initialize a BTT
1654 * @btt: the BTT handle that was generated by btt_init
1655 *
1656 * De-initialize a Block Translation Table on device removal
1657 *
1658 * Context:
1659 * Might sleep.
1660 */
1661static void btt_fini(struct btt *btt)
1662{
1663 if (btt) {
1664 btt_blk_cleanup(btt);
1665 free_arenas(btt);
1666 debugfs_remove_recursive(btt->debugfs_dir);
1667 }
1668}
1669
1670int nvdimm_namespace_attach_btt(struct nd_namespace_common *ndns)
1671{
1672 struct nd_btt *nd_btt = to_nd_btt(ndns->claim);
1673 struct nd_region *nd_region;
1674 struct btt_sb *btt_sb;
1675 struct btt *btt;
1676 size_t size, rawsize;
1677 int rc;
1678
1679 if (!nd_btt->uuid || !nd_btt->ndns || !nd_btt->lbasize) {
1680 dev_dbg(&nd_btt->dev, "incomplete btt configuration\n");
1681 return -ENODEV;
1682 }
1683
1684 btt_sb = devm_kzalloc(&nd_btt->dev, sizeof(*btt_sb), GFP_KERNEL);
1685 if (!btt_sb)
1686 return -ENOMEM;
1687
1688 size = nvdimm_namespace_capacity(ndns);
1689 rc = devm_namespace_enable(&nd_btt->dev, ndns, size);
1690 if (rc)
1691 return rc;
1692
1693 /*
1694 * If this returns < 0, that is ok as it just means there wasn't
1695 * an existing BTT, and we're creating a new one. We still need to
1696 * call this as we need the version dependent fields in nd_btt to be
1697 * set correctly based on the holder class
1698 */
1699 nd_btt_version(nd_btt, ndns, btt_sb);
1700
1701 rawsize = size - nd_btt->initial_offset;
1702 if (rawsize < ARENA_MIN_SIZE) {
1703 dev_dbg(&nd_btt->dev, "%s must be at least %ld bytes\n",
1704 dev_name(&ndns->dev),
1705 ARENA_MIN_SIZE + nd_btt->initial_offset);
1706 return -ENXIO;
1707 }
1708 nd_region = to_nd_region(nd_btt->dev.parent);
1709 btt = btt_init(nd_btt, rawsize, nd_btt->lbasize, nd_btt->uuid,
1710 nd_region);
1711 if (!btt)
1712 return -ENOMEM;
1713 nd_btt->btt = btt;
1714
1715 return 0;
1716}
1717EXPORT_SYMBOL(nvdimm_namespace_attach_btt);
1718
1719int nvdimm_namespace_detach_btt(struct nd_btt *nd_btt)
1720{
1721 struct btt *btt = nd_btt->btt;
1722
1723 btt_fini(btt);
1724 nd_btt->btt = NULL;
1725
1726 return 0;
1727}
1728EXPORT_SYMBOL(nvdimm_namespace_detach_btt);
1729
1730static int __init nd_btt_init(void)
1731{
1732 int rc = 0;
1733
1734 debugfs_root = debugfs_create_dir("btt", NULL);
1735 if (IS_ERR_OR_NULL(debugfs_root))
1736 rc = -ENXIO;
1737
1738 return rc;
1739}
1740
1741static void __exit nd_btt_exit(void)
1742{
1743 debugfs_remove_recursive(debugfs_root);
1744}
1745
1746MODULE_ALIAS_ND_DEVICE(ND_DEVICE_BTT);
1747MODULE_AUTHOR("Vishal Verma <vishal.l.verma@linux.intel.com>");
1748MODULE_LICENSE("GPL v2");
1749module_init(nd_btt_init);
1750module_exit(nd_btt_exit);