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

[Konstantin Khlebnikov]

On Sat, 15 Feb 2025 at 18:30, David Reaver <me@xxxxxxxxxxxxxxx> wrote:
>
> Konstantin Khlebnikov <koct9i@xxxxxxxxx> 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?

LGTM

>
>   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