[<prev] [next>] [<thread-prev] [day] [month] [year] [list]
Message-ID: <CALYGNiO1sbk-Z8MU_axDBWK7U+edw+yEU9mMTDDS3j9Uzj81qQ@mail.gmail.com>
Date: Sat, 15 Feb 2025 18:46:53 +0100
From: Konstantin Khlebnikov <koct9i@...il.com>
To: David Reaver <me@...idreaver.com>
Cc: Jonathan Corbet <corbet@....net>, Randy Dunlap <rdunlap@...radead.org>, Jens Axboe <axboe@...nel.dk>,
linux-doc@...r.kernel.org, linux-block@...r.kernel.org,
linux-kernel@...r.kernel.org
Subject: Re: [PATCH] docs: iostats: Rewrite intro, remove outdated formats
On Sat, 15 Feb 2025 at 18:30, David Reaver <me@...idreaver.com> wrote:
>
> Konstantin Khlebnikov <koct9i@...il.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?
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
Powered by blists - more mailing lists