Struct RotatingFileBuilder 

pub struct RotatingFileBuilder { /* private fields */ }

Available on crate feature std only.

Options for a RotatingFile. Create with RotatingFile::builder.

Implementations

impl RotatingFileBuilder

pub const fn max_bytes(self, bytes: u64) -> Self

Rotate before a write would take the active file past bytes.

pub const fn rotation(self, rotation: Rotation) -> Self

Rotate on a UTC time schedule.

pub const fn max_files(self, count: usize) -> Self

How many rotated files to keep (<path>.1 ..= <path>.N). 0 keeps none.

pub const fn buffer_capacity(self, bytes: usize) -> Self

Size of the in-memory write buffer (0 = unbuffered).

pub const fn mode(self, mode: u32) -> Self

Unix permission bits for every file this writer creates: the active file and each new one after a rotation, such as 0o600 or 0o640. The process umask still applies, and an existing file keeps its mode. Without this call files get 0o666 minus the umask, as before 2.1. On Windows files inherit their directory’s access control list and the mode has no effect.

Examples

use log_io::sink::{RotatingFile, Rotation};

let file = RotatingFile::builder("app.log")
    .rotation(Rotation::Daily)
    .mode(0o640)
    .open()?;

pub fn open(self) -> Result<RotatingFile>

Open (or create) the active file in append mode.

If the file already exists and was last modified in an earlier period of the time schedule, it is rotated on the first write.

Errors

Returns the I/O error from opening the file.

Trait Implementations

impl Clone for RotatingFileBuilder

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RotatingFileBuilder

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

Formats the value using the given formatter.