     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73

    // Copyright 2015-2017 Brian Smith.
    //
    // Permission to use, copy, modify, and/or distribute this software for any
    // purpose with or without fee is hereby granted, provided that the above
    // copyright notice and this permission notice appear in all copies.
    //
    // THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHORS DISCLAIM ALL WARRANTIES
    // WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
    // MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
    // SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
    // WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
    // OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
    // CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

    use {ec, error, rand};

    /// A key agreement algorithm.
    macro_rules! suite_b_curve {
        ( $NAME:ident, $bits:expr, $private_key_ops:expr, $id:expr,
          $check_private_key_bytes:ident, $generate_private_key:ident,
          $public_from_private:ident) =>
        {
            /// Public keys are encoding in uncompressed form using the
            /// Octet-String-to-Elliptic-Curve-Point algorithm in
            /// [SEC 1: Elliptic Curve Cryptography, Version 2.0]. Public keys are
            /// validated during key agreement according to
            /// [NIST Special Publication 800-56A, revision 2] and Appendix B.3 of
            /// the NSA's [Suite B Implementer's Guide to NIST SP 800-56A].
            ///
            /// [SEC 1: Elliptic Curve Cryptography, Version 2.0]:
            ///     http://www.secg.org/sec1-v2.pdf
            /// [NIST Special Publication 800-56A, revision 2]:
            ///     http://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-56Ar2.pdf
            /// [Suite B Implementer's Guide to NIST SP 800-56A]:
            ///     https://github.com/briansmith/ring/blob/master/doc/ecdh.pdf
            pub static $NAME: ec::Curve = ec::Curve {
                public_key_len: 1 + (2 * (($bits + 7) / 8)),
                elem_and_scalar_len: ($bits + 7) / 8,
                id: $id,
                check_private_key_bytes: $check_private_key_bytes,
                generate_private_key: $generate_private_key,
                public_from_private: $public_from_private,
            };

            fn $check_private_key_bytes(bytes: &[u8])
                                       -> Result<(), error::Unspecified> {
                debug_assert_eq!(bytes.len(), $bits / 8);
                ec::suite_b::private_key::check_scalar_big_endian_bytes(
                    $private_key_ops, bytes)
            }

            fn $generate_private_key(rng: &rand::SecureRandom)
                                     -> Result<ec::PrivateKey, error::Unspecified> {
                ec::suite_b::private_key::generate_private_key($private_key_ops, rng)
            }

            fn $public_from_private(public_out: &mut [u8],
                                    private_key: &ec::PrivateKey)
                                    -> Result<(), error::Unspecified> {
                ec::suite_b::private_key::public_from_private($private_key_ops,
                                                              public_out,
                                                              private_key)
            }
        }
    }

    suite_b_curve!(P256, 256, &ec::suite_b::ops::p256::PRIVATE_KEY_OPS,
                   ec::CurveID::P256, p256_check_private_key_bytes,
                   p256_generate_private_key, p256_public_from_private);

    suite_b_curve!(P384, 384, &ec::suite_b::ops::p384::PRIVATE_KEY_OPS,
                   ec::CurveID::P384, p384_check_private_key_bytes,
                   p384_generate_private_key, p384_public_from_private);

# Help

## Keyboard Shortcuts

?
  Show this help dialog
S
  Focus the search field
⇤
  Move up in search results
⇥
  Move down in search results
⏎
  Go to active search result
+
  Collapse/expand all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)