From: Rob Herring <robh@kernel.org>
To: Samuel Ortiz <sameo@rivosinc.com>
Cc: "Paul Walmsley" <paul.walmsley@sifive.com>,
"Palmer Dabbelt" <palmer@dabbelt.com>,
"Albert Ou" <aou@eecs.berkeley.edu>,
linux-riscv@lists.infradead.org, linux@rivosinc.com,
"Conor Dooley" <conor.dooley@microchip.com>,
"Andrew Jones" <ajones@ventanamicro.com>,
"Heiko Stuebner" <heiko.stuebner@vrull.eu>,
"Anup Patel" <apatel@ventanamicro.com>,
linux-kernel@vger.kernel.org,
"Hongren (Zenithal) Zheng" <i@zenithal.me>,
"Guo Ren" <guoren@kernel.org>,
"Atish Patra" <atishp@rivosinc.com>,
"Björn Töpel" <bjorn@rivosinc.com>,
"Evan Green" <evan@rivosinc.com>,
devicetree@vger.kernel.org
Subject: Re: [PATCH v3 2/4] dt-bindings: riscv: Document the 1.0 scalar cryptography extensions
Date: Mon, 10 Jul 2023 09:16:24 -0600 [thread overview]
Message-ID: <20230710151624.GA1987602-robh@kernel.org> (raw)
In-Reply-To: <20230709115549.2666557-3-sameo@rivosinc.com>
On Sun, Jul 09, 2023 at 01:55:44PM +0200, Samuel Ortiz wrote:
> The RISC-V cryptography extensions define a set of instructions, CSR
> definitions, architectural interfaces and also extension shorthands for
> running scalar and vector based cryptography operations on RISC-V
> systems.
>
> This documents all the dt-bindings for the scalar cryptography
> extensions, including the Zk, Zkn and Zks shorthands.
>
> Signed-off-by: Samuel Ortiz <sameo@rivosinc.com>
> ---
> .../devicetree/bindings/riscv/extensions.yaml | 82 +++++++++++++++++++
> 1 file changed, 82 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/riscv/extensions.yaml b/Documentation/devicetree/bindings/riscv/extensions.yaml
> index cc1f546fdbdc..361756978da1 100644
> --- a/Documentation/devicetree/bindings/riscv/extensions.yaml
> +++ b/Documentation/devicetree/bindings/riscv/extensions.yaml
> @@ -190,6 +190,24 @@ properties:
> instructions as ratified at commit 6d33919 ("Merge pull request #158
> from hirooih/clmul-fix-loop-end-condition") of riscv-bitmanip.
>
> + - const: zbkb
> + description: |
Don't need '|' if no formatting to preserve.
> + The standard Zbkb cryptography extension for bit-manipulation
> + instructions, as ratified at commit 73de909
> + ("Zvk: Update AES instruction specs") of riscv-crypto.
> +
> + - const: zbkc
> + description: |
> + The standard Zbkc cryptography extension for carry-less multiply
> + instructions, as ratified at commit 73de909
> + ("Zvk: Update AES instruction specs") of riscv-crypto.
> +
> + - const: zbkx
> + description: |
> + The standard Zbkx cryptography extension for crossbar permutation
> + instructions, as ratified at commit 73de909
> + ("Zvk: Update AES instruction specs") of riscv-crypto.
> +
> - const: zicbom
> description:
> The standard Zicbom extension for base cache management operations as
> @@ -240,6 +258,70 @@ properties:
> ratified in the 20191213 version of the unprivileged ISA
> specification.
>
> + - const: zk
> + description: |
> + The standard Zk cryptography extension is a shorthand for the
> + union of the Zkn, Zkr and Zkt cryptography extensions, as ratified
> + at commit 73de909 ("Zvk: Update AES instruction specs") of
> + riscv-crypto.
> +
> + - const: zkn
> + description: |
> + The standard Zkn cryptography extension covers the NIST algorithm
> + suite that other cryptography extensions support. It is the union of
> + the Zbkb, Zbkc, Zbkx, Zknd, Zkne and Zknh extensions, as ratified at
> + commit 73de909 ("Zvk: Update AES instruction specs") of riscv-crypto.
> +
> + - const: zknd
> + description: |
> + The standard Zknd cryptography extension for AES block cipher
> + decryption acceleration instructions, as ratified at commit 73de909
> + ("Zvk: Update AES instruction specs") of riscv-crypto.
> +
> + - const: zkne
> + description: |
> + The standard Zkne cryptography extension for AES block cipher
> + encryption acceleration instructions, as ratified at commit 73de909
> + ("Zvk: Update AES instruction specs") of riscv-crypto.
> +
> + - const: zknh
> + description: |
> + The standard Zknh cryptography extension for SHA2 hash algorithm
> + functions acceleration instructions as ratified at commit 73de909
> + ("Zvk: Update AES instruction specs") of riscv-crypto.
> +
> + - const: zkr
> + description: |
> + The standard Zkr cryptography extension for the entropy source CSR
> + definitions, as ratified at commit 73de909
> + ("Zvk: Update AES instruction specs") of riscv-crypto.
> +
> + - const: zks
> + description: |
> + The standard Zks cryptography extension covers the ShangMi algorithm
> + suite that other cryptography extensions support. It is the union of
> + the Zbkb, Zbkc, Zbkx, Zksed and Zksh extensions, as ratified at
> + commit 73de909 ("Zvk: Update AES instruction specs") of riscv-crypto.
> +
> + - const: zksed
> + description: |
> + The standard Zksed cryptography extension for SM4 block cipher
> + acceleration instructions, as ratified at commit 73de909
> + ("Zvk: Update AES instruction specs") of riscv-crypto.
> +
> + - const: zksh
> + description: |
> + The standard Zksh cryptography extension for SM3 hash algorithm
> + funstions acceleration instructions, as ratified at commit 73de909
> + ("Zvk: Update AES instruction specs") of riscv-crypto.
> +
> + - const: zkt
> + description: |
> + The standard Zkt cryptography extension for data independent
> + execution latency attestation, for a safe subset of instructions,
> + as ratified at commit 73de909 ("Zvk: Update AES instruction specs")
> + of riscv-crypto.
> +
> - const: ztso
> description:
> The standard Ztso extension for total store ordering, as ratified
> --
> 2.41.0
>
_______________________________________________
linux-riscv mailing list
linux-riscv@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-riscv
next prev parent reply other threads:[~2023-07-10 15:16 UTC|newest]
Thread overview: 16+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-07-09 11:55 [PATCH v3 0/4] RISC-V: archrandom support Samuel Ortiz
2023-07-09 11:55 ` [PATCH v3 1/4] RISC-V: Add Bitmanip/Scalar Crypto parsing from DT Samuel Ortiz
2023-07-09 13:24 ` Heiko Stuebner
2023-07-09 14:08 ` Heiko Stuebner
2023-07-09 11:55 ` [PATCH v3 2/4] dt-bindings: riscv: Document the 1.0 scalar cryptography extensions Samuel Ortiz
2023-07-09 13:25 ` Heiko Stuebner
2023-07-09 14:08 ` Heiko Stuebner
2023-07-10 15:16 ` Rob Herring [this message]
2023-07-10 15:42 ` Conor Dooley
2023-07-11 17:28 ` Samuel Ortiz
2023-07-11 18:29 ` Conor Dooley
2023-07-09 11:55 ` [PATCH v3 3/4] RISC-V: hwprobe: Expose Zbc and the scalar crypto extensions Samuel Ortiz
2023-07-09 11:55 ` [PATCH v3 4/4] RISC-V: Implement archrandom when Zkr is available Samuel Ortiz
2023-07-09 14:06 ` Heiko Stuebner
2023-07-11 17:17 ` Samuel Ortiz
2023-07-09 14:08 ` Heiko Stuebner
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=20230710151624.GA1987602-robh@kernel.org \
--to=robh@kernel.org \
--cc=ajones@ventanamicro.com \
--cc=aou@eecs.berkeley.edu \
--cc=apatel@ventanamicro.com \
--cc=atishp@rivosinc.com \
--cc=bjorn@rivosinc.com \
--cc=conor.dooley@microchip.com \
--cc=devicetree@vger.kernel.org \
--cc=evan@rivosinc.com \
--cc=guoren@kernel.org \
--cc=heiko.stuebner@vrull.eu \
--cc=i@zenithal.me \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-riscv@lists.infradead.org \
--cc=linux@rivosinc.com \
--cc=palmer@dabbelt.com \
--cc=paul.walmsley@sifive.com \
--cc=sameo@rivosinc.com \
/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: link
Be 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 NNTP newsgroup(s).