From patchwork Fri Oct 18 16:02:56 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 176892 Delivered-To: patch@linaro.org Received: by 2002:a92:7e96:0:0:0:0:0 with SMTP id q22csp1054398ill; Fri, 18 Oct 2019 09:03:01 -0700 (PDT) X-Google-Smtp-Source: APXvYqxOiq9Oxkj6ipNhhz9tzejtd7l1ExM8RYXj9LXDbkfG9XldO8jR611jm1CVlpD4g0yJvHxT X-Received: by 2002:adf:e80b:: with SMTP id o11mr8620683wrm.231.1571414581721; Fri, 18 Oct 2019 09:03:01 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1571414581; cv=none; d=google.com; s=arc-20160816; b=NbjaGesj9IQT5se3w8aMppb6UBd78vfN35fzSoekyvYO+b4NCUmBIErxeCIGTAqlI/ oi6y7F6FLaKiFduw9+eqmxYu3l1tkRdGdJkN57wT5lG7Ns6A6tC+gcNaMgdnTzQwp60L OxrO4Bifz4V6QF/eG1Kf4HlkxkBll2iMmhUHy/OwFmHYxGiS3eol5cw0JIl0eSGye6Om lxTkDsSzDRgvHsO5tA9WDE23zLukTE64zRh1R+FNJEpVGqmyBNsyo17EFfVGh0hOaEvM PJPdpfq6z+klrO35O6HcrEu0SVSq5o/4JAW3V6lvDogTzziLDbVoIcggCf9L4dJR1/ig 3hpQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :organization:message-id:subject:cc:to:from:date; bh=1Mw3dWwZFDj/Y7eBrFPlAHMgaiiSpLrjm1YI0feag1k=; b=ZwNVzGigxRan7Whhb9OV3+FkkKgCeeqU/j6XKcbaXTfVoHsr/TNFksGjDq3BONXqga Y6k/xpoZ00nq2DOiAGUxO2XcVkckNFy7laGA01A9mDIxjym8fAqY2pYTf8gOqgGGCbgL JoNSIuOiFGweTqx8NwOwGnH7F3IagSDHckentN8sEhG+JKSkHq/C5QxkVUYdxCBaEGC6 cxKQcJiwul2CAS3CQ1eB6v04iQtzQaUpMnOxNCV8T8E4N/nAZu5OYTTiKk9vvb49dz2q trn5x0KpuawCiD5bY5I7h+iMWUEFIwq1bYRViZgJkV15F7xc19rQ51cOndSlkEyOpG3l 86PA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id jr6si3431080ejb.307.2019.10.18.09.03.01; Fri, 18 Oct 2019 09:03:01 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2409125AbfJRQC6 (ORCPT + 26 others); Fri, 18 Oct 2019 12:02:58 -0400 Received: from ms.lwn.net ([45.79.88.28]:36802 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2408951AbfJRQC6 (ORCPT ); Fri, 18 Oct 2019 12:02:58 -0400 Received: from lwn.net (localhost [127.0.0.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id AC26C2CA; Fri, 18 Oct 2019 16:02:57 +0000 (UTC) Date: Fri, 18 Oct 2019 10:02:56 -0600 From: Jonathan Corbet To: linux-doc@vger.kernel.org Cc: LKML Subject: [PATCH RFC] Docs: mark admin-guide/iostats.rst as needing updates Message-ID: <20191018100256.75bb5c60@lwn.net> Organization: LWN.net MIME-Version: 1.0 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org This file tells us all about how 2.4 reported I/O statistics, which is less than fully useful. Put a note at the top advising of this fact and requesting some kind soul to bring things up to date. Signed-off-by: Jonathan Corbet --- I'm thinking about beginning to sprinkle these around Documentation/ in the hope that they inspire helpful people to improve the situation. It works (I think?) for wikipedia, maybe we should give it a try... Documentation/admin-guide/iostats.rst | 5 +++++ 1 file changed, 5 insertions(+) -- 2.21.0 diff --git a/Documentation/admin-guide/iostats.rst b/Documentation/admin-guide/iostats.rst index 5d63b18bd6d1..2d1b1c15fd91 100644 --- a/Documentation/admin-guide/iostats.rst +++ b/Documentation/admin-guide/iostats.rst @@ -2,6 +2,11 @@ I/O statistics fields ===================== +.. note:: + + This document contains a great deal of outdated information; please + consider helping out by updating it to match current reality. + Since 2.4.20 (and some versions before, with patches), and 2.5.45, more extensive disk statistics have been introduced to help measure disk activity. Tools such as ``sar`` and ``iostat`` typically interpret these and do