curve25519-dalek-source/src/backend/avx2/mod.rs

// -*- mode: rust; -*-
//
// This file is part of curve25519-dalek.
// Copyright (c) 2016-2018 Isis Lovecruft, Henry de Valence
// See LICENSE for licensing information.
//
// Authors:
// - Isis Agora Lovecruft <isis@patternsinthevoid.net>
// - Henry de Valence <hdevalence@hdevalence.ca>

// See the comment above the ristretto::notes module.
#![cfg_attr(
    all(feature = "nightly", feature = "stage2_build"), doc(include = "../docs/avx2-notes.md")
)]

pub(crate) mod field;

pub(crate) mod edwards;

pub(crate) mod constants;

pub(crate) mod scalar_mul;
first avx2 code 2017-10-23 21:03:23 +00:00			`// -- mode: rust; --`
			`//`
			`// This file is part of curve25519-dalek.`
Update year in copyright notices to 2018. 2018-07-05 00:24:41 +00:00			`// Copyright (c) 2016-2018 Isis Lovecruft, Henry de Valence`
first avx2 code 2017-10-23 21:03:23 +00:00			`// See LICENSE for licensing information.`
			`//`
			`// Authors:`
			`// - Isis Agora Lovecruft <isis@patternsinthevoid.net>`
			`// - Henry de Valence <hdevalence@hdevalence.ca>`

Split AVX2 docs into markdown file 2018-04-08 22:15:23 +00:00			`// See the comment above the ristretto::notes module.`
Rename 'precomputed_tables' to the more accurate 'stage2_build' 2018-05-14 22:41:45 +00:00			`#![cfg_attr(`
			`all(feature = "nightly", feature = "stage2_build"), doc(include = "../docs/avx2-notes.md")`
			`)]`
Write up notes on the AVX2 backend 2017-11-27 22:06:04 +00:00
first avx2 code 2017-10-23 21:03:23 +00:00			`pub(crate) mod field;`

			`pub(crate) mod edwards;`
Add double-base scalar vartime for AVX2 2017-11-30 20:39:23 +00:00
			`pub(crate) mod constants;`
Split out constant-time variable-base scalar mul. The serial (`u32`/`u64`) implementations use a multiple curve models, passing between extended and projective coordinates when performing addition and doubling (respectively). But the AVX2 backend doesn't, so in order to write a single scalar mult implementation, we have to either abstract over the curve models or have two implementations. A generic solution is possible but extremely unreadable: the scalar mul implementation would be parameterized over the point types used by the serial implementations, with many where clauses describing how the types relate. The AVX2 types could then be substituted in the appropriate places. Instead we just duplicate the code into the `avx2` backend. 2018-03-26 22:01:48 +00:00
			`pub(crate) mod scalar_mul;`