zbd: Add a missing pthread_mutex_unlock() call
[fio.git] / zbd.c
1 /*
2  * Copyright (C) 2018 Western Digital Corporation or its affiliates.
3  *
4  * This file is released under the GPL.
5  */
6
7 #include <errno.h>
8 #include <string.h>
9 #include <stdlib.h>
10 #include <fcntl.h>
11 #include <sys/stat.h>
12 #include <unistd.h>
13
14 #include "os/os.h"
15 #include "file.h"
16 #include "fio.h"
17 #include "lib/pow2.h"
18 #include "log.h"
19 #include "oslib/asprintf.h"
20 #include "smalloc.h"
21 #include "verify.h"
22 #include "pshared.h"
23 #include "zbd.h"
24
25 /**
26  * zbd_get_zoned_model - Get a device zoned model
27  * @td: FIO thread data
28  * @f: FIO file for which to get model information
29  */
30 int zbd_get_zoned_model(struct thread_data *td, struct fio_file *f,
31                         enum zbd_zoned_model *model)
32 {
33         int ret;
34
35         if (td->io_ops && td->io_ops->get_zoned_model)
36                 ret = td->io_ops->get_zoned_model(td, f, model);
37         else
38                 ret = blkzoned_get_zoned_model(td, f, model);
39         if (ret < 0) {
40                 td_verror(td, errno, "get zoned model failed");
41                 log_err("%s: get zoned model failed (%d).\n",
42                         f->file_name, errno);
43         }
44
45         return ret;
46 }
47
48 /**
49  * zbd_report_zones - Get zone information
50  * @td: FIO thread data.
51  * @f: FIO file for which to get zone information
52  * @offset: offset from which to report zones
53  * @zones: Array of struct zbd_zone
54  * @nr_zones: Size of @zones array
55  *
56  * Get zone information into @zones starting from the zone at offset @offset
57  * for the device specified by @f.
58  *
59  * Returns the number of zones reported upon success and a negative error code
60  * upon failure. If the zone report is empty, always assume an error (device
61  * problem) and return -EIO.
62  */
63 int zbd_report_zones(struct thread_data *td, struct fio_file *f,
64                      uint64_t offset, struct zbd_zone *zones,
65                      unsigned int nr_zones)
66 {
67         int ret;
68
69         if (td->io_ops && td->io_ops->report_zones)
70                 ret = td->io_ops->report_zones(td, f, offset, zones, nr_zones);
71         else
72                 ret = blkzoned_report_zones(td, f, offset, zones, nr_zones);
73         if (ret < 0) {
74                 td_verror(td, errno, "report zones failed");
75                 log_err("%s: report zones from sector %llu failed (%d).\n",
76                         f->file_name, (unsigned long long)offset >> 9, errno);
77         } else if (ret == 0) {
78                 td_verror(td, errno, "Empty zone report");
79                 log_err("%s: report zones from sector %llu is empty.\n",
80                         f->file_name, (unsigned long long)offset >> 9);
81                 ret = -EIO;
82         }
83
84         return ret;
85 }
86
87 /**
88  * zbd_reset_wp - reset the write pointer of a range of zones
89  * @td: FIO thread data.
90  * @f: FIO file for which to reset zones
91  * @offset: Starting offset of the first zone to reset
92  * @length: Length of the range of zones to reset
93  *
94  * Reset the write pointer of all zones in the range @offset...@offset+@length.
95  * Returns 0 upon success and a negative error code upon failure.
96  */
97 int zbd_reset_wp(struct thread_data *td, struct fio_file *f,
98                  uint64_t offset, uint64_t length)
99 {
100         int ret;
101
102         if (td->io_ops && td->io_ops->reset_wp)
103                 ret = td->io_ops->reset_wp(td, f, offset, length);
104         else
105                 ret = blkzoned_reset_wp(td, f, offset, length);
106         if (ret < 0) {
107                 td_verror(td, errno, "resetting wp failed");
108                 log_err("%s: resetting wp for %llu sectors at sector %llu failed (%d).\n",
109                         f->file_name, (unsigned long long)length >> 9,
110                         (unsigned long long)offset >> 9, errno);
111         }
112
113         return ret;
114 }
115
116 /**
117  * zbd_zone_idx - convert an offset into a zone number
118  * @f: file pointer.
119  * @offset: offset in bytes. If this offset is in the first zone_size bytes
120  *          past the disk size then the index of the sentinel is returned.
121  */
122 static uint32_t zbd_zone_idx(const struct fio_file *f, uint64_t offset)
123 {
124         uint32_t zone_idx;
125
126         if (f->zbd_info->zone_size_log2 > 0)
127                 zone_idx = offset >> f->zbd_info->zone_size_log2;
128         else
129                 zone_idx = offset / f->zbd_info->zone_size;
130
131         return min(zone_idx, f->zbd_info->nr_zones);
132 }
133
134 /**
135  * zbd_zone_swr - Test whether a zone requires sequential writes
136  * @z: zone info pointer.
137  */
138 static inline bool zbd_zone_swr(struct fio_zone_info *z)
139 {
140         return z->type == ZBD_ZONE_TYPE_SWR;
141 }
142
143 /**
144  * zbd_zone_end - Return zone end location
145  * @z: zone info pointer.
146  */
147 static inline uint64_t zbd_zone_end(const struct fio_zone_info *z)
148 {
149         return (z+1)->start;
150 }
151
152 /**
153  * zbd_zone_capacity_end - Return zone capacity limit end location
154  * @z: zone info pointer.
155  */
156 static inline uint64_t zbd_zone_capacity_end(const struct fio_zone_info *z)
157 {
158         return z->start + z->capacity;
159 }
160
161 /**
162  * zbd_zone_full - verify whether a minimum number of bytes remain in a zone
163  * @f: file pointer.
164  * @z: zone info pointer.
165  * @required: minimum number of bytes that must remain in a zone.
166  *
167  * The caller must hold z->mutex.
168  */
169 static bool zbd_zone_full(const struct fio_file *f, struct fio_zone_info *z,
170                           uint64_t required)
171 {
172         assert((required & 511) == 0);
173
174         return zbd_zone_swr(z) &&
175                 z->wp + required > zbd_zone_capacity_end(z);
176 }
177
178 static void zone_lock(struct thread_data *td, struct fio_file *f, struct fio_zone_info *z)
179 {
180         struct zoned_block_device_info *zbd = f->zbd_info;
181         uint32_t nz = z - zbd->zone_info;
182
183         /* A thread should never lock zones outside its working area. */
184         assert(f->min_zone <= nz && nz < f->max_zone);
185
186         /*
187          * Lock the io_u target zone. The zone will be unlocked if io_u offset
188          * is changed or when io_u completes and zbd_put_io() executed.
189          * To avoid multiple jobs doing asynchronous I/Os from deadlocking each
190          * other waiting for zone locks when building an io_u batch, first
191          * only trylock the zone. If the zone is already locked by another job,
192          * process the currently queued I/Os so that I/O progress is made and
193          * zones unlocked.
194          */
195         if (pthread_mutex_trylock(&z->mutex) != 0) {
196                 if (!td_ioengine_flagged(td, FIO_SYNCIO))
197                         io_u_quiesce(td);
198                 pthread_mutex_lock(&z->mutex);
199         }
200 }
201
202 static bool is_valid_offset(const struct fio_file *f, uint64_t offset)
203 {
204         return (uint64_t)(offset - f->file_offset) < f->io_size;
205 }
206
207 /* Verify whether direct I/O is used for all host-managed zoned drives. */
208 static bool zbd_using_direct_io(void)
209 {
210         struct thread_data *td;
211         struct fio_file *f;
212         int i, j;
213
214         for_each_td(td, i) {
215                 if (td->o.odirect || !(td->o.td_ddir & TD_DDIR_WRITE))
216                         continue;
217                 for_each_file(td, f, j) {
218                         if (f->zbd_info &&
219                             f->zbd_info->model == ZBD_HOST_MANAGED)
220                                 return false;
221                 }
222         }
223
224         return true;
225 }
226
227 /* Whether or not the I/O range for f includes one or more sequential zones */
228 static bool zbd_is_seq_job(struct fio_file *f)
229 {
230         uint32_t zone_idx, zone_idx_b, zone_idx_e;
231
232         assert(f->zbd_info);
233         if (f->io_size == 0)
234                 return false;
235         zone_idx_b = zbd_zone_idx(f, f->file_offset);
236         zone_idx_e = zbd_zone_idx(f, f->file_offset + f->io_size - 1);
237         for (zone_idx = zone_idx_b; zone_idx <= zone_idx_e; zone_idx++)
238                 if (zbd_zone_swr(&f->zbd_info->zone_info[zone_idx]))
239                         return true;
240
241         return false;
242 }
243
244 /*
245  * Verify whether offset and size parameters are aligned with zone boundaries.
246  */
247 static bool zbd_verify_sizes(void)
248 {
249         const struct fio_zone_info *z;
250         struct thread_data *td;
251         struct fio_file *f;
252         uint64_t new_offset, new_end;
253         uint32_t zone_idx;
254         int i, j;
255
256         for_each_td(td, i) {
257                 for_each_file(td, f, j) {
258                         if (!f->zbd_info)
259                                 continue;
260                         if (f->file_offset >= f->real_file_size)
261                                 continue;
262                         if (!zbd_is_seq_job(f))
263                                 continue;
264
265                         if (!td->o.zone_size) {
266                                 td->o.zone_size = f->zbd_info->zone_size;
267                                 if (!td->o.zone_size) {
268                                         log_err("%s: invalid 0 zone size\n",
269                                                 f->file_name);
270                                         return false;
271                                 }
272                         } else if (td->o.zone_size != f->zbd_info->zone_size) {
273                                 log_err("%s: job parameter zonesize %llu does not match disk zone size %llu.\n",
274                                         f->file_name, (unsigned long long) td->o.zone_size,
275                                         (unsigned long long) f->zbd_info->zone_size);
276                                 return false;
277                         }
278
279                         if (td->o.zone_skip &&
280                             (td->o.zone_skip < td->o.zone_size ||
281                              td->o.zone_skip % td->o.zone_size)) {
282                                 log_err("%s: zoneskip %llu is not a multiple of the device zone size %llu.\n",
283                                         f->file_name, (unsigned long long) td->o.zone_skip,
284                                         (unsigned long long) td->o.zone_size);
285                                 return false;
286                         }
287
288                         zone_idx = zbd_zone_idx(f, f->file_offset);
289                         z = &f->zbd_info->zone_info[zone_idx];
290                         if ((f->file_offset != z->start) &&
291                             (td->o.td_ddir != TD_DDIR_READ)) {
292                                 new_offset = zbd_zone_end(z);
293                                 if (new_offset >= f->file_offset + f->io_size) {
294                                         log_info("%s: io_size must be at least one zone\n",
295                                                  f->file_name);
296                                         return false;
297                                 }
298                                 log_info("%s: rounded up offset from %llu to %llu\n",
299                                          f->file_name, (unsigned long long) f->file_offset,
300                                          (unsigned long long) new_offset);
301                                 f->io_size -= (new_offset - f->file_offset);
302                                 f->file_offset = new_offset;
303                         }
304                         zone_idx = zbd_zone_idx(f, f->file_offset + f->io_size);
305                         z = &f->zbd_info->zone_info[zone_idx];
306                         new_end = z->start;
307                         if ((td->o.td_ddir != TD_DDIR_READ) &&
308                             (f->file_offset + f->io_size != new_end)) {
309                                 if (new_end <= f->file_offset) {
310                                         log_info("%s: io_size must be at least one zone\n",
311                                                  f->file_name);
312                                         return false;
313                                 }
314                                 log_info("%s: rounded down io_size from %llu to %llu\n",
315                                          f->file_name, (unsigned long long) f->io_size,
316                                          (unsigned long long) new_end - f->file_offset);
317                                 f->io_size = new_end - f->file_offset;
318                         }
319
320                         f->min_zone = zbd_zone_idx(f, f->file_offset);
321                         f->max_zone = zbd_zone_idx(f, f->file_offset + f->io_size);
322                         assert(f->min_zone < f->max_zone);
323                 }
324         }
325
326         return true;
327 }
328
329 static bool zbd_verify_bs(void)
330 {
331         struct thread_data *td;
332         struct fio_file *f;
333         uint32_t zone_size;
334         int i, j, k;
335
336         for_each_td(td, i) {
337                 for_each_file(td, f, j) {
338                         if (!f->zbd_info)
339                                 continue;
340                         zone_size = f->zbd_info->zone_size;
341                         for (k = 0; k < ARRAY_SIZE(td->o.bs); k++) {
342                                 if (td->o.verify != VERIFY_NONE &&
343                                     zone_size % td->o.bs[k] != 0) {
344                                         log_info("%s: block size %llu is not a divisor of the zone size %d\n",
345                                                  f->file_name, td->o.bs[k],
346                                                  zone_size);
347                                         return false;
348                                 }
349                         }
350                 }
351         }
352         return true;
353 }
354
355 static int ilog2(uint64_t i)
356 {
357         int log = -1;
358
359         while (i) {
360                 i >>= 1;
361                 log++;
362         }
363         return log;
364 }
365
366 /*
367  * Initialize f->zbd_info for devices that are not zoned block devices. This
368  * allows to execute a ZBD workload against a non-ZBD device.
369  */
370 static int init_zone_info(struct thread_data *td, struct fio_file *f)
371 {
372         uint32_t nr_zones;
373         struct fio_zone_info *p;
374         uint64_t zone_size = td->o.zone_size;
375         uint64_t zone_capacity = td->o.zone_capacity;
376         struct zoned_block_device_info *zbd_info = NULL;
377         int i;
378
379         if (zone_size == 0) {
380                 log_err("%s: Specifying the zone size is mandatory for regular block devices with --zonemode=zbd\n\n",
381                         f->file_name);
382                 return 1;
383         }
384
385         if (zone_size < 512) {
386                 log_err("%s: zone size must be at least 512 bytes for --zonemode=zbd\n\n",
387                         f->file_name);
388                 return 1;
389         }
390
391         if (zone_capacity == 0)
392                 zone_capacity = zone_size;
393
394         if (zone_capacity > zone_size) {
395                 log_err("%s: job parameter zonecapacity %llu is larger than zone size %llu\n",
396                         f->file_name, (unsigned long long) td->o.zone_capacity,
397                         (unsigned long long) td->o.zone_size);
398                 return 1;
399         }
400
401         nr_zones = (f->real_file_size + zone_size - 1) / zone_size;
402         zbd_info = scalloc(1, sizeof(*zbd_info) +
403                            (nr_zones + 1) * sizeof(zbd_info->zone_info[0]));
404         if (!zbd_info)
405                 return -ENOMEM;
406
407         mutex_init_pshared(&zbd_info->mutex);
408         zbd_info->refcount = 1;
409         p = &zbd_info->zone_info[0];
410         for (i = 0; i < nr_zones; i++, p++) {
411                 mutex_init_pshared_with_type(&p->mutex,
412                                              PTHREAD_MUTEX_RECURSIVE);
413                 p->start = i * zone_size;
414                 p->wp = p->start;
415                 p->type = ZBD_ZONE_TYPE_SWR;
416                 p->cond = ZBD_ZONE_COND_EMPTY;
417                 p->capacity = zone_capacity;
418         }
419         /* a sentinel */
420         p->start = nr_zones * zone_size;
421
422         f->zbd_info = zbd_info;
423         f->zbd_info->zone_size = zone_size;
424         f->zbd_info->zone_size_log2 = is_power_of_2(zone_size) ?
425                 ilog2(zone_size) : 0;
426         f->zbd_info->nr_zones = nr_zones;
427         return 0;
428 }
429
430 /*
431  * Maximum number of zones to report in one operation.
432  */
433 #define ZBD_REPORT_MAX_ZONES    8192U
434
435 /*
436  * Parse the device zone report and store it in f->zbd_info. Must be called
437  * only for devices that are zoned, namely those with a model != ZBD_NONE.
438  */
439 static int parse_zone_info(struct thread_data *td, struct fio_file *f)
440 {
441         int nr_zones, nrz;
442         struct zbd_zone *zones, *z;
443         struct fio_zone_info *p;
444         uint64_t zone_size, offset;
445         struct zoned_block_device_info *zbd_info = NULL;
446         int i, j, ret = 0;
447
448         zones = calloc(ZBD_REPORT_MAX_ZONES, sizeof(struct zbd_zone));
449         if (!zones)
450                 goto out;
451
452         nrz = zbd_report_zones(td, f, 0, zones, ZBD_REPORT_MAX_ZONES);
453         if (nrz < 0) {
454                 ret = nrz;
455                 log_info("fio: report zones (offset 0) failed for %s (%d).\n",
456                          f->file_name, -ret);
457                 goto out;
458         }
459
460         zone_size = zones[0].len;
461         nr_zones = (f->real_file_size + zone_size - 1) / zone_size;
462
463         if (td->o.zone_size == 0) {
464                 td->o.zone_size = zone_size;
465         } else if (td->o.zone_size != zone_size) {
466                 log_err("fio: %s job parameter zonesize %llu does not match disk zone size %llu.\n",
467                         f->file_name, (unsigned long long) td->o.zone_size,
468                         (unsigned long long) zone_size);
469                 ret = -EINVAL;
470                 goto out;
471         }
472
473         dprint(FD_ZBD, "Device %s has %d zones of size %llu KB\n", f->file_name,
474                nr_zones, (unsigned long long) zone_size / 1024);
475
476         zbd_info = scalloc(1, sizeof(*zbd_info) +
477                            (nr_zones + 1) * sizeof(zbd_info->zone_info[0]));
478         ret = -ENOMEM;
479         if (!zbd_info)
480                 goto out;
481         mutex_init_pshared(&zbd_info->mutex);
482         zbd_info->refcount = 1;
483         p = &zbd_info->zone_info[0];
484         for (offset = 0, j = 0; j < nr_zones;) {
485                 z = &zones[0];
486                 for (i = 0; i < nrz; i++, j++, z++, p++) {
487                         mutex_init_pshared_with_type(&p->mutex,
488                                                      PTHREAD_MUTEX_RECURSIVE);
489                         p->start = z->start;
490                         p->capacity = z->capacity;
491                         switch (z->cond) {
492                         case ZBD_ZONE_COND_NOT_WP:
493                         case ZBD_ZONE_COND_FULL:
494                                 p->wp = p->start + p->capacity;
495                                 break;
496                         default:
497                                 assert(z->start <= z->wp);
498                                 assert(z->wp <= z->start + zone_size);
499                                 p->wp = z->wp;
500                                 break;
501                         }
502                         p->type = z->type;
503                         p->cond = z->cond;
504                         if (j > 0 && p->start != p[-1].start + zone_size) {
505                                 log_info("%s: invalid zone data\n",
506                                          f->file_name);
507                                 ret = -EINVAL;
508                                 goto out;
509                         }
510                 }
511                 z--;
512                 offset = z->start + z->len;
513                 if (j >= nr_zones)
514                         break;
515                 nrz = zbd_report_zones(td, f, offset,
516                                             zones, ZBD_REPORT_MAX_ZONES);
517                 if (nrz < 0) {
518                         ret = nrz;
519                         log_info("fio: report zones (offset %llu) failed for %s (%d).\n",
520                                  (unsigned long long)offset,
521                                  f->file_name, -ret);
522                         goto out;
523                 }
524         }
525
526         /* a sentinel */
527         zbd_info->zone_info[nr_zones].start = offset;
528
529         f->zbd_info = zbd_info;
530         f->zbd_info->zone_size = zone_size;
531         f->zbd_info->zone_size_log2 = is_power_of_2(zone_size) ?
532                 ilog2(zone_size) : 0;
533         f->zbd_info->nr_zones = nr_zones;
534         zbd_info = NULL;
535         ret = 0;
536
537 out:
538         sfree(zbd_info);
539         free(zones);
540         return ret;
541 }
542
543 /*
544  * Allocate zone information and store it into f->zbd_info if zonemode=zbd.
545  *
546  * Returns 0 upon success and a negative error code upon failure.
547  */
548 static int zbd_create_zone_info(struct thread_data *td, struct fio_file *f)
549 {
550         enum zbd_zoned_model zbd_model;
551         int ret;
552
553         assert(td->o.zone_mode == ZONE_MODE_ZBD);
554
555         ret = zbd_get_zoned_model(td, f, &zbd_model);
556         if (ret)
557                 return ret;
558
559         switch (zbd_model) {
560         case ZBD_IGNORE:
561                 return 0;
562         case ZBD_HOST_AWARE:
563         case ZBD_HOST_MANAGED:
564                 ret = parse_zone_info(td, f);
565                 break;
566         case ZBD_NONE:
567                 ret = init_zone_info(td, f);
568                 break;
569         default:
570                 td_verror(td, EINVAL, "Unsupported zoned model");
571                 log_err("Unsupported zoned model\n");
572                 return -EINVAL;
573         }
574
575         if (ret == 0) {
576                 f->zbd_info->model = zbd_model;
577                 f->zbd_info->max_open_zones = td->o.max_open_zones;
578         }
579         return ret;
580 }
581
582 void zbd_free_zone_info(struct fio_file *f)
583 {
584         uint32_t refcount;
585
586         assert(f->zbd_info);
587
588         pthread_mutex_lock(&f->zbd_info->mutex);
589         refcount = --f->zbd_info->refcount;
590         pthread_mutex_unlock(&f->zbd_info->mutex);
591
592         assert((int32_t)refcount >= 0);
593         if (refcount == 0)
594                 sfree(f->zbd_info);
595         f->zbd_info = NULL;
596 }
597
598 /*
599  * Initialize f->zbd_info.
600  *
601  * Returns 0 upon success and a negative error code upon failure.
602  *
603  * Note: this function can only work correctly if it is called before the first
604  * fio fork() call.
605  */
606 static int zbd_init_zone_info(struct thread_data *td, struct fio_file *file)
607 {
608         struct thread_data *td2;
609         struct fio_file *f2;
610         int i, j, ret;
611
612         for_each_td(td2, i) {
613                 for_each_file(td2, f2, j) {
614                         if (td2 == td && f2 == file)
615                                 continue;
616                         if (!f2->zbd_info ||
617                             strcmp(f2->file_name, file->file_name) != 0)
618                                 continue;
619                         file->zbd_info = f2->zbd_info;
620                         file->zbd_info->refcount++;
621                         return 0;
622                 }
623         }
624
625         ret = zbd_create_zone_info(td, file);
626         if (ret < 0)
627                 td_verror(td, -ret, "zbd_create_zone_info() failed");
628         return ret;
629 }
630
631 static bool zbd_open_zone(struct thread_data *td, const struct fio_file *f,
632                           uint32_t zone_idx);
633 static int zbd_reset_zone(struct thread_data *td, struct fio_file *f,
634                           struct fio_zone_info *z);
635
636 int zbd_setup_files(struct thread_data *td)
637 {
638         struct fio_file *f;
639         int i;
640
641         for_each_file(td, f, i) {
642                 if (zbd_init_zone_info(td, f))
643                         return 1;
644         }
645
646         if (!zbd_using_direct_io()) {
647                 log_err("Using direct I/O is mandatory for writing to ZBD drives\n\n");
648                 return 1;
649         }
650
651         if (!zbd_verify_sizes())
652                 return 1;
653
654         if (!zbd_verify_bs())
655                 return 1;
656
657         for_each_file(td, f, i) {
658                 struct zoned_block_device_info *zbd = f->zbd_info;
659                 struct fio_zone_info *z;
660                 int zi;
661
662                 if (!zbd)
663                         continue;
664
665                 zbd->max_open_zones = zbd->max_open_zones ?: ZBD_MAX_OPEN_ZONES;
666
667                 if (td->o.max_open_zones > 0 &&
668                     zbd->max_open_zones != td->o.max_open_zones) {
669                         log_err("Different 'max_open_zones' values\n");
670                         return 1;
671                 }
672                 if (zbd->max_open_zones > ZBD_MAX_OPEN_ZONES) {
673                         log_err("'max_open_zones' value is limited by %u\n", ZBD_MAX_OPEN_ZONES);
674                         return 1;
675                 }
676
677                 for (zi = f->min_zone; zi < f->max_zone; zi++) {
678                         z = &zbd->zone_info[zi];
679                         if (z->cond != ZBD_ZONE_COND_IMP_OPEN &&
680                             z->cond != ZBD_ZONE_COND_EXP_OPEN)
681                                 continue;
682                         if (zbd_open_zone(td, f, zi))
683                                 continue;
684                         /*
685                          * If the number of open zones exceeds specified limits,
686                          * reset all extra open zones.
687                          */
688                         if (zbd_reset_zone(td, f, z) < 0) {
689                                 log_err("Failed to reest zone %d\n", zi);
690                                 return 1;
691                         }
692                 }
693         }
694
695         return 0;
696 }
697
698 static unsigned int zbd_zone_nr(struct zoned_block_device_info *zbd_info,
699                                 struct fio_zone_info *zone)
700 {
701         return zone - zbd_info->zone_info;
702 }
703
704 /**
705  * zbd_reset_zone - reset the write pointer of a single zone
706  * @td: FIO thread data.
707  * @f: FIO file associated with the disk for which to reset a write pointer.
708  * @z: Zone to reset.
709  *
710  * Returns 0 upon success and a negative error code upon failure.
711  *
712  * The caller must hold z->mutex.
713  */
714 static int zbd_reset_zone(struct thread_data *td, struct fio_file *f,
715                           struct fio_zone_info *z)
716 {
717         uint64_t offset = z->start;
718         uint64_t length = (z+1)->start - offset;
719         int ret = 0;
720
721         assert(is_valid_offset(f, offset + length - 1));
722
723         dprint(FD_ZBD, "%s: resetting wp of zone %u.\n", f->file_name,
724                 zbd_zone_nr(f->zbd_info, z));
725         switch (f->zbd_info->model) {
726         case ZBD_HOST_AWARE:
727         case ZBD_HOST_MANAGED:
728                 ret = zbd_reset_wp(td, f, offset, length);
729                 if (ret < 0)
730                         return ret;
731                 break;
732         default:
733                 break;
734         }
735
736         pthread_mutex_lock(&f->zbd_info->mutex);
737         f->zbd_info->sectors_with_data -= z->wp - z->start;
738         pthread_mutex_unlock(&f->zbd_info->mutex);
739         z->wp = z->start;
740         z->verify_block = 0;
741
742         td->ts.nr_zone_resets++;
743
744         return ret;
745 }
746
747 /* The caller must hold f->zbd_info->mutex */
748 static void zbd_close_zone(struct thread_data *td, const struct fio_file *f,
749                            unsigned int zone_idx)
750 {
751         uint32_t open_zone_idx = 0;
752
753         for (; open_zone_idx < f->zbd_info->num_open_zones; open_zone_idx++) {
754                 if (f->zbd_info->open_zones[open_zone_idx] == zone_idx)
755                         break;
756         }
757         if (open_zone_idx == f->zbd_info->num_open_zones) {
758                 dprint(FD_ZBD, "%s: zone %d is not open\n",
759                        f->file_name, zone_idx);
760                 return;
761         }
762
763         dprint(FD_ZBD, "%s: closing zone %d\n", f->file_name, zone_idx);
764         memmove(f->zbd_info->open_zones + open_zone_idx,
765                 f->zbd_info->open_zones + open_zone_idx + 1,
766                 (ZBD_MAX_OPEN_ZONES - (open_zone_idx + 1)) *
767                 sizeof(f->zbd_info->open_zones[0]));
768         f->zbd_info->num_open_zones--;
769         td->num_open_zones--;
770         f->zbd_info->zone_info[zone_idx].open = 0;
771 }
772
773 /*
774  * Reset a range of zones. Returns 0 upon success and 1 upon failure.
775  * @td: fio thread data.
776  * @f: fio file for which to reset zones
777  * @zb: first zone to reset.
778  * @ze: first zone not to reset.
779  * @all_zones: whether to reset all zones or only those zones for which the
780  *      write pointer is not a multiple of td->o.min_bs[DDIR_WRITE].
781  */
782 static int zbd_reset_zones(struct thread_data *td, struct fio_file *f,
783                            struct fio_zone_info *const zb,
784                            struct fio_zone_info *const ze, bool all_zones)
785 {
786         struct fio_zone_info *z;
787         const uint32_t min_bs = td->o.min_bs[DDIR_WRITE];
788         bool reset_wp;
789         int res = 0;
790
791         assert(min_bs);
792
793         dprint(FD_ZBD, "%s: examining zones %u .. %u\n", f->file_name,
794                 zbd_zone_nr(f->zbd_info, zb), zbd_zone_nr(f->zbd_info, ze));
795         for (z = zb; z < ze; z++) {
796                 uint32_t nz = z - f->zbd_info->zone_info;
797
798                 if (!zbd_zone_swr(z))
799                         continue;
800                 zone_lock(td, f, z);
801                 if (all_zones) {
802                         pthread_mutex_lock(&f->zbd_info->mutex);
803                         zbd_close_zone(td, f, nz);
804                         pthread_mutex_unlock(&f->zbd_info->mutex);
805
806                         reset_wp = z->wp != z->start;
807                 } else {
808                         reset_wp = z->wp % min_bs != 0;
809                 }
810                 if (reset_wp) {
811                         dprint(FD_ZBD, "%s: resetting zone %u\n",
812                                f->file_name,
813                                zbd_zone_nr(f->zbd_info, z));
814                         if (zbd_reset_zone(td, f, z) < 0)
815                                 res = 1;
816                 }
817                 pthread_mutex_unlock(&z->mutex);
818         }
819
820         return res;
821 }
822
823 /*
824  * Reset zbd_info.write_cnt, the counter that counts down towards the next
825  * zone reset.
826  */
827 static void _zbd_reset_write_cnt(const struct thread_data *td,
828                                  const struct fio_file *f)
829 {
830         assert(0 <= td->o.zrf.u.f && td->o.zrf.u.f <= 1);
831
832         f->zbd_info->write_cnt = td->o.zrf.u.f ?
833                 min(1.0 / td->o.zrf.u.f, 0.0 + UINT_MAX) : UINT_MAX;
834 }
835
836 static void zbd_reset_write_cnt(const struct thread_data *td,
837                                 const struct fio_file *f)
838 {
839         pthread_mutex_lock(&f->zbd_info->mutex);
840         _zbd_reset_write_cnt(td, f);
841         pthread_mutex_unlock(&f->zbd_info->mutex);
842 }
843
844 static bool zbd_dec_and_reset_write_cnt(const struct thread_data *td,
845                                         const struct fio_file *f)
846 {
847         uint32_t write_cnt = 0;
848
849         pthread_mutex_lock(&f->zbd_info->mutex);
850         assert(f->zbd_info->write_cnt);
851         if (f->zbd_info->write_cnt)
852                 write_cnt = --f->zbd_info->write_cnt;
853         if (write_cnt == 0)
854                 _zbd_reset_write_cnt(td, f);
855         pthread_mutex_unlock(&f->zbd_info->mutex);
856
857         return write_cnt == 0;
858 }
859
860 enum swd_action {
861         CHECK_SWD,
862         SET_SWD,
863 };
864
865 /* Calculate the number of sectors with data (swd) and perform action 'a' */
866 static uint64_t zbd_process_swd(const struct fio_file *f, enum swd_action a)
867 {
868         struct fio_zone_info *zb, *ze, *z;
869         uint64_t swd = 0;
870
871         zb = &f->zbd_info->zone_info[f->min_zone];
872         ze = &f->zbd_info->zone_info[f->max_zone];
873         for (z = zb; z < ze; z++) {
874                 pthread_mutex_lock(&z->mutex);
875                 swd += z->wp - z->start;
876         }
877         pthread_mutex_lock(&f->zbd_info->mutex);
878         switch (a) {
879         case CHECK_SWD:
880                 assert(f->zbd_info->sectors_with_data == swd);
881                 break;
882         case SET_SWD:
883                 f->zbd_info->sectors_with_data = swd;
884                 break;
885         }
886         pthread_mutex_unlock(&f->zbd_info->mutex);
887         for (z = zb; z < ze; z++)
888                 pthread_mutex_unlock(&z->mutex);
889
890         return swd;
891 }
892
893 /*
894  * The swd check is useful for debugging but takes too much time to leave
895  * it enabled all the time. Hence it is disabled by default.
896  */
897 static const bool enable_check_swd = false;
898
899 /* Check whether the value of zbd_info.sectors_with_data is correct. */
900 static void zbd_check_swd(const struct fio_file *f)
901 {
902         if (!enable_check_swd)
903                 return;
904
905         zbd_process_swd(f, CHECK_SWD);
906 }
907
908 static void zbd_init_swd(struct fio_file *f)
909 {
910         uint64_t swd;
911
912         if (!enable_check_swd)
913                 return;
914
915         swd = zbd_process_swd(f, SET_SWD);
916         dprint(FD_ZBD, "%s(%s): swd = %" PRIu64 "\n", __func__, f->file_name,
917                swd);
918 }
919
920 void zbd_file_reset(struct thread_data *td, struct fio_file *f)
921 {
922         struct fio_zone_info *zb, *ze;
923
924         if (!f->zbd_info || !td_write(td))
925                 return;
926
927         zb = &f->zbd_info->zone_info[f->min_zone];
928         ze = &f->zbd_info->zone_info[f->max_zone];
929         zbd_init_swd(f);
930         /*
931          * If data verification is enabled reset the affected zones before
932          * writing any data to avoid that a zone reset has to be issued while
933          * writing data, which causes data loss.
934          */
935         zbd_reset_zones(td, f, zb, ze, td->o.verify != VERIFY_NONE &&
936                         td->runstate != TD_VERIFYING);
937         zbd_reset_write_cnt(td, f);
938 }
939
940 /* The caller must hold f->zbd_info->mutex. */
941 static bool is_zone_open(const struct thread_data *td, const struct fio_file *f,
942                          unsigned int zone_idx)
943 {
944         struct zoned_block_device_info *zbdi = f->zbd_info;
945         int i;
946
947         assert(td->o.job_max_open_zones == 0 || td->num_open_zones <= td->o.job_max_open_zones);
948         assert(td->o.job_max_open_zones <= zbdi->max_open_zones);
949         assert(zbdi->num_open_zones <= zbdi->max_open_zones);
950
951         for (i = 0; i < zbdi->num_open_zones; i++)
952                 if (zbdi->open_zones[i] == zone_idx)
953                         return true;
954
955         return false;
956 }
957
958 /*
959  * Open a ZBD zone if it was not yet open. Returns true if either the zone was
960  * already open or if opening a new zone is allowed. Returns false if the zone
961  * was not yet open and opening a new zone would cause the zone limit to be
962  * exceeded.
963  */
964 static bool zbd_open_zone(struct thread_data *td, const struct fio_file *f,
965                           uint32_t zone_idx)
966 {
967         const uint32_t min_bs = td->o.min_bs[DDIR_WRITE];
968         struct fio_zone_info *z = &f->zbd_info->zone_info[zone_idx];
969         bool res = true;
970
971         if (z->cond == ZBD_ZONE_COND_OFFLINE)
972                 return false;
973
974         /*
975          * Skip full zones with data verification enabled because resetting a
976          * zone causes data loss and hence causes verification to fail.
977          */
978         if (td->o.verify != VERIFY_NONE && zbd_zone_full(f, z, min_bs))
979                 return false;
980
981         pthread_mutex_lock(&f->zbd_info->mutex);
982         if (is_zone_open(td, f, zone_idx)) {
983                 /*
984                  * If the zone is already open and going to be full by writes
985                  * in-flight, handle it as a full zone instead of an open zone.
986                  */
987                 if (z->wp >= zbd_zone_capacity_end(z))
988                         res = false;
989                 goto out;
990         }
991         res = false;
992         /* Zero means no limit */
993         if (td->o.job_max_open_zones > 0 &&
994             td->num_open_zones >= td->o.job_max_open_zones)
995                 goto out;
996         if (f->zbd_info->num_open_zones >= f->zbd_info->max_open_zones)
997                 goto out;
998         dprint(FD_ZBD, "%s: opening zone %d\n", f->file_name, zone_idx);
999         f->zbd_info->open_zones[f->zbd_info->num_open_zones++] = zone_idx;
1000         td->num_open_zones++;
1001         z->open = 1;
1002         res = true;
1003
1004 out:
1005         pthread_mutex_unlock(&f->zbd_info->mutex);
1006         return res;
1007 }
1008
1009 /* Anything goes as long as it is not a constant. */
1010 static uint32_t pick_random_zone_idx(const struct fio_file *f,
1011                                      const struct io_u *io_u)
1012 {
1013         return io_u->offset * f->zbd_info->num_open_zones / f->real_file_size;
1014 }
1015
1016 /*
1017  * Modify the offset of an I/O unit that does not refer to an open zone such
1018  * that it refers to an open zone. Close an open zone and open a new zone if
1019  * necessary. This algorithm can only work correctly if all write pointers are
1020  * a multiple of the fio block size. The caller must neither hold z->mutex
1021  * nor f->zbd_info->mutex. Returns with z->mutex held upon success.
1022  */
1023 static struct fio_zone_info *zbd_convert_to_open_zone(struct thread_data *td,
1024                                                       struct io_u *io_u)
1025 {
1026         const uint32_t min_bs = td->o.min_bs[io_u->ddir];
1027         struct fio_file *f = io_u->file;
1028         struct fio_zone_info *z;
1029         unsigned int open_zone_idx = -1;
1030         uint32_t zone_idx, new_zone_idx;
1031         int i;
1032         bool wait_zone_close;
1033
1034         assert(is_valid_offset(f, io_u->offset));
1035
1036         if (td->o.max_open_zones || td->o.job_max_open_zones) {
1037                 /*
1038                  * This statement accesses f->zbd_info->open_zones[] on purpose
1039                  * without locking.
1040                  */
1041                 zone_idx = f->zbd_info->open_zones[pick_random_zone_idx(f, io_u)];
1042         } else {
1043                 zone_idx = zbd_zone_idx(f, io_u->offset);
1044         }
1045         if (zone_idx < f->min_zone)
1046                 zone_idx = f->min_zone;
1047         else if (zone_idx >= f->max_zone)
1048                 zone_idx = f->max_zone - 1;
1049         dprint(FD_ZBD, "%s(%s): starting from zone %d (offset %lld, buflen %lld)\n",
1050                __func__, f->file_name, zone_idx, io_u->offset, io_u->buflen);
1051
1052         /*
1053          * Since z->mutex is the outer lock and f->zbd_info->mutex the inner
1054          * lock it can happen that the state of the zone with index zone_idx
1055          * has changed after 'z' has been assigned and before f->zbd_info->mutex
1056          * has been obtained. Hence the loop.
1057          */
1058         for (;;) {
1059                 uint32_t tmp_idx;
1060
1061                 z = &f->zbd_info->zone_info[zone_idx];
1062
1063                 zone_lock(td, f, z);
1064                 pthread_mutex_lock(&f->zbd_info->mutex);
1065                 if (td->o.max_open_zones == 0 && td->o.job_max_open_zones == 0)
1066                         goto examine_zone;
1067                 if (f->zbd_info->num_open_zones == 0) {
1068                         dprint(FD_ZBD, "%s(%s): no zones are open\n",
1069                                __func__, f->file_name);
1070                         goto open_other_zone;
1071                 }
1072
1073                 /*
1074                  * List of opened zones is per-device, shared across all threads.
1075                  * Start with quasi-random candidate zone.
1076                  * Ignore zones which don't belong to thread's offset/size area.
1077                  */
1078                 open_zone_idx = pick_random_zone_idx(f, io_u);
1079                 assert(open_zone_idx < f->zbd_info->num_open_zones);
1080                 tmp_idx = open_zone_idx;
1081                 for (i = 0; i < f->zbd_info->num_open_zones; i++) {
1082                         uint32_t tmpz;
1083
1084                         if (tmp_idx >= f->zbd_info->num_open_zones)
1085                                 tmp_idx = 0;
1086                         tmpz = f->zbd_info->open_zones[tmp_idx];
1087                         if (f->min_zone <= tmpz && tmpz < f->max_zone) {
1088                                 open_zone_idx = tmp_idx;
1089                                 goto found_candidate_zone;
1090                         }
1091
1092                         tmp_idx++;
1093                 }
1094
1095                 dprint(FD_ZBD, "%s(%s): no candidate zone\n",
1096                         __func__, f->file_name);
1097                 pthread_mutex_unlock(&f->zbd_info->mutex);
1098                 pthread_mutex_unlock(&z->mutex);
1099                 return NULL;
1100
1101 found_candidate_zone:
1102                 new_zone_idx = f->zbd_info->open_zones[open_zone_idx];
1103                 if (new_zone_idx == zone_idx)
1104                         break;
1105                 zone_idx = new_zone_idx;
1106                 pthread_mutex_unlock(&f->zbd_info->mutex);
1107                 pthread_mutex_unlock(&z->mutex);
1108         }
1109
1110         /* Both z->mutex and f->zbd_info->mutex are held. */
1111
1112 examine_zone:
1113         if (z->wp + min_bs <= zbd_zone_capacity_end(z)) {
1114                 pthread_mutex_unlock(&f->zbd_info->mutex);
1115                 goto out;
1116         }
1117
1118 open_other_zone:
1119         /* Check if number of open zones reaches one of limits. */
1120         wait_zone_close =
1121                 f->zbd_info->num_open_zones == f->max_zone - f->min_zone ||
1122                 (td->o.max_open_zones &&
1123                  f->zbd_info->num_open_zones == td->o.max_open_zones) ||
1124                 (td->o.job_max_open_zones &&
1125                  td->num_open_zones == td->o.job_max_open_zones);
1126
1127         pthread_mutex_unlock(&f->zbd_info->mutex);
1128
1129         /* Only z->mutex is held. */
1130
1131         /*
1132          * When number of open zones reaches to one of limits, wait for
1133          * zone close before opening a new zone.
1134          */
1135         if (wait_zone_close) {
1136                 dprint(FD_ZBD, "%s(%s): quiesce to allow open zones to close\n",
1137                        __func__, f->file_name);
1138                 io_u_quiesce(td);
1139         }
1140
1141         /* Zone 'z' is full, so try to open a new zone. */
1142         for (i = f->io_size / f->zbd_info->zone_size; i > 0; i--) {
1143                 zone_idx++;
1144                 pthread_mutex_unlock(&z->mutex);
1145                 z++;
1146                 if (!is_valid_offset(f, z->start)) {
1147                         /* Wrap-around. */
1148                         zone_idx = f->min_zone;
1149                         z = &f->zbd_info->zone_info[zone_idx];
1150                 }
1151                 assert(is_valid_offset(f, z->start));
1152                 zone_lock(td, f, z);
1153                 if (z->open)
1154                         continue;
1155                 if (zbd_open_zone(td, f, zone_idx))
1156                         goto out;
1157         }
1158
1159         /* Only z->mutex is held. */
1160
1161         /* Check whether the write fits in any of the already opened zones. */
1162         pthread_mutex_lock(&f->zbd_info->mutex);
1163         for (i = 0; i < f->zbd_info->num_open_zones; i++) {
1164                 zone_idx = f->zbd_info->open_zones[i];
1165                 if (zone_idx < f->min_zone || zone_idx >= f->max_zone)
1166                         continue;
1167                 pthread_mutex_unlock(&f->zbd_info->mutex);
1168                 pthread_mutex_unlock(&z->mutex);
1169
1170                 z = &f->zbd_info->zone_info[zone_idx];
1171
1172                 zone_lock(td, f, z);
1173                 if (z->wp + min_bs <= zbd_zone_capacity_end(z))
1174                         goto out;
1175                 pthread_mutex_lock(&f->zbd_info->mutex);
1176         }
1177         pthread_mutex_unlock(&f->zbd_info->mutex);
1178         pthread_mutex_unlock(&z->mutex);
1179         dprint(FD_ZBD, "%s(%s): did not open another zone\n", __func__,
1180                f->file_name);
1181         return NULL;
1182
1183 out:
1184         dprint(FD_ZBD, "%s(%s): returning zone %d\n", __func__, f->file_name,
1185                zone_idx);
1186         io_u->offset = z->start;
1187         return z;
1188 }
1189
1190 /* The caller must hold z->mutex. */
1191 static struct fio_zone_info *zbd_replay_write_order(struct thread_data *td,
1192                                                     struct io_u *io_u,
1193                                                     struct fio_zone_info *z)
1194 {
1195         const struct fio_file *f = io_u->file;
1196         const uint32_t min_bs = td->o.min_bs[DDIR_WRITE];
1197
1198         if (!zbd_open_zone(td, f, z - f->zbd_info->zone_info)) {
1199                 pthread_mutex_unlock(&z->mutex);
1200                 z = zbd_convert_to_open_zone(td, io_u);
1201                 assert(z);
1202         }
1203
1204         if (z->verify_block * min_bs >= z->capacity)
1205                 log_err("%s: %d * %d >= %llu\n", f->file_name, z->verify_block,
1206                         min_bs, (unsigned long long)z->capacity);
1207         io_u->offset = z->start + z->verify_block++ * min_bs;
1208         return z;
1209 }
1210
1211 /*
1212  * Find another zone for which @io_u fits below the write pointer. Start
1213  * searching in zones @zb + 1 .. @zl and continue searching in zones
1214  * @zf .. @zb - 1.
1215  *
1216  * Either returns NULL or returns a zone pointer and holds the mutex for that
1217  * zone.
1218  */
1219 static struct fio_zone_info *
1220 zbd_find_zone(struct thread_data *td, struct io_u *io_u,
1221               struct fio_zone_info *zb, struct fio_zone_info *zl)
1222 {
1223         const uint32_t min_bs = td->o.min_bs[io_u->ddir];
1224         struct fio_file *f = io_u->file;
1225         struct fio_zone_info *z1, *z2;
1226         const struct fio_zone_info *const zf =
1227                 &f->zbd_info->zone_info[f->min_zone];
1228
1229         /*
1230          * Skip to the next non-empty zone in case of sequential I/O and to
1231          * the nearest non-empty zone in case of random I/O.
1232          */
1233         for (z1 = zb + 1, z2 = zb - 1; z1 < zl || z2 >= zf; z1++, z2--) {
1234                 if (z1 < zl && z1->cond != ZBD_ZONE_COND_OFFLINE) {
1235                         zone_lock(td, f, z1);
1236                         if (z1->start + min_bs <= z1->wp)
1237                                 return z1;
1238                         pthread_mutex_unlock(&z1->mutex);
1239                 } else if (!td_random(td)) {
1240                         break;
1241                 }
1242                 if (td_random(td) && z2 >= zf &&
1243                     z2->cond != ZBD_ZONE_COND_OFFLINE) {
1244                         zone_lock(td, f, z2);
1245                         if (z2->start + min_bs <= z2->wp)
1246                                 return z2;
1247                         pthread_mutex_unlock(&z2->mutex);
1248                 }
1249         }
1250         dprint(FD_ZBD, "%s: adjusting random read offset failed\n",
1251                f->file_name);
1252         return NULL;
1253 }
1254
1255 /**
1256  * zbd_end_zone_io - update zone status at command completion
1257  * @io_u: I/O unit
1258  * @z: zone info pointer
1259  *
1260  * If the write command made the zone full, close it.
1261  *
1262  * The caller must hold z->mutex.
1263  */
1264 static void zbd_end_zone_io(struct thread_data *td, const struct io_u *io_u,
1265                             struct fio_zone_info *z)
1266 {
1267         const struct fio_file *f = io_u->file;
1268
1269         if (io_u->ddir == DDIR_WRITE &&
1270             io_u->offset + io_u->buflen >= zbd_zone_capacity_end(z)) {
1271                 pthread_mutex_lock(&f->zbd_info->mutex);
1272                 zbd_close_zone(td, f, z - f->zbd_info->zone_info);
1273                 pthread_mutex_unlock(&f->zbd_info->mutex);
1274         }
1275 }
1276
1277 /**
1278  * zbd_queue_io - update the write pointer of a sequential zone
1279  * @io_u: I/O unit
1280  * @success: Whether or not the I/O unit has been queued successfully
1281  * @q: queueing status (busy, completed or queued).
1282  *
1283  * For write and trim operations, update the write pointer of the I/O unit
1284  * target zone.
1285  */
1286 static void zbd_queue_io(struct thread_data *td, struct io_u *io_u, int q,
1287                          bool success)
1288 {
1289         const struct fio_file *f = io_u->file;
1290         struct zoned_block_device_info *zbd_info = f->zbd_info;
1291         struct fio_zone_info *z;
1292         uint32_t zone_idx;
1293         uint64_t zone_end;
1294
1295         if (!zbd_info)
1296                 return;
1297
1298         zone_idx = zbd_zone_idx(f, io_u->offset);
1299         assert(zone_idx < zbd_info->nr_zones);
1300         z = &zbd_info->zone_info[zone_idx];
1301
1302         if (!zbd_zone_swr(z))
1303                 return;
1304
1305         if (!success)
1306                 goto unlock;
1307
1308         dprint(FD_ZBD,
1309                "%s: queued I/O (%lld, %llu) for zone %u\n",
1310                f->file_name, io_u->offset, io_u->buflen, zone_idx);
1311
1312         switch (io_u->ddir) {
1313         case DDIR_WRITE:
1314                 zone_end = min((uint64_t)(io_u->offset + io_u->buflen),
1315                                zbd_zone_capacity_end(z));
1316                 pthread_mutex_lock(&zbd_info->mutex);
1317                 /*
1318                  * z->wp > zone_end means that one or more I/O errors
1319                  * have occurred.
1320                  */
1321                 if (z->wp <= zone_end)
1322                         zbd_info->sectors_with_data += zone_end - z->wp;
1323                 pthread_mutex_unlock(&zbd_info->mutex);
1324                 z->wp = zone_end;
1325                 break;
1326         case DDIR_TRIM:
1327                 assert(z->wp == z->start);
1328                 break;
1329         default:
1330                 break;
1331         }
1332
1333         if (q == FIO_Q_COMPLETED && !io_u->error)
1334                 zbd_end_zone_io(td, io_u, z);
1335
1336 unlock:
1337         if (!success || q != FIO_Q_QUEUED) {
1338                 /* BUSY or COMPLETED: unlock the zone */
1339                 pthread_mutex_unlock(&z->mutex);
1340                 io_u->zbd_put_io = NULL;
1341         }
1342 }
1343
1344 /**
1345  * zbd_put_io - Unlock an I/O unit target zone lock
1346  * @io_u: I/O unit
1347  */
1348 static void zbd_put_io(struct thread_data *td, const struct io_u *io_u)
1349 {
1350         const struct fio_file *f = io_u->file;
1351         struct zoned_block_device_info *zbd_info = f->zbd_info;
1352         struct fio_zone_info *z;
1353         uint32_t zone_idx;
1354         int ret;
1355
1356         if (!zbd_info)
1357                 return;
1358
1359         zone_idx = zbd_zone_idx(f, io_u->offset);
1360         assert(zone_idx < zbd_info->nr_zones);
1361         z = &zbd_info->zone_info[zone_idx];
1362
1363         if (!zbd_zone_swr(z))
1364                 return;
1365
1366         dprint(FD_ZBD,
1367                "%s: terminate I/O (%lld, %llu) for zone %u\n",
1368                f->file_name, io_u->offset, io_u->buflen, zone_idx);
1369
1370         zbd_end_zone_io(td, io_u, z);
1371
1372         ret = pthread_mutex_unlock(&z->mutex);
1373         assert(ret == 0);
1374         zbd_check_swd(f);
1375 }
1376
1377 /*
1378  * Windows and MacOS do not define this.
1379  */
1380 #ifndef EREMOTEIO
1381 #define EREMOTEIO       121     /* POSIX value */
1382 #endif
1383
1384 bool zbd_unaligned_write(int error_code)
1385 {
1386         switch (error_code) {
1387         case EIO:
1388         case EREMOTEIO:
1389                 return true;
1390         }
1391         return false;
1392 }
1393
1394 /**
1395  * setup_zbd_zone_mode - handle zoneskip as necessary for ZBD drives
1396  * @td: FIO thread data.
1397  * @io_u: FIO I/O unit.
1398  *
1399  * For sequential workloads, change the file offset to skip zoneskip bytes when
1400  * no more IO can be performed in the current zone.
1401  * - For read workloads, zoneskip is applied when the io has reached the end of
1402  *   the zone or the zone write position (when td->o.read_beyond_wp is false).
1403  * - For write workloads, zoneskip is applied when the zone is full.
1404  * This applies only to read and write operations.
1405  */
1406 void setup_zbd_zone_mode(struct thread_data *td, struct io_u *io_u)
1407 {
1408         struct fio_file *f = io_u->file;
1409         enum fio_ddir ddir = io_u->ddir;
1410         struct fio_zone_info *z;
1411         uint32_t zone_idx;
1412
1413         assert(td->o.zone_mode == ZONE_MODE_ZBD);
1414         assert(td->o.zone_size);
1415
1416         zone_idx = zbd_zone_idx(f, f->last_pos[ddir]);
1417         z = &f->zbd_info->zone_info[zone_idx];
1418
1419         /*
1420          * When the zone capacity is smaller than the zone size and the I/O is
1421          * sequential write, skip to zone end if the latest position is at the
1422          * zone capacity limit.
1423          */
1424         if (z->capacity < f->zbd_info->zone_size && !td_random(td) &&
1425             ddir == DDIR_WRITE &&
1426             f->last_pos[ddir] >= zbd_zone_capacity_end(z)) {
1427                 dprint(FD_ZBD,
1428                        "%s: Jump from zone capacity limit to zone end:"
1429                        " (%llu -> %llu) for zone %u (%llu)\n",
1430                        f->file_name, (unsigned long long) f->last_pos[ddir],
1431                        (unsigned long long) zbd_zone_end(z),
1432                        zbd_zone_nr(f->zbd_info, z),
1433                        (unsigned long long) z->capacity);
1434                 td->io_skip_bytes += zbd_zone_end(z) - f->last_pos[ddir];
1435                 f->last_pos[ddir] = zbd_zone_end(z);
1436         }
1437
1438         /*
1439          * zone_skip is valid only for sequential workloads.
1440          */
1441         if (td_random(td) || !td->o.zone_skip)
1442                 return;
1443
1444         /*
1445          * It is time to switch to a new zone if:
1446          * - zone_bytes == zone_size bytes have already been accessed
1447          * - The last position reached the end of the current zone.
1448          * - For reads with td->o.read_beyond_wp == false, the last position
1449          *   reached the zone write pointer.
1450          */
1451         if (td->zone_bytes >= td->o.zone_size ||
1452             f->last_pos[ddir] >= zbd_zone_end(z) ||
1453             (ddir == DDIR_READ &&
1454              (!td->o.read_beyond_wp) && f->last_pos[ddir] >= z->wp)) {
1455                 /*
1456                  * Skip zones.
1457                  */
1458                 td->zone_bytes = 0;
1459                 f->file_offset += td->o.zone_size + td->o.zone_skip;
1460
1461                 /*
1462                  * Wrap from the beginning, if we exceed the file size
1463                  */
1464                 if (f->file_offset >= f->real_file_size)
1465                         f->file_offset = get_start_offset(td, f);
1466
1467                 f->last_pos[ddir] = f->file_offset;
1468                 td->io_skip_bytes += td->o.zone_skip;
1469         }
1470 }
1471
1472 /**
1473  * zbd_adjust_ddir - Adjust an I/O direction for zonemode=zbd.
1474  *
1475  * @td: FIO thread data.
1476  * @io_u: FIO I/O unit.
1477  * @ddir: I/O direction before adjustment.
1478  *
1479  * Return adjusted I/O direction.
1480  */
1481 enum fio_ddir zbd_adjust_ddir(struct thread_data *td, struct io_u *io_u,
1482                               enum fio_ddir ddir)
1483 {
1484         /*
1485          * In case read direction is chosen for the first random I/O, fio with
1486          * zonemode=zbd stops because no data can be read from zoned block
1487          * devices with all empty zones. Overwrite the first I/O direction as
1488          * write to make sure data to read exists.
1489          */
1490         if (ddir != DDIR_READ || !td_rw(td))
1491                 return ddir;
1492
1493         if (io_u->file->zbd_info->sectors_with_data ||
1494             td->o.read_beyond_wp)
1495                 return DDIR_READ;
1496
1497         return DDIR_WRITE;
1498 }
1499
1500 /**
1501  * zbd_adjust_block - adjust the offset and length as necessary for ZBD drives
1502  * @td: FIO thread data.
1503  * @io_u: FIO I/O unit.
1504  *
1505  * Locking strategy: returns with z->mutex locked if and only if z refers
1506  * to a sequential zone and if io_u_accept is returned. z is the zone that
1507  * corresponds to io_u->offset at the end of this function.
1508  */
1509 enum io_u_action zbd_adjust_block(struct thread_data *td, struct io_u *io_u)
1510 {
1511         struct fio_file *f = io_u->file;
1512         uint32_t zone_idx_b;
1513         struct fio_zone_info *zb, *zl, *orig_zb;
1514         uint32_t orig_len = io_u->buflen;
1515         uint32_t min_bs = td->o.min_bs[io_u->ddir];
1516         uint64_t new_len;
1517         int64_t range;
1518
1519         if (!f->zbd_info)
1520                 return io_u_accept;
1521
1522         assert(min_bs);
1523         assert(is_valid_offset(f, io_u->offset));
1524         assert(io_u->buflen);
1525         zone_idx_b = zbd_zone_idx(f, io_u->offset);
1526         zb = &f->zbd_info->zone_info[zone_idx_b];
1527         orig_zb = zb;
1528
1529         /* Accept the I/O offset for conventional zones. */
1530         if (!zbd_zone_swr(zb))
1531                 return io_u_accept;
1532
1533         /*
1534          * Accept the I/O offset for reads if reading beyond the write pointer
1535          * is enabled.
1536          */
1537         if (zb->cond != ZBD_ZONE_COND_OFFLINE &&
1538             io_u->ddir == DDIR_READ && td->o.read_beyond_wp)
1539                 return io_u_accept;
1540
1541         zbd_check_swd(f);
1542
1543         zone_lock(td, f, zb);
1544
1545         switch (io_u->ddir) {
1546         case DDIR_READ:
1547                 if (td->runstate == TD_VERIFYING && td_write(td)) {
1548                         zb = zbd_replay_write_order(td, io_u, zb);
1549                         pthread_mutex_unlock(&zb->mutex);
1550                         goto accept;
1551                 }
1552                 /*
1553                  * Check that there is enough written data in the zone to do an
1554                  * I/O of at least min_bs B. If there isn't, find a new zone for
1555                  * the I/O.
1556                  */
1557                 range = zb->cond != ZBD_ZONE_COND_OFFLINE ?
1558                         zb->wp - zb->start : 0;
1559                 if (range < min_bs ||
1560                     ((!td_random(td)) && (io_u->offset + min_bs > zb->wp))) {
1561                         pthread_mutex_unlock(&zb->mutex);
1562                         zl = &f->zbd_info->zone_info[f->max_zone];
1563                         zb = zbd_find_zone(td, io_u, zb, zl);
1564                         if (!zb) {
1565                                 dprint(FD_ZBD,
1566                                        "%s: zbd_find_zone(%lld, %llu) failed\n",
1567                                        f->file_name, io_u->offset,
1568                                        io_u->buflen);
1569                                 goto eof;
1570                         }
1571                         /*
1572                          * zbd_find_zone() returned a zone with a range of at
1573                          * least min_bs.
1574                          */
1575                         range = zb->wp - zb->start;
1576                         assert(range >= min_bs);
1577
1578                         if (!td_random(td))
1579                                 io_u->offset = zb->start;
1580                 }
1581                 /*
1582                  * Make sure the I/O is within the zone valid data range while
1583                  * maximizing the I/O size and preserving randomness.
1584                  */
1585                 if (range <= io_u->buflen)
1586                         io_u->offset = zb->start;
1587                 else if (td_random(td))
1588                         io_u->offset = zb->start +
1589                                 ((io_u->offset - orig_zb->start) %
1590                                  (range - io_u->buflen)) / min_bs * min_bs;
1591                 /*
1592                  * Make sure the I/O does not cross over the zone wp position.
1593                  */
1594                 new_len = min((unsigned long long)io_u->buflen,
1595                               (unsigned long long)(zb->wp - io_u->offset));
1596                 new_len = new_len / min_bs * min_bs;
1597                 if (new_len < io_u->buflen) {
1598                         io_u->buflen = new_len;
1599                         dprint(FD_IO, "Changed length from %u into %llu\n",
1600                                orig_len, io_u->buflen);
1601                 }
1602                 assert(zb->start <= io_u->offset);
1603                 assert(io_u->offset + io_u->buflen <= zb->wp);
1604                 goto accept;
1605         case DDIR_WRITE:
1606                 if (io_u->buflen > f->zbd_info->zone_size)
1607                         goto eof;
1608                 if (!zbd_open_zone(td, f, zone_idx_b)) {
1609                         pthread_mutex_unlock(&zb->mutex);
1610                         zb = zbd_convert_to_open_zone(td, io_u);
1611                         if (!zb)
1612                                 goto eof;
1613                         zone_idx_b = zb - f->zbd_info->zone_info;
1614                 }
1615                 /* Check whether the zone reset threshold has been exceeded */
1616                 if (td->o.zrf.u.f) {
1617                         if (f->zbd_info->sectors_with_data >=
1618                             f->io_size * td->o.zrt.u.f &&
1619                             zbd_dec_and_reset_write_cnt(td, f)) {
1620                                 zb->reset_zone = 1;
1621                         }
1622                 }
1623                 /* Reset the zone pointer if necessary */
1624                 if (zb->reset_zone || zbd_zone_full(f, zb, min_bs)) {
1625                         assert(td->o.verify == VERIFY_NONE);
1626                         /*
1627                          * Since previous write requests may have been submitted
1628                          * asynchronously and since we will submit the zone
1629                          * reset synchronously, wait until previously submitted
1630                          * write requests have completed before issuing a
1631                          * zone reset.
1632                          */
1633                         io_u_quiesce(td);
1634                         zb->reset_zone = 0;
1635                         if (zbd_reset_zone(td, f, zb) < 0)
1636                                 goto eof;
1637
1638                         if (zb->capacity < min_bs) {
1639                                 log_err("zone capacity %llu smaller than minimum block size %d\n",
1640                                         (unsigned long long)zb->capacity,
1641                                         min_bs);
1642                                 goto eof;
1643                         }
1644                 }
1645                 /* Make writes occur at the write pointer */
1646                 assert(!zbd_zone_full(f, zb, min_bs));
1647                 io_u->offset = zb->wp;
1648                 if (!is_valid_offset(f, io_u->offset)) {
1649                         dprint(FD_ZBD, "Dropped request with offset %llu\n",
1650                                io_u->offset);
1651                         goto eof;
1652                 }
1653                 /*
1654                  * Make sure that the buflen is a multiple of the minimal
1655                  * block size. Give up if shrinking would make the request too
1656                  * small.
1657                  */
1658                 new_len = min((unsigned long long)io_u->buflen,
1659                               zbd_zone_capacity_end(zb) - io_u->offset);
1660                 new_len = new_len / min_bs * min_bs;
1661                 if (new_len == io_u->buflen)
1662                         goto accept;
1663                 if (new_len >= min_bs) {
1664                         io_u->buflen = new_len;
1665                         dprint(FD_IO, "Changed length from %u into %llu\n",
1666                                orig_len, io_u->buflen);
1667                         goto accept;
1668                 }
1669                 log_err("Zone remainder %lld smaller than minimum block size %d\n",
1670                         (zbd_zone_capacity_end(zb) - io_u->offset),
1671                         min_bs);
1672                 goto eof;
1673         case DDIR_TRIM:
1674                 /* fall-through */
1675         case DDIR_SYNC:
1676         case DDIR_DATASYNC:
1677         case DDIR_SYNC_FILE_RANGE:
1678         case DDIR_WAIT:
1679         case DDIR_LAST:
1680         case DDIR_INVAL:
1681                 goto accept;
1682         }
1683
1684         assert(false);
1685
1686 accept:
1687         assert(zb);
1688         assert(zb->cond != ZBD_ZONE_COND_OFFLINE);
1689         assert(!io_u->zbd_queue_io);
1690         assert(!io_u->zbd_put_io);
1691         io_u->zbd_queue_io = zbd_queue_io;
1692         io_u->zbd_put_io = zbd_put_io;
1693         return io_u_accept;
1694
1695 eof:
1696         if (zb)
1697                 pthread_mutex_unlock(&zb->mutex);
1698         return io_u_eof;
1699 }
1700
1701 /* Return a string with ZBD statistics */
1702 char *zbd_write_status(const struct thread_stat *ts)
1703 {
1704         char *res;
1705
1706         if (asprintf(&res, "; %llu zone resets", (unsigned long long) ts->nr_zone_resets) < 0)
1707                 return NULL;
1708         return res;
1709 }