examples/xnvme-compare.fio

   1 ; Compare fio IO engines with a random-read workload using BS=4k at QD=1
   2 ;
   3 ; README
   4 ;
   5 ; This job-file is intended to be used as:
   6 ;
   7 ; # Use the built-in io_uring engine to get baseline numbers
   8 ; fio examples/xnvme-compare.fio \
   9 ;   --section=default \
  10 ;   --ioengine=io_uring \
  11 ;   --sqthread_poll=1 \
  12 ;   --filename=/dev/nvme0n1
  13 ;
  14 ; # Use the xNVMe io-engine engine with Linux backend and io_uring async. impl.
  15 ; fio examples/xnvme-compare.fio \
  16 ;   --section=default \
  17 ;   --ioengine=xnvme \
  18 ;   --sqthread_poll=1 \
  19 ;   --xnvme_async=io_uring \
  20 ;   --filename=/dev/nvme0n1
  21 ;
  22 ; # Use the xNVMe io-engine engine with Linux backend and libaio async. impl.
  23 ; fio examples/xnvme-compare.fio \
  24 ;   --section=default \
  25 ;   --ioengine=xnvme \
  26 ;   --xnvme_async=libaio \
  27 ;   --filename=/dev/nvme0n1
  28 ;
  29 ; # Use the xNVMe io-engine engine with SPDK backend, note that you have to set the Namespace-id
  30 ; fio examples/xnvme-compare.fio \
  31 ;   --section=default \
  32 ;   --ioengine=xnvme \
  33 ;   --xnvme_dev_nsid=1 \
  34 ;   --filename=0000\\:01\\:00.0
  35 ;
  36 ; NOTE: The URI encoded in the filename above, the ":" must be escaped.
  37 ;
  38 ; On the command-line using two "\\":
  39 ;
  40 ; --filename=0000\\:01\\:00.0
  41 ;
  42 ; Within a fio-script using a single "\":
  43 ;
  44 ; filename=0000\:01\:00.0
  45 ;
  46 ; NOTE: If you want to override the default bs, iodepth, and workload, then
  47 ; invoke it as:
  48 ;
  49 ; FIO_BS="512" FIO_RW="verify" FIO_IODEPTH=16 fio examples/xnvme-compare.fio \
  50 ;   --section=override
  51 ;
  52 [global]
  53 rw=randread
  54 size=12G
  55 iodepth=1
  56 bs=4K
  57 direct=1
  58 thread=1
  59 time_based=1
  60 runtime=7
  61 ramp_time=3
  62 norandommap=1
  63
  64 ; Avoid accidentally creating device files; e.g. "/dev/nvme0n1", "/dev/nullb0"
  65 allow_file_create=0
  66
  67 [default]
  68
  69 [override]
  70 rw=${FIO_RW}
  71 iodepth=${FIO_IODEPTH}
  72 bs=${FIO_BS}