Struct syslog_rs::a_sync::syslog_async::Syslog

source ·

pub struct Syslog { /* private fields */ }

Expand description

A common instance which describes the syslog state

Trait Implementations§

source §

impl SyslogExt for Syslog

source §

fn openlog_custom<'life0, 'async_trait, P>(
 ident: Option<&'life0 str>,
 logstat: LogStat,
 facility: LogFacility,
 sock_path: P
) -> Pin<Box<dyn Future<Output = SyRes<Self>> + Send + 'async_trait>>where
 P: AsRef<Path> + Send + 'async_trait,
 Self: 'async_trait,
 'life0: 'async_trait,

NON STANDARD FUNCTION

This function acting like openlog() but allows to open connection to the arbitrary object.

Arguments

@see openlog()
sock_path - AsRef Path a path to the unix datagram socket

source §

fn change_identity<'life0, 'async_trait, I>(
 &'life0 self,
 ident: I
) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>where
 I: 'async_trait + AsRef<str> + Send,
 Self: 'async_trait,
 'life0: 'async_trait,

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

Arguments

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

source §

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);

source §

fn setlogmask<'life0, 'async_trait>(
 &'life0 self,
 logmask: i32
) -> Pin<Box<dyn Future<Output = i32> + Send + 'async_trait>>where
 Self: 'async_trait,
 'life0: 'async_trait,

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)

source §

fn closelog<'life0, 'async_trait>(
 &'life0 self
) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>where
 Self: 'async_trait,
 'life0: 'async_trait,

Similar to libc, closelog() will close the log

source §

fn syslog<'life0, 'async_trait>(
 &'life0 self,
 pri: Priority,
 fmt: String
) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>where
 Self: 'async_trait,
 'life0: 'async_trait,

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!()]

source §