From patchwork Thu Sep 17 13:45:51 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 7207711 X-Patchwork-Delegate: herbert@gondor.apana.org.au Return-Path: X-Original-To: patchwork-linux-crypto@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork1.web.kernel.org (Postfix) with ESMTP id AEAD99F380 for ; Thu, 17 Sep 2015 13:48:32 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id D4A7C207CB for ; Thu, 17 Sep 2015 13:48:31 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id A6E6320752 for ; Thu, 17 Sep 2015 13:48:30 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752471AbbIQNsT (ORCPT ); Thu, 17 Sep 2015 09:48:19 -0400 Received: from mail-wi0-f175.google.com ([209.85.212.175]:36597 "EHLO mail-wi0-f175.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751523AbbIQNqF (ORCPT ); Thu, 17 Sep 2015 09:46:05 -0400 Received: by wicgb1 with SMTP id gb1so118739981wic.1 for ; Thu, 17 Sep 2015 06:46:04 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=C0ZgWywkZwYltImuJlYuQ0sEToFGO8nyFDNFkP+oXEw=; b=bi6K+fiQViFokjdsPxXT3QP6INm6xpaPdoejEhak6+jnrggF/E3ZHAmr103eybvQmd qDyWmFUAgPNt/T4zAN32CsyY87+W1fQ161eQuyS5wKj2ZgP6AWExh6Wf5DAHuwkbkDR6 QgaNaeMVOrVatQEmMJcVEmJ7rs06hrVPzErdbmvrDEUl6pZeho3OwmSmj0ojL5o14Zw7 NExd2sCcakgss2i+gT42zhz0F5ZKfmRVdLEqdlfgH3tw/8tOsNQKxM5aqhxhL3aPzJRK j6qNfVpkp9wFqiDRDwOBBrKdLj8fJouEiWoP+WTUokJ105Pii10Fh5KwUM/fHKbgS2QX cYNw== X-Gm-Message-State: ALoCoQmjstiRQ/UnlxBQ6tqXdPLBomKErDZVC7YzMyxLzOaSXtm6FlInGqZF0EcUu/nh6MJEbyCq X-Received: by 10.194.110.37 with SMTP id hx5mr63945695wjb.149.1442497564477; Thu, 17 Sep 2015 06:46:04 -0700 (PDT) Received: from x1.o2wifi.co.uk ([46.233.116.143]) by smtp.gmail.com with ESMTPSA id hk5sm3547895wjb.6.2015.09.17.06.46.02 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Thu, 17 Sep 2015 06:46:03 -0700 (PDT) From: Lee Jones To: linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, herbert@gondor.apana.org.au, linux-crypto@vger.kernel.org, peter@korsgaard.com, festevam@gmail.com, kieranbingham@gmail.com Cc: kernel@stlinux.com, Lee Jones Subject: [PATCH v2 1/7] Documentation: hw_random: Fix device node name reference /dev/hw_random => /dev/hwrng Date: Thu, 17 Sep 2015 14:45:51 +0100 Message-Id: <1442497557-9271-2-git-send-email-lee.jones@linaro.org> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1442497557-9271-1-git-send-email-lee.jones@linaro.org> References: <1442497557-9271-1-git-send-email-lee.jones@linaro.org> Sender: linux-crypto-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-crypto@vger.kernel.org X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_HI, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP In April 2009, commit d405640 ("Driver Core: misc: add node name support for misc devices.") inadvertently changed the device node name from /dev/hw_random to /dev/hwrng. Since 6 years has passed since the change it seems unpractical to change it back, as this node name is probably considered ABI by now. So instead, we'll just change the documentation to match the current situation. NB: It looks like rng-tools have already been updated. Signed-off-by: Lee Jones Acked-by: Kieran Bingham --- Documentation/hw_random.txt | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Documentation/hw_random.txt b/Documentation/hw_random.txt index 026e237..fce1634 100644 --- a/Documentation/hw_random.txt +++ b/Documentation/hw_random.txt @@ -3,7 +3,7 @@ Introduction: The hw_random framework is software that makes use of a special hardware feature on your CPU or motherboard, a Random Number Generator (RNG). The software has two parts: - a core providing the /dev/hw_random character device and its + a core providing the /dev/hwrng character device and its sysfs support, plus a hardware-specific driver that plugs into that core. @@ -14,7 +14,7 @@ Introduction: http://sourceforge.net/projects/gkernel/ - Those tools use /dev/hw_random to fill the kernel entropy pool, + Those tools use /dev/hwrng to fill the kernel entropy pool, which is used internally and exported by the /dev/urandom and /dev/random special files. @@ -32,13 +32,13 @@ Theory of operation: The rng-tools package uses such tests in "rngd", and lets you run them by hand with a "rngtest" utility. - /dev/hw_random is char device major 10, minor 183. + /dev/hwrng is char device major 10, minor 183. CLASS DEVICE. There is a /sys/class/misc/hw_random node with two unique attributes, "rng_available" and "rng_current". The "rng_available" attribute lists the hardware-specific drivers available, while "rng_current" lists the one which is currently - connected to /dev/hw_random. If your system has more than one + connected to /dev/hwrng. If your system has more than one RNG available, you may change the one used by writing a name from the list in "rng_available" into "rng_current".