man(1) Manual page archive


     IOPS(8)                                                   IOPS(8)

              delim $$

     NAME
          iops - measure IOPS and throughput

     SYNOPSYS
          disk/iops [ -v [ rws ] [ -p prog ] ... [ file

     DESCRIPTION
          Iops uses a command-line specified programs to generate an
          I/O pattern to measure I/O throughput and IOPS on the given
          files.  Each program is run on each file.  Programs, speci-
          fied with -p, consist of single-character op codes, some
          with a postfix argument.  The opcodes either do I/O or
          manipulate the internal registers, which are:

          offset  The base offset int the file.  I/O is at byte loca-
                  tion $o + roman lba * ss$.  The initial value is 0.
          ss      The sector size.  The initial value is 512.
          lba     The current sector.  The initial value is 0.

          The size of the file is determined by dirstat (see stat(2)).
          Neither loops nor timing nest.  Whitespace is ignored.  The
          op codes are

          :n     Begin loop of n iterations.
          ;      End loop.
          {      Begin timing.
          }      End timing.  Print the elapsed time time, read,
                 write, and combined throughput and iops.
          on     Set the offset register to n.
          zss    Set the ss register to ss.
          r      Read one sector.
          w      Write one sector.
          s=n    Set the lba register to n.
          sr     Set a random lba in the file.  The maximum lba is $(
                 roman "size" - o)/ss$.
          sn     Increment the lba by n sectors.

          The -v flag prints debugging information based on its argu-
          ments; s prints the lba after a seek, r prints the lba of a
          read, and w prints the lba of a write.

     SOURCE
          /sys/src/cmd/disk/iops.c

     BUGS
          No nesting.  Output is pre-divided.