public inbox for libstdc++-cvs@sourceware.org help / color / mirror / Atom feed
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 Date: Fri, 14 Jan 2022 10:14:39 +0000 (GMT) [thread overview] Message-ID: <20220114101439.3E8AF3858401@sourceware.org> (raw) 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>
reply other threads:[~2022-01-14 10:14 UTC|newest] Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=20220114101439.3E8AF3858401@sourceware.org \ --to=redi@gcc.gnu.org \ --cc=gcc-cvs@gcc.gnu.org \ --cc=libstdc++-cvs@gcc.gnu.org \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
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).