Bug 231313 - iostat manpages don't describe -x output
Summary: iostat manpages don't describe -x output
Status: Closed Feedback Timeout
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: freebsd-bugs mailing list
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2018-09-11 23:17 UTC by Nick Venenga
Modified: 2020-05-19 13:19 UTC (History)
3 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Nick Venenga 2018-09-11 23:17:00 UTC
root@OPNsense:~ # iostat -x
                        extended device statistics
device       r/s     w/s     kr/s     kw/s  ms/r  ms/w  ms/o  ms/t qlen  %b
ada0           0       2      7.5     73.1     0    97     0    76    0   2
pass0          0       0      0.0      0.0     7     0     1     4    0   0

I don't see any description of "ms/*" columns in the manpage

Excerpt:
           The extended iostat device display, with the -x flag specified,
           shows the following statistics:

           r/s     read operations per second
           w/s     write operations per second
           kr/s    kilobytes read per second
           kw/s    kilobytes write per second
           qlen    transactions queue length
           svc_t   average duration of transactions, in milliseconds
           %b      % of time the device had one or more outstanding
                   transactions
Comment 1 Nick Venenga 2018-09-11 23:20:53 UTC
I'm seeing this on opnsense and freenas (both 11.1)
Comment 2 Conrad Meyer freebsd_committer 2018-09-11 23:56:20 UTC
ms is short for milliseconds, which are 1/1000 of a second.
Comment 3 Nick Venenga 2018-09-12 01:13:15 UTC
Sure, but if these are "milliseconds per read" what is the timeframe these are being measured in? Also not clear what o and t are (operations and transactions..?)
Comment 4 Conrad Meyer freebsd_committer 2018-09-12 01:48:41 UTC
Seems like it was fixed only quite recently on CURRENT: https://svnweb.freebsd.org/base?view=revision&revision=338103

           The extended iostat device display, with the -x flag specified,
           shows the following statistics:

           r/s     read operations per second
           w/s     write operations per second
           kr/s    kilobytes read per second
           kw/s    kilobytes write per second
           qlen    transactions queue length
           ms/r    average duration of read transactions, in milliseconds
           ms/w    average duration of write transactions, in milliseconds
           ms/o    average duration of all other transactions, in milliseconds
           ms/t    average duration of all transactions, in milliseconds
           %b      % of time the device had one or more outstanding
                   transactions
Comment 5 Benedict Reuschling freebsd_committer 2020-05-19 13:19:12 UTC
I'm closing this with feedback timeout, as there was no reply to Conrad's comment since Sept. 2018.