domain 0.12.0

A DNS library for Rust.
Documentation 
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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

//! Cryptographic backends, key generation and import.
//!
//! This module is enabled by the `unstable-crypto` or `unstable-crypto-sign`
//! feature flags. The `unstable-crypto` enables all features except for
//! private key operations such as generation and signing. All features of
//! this module are enabled with the `unstable-crypto-sign` feature flag.
//!
//! This crate supports OpenSSL and Ring for performing cryptography.  These
//! cryptographic backends are gated on the `openssl` and `ring` features,
//! respectively.  They offer mostly equivalent functionality, but OpenSSL
//! supports a larger set of signing algorithms (and, for RSA keys, supports
//! weaker key sizes).  A
#![cfg_attr(feature = "unstable-crypto-sign", doc = "[`sign`]")]
#![cfg_attr(not(feature = "unstable-crypto-sign"), doc = "`sign`")]
//! backend is provided for users that wish to use either or both backends at
//! runtime.
//!
//! Each backend module (
#![cfg_attr(
    all(feature = "unstable-crypto-sign", feature = "openssl"),
    doc = "[`openssl::sign`]"
)]
#![cfg_attr(
    not(all(feature = "unstable-crypto-sign", feature = "openssl")),
    doc = "`openssl::sign`"
)]
//! ,
#![cfg_attr(
    all(feature = "unstable-crypto-sign", feature = "ring"),
    doc = "[`ring::sign`]"
)]
#![cfg_attr(
    not(all(feature = "unstable-crypto-sign", feature = "ring")),
    doc = "`ring::sign`"
)]
//! , and
#![cfg_attr(feature = "unstable-crypto-sign", doc = "[`sign`]")]
#![cfg_attr(not(feature = "unstable-crypto-sign"), doc = "`sign`")]
//! ) exposes a `KeyPair` type, representing a cryptographic key that can be
//! used for signing, and a `generate()` function for creating new keys.
//!
//! Users can choose to bring their own cryptography by providing their own
//! `KeyPair` type that implements the
#![cfg_attr(feature = "unstable-crypto-sign", doc = "[`sign::SignRaw`]")]
#![cfg_attr(not(feature = "unstable-crypto-sign"), doc = "`sign::SignRaw`")]
//! trait.
//!
//! While each cryptographic backend can support a limited number of signature
//! algorithms, even the types independent of a cryptographic backend (e.g.
#![cfg_attr(
    feature = "unstable-crypto-sign",
    doc = "[`sign::SecretKeyBytes`]"
)]
#![cfg_attr(
    not(feature = "unstable-crypto-sign"),
    doc = "`sign::SecretKeyBytes`"
)]
//! and
#![cfg_attr(
    feature = "unstable-crypto-sign",
    doc = "[`sign::GenerateParams`]"
)]
#![cfg_attr(
    not(feature = "unstable-crypto-sign"),
    doc = "`sign::GenerateParams`"
)]
//! ) support a limited number of algorithms.  Even with custom cryptographic
//! backends, this module can only support these algorithms.
//!
//! In addition to private key operations, this module provides the
#![cfg_attr(
    feature = "unstable-crypto-backend",
    doc = "[`common::PublicKey`]"
)]
#![cfg_attr(
    not(feature = "unstable-crypto-backend"),
    doc = "`common::PublicKey`"
)]
//! type for signature verification.
//!
//! The module also support computing message digests using the
#![cfg_attr(
    feature = "unstable-crypto-backend",
    doc = "[`common::DigestBuilder`]"
)]
#![cfg_attr(
    not(feature = "unstable-crypto-backend"),
    doc = "`common::DigestBuilder`"
)]
//! type.
//!
//! For examples, see the
#![cfg_attr(feature = "unstable-crypto-backend", doc = "[`common`]")]
#![cfg_attr(not(feature = "unstable-crypto-backend"), doc = "`common`")]
//! module.

#![cfg(feature = "unstable-crypto")]
#![cfg_attr(docsrs, doc(cfg(feature = "unstable-crypto")))]
#![warn(missing_docs)]
#![warn(clippy::missing_docs_in_private_items)]

pub mod common;
pub mod openssl;
pub mod ring;
pub mod sign;