Struct LibraryConfig 

pub struct LibraryConfig {
    pub profile: Profile,
    pub policy: SecurityPolicy,
}

Top-level NoxTLS library configuration: active profile and effective security policy.

Fields

profile: Profile

Selected feature profile for TLS/DTLS and crypto surface area.

policy: SecurityPolicy

Security policy flags validated together with profile.

Implementations

impl LibraryConfig

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.

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.

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 #define directives.

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.

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 #define lines.

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

impl Clone for LibraryConfig

fn clone(&self) -> LibraryConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for LibraryConfig

impl Debug for LibraryConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for LibraryConfig

impl PartialEq for LibraryConfig

fn eq(&self, other: &LibraryConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for LibraryConfig