`flare.tls.error`

TLS-specific error types for flare.tls.

All error types implement Copyable (which implies Movable) and Writable so they can be raised, caught, printed, and logged uniformly.

Structs

struct TlsHandshakeError

The TLS handshake failed (generic failure not covered by cert errors).

Fields: message: Human-readable OpenSSL error string.

Implements Copyable, Movable, Writable

def __init__(out self, message: String)

Create a TlsHandshakeError.

def write_to[W: Writer](self, mut writer: W)

Write "TlsHandshakeError: <message>" to writer.

struct CertificateExpired

The server certificate has passed its notAfter date.

Fields: subject: Certificate subject DN from X509_NAME_oneline.

Implements Copyable, Movable, Writable

def __init__(out self, subject: String = "")

Create a CertificateExpired error.

def write_to[W: Writer](self, mut writer: W)

Write the error to writer.

struct CertificateHostnameMismatch

The server certificate's CN/SAN does not match the target hostname.

Fields: expected: The hostname that was required. subject: The certificate's subject DN.

Implements Copyable, Movable, Writable

def __init__(out self, expected: String, subject: String = "")

Create a CertificateHostnameMismatch error.

Args: expected: The hostname the client tried to connect to.; subject: Certificate subject DN (may be empty if unavailable).

def write_to[W: Writer](self, mut writer: W)

Write the error to writer.

struct CertificateUntrusted

The server certificate is not trusted by any CA in the bundle.

Raised for self-signed certs, expired CAs, or missing CA chains.

Fields: reason: OpenSSL verification failure reason string.

Implements Copyable, Movable, Writable

def __init__(out self, reason: String = "")

Create a CertificateUntrusted error.

def write_to[W: Writer](self, mut writer: W)

Write the error to writer.