| 
sd-id128 | 
| 
sd-journal | 
| 
sd-journal is a rust wrapper for sd-journal in the systemd API of libsystemd. sd-journal is part of the systemd.rs project.
gitlab.com | crates.io | docs.rs
-----------|-----------|--------
sd-sys |
sd-id128 |
sd-journal |
systemd.rs is an alternative to the systemd-rust project.
libsystemd is developed in C around a single struct "journal" with no differentiation whether a function refers to the journal in total or whether the fuction relates to a single record within the journal.
This library also offers all the wrapped functions on the main struct Journal. Additionally two iterators are implemented for Journal: CursorIterator and CursorReverseIterator which both return a Result<Cursor, Error>. All methods implemented on Cursor do call a method implemented on Journal. For that reason, documentation of Cursor is always referring back to the documentation for Journal.
libsystemd implements some additional enumerations. For each of those, an iterator has been implemented as well.
This library is still under development. There are various methods marked with the feature "experimental". These methods are not considered finalized yet. The documentation of each of these methods contains further information. Additionally the library structure is currently under investigation. Currently all methods are implemented for struct Journal. This may change soon: methods that refer to a single record may be moved to struct Cursor and methods performing cursor movements (next(), previous() and similar ones) will return a Cursor.
Journald stores data as "FIELDNAME=field value". While field names are strict UTF-8 encoded and field value are usually encoded in UTF-8, field values may as well be in any encoding including binary data. This library allows logging to the journal in any encoding although using UTF-8 only is highly recommended. While reading from the journal this library will strictly raise an error whenever non-UTF-8 data is encountered. In future releases decoding support and a lossy decoding may be added.
toml
[dependencies]
sdJournal = "0.1"
rust
use sd_journal::*;
Journal::log_message(Level::Info, "Hello World!").unwrap();
Journal::log_raw_record(&["MESSAGE=Hello World!",
&format!("PRIORITY={}", Level::Info),
&format!("CODE_FILE={}", file!()),
&format!("CODE_LINE={}", line!()),
"CUSTOM_FIELD=42"]).unwrap();
```rust use sd_journal::*; use std::path::PathBuf;
// load local test data let mut testdata = PathBuf::from(env!("CARGOMANIFESTDIR")); testdata.push("test-data/"); println!("looking for test data in folder {}", testdata.display()); let journal = Journal::opendirectory(&test_data, PathFlags::FullPath, UserFlags::AllUsers).unwrap();
// loop over journal records while let Ok(CursorMovement::Done) = journal.next() { // do something on each cursor, e.g. print the MESSAGE println!("{}", journal.get_data("MESSAGE").unwrap()); } ```
sd-journal: a wrapper for sd-journal of libsystemd
Copyright (C) 2020 Christian Klaue [mail@ck76.de]
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.
Individual licenses may be granted upon request.