From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <redi@sourceware.org>
Received: by sourceware.org (Postfix, from userid 2181)
 id 3E8AF3858401; Fri, 14 Jan 2022 10:14:39 +0000 (GMT)
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 3E8AF3858401
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="utf-8"
From: Jonathan Wakely <redi@gcc.gnu.org>
To: gcc-cvs@gcc.gnu.org, libstdc++-cvs@gcc.gnu.org
Subject: [gcc r12-6571] libstdc++: Document new std::random_device tokens
X-Act-Checkin: gcc
X-Git-Author: Jonathan Wakely <jwakely@redhat.com>
X-Git-Refname: refs/heads/master
X-Git-Oldrev: 51e9e8a2e2098d87e4e1932424938bd11078860f
X-Git-Newrev: 7f390f11b445ee36cce5c5f1d5779baee817f0af
Message-Id: <20220114101439.3E8AF3858401@sourceware.org>
Date: Fri, 14 Jan 2022 10:14:39 +0000 (GMT)
X-BeenThere: libstdc++-cvs@gcc.gnu.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Libstdc++-cvs mailing list <libstdc++-cvs.gcc.gnu.org>
List-Unsubscribe: <https://gcc.gnu.org/mailman/options/libstdc++-cvs>,
 <mailto:libstdc++-cvs-request@gcc.gnu.org?subject=unsubscribe>
List-Archive: <https://gcc.gnu.org/pipermail/libstdc++-cvs/>
List-Help: <mailto:libstdc++-cvs-request@gcc.gnu.org?subject=help>
List-Subscribe: <https://gcc.gnu.org/mailman/listinfo/libstdc++-cvs>,
 <mailto:libstdc++-cvs-request@gcc.gnu.org?subject=subscribe>
X-List-Received-Date: Fri, 14 Jan 2022 10:14:39 -0000

https://gcc.gnu.org/g:7f390f11b445ee36cce5c5f1d5779baee817f0af

commit r12-6571-g7f390f11b445ee36cce5c5f1d5779baee817f0af
Author: Jonathan Wakely <jwakely@redhat.com>
Date:   Tue Jan 11 21:27:28 2022 +0000

    libstdc++: Document new std::random_device tokens
    
    libstdc++-v3/ChangeLog:
    
            * doc/xml/manual/status_cxx2011.xml: Document new tokens
            accepted by std::random_device constructor.
            * doc/html/manual/status.html: Regenerate.

Diff:
---
 libstdc++-v3/doc/html/manual/status.html       | 13 +++++++++++
 libstdc++-v3/doc/xml/manual/status_cxx2011.xml | 30 ++++++++++++++++++++++++++
 2 files changed, 43 insertions(+)

diff --git a/libstdc++-v3/doc/html/manual/status.html b/libstdc++-v3/doc/html/manual/status.html
index ad612310b5d..c449fdec928 100644
--- a/libstdc++-v3/doc/html/manual/status.html
+++ b/libstdc++-v3/doc/html/manual/status.html
@@ -325,6 +325,19 @@ particular release.
           instruction to read from an on-chip hardware random number generator.
           These tokens are only valid for x86 and x86_64 targets when both
           the assembler and CPU support the corresponding instruction.
+        </dd><dt><span class="term"><code class="literal">"darn"</code></span></dt><dd>
+          Use the Power ISA-3.0 <code class="literal">DARN</code>
+          ("Deliver A Random Number")
+          instruction to read from an on-chip hardware random number generator.
+          This token is only valid for 64-bit powerpc targets when both
+          the assembler and CPU support the corresponding instruction.
+        </dd><dt><span class="term"><code class="literal">"hw"</code>, </span><span class="term"><code class="literal">"hardware"</code></span></dt><dd>
+          Use any available CPU
+          instruction to read from an on-chip hardware random number generator.
+          This is equivalent to trying each of the following and using the
+          first that is supported:
+          <code class="literal">"rdseed"</code><code class="literal">"rdrand"</code><code class="literal">"darn"</code></dd><dt><span class="term"><code class="literal">"arc4random"</code>, </span><span class="term"><code class="literal">"getentropy"</code></span></dt><dd>
+          Use the named C library function, if available on the target.
         </dd><dt><span class="term"><code class="literal">"/dev/urandom"</code>, </span><span class="term"><code class="literal">"/dev/random"</code></span></dt><dd>
           Use the named character special file to read random bytes from.
           These tokens are only valid when the device files are present
diff --git a/libstdc++-v3/doc/xml/manual/status_cxx2011.xml b/libstdc++-v3/doc/xml/manual/status_cxx2011.xml
index 88844f8f0cc..1eeb2d1ccd7 100644
--- a/libstdc++-v3/doc/xml/manual/status_cxx2011.xml
+++ b/libstdc++-v3/doc/xml/manual/status_cxx2011.xml
@@ -2720,6 +2720,36 @@ particular release.
           the assembler and CPU support the corresponding instruction.
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term><literal>"darn"</literal></term>
+        <listitem>
+          Use the Power ISA-3.0 <literal>DARN</literal>
+          ("Deliver A Random Number")
+          instruction to read from an on-chip hardware random number generator.
+          This token is only valid for 64-bit powerpc targets when both
+          the assembler and CPU support the corresponding instruction.
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><literal>"hw"</literal></term>
+        <term><literal>"hardware"</literal></term>
+        <listitem>
+          Use any available CPU
+          instruction to read from an on-chip hardware random number generator.
+          This is equivalent to trying each of the following and using the
+          first that is supported:
+          <literal>"rdseed"</literal>
+          <literal>"rdrand"</literal>
+          <literal>"darn"</literal>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><literal>"arc4random"</literal></term>
+        <term><literal>"getentropy"</literal></term>
+        <listitem>
+          Use the named C library function, if available on the target.
+        </listitem>
+      </varlistentry>
       <varlistentry>
         <term><literal>"/dev/urandom"</literal></term>
         <term><literal>"/dev/random"</literal></term>