Struct syslog_rs::syslog_async::Syslog

pub struct Syslog { /* fields omitted */ }

A common instance which describes the syslog state

Implementations

impl Syslog

Private realization. It is assumed that functions which are called, are called after ‘lock’ is locked. A public implementations

pub async fn openlog(
    ident: Option<&str>,
    logstat: LogStat,
    facility: LogFacility
) -> SyRes<Self>

As in a libc, this function initializes the syslog instance. The main difference with realization in C is it returns the instance to program used this crate. This structure implements the Send and Sync so it does not require any additional synchonization.

Arguments

• ident - a identification of the sender. If not set, the crate will determine automatically!

• logstat - sets up the syslog behaviour. Use LogStat

• facility - a syslog facility. Use LogFacility

Returns

• A SyRes with instance or Err()

Example

 Syslog::openlog(
       Some("test1"), 
        LogStat::LOG_NDELAY | LogStat::LOG_PID, 
        LogFacility::LOG_DAEMON);

pub async fn setlogmask(&self, logmask: i32) -> i32

Sets the logmask to filter out the syslog calls.

See macroses LOG_MASK and LOG_UPTO to generate mask

Example

LOG_MASK!(Priority::LOG_EMERG) | LOG_MASK!(Priority::LOG_ERROR)

or

~(LOG_MASK!(Priority::LOG_INFO)) LOG_UPTO!(Priority::LOG_ERROR)

pub async fn closelog(&self)

Similar to libc, closelog() will close the log

pub async fn syslog(&self, pri: Priority, fmt: String)

Similar to libc, syslog() sends data to syslog server.

Arguments

• pri - a priority Priority

• fmt - a string message. In C exists a functions with variable argumets amount. In Rust you should create your own macros like format!() or use format!()]

pub async fn vsyslog<S: AsRef<str>>(&self, pri: Priority, fmt: S)

Similar to syslog() and created for the compatability.

pub async fn change_identity<I: AsRef<str>>(&self, ident: I)

This function can be used to update the facility name, for example after fork().

Arguments

• ident - a new identity (up to 48 UTF8 chars)

Trait Implementations

impl Send for Syslog

impl Sync for Syslog