3 # Copyright (C) 2018 Western Digital Corporation or its affiliates.
5 # This file is released under the GPL.
8 echo "Usage: $(basename "$0") [OPTIONS] <test target device file>"
10 echo -e "\t-d Run fio with valgrind using DRD tool"
11 echo -e "\t-e Run fio with valgrind using helgrind tool"
12 echo -e "\t-v Run fio with valgrind --read-var-info option"
13 echo -e "\t-l Test with libzbc ioengine"
14 echo -e "\t-r Reset all zones before test start"
15 echo -e "\t-o <max_open_zones> Run fio with max_open_zones limit"
16 echo -e "\t-t <test #> Run only a single test case with specified number"
17 echo -e "\t-z Run fio with debug=zbd option"
21 if [ "$1" -gt "$2" ]; then
29 if [ "$1" -lt "$2" ]; then
37 if [ -n "$use_libzbc" ]; then
38 echo -n "--ioengine=libzbc"
40 echo -n "--ioengine=$1"
47 [ -e "/sys/block/$dev" ] || return $?
48 if [ -e "/sys/block/$dev/mq" ]; then
51 deadline) sched=mq-deadline;;
56 mq-deadline) sched=deadline;;
60 echo "$sched" >"/sys/block/$dev/queue/scheduler"
66 read=$(fio_read <"${logfile}.${test_number}")
67 echo "read: $read <> $1" >> "${logfile}.${test_number}"
74 written=$(fio_written <"${logfile}.${test_number}")
75 echo "written: $written <> $1" >> "${logfile}.${test_number}"
79 # Compare the reset count from the log file with reset count $2 using operator
80 # $1 (=, -ge, -gt, -le, -lt).
84 reset_count=$(fio_reset_count <"${logfile}.${test_number}")
85 echo "reset_count: test $reset_count $1 $2" >> "${logfile}.${test_number}"
86 eval "[ '$reset_count' '$1' '$2' ]"
89 # Check log for failed assertions and crashes. Without these checks,
90 # a test can succeed even when these events happen, but it must fail.
92 [ ! -f "${logfile}.${1}" ] && return 0
93 ! grep -q -e "Assertion " -e "Aborted " "${logfile}.${1}"
96 # Whether or not $1 (/dev/...) is a SCSI device.
101 for f in /sys/class/scsi_device/*/device/block/"$d"; do
102 [ -e "$f" ] && return 0
107 job_var_opts_exclude() {
111 for o in "${job_var_opts[@]}"; do
112 if [[ ${o} =~ "${ex_key}" ]]; then
119 has_max_open_zones() {
121 if [[ ${1} =~ "--max_open_zones" ]]; then
132 fio=$(dirname "$0")/../../fio
134 opts=(${global_var_opts[@]})
135 opts+=("--max-jobs=16" "--aux-path=/tmp" "--allow_file_create=0" \
136 "--significant_figures=10" "$@")
137 # When max_open_zones option is specified to this test script, add
138 # max_open_zones option to fio command unless the test case already add it.
139 if [[ -n ${max_open_zones_opt} ]] && ! has_max_open_zones "${opts[@]}"; then
140 opts+=("--max_open_zones=${max_open_zones_opt}")
142 { echo; echo "fio ${opts[*]}"; echo; } >>"${logfile}.${test_number}"
144 "${dynamic_analyzer[@]}" "$fio" "${opts[@]}"
150 r=$(((RANDOM << 16) | RANDOM))
151 run_fio --name="$dev" --filename="$dev" "$@" --randseed="$r" \
152 --thread=1 --direct=1
155 write_and_run_one_fio_job() {
157 local write_offset="${1}"
158 local write_size="${2}"
162 r=$(((RANDOM << 16) | RANDOM))
163 write_opts=(--name="write_job" --rw=write "$(ioengine "psync")" \
164 --bs="${logical_block_size}" --zonemode=zbd \
165 --zonesize="${zone_size}" --thread=1 --direct=1 \
166 --offset="${write_offset}" --size="${write_size}")
167 write_opts+=("${job_var_opts[@]}")
168 run_fio --filename="$dev" --randseed="$r" "${write_opts[@]}" \
169 --name="$dev" --wait_for="write_job" "$@" --thread=1 --direct=1
172 # Run fio on the first four sequential zones of the disk.
176 opts+=("--offset=$((first_sequential_zone_sector * 512))")
177 opts+=("--size=$((4 * zone_size))" "--zonemode=zbd")
178 if [ -z "$is_zbd" ]; then
179 opts+=("--zonesize=${zone_size}")
181 run_one_fio_job "${opts[@]}" "$@"
184 # Prepare for write test by resetting zones. When max_open_zones option is
185 # specified, reset all zones of the test target to ensure that zones out of the
186 # test target range do not have open zones. This allows the write test to the
187 # target range to be able to open zones up to max_open_zones.
189 [[ -n "${max_open_zones_opt}" && -n "${is_zbd}" ]] &&
190 reset_zone "${dev}" -1
196 if ! is_scsi_device "$dev"; then
197 SKIP_REASON="$dev is not a SCSI device"
203 require_conv_zone_bytes() {
206 if ((req_bytes > first_sequential_zone_sector * 512)); then
207 SKIP_REASON="$dev does not have enough conventional zones"
214 if [[ -z ${is_zbd} ]]; then
215 SKIP_REASON="$dev is not a zoned block device"
221 require_regular_block_dev() {
222 if [[ -n ${is_zbd} ]]; then
223 SKIP_REASON="$dev is not a regular block device"
229 require_seq_zones() {
230 local req_seq_zones=${1}
231 local seq_bytes=$((disk_size - first_sequential_zone_sector * 512))
233 if ((req_seq_zones > seq_bytes / zone_size)); then
234 SKIP_REASON="$dev does not have $req_seq_zones sequential zones"
240 require_conv_zones() {
241 local req_c_zones=${1}
242 local conv_bytes=$((first_sequential_zone_sector * 512))
244 if ((req_c_zones > conv_bytes / zone_size)); then
245 SKIP_REASON="$dev does not have $req_c_zones conventional zones"
251 # Check whether buffered writes are refused.
253 run_fio --name=job1 --filename="$dev" --rw=write --direct=0 --bs=4K \
254 "$(ioengine "psync")" --size="${zone_size}" --thread=1 \
255 --zonemode=zbd --zonesize="${zone_size}" 2>&1 |
256 tee -a "${logfile}.${test_number}" |
257 grep -q 'Using direct I/O is mandatory for writing to ZBD drives'
258 local fio_rc=${PIPESTATUS[0]} grep_rc=${PIPESTATUS[2]}
263 if [ -n "$is_zbd" ]; then
270 # Block size exceeds zone size.
272 local bs off opts=() rc
274 off=$(((first_sequential_zone_sector + 2 * sectors_per_zone) * 512))
275 bs=$((2 * zone_size))
276 opts+=("$(ioengine "psync")")
277 opts+=("--name=job1" "--filename=$dev" "--rw=write" "--direct=1")
278 opts+=("--zonemode=zbd" "--offset=$off" "--bs=$bs" "--size=$bs")
279 if [ -z "$is_zbd" ]; then
280 opts+=("--zonesize=${zone_size}")
282 run_fio "${opts[@]}" >> "${logfile}.${test_number}" 2>&1 && return 1
283 grep -q 'buflen exceeds zone size' "${logfile}.${test_number}"
286 # Run fio against an empty zone. This causes fio to report "No I/O performed".
290 require_seq_zones 129 || return $SKIP_TESTCASE
291 off=$((first_sequential_zone_sector * 512 + 128 * zone_size))
293 [ -n "$is_zbd" ] && reset_zone "$dev" $((off / 512))
294 opts+=("--name=$dev" "--filename=$dev" "--offset=$off" "--bs=4K")
295 opts+=("--size=$size" "--zonemode=zbd")
296 opts+=("$(ioengine "psync")" "--rw=read" "--direct=1" "--thread=1")
297 if [ -z "$is_zbd" ]; then
298 opts+=("--zonesize=${zone_size}")
300 run_fio "${opts[@]}" >> "${logfile}.${test_number}" 2>&1 || return $?
301 ! grep -q 'READ:' "${logfile}.${test_number}"
304 # Run fio with --read_beyond_wp=1 against an empty zone.
308 require_seq_zones 130 || return $SKIP_TESTCASE
309 off=$((first_sequential_zone_sector * 512 + 129 * zone_size))
311 [ -n "$is_zbd" ] && reset_zone "$dev" $((off / 512))
312 opts+=("--name=$dev" "--filename=$dev" "--offset=$off" "--bs=$size")
313 opts+=("--size=$size" "--thread=1" "--read_beyond_wp=1")
314 opts+=("$(ioengine "psync")" "--rw=read" "--direct=1" "--disable_lat=1")
315 opts+=("--zonemode=zbd" "--zonesize=${zone_size}")
316 run_fio "${opts[@]}" >> "${logfile}.${test_number}" 2>&1 || return $?
317 check_read $size || return $?
320 # Sequential write to sequential zones.
322 local size off capacity
325 off=$((first_sequential_zone_sector * 512))
326 capacity=$(total_zone_capacity 4 $off $dev)
327 size=$((4 * zone_size))
328 run_fio_on_seq "$(ioengine "psync")" --iodepth=1 --rw=write \
329 --bs="$(max $((zone_size / 64)) "$logical_block_size")"\
330 --do_verify=1 --verify=md5 \
331 >>"${logfile}.${test_number}" 2>&1 || return $?
332 check_written $capacity || return $?
333 check_read $capacity || return $?
336 # Sequential read from sequential zones.
338 local size off capacity
341 off=$((first_sequential_zone_sector * 512))
342 capacity=$(total_zone_capacity 4 $off $dev)
343 size=$((4 * zone_size))
344 write_and_run_one_fio_job \
345 $((first_sequential_zone_sector * 512)) "${size}" \
347 --size="${size}" --zonemode=zbd --zonesize="${zone_size}" \
348 "$(ioengine "psync")" --iodepth=1 --rw=read \
349 --bs="$(max $((zone_size / 64)) "$logical_block_size")" \
350 >>"${logfile}.${test_number}" 2>&1 || return $?
351 check_read $capacity || return $?
354 # Random write to sequential zones, libaio, queue depth 1.
356 local size=$((zone_size))
360 off=$((first_sequential_zone_sector * 512))
361 capacity=$(total_zone_capacity 1 $off $dev)
362 run_fio_on_seq "$(ioengine "libaio")" --iodepth=1 --rw=randwrite \
363 --bs="$(min 16384 "${zone_size}")" \
364 --do_verify=1 --verify=md5 --size="$size" \
365 >>"${logfile}.${test_number}" 2>&1 || return $?
366 check_written $capacity || return $?
367 check_read $capacity || return $?
370 # Random write to sequential zones, libaio, queue depth 64.
372 local size off capacity
375 size=$((4 * zone_size))
376 off=$((first_sequential_zone_sector * 512))
377 capacity=$(total_zone_capacity 4 $off $dev)
378 run_fio_on_seq "$(ioengine "libaio")" --iodepth=64 --rw=randwrite \
379 --bs="$(min 16384 "${zone_size}")" \
380 --do_verify=1 --verify=md5 \
381 >>"${logfile}.${test_number}" 2>&1 || return $?
382 check_written $capacity || return $?
383 check_read $capacity || return $?
386 # Random write to sequential zones, sg, queue depth 1.
390 require_scsi_dev || return $SKIP_TESTCASE
393 size=$((4 * zone_size))
394 run_fio_on_seq --ioengine=sg \
395 --iodepth=1 --rw=randwrite --bs=16K \
396 --do_verify=1 --verify=md5 \
397 >>"${logfile}.${test_number}" 2>&1 || return $?
398 check_written $size || return $?
399 check_read $size || return $?
402 # Random write to sequential zones, sg, queue depth 64.
406 require_scsi_dev || return $SKIP_TESTCASE
409 size=$((4 * zone_size))
410 run_fio_on_seq --ioengine=sg \
411 --iodepth=64 --rw=randwrite --bs=16K \
412 --do_verify=1 --verify=md5 \
413 >>"${logfile}.${test_number}" 2>&1 || return $?
414 check_written $size || return $?
415 check_read $size || return $?
418 # Random write to sequential zones, libaio, queue depth 64, random block size.
420 local size off capacity
423 size=$((4 * zone_size))
424 off=$((first_sequential_zone_sector * 512))
425 capacity=$(total_zone_capacity 4 $off $dev)
426 run_fio_on_seq "$(ioengine "libaio")" --iodepth=64 --rw=randwrite \
427 --bsrange=4K-64K --do_verify=1 --verify=md5 \
428 --debug=zbd >>"${logfile}.${test_number}" 2>&1 || return $?
429 check_written $capacity || return $?
430 check_read $capacity || return $?
433 # Random write to sequential zones, libaio, queue depth 64, max 1 open zone.
435 local size off capacity
438 size=$((8 * zone_size))
439 off=$((first_sequential_zone_sector * 512))
440 capacity=$(total_zone_capacity 8 $off $dev)
441 run_fio_on_seq "$(ioengine "libaio")" --iodepth=64 --rw=randwrite --bs=16K \
442 --max_open_zones=1 --size=$size --do_verify=1 --verify=md5 \
443 --debug=zbd >>"${logfile}.${test_number}" 2>&1 || return $?
444 check_written $capacity || return $?
445 check_read $capacity || return $?
448 # Random write to sequential zones, libaio, queue depth 64, max 4 open zones.
450 local size off capacity
453 size=$((8 * zone_size))
454 off=$((first_sequential_zone_sector * 512))
455 capacity=$(total_zone_capacity 8 $off $dev)
456 run_fio_on_seq "$(ioengine "libaio")" --iodepth=64 --rw=randwrite --bs=16K \
457 --max_open_zones=4 --size=$size --do_verify=1 --verify=md5 \
459 >>"${logfile}.${test_number}" 2>&1 || return $?
460 check_written $capacity || return $?
461 check_read $capacity || return $?
464 # Random write to conventional zones.
469 size=$((16 * 2**20)) # 20 MB
470 require_conv_zone_bytes "${size}" || return $SKIP_TESTCASE
472 run_one_fio_job "$(ioengine "libaio")" --iodepth=64 --rw=randwrite --bs=16K \
473 --zonemode=zbd --zonesize="${zone_size}" --do_verify=1 \
474 --verify=md5 --size=$size \
475 >>"${logfile}.${test_number}" 2>&1 || return $?
476 check_written $((size)) || return $?
477 check_read $((size)) || return $?
480 # Sequential read on a mix of empty and full zones.
483 local w_off w_size w_capacity
485 for ((i=0;i<4;i++)); do
487 reset_zone "$dev" $((first_sequential_zone_sector +
491 w_off=$(((first_sequential_zone_sector + 2 * sectors_per_zone) * 512))
492 w_size=$((2 * zone_size))
493 w_capacity=$(total_zone_capacity 2 $w_off $dev)
494 off=$((first_sequential_zone_sector * 512))
495 size=$((4 * zone_size))
496 write_and_run_one_fio_job "${w_off}" "${w_size}" \
497 "$(ioengine "psync")" --rw=read --bs=$((zone_size / 16)) \
498 --zonemode=zbd --zonesize="${zone_size}" --offset=$off \
499 --size=$((size)) >>"${logfile}.${test_number}" 2>&1 ||
501 check_written $((w_capacity)) || return $?
502 check_read $((w_capacity))
505 # Random read on a mix of empty and full zones.
508 local i w_off w_size w_capacity
510 for ((i=0;i<4;i++)); do
512 reset_zone "$dev" $((first_sequential_zone_sector +
516 w_off=$(((first_sequential_zone_sector + 2 * sectors_per_zone) * 512))
517 w_size=$((2 * zone_size))
518 w_capacity=$(total_zone_capacity 2 $w_off $dev)
519 off=$((first_sequential_zone_sector * 512))
520 size=$((4 * zone_size))
521 write_and_run_one_fio_job "${w_off}" "${w_size}" \
522 "$(ioengine "libaio")" --iodepth=64 --rw=randread --bs=16K \
523 --zonemode=zbd --zonesize="${zone_size}" --offset=$off \
524 --size=$size >>"${logfile}.${test_number}" 2>&1 || return $?
525 check_written $w_capacity || return $?
526 check_read $size || return $?
529 # Random reads and writes in the last zone.
531 local io off read size written
533 off=$(((disk_size / zone_size - 1) * zone_size))
534 size=$((disk_size - off))
535 if [ -n "$is_zbd" ]; then
536 reset_zone "$dev" $((off / 512)) || return $?
539 run_one_fio_job "$(ioengine "libaio")" --iodepth=8 --rw=randrw --bs=4K \
540 --zonemode=zbd --zonesize="${zone_size}" \
541 --offset=$off --loops=2 --norandommap=1\
542 >>"${logfile}.${test_number}" 2>&1 || return $?
543 written=$(fio_written <"${logfile}.${test_number}")
544 read=$(fio_read <"${logfile}.${test_number}")
545 io=$((written + read))
546 echo "Total number of bytes read and written: $io <> $size" \
547 >>"${logfile}.${test_number}"
548 [ $io = $((size * 2)) ];
551 # Out-of-range zone reset threshold and frequency parameters.
553 run_fio_on_seq --zone_reset_threshold=-1 |&
554 tee -a "${logfile}.${test_number}" |
555 grep -q 'value out of range' || return $?
559 run_fio_on_seq --zone_reset_threshold=2 |&
560 tee -a "${logfile}.${test_number}" |
561 grep -q 'value out of range' || return $?
565 run_fio_on_seq --zone_reset_threshold=.4:.6 |&
566 tee -a "${logfile}.${test_number}" |
567 grep -q 'the list exceeding max length' || return $?
571 run_fio_on_seq --zone_reset_frequency=-1 |&
572 tee -a "${logfile}.${test_number}" |
573 grep -q 'value out of range' || return $?
577 run_fio_on_seq --zone_reset_frequency=2 |&
578 tee -a "${logfile}.${test_number}" |
579 grep -q 'value out of range' || return $?
583 run_fio_on_seq --zone_reset_frequency=.4:.6 |&
584 tee -a "${logfile}.${test_number}" |
585 grep -q 'the list exceeding max length' || return $?
589 local bs loops=9 size=$((zone_size))
593 off=$((first_sequential_zone_sector * 512))
594 capacity=$(total_zone_capacity 1 $off $dev)
596 bs=$(min $((256*1024)) "$zone_size")
597 run_fio_on_seq "$(ioengine "psync")" --rw=write --bs="$bs" \
598 --size=$size --loops=$loops \
599 --zone_reset_frequency=.01 --zone_reset_threshold=.90 \
600 >> "${logfile}.${test_number}" 2>&1 || return $?
601 check_written $((capacity * loops)) || return $?
602 check_reset_count -eq 8 ||
603 check_reset_count -eq 9 ||
604 check_reset_count -eq 10 || return $?
607 # Multiple non-overlapping sequential write jobs for the same drive.
611 for ((i=0;i<16;i++)); do
613 reset_zone "$dev" $((first_sequential_zone_sector + i*sectors_per_zone))
616 for ((i=0;i<16;i++)); do
617 opts+=("--name=job$i" "--filename=$dev" "--thread=1" "--direct=1")
618 opts+=("--offset=$((first_sequential_zone_sector*512 + zone_size*i))")
619 opts+=("--size=$zone_size" "$(ioengine "psync")" "--rw=write" "--bs=16K")
620 opts+=("--zonemode=zbd" "--zonesize=${zone_size}" "--group_reporting=1")
621 opts+=(${job_var_opts[@]})
623 run_fio "${opts[@]}" >> "${logfile}.${test_number}" 2>&1 || return $?
626 write_to_first_seq_zone() {
631 off=$((first_sequential_zone_sector * 512))
632 capacity=$(total_zone_capacity 1 $off $dev)
634 r=$(((RANDOM << 16) | RANDOM))
635 run_fio --name="$dev" --filename="$dev" "$(ioengine "psync")" --rw="$1" \
636 --thread=1 --do_verify=1 --verify=md5 --direct=1 --bs=4K \
638 --size=$zone_size --loops=$loops --randseed="$r" \
639 --zonemode=zbd --zonesize="${zone_size}" --group_reporting=1 \
640 --gtod_reduce=1 >> "${logfile}.${test_number}" 2>&1 || return $?
641 check_written $((loops * capacity)) || return $?
644 # Overwrite the first sequential zone four times sequentially.
646 write_to_first_seq_zone write
649 # Overwrite the first sequential zone four times using random writes.
651 write_to_first_seq_zone randwrite
654 # Multiple overlapping random write jobs for the same drive.
656 local i jobs=16 off opts
658 require_seq_zones 65 || return $SKIP_TESTCASE
659 off=$((first_sequential_zone_sector * 512 + 64 * zone_size))
660 [ -n "$is_zbd" ] && reset_zone "$dev" $((off / 512))
663 capacity=$(total_zone_capacity 1 $off $dev)
664 for ((i=0;i<jobs;i++)); do
665 opts+=("--name=job$i" "--filename=$dev" "--offset=$off" "--bs=16K")
666 opts+=("--size=$zone_size" "--io_size=$capacity" "$(ioengine "psync")" "--rw=randwrite")
667 opts+=("--thread=1" "--direct=1" "--zonemode=zbd")
668 opts+=("--zonesize=${zone_size}" "--group_reporting=1")
669 opts+=(${job_var_opts[@]})
671 run_fio "${opts[@]}" >> "${logfile}.${test_number}" 2>&1 || return $?
672 check_written $((jobs * $capacity)) || return $?
673 check_reset_count -eq $jobs ||
674 check_reset_count -eq $((jobs - 1)) ||
678 # Multiple overlapping random write jobs for the same drive and with a limited
679 # number of open zones.
681 local i jobs=16 off opts=()
683 require_seq_zones 80 || return $SKIP_TESTCASE
684 off=$((first_sequential_zone_sector * 512 + 64 * zone_size))
685 size=$((16*zone_size))
688 for ((i=0;i<jobs;i++)); do
689 opts+=("--name=job$i" "--filename=$dev" "--offset=$off" "--bs=16K")
690 opts+=("--size=$size" "--io_size=$zone_size" "--thread=1")
691 opts+=("$(ioengine "psync")" "--rw=randwrite" "--direct=1")
692 opts+=("--max_open_zones=4" "--group_reporting=1")
693 opts+=("--zonemode=zbd" "--zonesize=${zone_size}")
694 # max_open_zones is already specified
695 opts+=($(job_var_opts_exclude "--max_open_zones"))
697 run_fio "${opts[@]}" >> "${logfile}.${test_number}" 2>&1 || return $?
698 check_written $((jobs * zone_size)) || return $?
701 # Random reads and writes across the entire disk for 30s.
706 off=$((first_sequential_zone_sector * 512))
707 run_one_fio_job "$(ioengine "libaio")" --iodepth=8 --rw=randrw \
708 --bs="$(max $((zone_size / 128)) "$logical_block_size")"\
709 --zonemode=zbd --zonesize="${zone_size}" --offset=$off\
710 --loops=2 --time_based --runtime=30s --norandommap=1\
711 >>"${logfile}.${test_number}" 2>&1
714 # Random reads across all sequential zones for 30s. This is not only a fio
715 # test but also allows to verify the performance of a drive.
717 local bs inc nz off opts size
720 # Start with writing 128 KB to 128 sequential zones.
723 # shellcheck disable=SC2017
724 inc=$(((disk_size - (first_sequential_zone_sector * 512)) / (nz * zone_size)
727 for ((off = first_sequential_zone_sector * 512; off < disk_size;
729 opts+=("--name=$dev" "--filename=$dev" "--offset=$off" "--io_size=$bs")
730 opts+=("--bs=$bs" "--size=$zone_size" "$(ioengine "libaio")")
731 opts+=("--rw=write" "--direct=1" "--thread=1" "--stats=0")
732 opts+=("--zonemode=zbd" "--zonesize=${zone_size}")
733 opts+=(${job_var_opts[@]})
735 "$(dirname "$0")/../../fio" "${opts[@]}" >> "${logfile}.${test_number}" 2>&1
736 # Next, run the test.
737 off=$((first_sequential_zone_sector * 512))
738 size=$((disk_size - off))
739 opts=("--name=$dev" "--filename=$dev" "--offset=$off" "--size=$size")
740 opts+=("--bs=$bs" "$(ioengine "psync")" "--rw=randread" "--direct=1")
741 opts+=("--thread=1" "--time_based" "--runtime=30" "--zonemode=zbd")
742 opts+=("--zonesize=${zone_size}")
743 opts+=(${job_var_opts[@]})
744 run_fio "${opts[@]}" >> "${logfile}.${test_number}" 2>&1 || return $?
747 # Random writes across all sequential zones. This is not only a fio test but
748 # also allows to verify the performance of a drive.
750 local off opts=() size
752 require_zbd || return $SKIP_TESTCASE
755 off=$((first_sequential_zone_sector * 512))
756 size=$((disk_size - off))
757 opts+=("--name=$dev" "--filename=$dev" "--offset=$off" "--size=$size")
758 opts+=("--bs=128K" "$(ioengine "psync")" "--rw=randwrite" "--direct=1")
759 opts+=("--thread=1" "--time_based" "--runtime=30")
760 opts+=("--max_open_zones=$max_open_zones" "--zonemode=zbd")
761 opts+=("--zonesize=${zone_size}")
762 run_fio "${opts[@]}" >> "${logfile}.${test_number}" 2>&1 || return $?
765 # Write to sequential zones with a block size that is not a divisor of the
768 local bs io_size size
769 local off capacity=0;
772 off=$((first_sequential_zone_sector * 512))
773 capacity=$(total_zone_capacity 1 $off $dev)
774 size=$((2 * zone_size))
775 io_size=$((5 * capacity))
776 bs=$((3 * capacity / 4))
777 run_fio_on_seq "$(ioengine "psync")" --iodepth=1 --rw=write \
778 --size=$size --io_size=$io_size --bs=$bs \
779 >> "${logfile}.${test_number}" 2>&1 || return $?
780 check_written $(((io_size + bs - 1) / bs * bs)) || return $?
783 # Write to sequential zones with a block size that is not a divisor of the
784 # zone size and with data verification enabled.
789 size=$((2 * zone_size))
790 run_fio_on_seq "$(ioengine "psync")" --iodepth=1 --rw=write --size=$size \
791 --do_verify=1 --verify=md5 --bs=$((3 * zone_size / 4)) \
792 >> "${logfile}.${test_number}" 2>&1 && return 1
793 grep -q 'not a divisor of' "${logfile}.${test_number}"
796 # Test 1/4 for the I/O boundary rounding code: $size < $zone_size.
798 local bs off io_size size
801 off=$(((first_sequential_zone_sector + 1) * 512))
802 size=$((zone_size - 2 * 512))
803 bs=$((zone_size / 4))
804 run_one_fio_job --offset=$off --size=$size "$(ioengine "psync")" \
805 --iodepth=1 --rw=write --do_verify=1 --verify=md5 \
806 --bs=$bs --zonemode=zbd --zonesize="${zone_size}" \
807 >> "${logfile}.${test_number}" 2>&1 && return 1
808 grep -q 'io_size must be at least one zone' "${logfile}.${test_number}"
811 # Test 2/4 for the I/O boundary rounding code: $size < $zone_size.
813 local bs off io_size size
816 off=$(((first_sequential_zone_sector) * 512))
817 size=$((zone_size - 512))
818 bs=$((zone_size / 4))
819 run_one_fio_job --offset=$off --size=$size "$(ioengine "psync")" \
820 --iodepth=1 --rw=write --do_verify=1 --verify=md5 \
821 --bs=$bs --zonemode=zbd --zonesize="${zone_size}" \
822 >> "${logfile}.${test_number}" 2>&1 && return 1
823 grep -q 'io_size must be at least one zone' "${logfile}.${test_number}"
826 # Test 3/4 for the I/O boundary rounding code: $size > $zone_size.
828 local bs off size capacity
831 capacity=$(total_zone_capacity 1 $((first_sequential_zone_sector*512)) $dev)
832 if [ "$first_sequential_zone_sector" = 0 ]; then
835 off=$(((first_sequential_zone_sector - 1) * 512))
837 size=$((zone_size + 2 * 512))
838 bs=$((zone_size / 4))
839 run_one_fio_job --offset=$off --size=$size "$(ioengine "psync")" \
840 --iodepth=1 --rw=write --do_verify=1 --verify=md5 \
841 --bs=$bs --zonemode=zbd --zonesize="${zone_size}" \
842 >> "${logfile}.${test_number}" 2>&1
843 check_written $capacity || return $?
846 # Test 4/4 for the I/O boundary rounding code: $offset > $disk_size - $zone_size
851 size=$((logical_block_size))
852 off=$((disk_size - logical_block_size))
853 bs=$((logical_block_size))
854 run_one_fio_job --offset=$off --size=$size "$(ioengine "psync")" \
855 --iodepth=1 --rw=write --do_verify=1 --verify=md5 \
856 --bs=$bs --zonemode=zbd --zonesize="${zone_size}" \
857 >> "${logfile}.${test_number}" 2>&1 && return 1
858 grep -q 'io_size must be at least one zone' "${logfile}.${test_number}"
861 # Read one block from a block device.
865 bs=$((logical_block_size))
866 run_one_fio_job --rw=read "$(ioengine "psync")" --bs=$bs --size=$bs "$@" 2>&1 |
867 tee -a "${logfile}.${test_number}"
870 # Check whether fio accepts --zonemode=none for zoned block devices.
872 require_zbd || return $SKIP_TESTCASE
873 read_one_block --zonemode=none >/dev/null || return $?
874 check_read $((logical_block_size)) || return $?
877 # Check whether fio accepts --zonemode=strided for zoned block devices.
881 bs=$((logical_block_size))
882 require_zbd || return $SKIP_TESTCASE
883 read_one_block --zonemode=strided |
884 grep -q 'fio: --zonesize must be specified when using --zonemode=strided' ||
886 read_one_block --zonemode=strided --zonesize=$bs >/dev/null || return $?
887 check_read $bs || return $?
890 # Check whether fio checks the zone size for zoned block devices.
892 require_zbd || return $SKIP_TESTCASE
893 read_one_block --zonemode=zbd --zonesize=$((2 * zone_size)) |
894 grep -q 'job parameter zonesize.*does not match disk zone size'
897 # Check whether fio handles --zonesize=0 correctly for regular block devices.
899 require_regular_block_dev || return $SKIP_TESTCASE
900 read_one_block --zonemode=zbd --zonesize=0 |
901 grep -q 'Specifying the zone size is mandatory for regular block devices with --zonemode=zbd'
904 # Check whether fio handles --zonesize=1 correctly for regular block devices.
906 require_regular_block_dev || return $SKIP_TESTCASE
907 read_one_block --zonemode=zbd --zonesize=1 |
908 grep -q 'zone size must be at least 512 bytes for --zonemode=zbd'
911 # Check whether fio handles --zonemode=none --zonesize=1 correctly.
913 read_one_block --zonemode=none --zonesize=1 |
914 grep -q 'fio: --zonemode=none and --zonesize are not compatible'
920 require_zbd || return $SKIP_TESTCASE
922 bs=$((logical_block_size))
923 run_one_fio_job "$(ioengine "psync")" --iodepth=1 --rw=randwrite --bs=$bs\
924 --offset=$((first_sequential_zone_sector * 512)) \
925 --size="$zone_size" --do_verify=1 --verify=md5 2>&1 |
926 tee -a "${logfile}.${test_number}" |
927 grep -q "fio: first I/O failed. If .* is a zoned block device, consider --zonemode=zbd"
930 # Random write to sequential zones, libaio, 8 jobs, queue depth 64 per job
935 size=$((4 * zone_size))
936 run_fio_on_seq "$(ioengine "libaio")" --iodepth=64 --rw=randwrite --bs=4K \
937 --group_reporting=1 --numjobs=8 \
938 >> "${logfile}.${test_number}" 2>&1 || return $?
939 check_written $((size * 8)) || return $?
942 # Check whether fio handles --zonemode=zbd --zoneskip=1 correctly.
947 bs=$((logical_block_size))
948 run_fio_on_seq "$(ioengine "psync")" --rw=write --bs=$bs --zoneskip=1 \
949 >> "${logfile}.${test_number}" 2>&1 && return 1
950 grep -q 'zoneskip 1 is not a multiple of the device zone size' "${logfile}.${test_number}"
953 # Multiple overlapping random write jobs for the same drive and with a
954 # limited number of open zones. This is similar to test29, but uses libaio
955 # to stress test zone locking.
957 local i jobs=16 off opts=()
959 require_zbd || return $SKIP_TESTCASE
960 require_seq_zones 80 || return $SKIP_TESTCASE
962 off=$((first_sequential_zone_sector * 512 + 64 * zone_size))
963 size=$((16*zone_size))
965 opts=("--aux-path=/tmp" "--allow_file_create=0" "--significant_figures=10")
966 opts+=("--debug=zbd")
967 opts+=("$(ioengine "libaio")" "--rw=randwrite" "--direct=1")
968 opts+=("--time_based" "--runtime=30")
969 opts+=("--zonemode=zbd" "--zonesize=${zone_size}")
970 opts+=("--max_open_zones=4")
971 for ((i=0;i<jobs;i++)); do
972 opts+=("--name=job$i" "--filename=$dev" "--offset=$off" "--bs=16K")
973 opts+=("--io_size=$zone_size" "--iodepth=256" "--thread=1")
974 opts+=("--size=$size" "--group_reporting=1")
975 # max_open_zones is already specified
976 opts+=($(job_var_opts_exclude "--max_open_zones"))
979 fio=$(dirname "$0")/../../fio
981 { echo; echo "fio ${opts[*]}"; echo; } >>"${logfile}.${test_number}"
983 timeout -v -s KILL 45s \
984 "${dynamic_analyzer[@]}" "$fio" "${opts[@]}" \
985 >> "${logfile}.${test_number}" 2>&1 || return $?
988 # Check if fio handles --zonecapacity on a normal block device correctly
991 require_regular_block_dev || return $SKIP_TESTCASE
993 size=$((2 * zone_size))
994 capacity=$((zone_size * 3 / 4))
996 run_one_fio_job "$(ioengine "psync")" --rw=write \
997 --zonemode=zbd --zonesize="${zone_size}" \
998 --zonecapacity=${capacity} \
999 --verify=md5 --size=${size} >>"${logfile}.${test_number}" 2>&1 ||
1001 check_written $((capacity * 2)) || return $?
1002 check_read $((capacity * 2)) || return $?
1005 # Verify that conv zones are not locked and only seq zones are locked during
1006 # random read on conv-seq mixed zones.
1010 require_zbd || return $SKIP_TESTCASE
1011 require_conv_zones 8 || return $SKIP_TESTCASE
1012 require_seq_zones 8 || return $SKIP_TESTCASE
1014 reset_zone "${dev}" -1
1016 off=$((first_sequential_zone_sector * 512 - 8 * zone_size))
1017 run_fio --name=job --filename=${dev} --offset=${off} --bs=64K \
1018 --size=$((16 * zone_size)) "$(ioengine "libaio")" --rw=randread\
1019 --time_based --runtime=3 --zonemode=zbd --zonesize=${zone_size}\
1020 --direct=1 --group_reporting=1 ${job_var_opts[@]} \
1021 >> "${logfile}.${test_number}" 2>&1 || return $?
1024 # Verify that conv zones are neither locked nor opened during random write on
1025 # conv-seq mixed zones. Zone lock and zone open shall happen only on seq zones.
1030 require_zbd || return $SKIP_TESTCASE
1031 require_conv_zones 8 || return $SKIP_TESTCASE
1032 require_seq_zones 8 || return $SKIP_TESTCASE
1036 off=$((first_sequential_zone_sector * 512 - 8 * zone_size))
1037 opts+=("--size=$((16 * zone_size))" "$(ioengine "libaio")")
1038 opts+=("--zonemode=zbd" "--direct=1" "--zonesize=${zone_size}")
1039 opts+=("--max_open_zones=2" "--offset=$off")
1040 opts+=("--thread=1" "--group_reporting=1")
1041 opts+=("--time_based" "--runtime=30" "--rw=randwrite")
1042 for ((i=0;i<jobs;i++)); do
1043 opts+=("--name=job${i}" "--filename=$dev")
1044 opts+=("--bs=$(((i+1)*16))K")
1045 opts+=($(job_var_opts_exclude "--max_open_zones"))
1047 run_fio "${opts[@]}" >> "${logfile}.${test_number}" 2>&1 || return $?
1050 # Verify that zone_reset_threshold only takes logical blocks from seq
1051 # zones into account, and logical blocks of conv zones are not counted.
1055 require_zbd || return $SKIP_TESTCASE
1056 require_conv_zones 8 || return $SKIP_TESTCASE
1057 require_seq_zones 8 || return $SKIP_TESTCASE
1059 reset_zone "${dev}" -1
1061 # Total I/O size is 1/8 = 0.125 of the I/O range of cont + seq zones.
1062 # Set zone_reset_threshold as 0.1. The threshold size is less than
1063 # 0.125, then, reset count zero is expected.
1064 # On the other hand, half of the I/O range is covered by conv zones.
1065 # If fio would count the conv zones for zone_reset_threshold, the ratio
1066 # were more than 0.5 and would trigger zone resets.
1068 off=$((first_sequential_zone_sector * 512 - 8 * zone_size))
1069 io_size=$((zone_size * 16 / 8))
1070 run_fio --name=job --filename=$dev --rw=randwrite --bs=$((zone_size/16))\
1071 --size=$((zone_size * 16)) --softrandommap=1 \
1072 --io_size=$((io_size)) "$(ioengine "psync")" --offset=$off \
1073 --zonemode=zbd --direct=1 --zonesize=${zone_size} \
1074 --zone_reset_threshold=.1 --zone_reset_frequency=1.0 \
1075 ${job_var_opts[@]} --debug=zbd \
1076 >> "${logfile}.${test_number}" 2>&1 || return $?
1078 check_written ${io_size} || return $?
1079 check_reset_count -eq 0 || return $?
1082 # Check both reads and writes are executed by random I/O to conventional zones.
1084 local off capacity io read_b=0 written_b=0
1086 require_zbd || return $SKIP_TESTCASE
1087 require_conv_zones 4 || return $SKIP_TESTCASE
1089 off=$((first_sequential_zone_sector * 512 - 4 * zone_size))
1090 capacity=$(total_zone_capacity 4 $off $dev)
1091 run_fio --name=job --filename=${dev} --rw=randrw --bs=64K \
1092 --size=$((4 * zone_size)) "$(ioengine "psync")" --offset=${off}\
1093 --zonemode=zbd --direct=1 --zonesize=${zone_size} \
1094 ${job_var_opts[@]} \
1095 >> "${logfile}.${test_number}" 2>&1 || return $?
1097 written_b=$(fio_written <"${logfile}.${test_number}")
1098 read_b=$(fio_read <"${logfile}.${test_number}")
1099 io=$((written_b + read_b))
1100 echo "Number of bytes read: $read_b" >>"${logfile}.${test_number}"
1101 echo "Number of bytes written: $written_b" >>"${logfile}.${test_number}"
1102 echo "Total number of bytes read and written: $io <> $capacity" \
1103 >>"${logfile}.${test_number}"
1104 if ((io==capacity && written_b != 0 && read_b != 0)); then
1117 while [ "${1#-}" != "$1" ]; do
1119 -d) dynamic_analyzer=(valgrind "--read-var-info=yes" "--tool=drd"
1120 "--show-confl-seg=no");
1122 -e) dynamic_analyzer=(valgrind "--read-var-info=yes" "--tool=helgrind");
1124 -l) use_libzbc=1; shift;;
1125 -r) reset_all_zones=1; shift;;
1126 -t) tests+=("$2"); shift; shift;;
1127 -o) max_open_zones_opt="${2}"; shift; shift;;
1128 -v) dynamic_analyzer=(valgrind "--read-var-info=yes");
1130 -z) zbd_debug=1; shift;;
1135 if [ $# != 1 ]; then
1140 # shellcheck source=functions
1141 source "$(dirname "$0")/functions" || exit $?
1145 if [ -n "$zbd_debug" ]; then
1146 global_var_opts+=("--debug=zbd")
1149 realdev=$(readlink -f "$dev")
1150 basename=$(basename "$realdev")
1152 if [[ -b "$realdev" ]]; then
1153 major=$((0x$(stat -L -c '%t' "$realdev"))) || exit $?
1154 minor=$((0x$(stat -L -c '%T' "$realdev"))) || exit $?
1155 disk_size=$(($(<"/sys/dev/block/$major:$minor/size")*512))
1157 # When the target is a partition device, get basename of its
1158 # holder device to access sysfs path of the holder device
1159 if [[ -r "/sys/dev/block/$major:$minor/partition" ]]; then
1160 realsysfs=$(readlink "/sys/dev/block/$major:$minor")
1161 basename=$(basename "${realsysfs%/*}")
1163 logical_block_size=$(<"/sys/block/$basename/queue/logical_block_size")
1164 case "$(<"/sys/class/block/$basename/queue/zoned")" in
1165 host-managed|host-aware)
1167 if ! check_blkzone "${dev}"; then
1170 if ! result=($(first_sequential_zone "$dev")); then
1171 echo "Failed to determine first sequential zone"
1174 first_sequential_zone_sector=${result[0]}
1175 sectors_per_zone=${result[1]}
1176 zone_size=$((sectors_per_zone * 512))
1177 if ! max_open_zones=$(max_open_zones "$dev"); then
1178 echo "Failed to determine maximum number of open zones"
1181 set_io_scheduler "$basename" deadline || exit $?
1182 if [ -n "$reset_all_zones" ]; then
1183 reset_zone "$dev" -1
1187 first_sequential_zone_sector=$(((disk_size / 2) &
1188 (logical_block_size - 1)))
1189 zone_size=$(max 65536 "$logical_block_size")
1190 sectors_per_zone=$((zone_size / 512))
1192 set_io_scheduler "$basename" none || exit $?
1195 elif [[ -c "$realdev" ]]; then
1196 # For an SG node, we must have libzbc option specified
1197 if [[ ! -n "$use_libzbc" ]]; then
1198 echo "Character device files can only be used with -l (libzbc) option"
1202 if ! $(is_zbc "$dev"); then
1203 echo "Device is not a ZBC disk"
1208 if ! disk_size=($(( $(zbc_disk_sectors "$dev") * 512))); then
1209 echo "Failed to determine disk size"
1212 if ! logical_block_size=($(zbc_logical_block_size "$dev")); then
1213 echo "Failed to determine logical block size"
1216 if ! result=($(first_sequential_zone "$dev")); then
1217 echo "Failed to determine first sequential zone"
1220 first_sequential_zone_sector=${result[0]}
1221 sectors_per_zone=${result[1]}
1222 zone_size=$((sectors_per_zone * 512))
1223 if ! max_open_zones=$(max_open_zones "$dev"); then
1224 echo "Failed to determine maximum number of open zones"
1227 if [ -n "$reset_all_zones" ]; then
1228 reset_zone "$dev" -1
1232 if [[ -n ${max_open_zones_opt} ]]; then
1233 # Override max_open_zones with the script option value
1234 max_open_zones="${max_open_zones_opt}"
1235 job_var_opts+=("--max_open_zones=${max_open_zones_opt}")
1238 echo -n "First sequential zone starts at sector $first_sequential_zone_sector;"
1239 echo " zone size: $((zone_size >> 20)) MB"
1241 if [ "${#tests[@]}" = 0 ]; then
1242 readarray -t tests < <(declare -F | grep "test[0-9]*" | \
1243 tr -c -d "[:digit:]\n" | sort -n)
1264 trap 'intr=1' SIGINT
1267 for test_number in "${tests[@]}"; do
1268 rm -f "${logfile}.${test_number}"
1270 echo -n "Running test $(printf "%02d" $test_number) ... "
1271 eval "test$test_number"
1273 if ((!ret)) && check_log $test_number; then
1275 cc_status="${green}${status}${end}"
1277 elif ((ret==SKIP_TESTCASE)); then
1279 echo "${SKIP_REASON}" >> "${logfile}.${test_number}"
1280 cc_status="${cyan}${status}${end} ${SKIP_REASON}"
1284 cc_status="${red}${status}${end}"
1288 echo -e "$cc_status"
1289 echo "$status" >> "${logfile}.${test_number}"
1290 [ $intr -ne 0 ] && exit 1
1293 echo "$passed tests passed"
1294 if [ $skipped -gt 0 ]; then
1295 echo " $skipped tests skipped"
1297 if [ $failed -gt 0 ]; then
1298 echo " $failed tests failed"