Enum ServerConfigError 

pub enum ServerConfigError {
    BindAddress(AddrParseError),
    RootDir(Error),
    InvalidServerRole,
    InvalidServerFrontend,
    MissingServerFrontends,
    InvalidObjectStorageAdapter,
    InvalidAuthProvider,
    MissingS3Bucket,
    InvalidS3AllowHttp,
    InvalidS3VirtualHostedStyleRequest,
    S3CredentialSourceConflict {
        env: &'static str,
        file_env: &'static str,
    },
    S3CredentialFile {
        name: &'static str,
        source: Error,
    },
    S3CredentialTooLarge {
        name: &'static str,
        observed_bytes: u64,
        maximum_bytes: u64,
    },
    S3CredentialLengthMismatch {
        name: &'static str,
        expected_bytes: u64,
        observed_bytes: u64,
    },
    S3CredentialUtf8 {
        name: &'static str,
    },
    ChunkSize(ParseIntError),
    MaxRequestBodyBytes(ParseIntError),
    ZeroMaxRequestBodyBytes,
    MaxShardFiles(ParseIntError),
    ZeroMaxShardFiles,
    MaxShardXorbs(ParseIntError),
    ZeroMaxShardXorbs,
    MaxShardReconstructionTerms(ParseIntError),
    ZeroMaxShardReconstructionTerms,
    MaxShardXorbChunks(ParseIntError),
    ZeroMaxShardXorbChunks,
    ZeroChunkSize,
    UploadMaxInFlightChunks(ParseIntError),
    ZeroUploadMaxInFlightChunks,
    TransferMaxInFlightChunks(ParseIntError),
    ZeroTransferMaxInFlightChunks,
    InvalidReconstructionCacheAdapter,
    ReconstructionCacheTtl(ParseIntError),
    ZeroReconstructionCacheTtlSeconds,
    ReconstructionCacheMemoryMaxEntries(ParseIntError),
    ZeroReconstructionCacheMemoryMaxEntries,
    OciUploadSessionTtl(ParseIntError),
    ZeroOciUploadSessionTtlSeconds,
    OciUploadMaxActiveSessions(ParseIntError),
    ZeroOciUploadMaxActiveSessions,
    OciRegistryTokenTtl(ParseIntError),
    ZeroOciRegistryTokenTtlSeconds,
    OciRegistryTokenMaxInFlightRequests(ParseIntError),
    ZeroOciRegistryTokenMaxInFlightRequests,
    EmptyReconstructionCacheRedisUrl,
    MissingReconstructionCacheRedisUrl,
    RedisTlsMaterial {
        name: &'static str,
        source: Error,
    },
    RedisTlsMaterialTooLarge {
        name: &'static str,
        observed_bytes: u64,
        maximum_bytes: u64,
    },
    IncompleteRedisTlsClientIdentity,
    EmptyIndexPostgresUrl,
    TokenSigningKey(Error),
    TokenSigningKeyTooLarge {
        observed_bytes: u64,
        maximum_bytes: u64,
    },
    TokenSigningKeyLengthMismatch {
        expected_bytes: u64,
        observed_bytes: u64,
    },
    ProviderTokenTtl,
    EmptyTokenSigningKey,
    MetricsToken(Error),
    EmptyMetricsToken,
    MetricsTokenTooLarge {
        observed_bytes: u64,
        maximum_bytes: u64,
    },
    MetricsTokenLengthMismatch {
        expected_bytes: u64,
        observed_bytes: u64,
    },
    MissingTokenSigningKeyForServedRoutes,
    EmptyProviderApiKey,
    ProviderApiKey(Error),
    ProviderApiKeyTooLarge {
        observed_bytes: u64,
        maximum_bytes: u64,
    },
    ProviderApiKeyLengthMismatch {
        expected_bytes: u64,
        observed_bytes: u64,
    },
    EmptyProviderTokenIssuer,
    ZeroProviderTokenTtl,
    IncompleteProviderTokenConfig,
    ProviderTokensRequireSigningKey,
    ChunkSizeTooLarge,
    InvalidPublicBaseUrl(String),
    ConfigFileError(String),
    MissingOidcIssuer,
    MissingJwksUrl,
    HubRequiresAuth,
    PassthroughProviderRequiresLoopbackBind {
        bind_addr: SocketAddr,
    },
    SecretSourceConflict {
        env: &'static str,
        file_env: &'static str,
    },
    MissingEd25519Key,
    ConflictingEd25519Keys,
    Ed25519PrivateKey(Error),
    Ed25519PublicKey(Error),
    Ed25519PrivateKeyTooLarge {
        observed_bytes: u64,
        maximum_bytes: u64,
    },
    Ed25519PublicKeyTooLarge {
        observed_bytes: u64,
        maximum_bytes: u64,
    },
    Ed25519PrivateKeyLengthMismatch {
        expected_bytes: u64,
        observed_bytes: u64,
    },
    Ed25519PublicKeyLengthMismatch {
        expected_bytes: u64,
        observed_bytes: u64,
    },
    EmptyEd25519PrivateKey,
    EmptyEd25519PublicKey,
}

Server configuration loading failure.

Variants

BindAddress(AddrParseError)

The bind address could not be parsed.

RootDir(Error)

The local deployment root contained an invalid filesystem component.

InvalidServerRole

The server role token was invalid.

InvalidServerFrontend

The server frontend token was invalid.

MissingServerFrontends

The configured server frontend set was empty.

InvalidObjectStorageAdapter

The object-storage adapter token was invalid.

InvalidAuthProvider

The auth provider token was invalid.

MissingS3Bucket

S3 object storage was selected without a bucket.

InvalidS3AllowHttp

S3 object storage was selected with an invalid allow-http flag.

InvalidS3VirtualHostedStyleRequest

S3 object storage was selected with an invalid virtual-hosted-style flag.

S3CredentialSourceConflict

An S3 credential was provided through both direct env and file indirection.

Fields

env: &'static str

Direct environment variable name.

file_env: &'static str

File-indirection environment variable name.

S3CredentialFile

An S3 credential file could not be read.

Fields

name: &'static str

Credential file-indirection environment variable name.

source: Error

Underlying filesystem failure.

S3CredentialTooLarge

An S3 credential file exceeded the bounded parser ceiling.

Fields

name: &'static str

Credential file-indirection environment variable name.

observed_bytes: u64

Observed secret file length in bytes.

maximum_bytes: u64

Maximum accepted secret file length in bytes.

S3CredentialLengthMismatch

An S3 credential file changed after validation and was rejected.

Fields

name: &'static str

Credential file-indirection environment variable name.

expected_bytes: u64

Validated secret file length in bytes.

observed_bytes: u64

Observed secret file length in bytes after bounded read.

S3CredentialUtf8

An S3 credential file was not valid UTF-8.

Fields

name: &'static str

Credential file-indirection environment variable name.

ChunkSize(ParseIntError)

The chunk size could not be parsed.

MaxRequestBodyBytes(ParseIntError)

The maximum request body size could not be parsed.

ZeroMaxRequestBodyBytes

The maximum request body size was zero.

MaxShardFiles(ParseIntError)

The maximum shard file section count could not be parsed.

ZeroMaxShardFiles

The maximum shard file section count was zero.

MaxShardXorbs(ParseIntError)

The maximum shard xorb section count could not be parsed.

ZeroMaxShardXorbs

The maximum shard xorb section count was zero.

MaxShardReconstructionTerms(ParseIntError)

The maximum shard reconstruction term count could not be parsed.

ZeroMaxShardReconstructionTerms

The maximum shard reconstruction term count was zero.

MaxShardXorbChunks(ParseIntError)

The maximum shard xorb chunk record count could not be parsed.

ZeroMaxShardXorbChunks

The maximum shard xorb chunk record count was zero.

ZeroChunkSize

The chunk size was zero.

UploadMaxInFlightChunks(ParseIntError)

The per-upload chunk processing window could not be parsed.

ZeroUploadMaxInFlightChunks

The per-upload chunk processing window was zero.

TransferMaxInFlightChunks(ParseIntError)

The transfer concurrency budget could not be parsed.

ZeroTransferMaxInFlightChunks

The transfer concurrency budget was zero.

InvalidReconstructionCacheAdapter

The reconstruction-cache adapter token was invalid.

ReconstructionCacheTtl(ParseIntError)

The reconstruction-cache TTL could not be parsed.

ZeroReconstructionCacheTtlSeconds

The reconstruction-cache TTL was zero.

ReconstructionCacheMemoryMaxEntries(ParseIntError)

The in-memory reconstruction-cache capacity could not be parsed.

ZeroReconstructionCacheMemoryMaxEntries

The in-memory reconstruction-cache capacity was zero.

OciUploadSessionTtl(ParseIntError)

The OCI upload-session TTL could not be parsed.

ZeroOciUploadSessionTtlSeconds

The OCI upload-session TTL was zero.

OciUploadMaxActiveSessions(ParseIntError)

The OCI upload live-session ceiling could not be parsed.

ZeroOciUploadMaxActiveSessions

The OCI upload live-session ceiling was zero.

OciRegistryTokenTtl(ParseIntError)

The OCI registry token TTL could not be parsed.

ZeroOciRegistryTokenTtlSeconds

The OCI registry token TTL was zero.

OciRegistryTokenMaxInFlightRequests(ParseIntError)

The OCI registry token in-flight request ceiling could not be parsed.

ZeroOciRegistryTokenMaxInFlightRequests

The OCI registry token in-flight request ceiling was zero.

EmptyReconstructionCacheRedisUrl

The Redis reconstruction-cache URL was empty.

MissingReconstructionCacheRedisUrl

Redis reconstruction-cache configuration was incomplete.

RedisTlsMaterial

A Redis TLS certificate, CA, or private key file could not be read.

Fields

name: &'static str

Environment variable that supplied the file path.

source: Error

Underlying secure file-read failure.

RedisTlsMaterialTooLarge

Redis TLS material exceeded the bounded parser ceiling.

Fields

name: &'static str

Environment variable that supplied the file path.

observed_bytes: u64

Observed secret file length in bytes.

maximum_bytes: u64

Maximum accepted secret file length in bytes.

IncompleteRedisTlsClientIdentity

Redis mTLS needs both halves of a client identity.

EmptyIndexPostgresUrl

The Postgres metadata URL was empty.

TokenSigningKey(Error)

The token signing key file could not be read.

TokenSigningKeyTooLarge

The token signing key exceeded the bounded parser ceiling.

Fields

observed_bytes: u64

Observed secret file length in bytes.

maximum_bytes: u64

Maximum accepted secret file length in bytes.

TokenSigningKeyLengthMismatch

The token signing key changed after validation and was rejected.

Fields

expected_bytes: u64

Validated secret file length in bytes.

observed_bytes: u64

Observed secret file length in bytes after bounded read.

ProviderTokenTtl

The provider token TTL could not be parsed.

EmptyTokenSigningKey

The token signing key was empty.

MetricsToken(Error)

The metrics token file could not be read.

EmptyMetricsToken

The metrics bearer token was empty.

MetricsTokenTooLarge

The metrics bearer token exceeded the bounded parser ceiling.

Fields

observed_bytes: u64

Observed secret file length in bytes.

maximum_bytes: u64

Maximum accepted secret file length in bytes.

MetricsTokenLengthMismatch

The metrics bearer token changed after validation and was rejected.

Fields

expected_bytes: u64

Validated secret file length in bytes.

observed_bytes: u64

Observed secret file length in bytes after bounded read.

MissingTokenSigningKeyForServedRoutes

The selected role uses the local HMAC provider and would expose CAS routes without bearer-token verification.

EmptyProviderApiKey

The provider bootstrap key was empty.

ProviderApiKey(Error)

The provider bootstrap key file could not be read.

ProviderApiKeyTooLarge

The provider bootstrap key exceeded the bounded parser ceiling.

Fields

observed_bytes: u64

Observed secret file length in bytes.

maximum_bytes: u64

Maximum accepted secret file length in bytes.

ProviderApiKeyLengthMismatch

The provider bootstrap key changed after validation and was rejected.

Fields

expected_bytes: u64

Validated secret file length in bytes.

observed_bytes: u64

Observed secret file length in bytes after bounded read.

EmptyProviderTokenIssuer

The provider token issuer was empty.

ZeroProviderTokenTtl

The provider token TTL was zero.

IncompleteProviderTokenConfig

Provider token issuance was only partially configured.

ProviderTokensRequireSigningKey

Provider token issuance needs the CAS signing key.

ChunkSizeTooLarge

The chunk size exceeds the maximum allowed value.

InvalidPublicBaseUrl(String)

The public base URL is not a valid URL.

ConfigFileError(String)

A configuration file could not be loaded.

MissingOidcIssuer

OIDC auth provider requires an issuer URL.

MissingJwksUrl

JWKS auth provider requires a JWKS URL.

HubRequiresAuth

Hub frontend requires an auth provider to be configured.

PassthroughProviderRequiresLoopbackBind

Passthrough auth provider requires a loopback bind address.

Fields

bind_addr: SocketAddr

The rejected bind address.

SecretSourceConflict

A secret was provided through both direct env and file indirection.

Fields

env: &'static str

Direct environment variable name.

file_env: &'static str

File-indirection environment variable name.

MissingEd25519Key

Ed25519 auth provider requires a key.

ConflictingEd25519Keys

Ed25519 signing and verification-only modes were configured together.

Ed25519PrivateKey(Error)

The Ed25519 private key file could not be read.

Ed25519PublicKey(Error)

The Ed25519 public key file could not be read.

Ed25519PrivateKeyTooLarge

The Ed25519 private key exceeded the bounded parser ceiling.

Fields

observed_bytes: u64

Observed secret file length in bytes.

maximum_bytes: u64

Maximum accepted secret file length in bytes.

Ed25519PublicKeyTooLarge

The Ed25519 public key exceeded the bounded parser ceiling.

Fields

observed_bytes: u64

Observed secret file length in bytes.

maximum_bytes: u64

Maximum accepted secret file length in bytes.

Ed25519PrivateKeyLengthMismatch

The Ed25519 private key changed after validation and was rejected.

Fields

expected_bytes: u64

Validated secret file length in bytes.

observed_bytes: u64

Observed secret file length in bytes after bounded read.

Ed25519PublicKeyLengthMismatch

The Ed25519 public key changed after validation and was rejected.

Fields

expected_bytes: u64

Validated secret file length in bytes.

observed_bytes: u64

Observed secret file length in bytes after bounded read.

EmptyEd25519PrivateKey

The Ed25519 private key was empty.

EmptyEd25519PublicKey

The Ed25519 public key was empty.

Trait Implementations

impl Debug for ServerConfigError

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

Formats the value using the given formatter.

impl Display for ServerConfigError

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

Formats the value using the given formatter.

impl Error for ServerConfigError

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<AddrParseError> for ServerConfigError

fn from(source: AddrParseError) -> Self

Converts to this type from the input type.

impl From<ParseIntError> for ServerConfigError

fn from(source: ParseIntError) -> Self

Converts to this type from the input type.

impl From<ServerConfigError> for ServerError

fn from(source: ServerConfigError) -> Self

Converts to this type from the input type.