Re: [PATCH] docs: iostats: Rewrite intro, remove outdated formats

[David Reaver <me@davidreaver.com>]

Konstantin Khlebnikov <koct9i@gmail.com> writes:

> There is another case when counters back to zero:
> device reattachment or reinitialization.
> The device itself might be the same or completely different,
> but statistics sampling will see only restart from zero.
>
> So, maybe rephrase that counters sometimes restarts at zero.
> For example at boot, device attachment, or counter overflows.

That makes sense. How does this version of that paragraph sound?

  All fields are cumulative, monotonic counters, except for field 9, which
  resets to zero as I/Os complete. The remaining fields reset at boot, on
  device reattachment or reinitialization, or when the underlying counter
  overflows. Applications reading these counters should detect and handle
  resets when comparing stat snapshots.

Thanks for your feedback!

Thanks,
David Reaver