.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "xsec-xtest.pod 1"
.TH xsec-xtest.pod 1 2024-02-10 2.0.4 "Apache XML Security"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
xmlsec\-xtest \- Perform run\-time tests of the XML Security library
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBxmlsec-xtest\fR [\fB\-\-help\fR] [\fB\-p\fR]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBxmlsec-xtest\fR performs a set of run-time tests against the Apache XML
Security for C++ library.  This is rarely of interest to a user of the
library, but it can be used as a sanity check to ensure that the library
is working properly.
.SH OPTIONS
.IX Header "OPTIONS"
Note that the single-character options must still occur as separate
options on the command line.  In other words, \fB\-pe\fR to specify both the
\&\fB\-p\fR and \fB\-e\fR options is not allowed.
.IP \fB\-\-help\fR 4
.IX Item "--help"
Print out usage information and exit.
.IP "\fB\-\-print\-docs\fR, \fB\-p\fR" 4
.IX Item "--print-docs, -p"
Print out the test documents while running each test.
.IP "\fB\-\-encryption\-only\fR, \fB\-e\fR" 4
.IX Item "--encryption-only, -e"
.PD 0
.IP "\fB\-\-encryption\-unit\-only\fR, \fB\-u\fR" 4
.IX Item "--encryption-unit-only, -u"
.IP "\fB\-\-signature\-only\fR, \fB\-s\fR" 4
.IX Item "--signature-only, -s"
.IP "\fB\-\-signature\-unit\-only\fR, \fB\-t\fR" 4
.IX Item "--signature-unit-only, -t"
.IP "\fB\-\-xkms\-only\fR, \fB\-x\fR" 4
.IX Item "--xkms-only, -x"
.PD
By default, \fBxmlsec-xtest\fR runs all of the tests.  One of these options
may be specified to run only that set of tests.  All of these options are
mutually exclusive; at most one of them should be specified.
.SH AUTHOR
.IX Header "AUTHOR"
This manual page was written by Russ Allbery for Debian.
.SH "MANUAL LICENSE"
.IX Header "MANUAL LICENSE"
The authors hereby relinquish any claim to any copyright that they may
have in this work, whether granted under contract or by operation of law
or international treaty, and hereby commit to the public, at large, that
they shall not, at any time in the future, seek to enforce any copyright
in this work against any person or entity, or prevent any person or entity
from copying, publishing, distributing or creating derivative works of
this work.