Struct syslog_rs::syslog_sync_queue::Syslog

pub struct Syslog { /* fields omitted */ }

A common instance which describes the syslog state

Implementations

impl Syslog

pub 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 fn setlogmask(&self, logmask: i32) -> SyRes<i32>

Sets the logmask to filter out the syslog calls. This function behaves differently as it behaves in syslog_sync.rs or syslog_async.rs. It may return an error if: syslog thread had exit and some thread calls this function. Or something happened with channel. This function blocks until the previous mask is received.

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 fn closelog(&self)

Similar to libc, closelog() will close the log

pub 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 fn vsyslog<S: AsRef<str>>(&self, pri: Priority, fmt: S)

Similar to syslog() and created for the compatability.

pub 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