Enum Refusal 

#[non_exhaustive]
pub enum Refusal {
    NoSections,
    NoClients,
    DuplicateSection {
        application: String,
        profile: String,
    },
    UnroutableSection {
        application: String,
        profile: String,
        part: &'static str,
    },
    DuplicateClient {
        name: String,
    },
    DuplicateToken,
    WeakToken {
        client: String,
    },
    AnonymousNotAllowed {
        client: String,
    },
    SeveralAnonymousClients,
    UnservedGrant {
        client: String,
        application: String,
    },
    ExposedBind {
        bind: String,
    },
    KubernetesAuth {
        reason: String,
    },
    UnparsableBind {
        bind: String,
    },
    TlsUnsupported,
    InsecureWithTls,
    TlsPathMissing {
        key: &'static str,
    },
    RevocationUnsupported,
}

Why a configuration will not start a server.

Every variant’s Display names the key that fixes it, and none of them carries a token: a refusal is printed to a terminal and scraped into a log, which is the last place a credential should turn up.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NoSections

No sections — the server would serve nothing.

NoClients

No clients — nobody could ever read anything.

DuplicateSection

Two sections claim the same application and profile.

Fields

application: String

The application both claim.

profile: String

The profile both claim.

UnroutableSection

A section names an application or profile no route can carry, so nothing could ever reach it.

Fields

application: String

The application, as configured.

profile: String

The profile, as configured.

part: &'static str

Which of the two was refused: application or profile.

DuplicateClient

Two clients share a name.

Fields

name: String

The name.

DuplicateToken

Two clients share a token.

WeakToken

A configured token is shorter than MIN_TOKEN_LEN.

Fields

client: String

The client whose token is too short.

AnonymousNotAllowed

A client has no token and allow_anonymous is not set.

Fields

client: String

The client with no token.

SeveralAnonymousClients

More than one client has no token, so “the anonymous caller” names two different grants.

UnservedGrant

A client is granted an application no section serves.

Fields

client: String

The client.

application: String

The application it was granted.

ExposedBind

A non-loopback bind with neither tls nor insecure.

Fields

bind: String

The address.

KubernetesAuth

[kubernetes] was present but unusable — an empty grant list, a malformed service_account, or an environment that is not a cluster. The reason names the fix; it never carries a token.

Fields

reason: String

What was wrong, exactly.

UnparsableBind

bind is not a literal address:port.

Fields

bind: String

What was written.

TlsUnsupported

[server.tls] in a build compiled without the tls feature.

InsecureWithTls

insecure is set and [server.tls] is configured: an acknowledgement of something that is not true.

TlsPathMissing

A [server.tls] key that must name a file names an empty string.

Fields

key: &'static str

Which key.

RevocationUnsupported

tls.crl is configured. This server checks no revocation and says so rather than accepting a key it would ignore.

Trait Implementations

impl Clone for Refusal

fn clone(&self) -> Refusal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Refusal

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

Formats the value using the given formatter.

impl Display for Refusal

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

Formats the value using the given formatter.

impl Eq for Refusal

impl Error for Refusal

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Refusal> for StartupError

fn from(refusal: Refusal) -> Self

Converts to this type from the input type.

impl PartialEq for Refusal

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Refusal