pub struct LibraryConfig {
pub profile: Profile,
pub policy: SecurityPolicy,
}Expand description
Top-level NoxTLS library configuration: active profile and effective security policy.
Fields§
§profile: ProfileSelected feature profile for TLS/DTLS and crypto surface area.
policy: SecurityPolicySecurity policy flags validated together with profile.
Implementations§
Source§impl LibraryConfig
impl LibraryConfig
Sourcepub fn compiled() -> Result<Self>
pub fn compiled() -> Result<Self>
Builds the default LibraryConfig using compile-time policy flags and validates it.
§Arguments
This function takes no parameters.
§Returns
On success, a configuration with Profile::Default and SecurityPolicy::compiled.
§Errors
Propagates Error::UnsupportedFeature from SecurityPolicy::validate when the compiled policy is invalid.
§Panics
This function does not panic.
Sourcepub fn validate(self) -> Result<()>
pub fn validate(self) -> Result<()>
Validates the profile and nested security policy together.
§Arguments
self— Library configuration to check.
§Returns
Ok(()) when the configuration is consistent.
§Errors
Returns the same errors as SecurityPolicy::validate when policy invariants fail.
§Panics
This function does not panic.
Sourcepub fn from_mbedtls_style_str(input: &str) -> Result<Self>
pub fn from_mbedtls_style_str(input: &str) -> Result<Self>
Parses mbedTLS-style #define configuration text into a LibraryConfig.
Recognized profile symbols (at most one may appear): NOXTLS_PROFILE_DEFAULT,
NOXTLS_PROFILE_MINIMAL_TLS_CLIENT, NOXTLS_PROFILE_TLS_SERVER_PKI, NOXTLS_PROFILE_CRYPTO_ONLY,
NOXTLS_PROFILE_FIPS_LIKE, NOXTLS_PROFILE_UT_ALL_FEATURES. Policy symbols: NOXTLS_STRICT_CONSTANT_TIME,
NOXTLS_ALLOW_LEGACY_ALGORITHMS, NOXTLS_ALLOW_SHA1_SIGNATURES. Lines may include // or /* inline comments.
§Arguments
input— Full configuration text scanned line-by-line for supported#definedirectives.
§Returns
On success, a validated configuration; if no profile symbol is present, Profile::Default is used.
§Errors
Returns Error::ParseFailure for duplicate profiles, unknown symbols, or malformed #define lines.
Returns Error::UnsupportedFeature when parsed policy violates the same rules as SecurityPolicy::validate.
§Panics
This function does not panic.
Sourcepub fn from_mbedtls_style_file(path: &Path) -> Result<Self>
pub fn from_mbedtls_style_file(path: &Path) -> Result<Self>
Reads a file from disk and parses it with LibraryConfig::from_mbedtls_style_str.
§Arguments
path— Filesystem path to a UTF-8 text file containing mbedTLS-style#definelines.
§Returns
On success, the parsed and validated LibraryConfig.
§Errors
Returns Error::ParseFailure when the file cannot be read as UTF-8 or when text parsing fails.
Returns Error::UnsupportedFeature when parsed policy fails validation.
§Panics
This function does not panic.
Trait Implementations§
Source§impl Clone for LibraryConfig
impl Clone for LibraryConfig
Source§fn clone(&self) -> LibraryConfig
fn clone(&self) -> LibraryConfig
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moreSource§impl Debug for LibraryConfig
impl Debug for LibraryConfig
Source§impl PartialEq for LibraryConfig
impl PartialEq for LibraryConfig
Source§fn eq(&self, other: &LibraryConfig) -> bool
fn eq(&self, other: &LibraryConfig) -> bool
self and other values to be equal, and is used by ==.