public inbox for libstdc++-cvs@sourceware.org
help / color / mirror / Atom feed
* [gcc r12-6571] libstdc++: Document new std::random_device tokens
@ 2022-01-14 10:14 Jonathan Wakely
0 siblings, 0 replies; only message in thread
From: Jonathan Wakely @ 2022-01-14 10:14 UTC (permalink / raw)
To: gcc-cvs, libstdc++-cvs
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>
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2022-01-14 10:14 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-01-14 10:14 [gcc r12-6571] libstdc++: Document new std::random_device tokens Jonathan Wakely
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).