'\" t
.\"     Title: slogverify
.\"    Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 09/05/2020
.\"    Manual: The slogverify utility manual page
.\"    Source: 3.27
.\"  Language: English
.\"
.TH "SLOGVERIFY" "1" "09/05/2020" "3\&.27" "The slogverify utility manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
slogverify \- Verify cryptographically secured logs
.SH "SYNOPSIS"
.HP \w'\fBslogverify\fR\ 'u
\fBslogverify\fR [arguments]
.SH "DESCRIPTION"
.PP
The
\fBslogverify\fR
utility is used to verify the integrity of cryptographically secured logs and to decrypt log entries from with a secure encrypted destination\&.
.SH "OPTIONS"
.PP
\fBslogverify <host key file> <input file> <input MAC file> <output file> [bufferSize] \fR
.RS 4
<host key file> The name of the file containing the initial host key (key0)\&.
.sp
<input file> The cryptographically secured log file\&.
.sp
<input MAC file> The file containing the current message authenfication code (MAC) for the input file\&.
.sp
<output file> The file receiving the plaintext log entries after successful verification and decryption\&.
.sp
[bufferSize] Optional buffer size\&. The buffer size can be used for performance adjustments in case the log file to be verified is very large and cannot be processed at once\&. It is a positive number of log entries that can be held in memory during verification\&. The default is 1000\&.
.RE
.PP
\fB\-i <previous MAC file file> <previous key file> <input file> <current MAC file> <output file> [bufferSize] \fR
.RS 4
<previous MAC file file> This is the file containing the MAC from the previous log file\&.
.sp
<previous key file> This is the file containing the key from the previous log file\&. In theory, this can be host key key0, but using key key0 might generates warnings, as the gap between the first log entry ever (log entry 0) and the first log entry of the current log file might be large\&.
.sp
<input file> This is the file containing the current log data\&.
.sp
<current MAC file> This is the file containing the MAC of the current log input file\&.
.sp
<output file> Decrypted log data will be written into this file\&.
.sp
[bufferSize] Optional buffer size\&. The buffer size can be used for performance adjustments in case the log file to be verified is very large and cannot be processed at once\&. It is a positive number of log entries that can be held in memory during verification\&. The default is 1000\&.
.RE
.SH "FILES"
.PP
/usr/bin/slogverify
.PP
/etc/syslog\-ng\&.conf
.SH "SEE ALSO"
.PP
\fBsyslog\-ng\&.conf\fR(5)
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
For the detailed documentation of see
\m[blue]\fB\fBThe syslog\-ng Administrator Guide\fR\fR\m[]\&\s-2\u[1]\d\s+2
.PP
If you experience any problems or need help with syslog\-ng, visit the
\m[blue]\fB\fBsyslog\-ng mailing list\fR\fR\m[]\&\s-2\u[2]\d\s+2\&.
.PP
For news and notifications about of syslog\-ng, visit the
\m[blue]\fB\fBsyslog\-ng blogs\fR\fR\m[]\&\s-2\u[3]\d\s+2\&.
.sp .5v
.RE
.SH "AUTHOR"
.PP
This manual page was written by the Airbus Secure Logging Team <secure\-logging@airbus\&.com>\&.
.SH "COPYRIGHT"
.SH "NOTES"
.IP " 1." 4
\fBThe syslog-ng Administrator Guide\fR
.RS 4
\%https://www.balabit.com/documents/syslog-ng-ose-latest-guides/en/syslog-ng-ose-guide-admin/html/index.html
.RE
.IP " 2." 4
\fBsyslog-ng mailing list\fR
.RS 4
\%https://lists.balabit.hu/mailman/listinfo/syslog-ng
.RE
.IP " 3." 4
\fBsyslog-ng blogs\fR
.RS 4
\%https://syslog-ng.org/blogs/
.RE