Enum LoggingError 

pub enum LoggingError {
    Directory {
        directory: PathBuf,
        source: PathsError,
    },
    Appender {
        directory: PathBuf,
        attempts: String,
    },
    AlreadyInstalled {
        message: String,
    },
}

The sink could not be installed.

Variants

Directory

The application-data directories could not be created.

Carries a crate::paths::PathsError rather than a bare std::io::Error because install creates logs/ through crate::paths::AppPaths::create_all, which is what applies the 0700 restriction; the source therefore names whichever of the four directories actually failed, and that need not be logs/.

Fields

directory: PathBuf

The diagnostics directory install was asked to write into.

source: PathsError

The underlying error.

Appender

No diagnostics file in logs/ could be opened for appending.

Both stems are named because install tries two — the role’s own, and then one qualified by the account — and an operator who is told only about the second would go looking for a file this process never reached for first.

The two attempts are composed into one string rather than carried as four fields. As four this variant reached 128 bytes on Windows — where PathBuf is wider than on the Unixes — and tripped clippy::result_large_err, which is a lint about every success path paying for the size of a failure. The message is the same either way, and only this error is ever built.

Fields

directory: PathBuf

The diagnostics directory.

attempts: String

Both stems that were tried, and why each was refused.

AlreadyInstalled

A global subscriber was already installed.

Fields

message: String

What tracing_subscriber said.

Trait Implementations

impl Debug for LoggingError

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

Formats the value using the given formatter.

impl Display for LoggingError

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

Formats the value using the given formatter.

impl Error for LoggingError

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.