From patchwork Fri Jan 14 10:14:55 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Wakely X-Patchwork-Id: 50015 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 4FCE03858C27 for ; Fri, 14 Jan 2022 10:16:38 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 4FCE03858C27 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1642155398; bh=PU+/FJmrlDcenueGMUcv2qoYBSkoHaTeFMMKIOdpt+0=; h=To:Subject:Date:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:From; b=rprO/PkGvSxhEcOCtPorrnKKU4gVgvKH55A0kDwRDcdKcKfEmM8+Hgmeu98Kj4n2O qYg03rwwZl6RBHihRLXs0K+8+hA1TKJA0NCM1H1eDh5C5VzuyEctnmJ3qqY8l/dT0e T486EnqiptJM3yO5FN95gyVMkq3/hu43SgQuJsbQ= X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by sourceware.org (Postfix) with ESMTPS id 4906E3857C69 for ; Fri, 14 Jan 2022 10:15:01 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 4906E3857C69 Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-650-QV5F53LuPWSsuDclg701pA-1; Fri, 14 Jan 2022 05:14:57 -0500 X-MC-Unique: QV5F53LuPWSsuDclg701pA-1 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id B391636393; Fri, 14 Jan 2022 10:14:56 +0000 (UTC) Received: from localhost (unknown [10.33.36.252]) by smtp.corp.redhat.com (Postfix) with ESMTP id 62EA27B9D1; Fri, 14 Jan 2022 10:14:56 +0000 (UTC) To: libstdc++@gcc.gnu.org, gcc-patches@gcc.gnu.org Subject: [committed] libstdc++: Document new std::random_device tokens Date: Fri, 14 Jan 2022 10:14:55 +0000 Message-Id: <20220114101455.2975204-1-jwakely@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com X-Spam-Status: No, score=-13.9 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL, SPF_HELO_NONE, SPF_NONE, TXREP autolearn=unavailable autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Jonathan Wakely via Gcc-patches From: Jonathan Wakely Reply-To: Jonathan Wakely Errors-To: gcc-patches-bounces+patchwork=sourceware.org@gcc.gnu.org Sender: "Gcc-patches" Pushed to trunk. libstdc++-v3/ChangeLog: * doc/xml/manual/status_cxx2011.xml: Document new tokens accepted by std::random_device constructor. * doc/html/manual/status.html: Regenerate. --- libstdc++-v3/doc/html/manual/status.html | 13 ++++++++ .../doc/xml/manual/status_cxx2011.xml | 30 +++++++++++++++++++ 2 files changed, 43 insertions(+) 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. + + "darn" + + Use the Power ISA-3.0 DARN + ("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. + + + + "hw" + "hardware" + + 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: + "rdseed" + "rdrand" + "darn" + + + + "arc4random" + "getentropy" + + Use the named C library function, if available on the target. + + "/dev/urandom" "/dev/random"