1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45
//! Parser for [RFC 5424](https://tools.ietf.org/html/rfc5424) Syslog messages. Not to be confused //! with the older [RFC 3164](https://tools.ietf.org/html/rfc3164) BSD Syslog protocol, which many //! systems still emit. //! //! In particular, supports the Structured Data fields. //! //! Usually, you'll just call the (re-exported) `parse_message` function with a stringy object. //! //! # Example //! //! A simple syslog server //! //! ```no_run //! use syslog_rfc5424::parse_message; //! use std::net::UdpSocket; //! use std::str; //! //! let s = UdpSocket::bind("127.0.0.1:10514").unwrap(); //! let mut buf = [0u8; 2048]; //! loop { //! let (data_read, _) = s.recv_from(&mut buf).unwrap(); //! let msg = parse_message(str::from_utf8(&buf[0..data_read]).unwrap()).unwrap(); //! println!("{:?} {:?} {:?} {:?}", msg.facility, msg.severity, msg.hostname, msg.msg); //! } //! ``` //! //! # Unimplemented Features //! //! * Theoretically, you can send arbitrary (non-unicode) bytes for the message part of a syslog //! message. Rust doesn't have a convenient way to only treat *some* of a buffer as utf-8, //! so I'm just not supporting that. Most "real" syslog servers barf on it anway. //! #[macro_use] extern crate assert_matches; extern crate time; extern crate rustc_serialize; pub mod message; mod severity; mod facility; pub mod parser; pub use severity::SyslogSeverity; pub use facility::SyslogFacility; pub use parser::parse_message;