.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" 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
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    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
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "OSINFO-DB-VALIDATE.C 1"
.TH OSINFO-DB-VALIDATE.C 1 "2019-07-29" "osinfo-db-tools-1.1.0" "Virtualization Support"
.\" 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"
osinfo\-db\-validate \- Validate libosinfo XML data files
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
osinfo-db-validate [\s-1OPTIONS...\s0]
.PP
osinfo-db-validate [\s-1OPTIONS...\s0] \s-1LOCAL\-PATH1\s0 [\s-1LOCAL\-PATH2...\s0]
.PP
osinfo-db-validate [\s-1OPTIONS...\s0] \s-1URI1\s0 [\s-1URI2...\s0]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The \fBosinfo-db-validate\fR tool is able to validate \s-1XML\s0 files
in one of the osinfo database locations for compliance with
the \s-1RNG\s0 schema.
.IP "\fBsystem\fR" 1
.IX Item "system"
This is the primary system-wide database location, intended
for use by operating system vendors distributing database
files in the native package format. The \s-1RNG\s0 schema is
expected to be present in this location.
.IP "\fBlocal\fR" 1
.IX Item "local"
This is the secondary system-wide database location, intended
for use by system administrators wishing to provide an updated
database for all users. This location may provide an \s-1RNG\s0 schema
override, otherwise the \s-1RNG\s0 schema from the system location
will be used.
.IP "\fBuser\fR" 1
.IX Item "user"
This is the user private database location, intended for use
by unprivileged local users wishing to provide applications
they use with an updated database. This location may provide
an \s-1RNG\s0 schema override, otherwise the \s-1RNG\s0 schema from the
local location will be used, or failing that the system
location.
.PP
If run by a privileged account (ie root), the \fBlocal\fR database
location will be validate by default, otherwise the \fBuser\fR location
will be validated.
.PP
Alternatively it is possible to directly provide a list of files
to be validated using the (\f(CW\*(C`LOCAL\-PATH1\*(C'\fR or \f(CW\*(C`URI1\*(C'\fR) arguments.
.PP
Any validation errors will be displayed on the console when
detected.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-\-user\fR" 8
.IX Item "--user"
Override the default behaviour to force validating files from the
\&\fBuser\fR database location.
.IP "\fB\-\-local\fR" 8
.IX Item "--local"
Override the default behaviour to force validating files from the
\&\fBlocal\fR database location.
.IP "\fB\-\-system\fR" 8
.IX Item "--system"
Override the default behaviour to force validating files from the
\&\fBsystem\fR database location.
.IP "\fB\-\-dir=PATH\fR" 8
.IX Item "--dir=PATH"
Override the default behaviour to force validating files from the
custom directory \fB\s-1PATH\s0\fR.
.IP "\fB\-\-root=PATH\fR" 8
.IX Item "--root=PATH"
Prefix the database location with the root directory given by
\&\f(CW\*(C`PATH\*(C'\fR. This is useful when wishing to validate files that are
in a chroot environment or equivalent.
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 8
.IX Item "-v, --verbose"
Display verbose progress information when validating files
.SH "EXIT STATUS"
.IX Header "EXIT STATUS"
The exit status will be 0 if all files passed validation,
or 1 if a validation error was hit.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\f(CW\*(C`osinfo\-db\-path(1)\*(C'\fR
.SH "AUTHORS"
.IX Header "AUTHORS"
Daniel P. Berrange <berrange@redhat.com>
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2012\-2016 Red Hat, Inc.
.SH "LICENSE"
.IX Header "LICENSE"
\&\f(CW\*(C`osinfo\-db\-validate\*(C'\fR is distributed under the terms of the \s-1GNU LGPL\s0 v2+
license. This is free software; see the source for copying conditions.
There is \s-1NO\s0 warranty; not even for \s-1MERCHANTABILITY\s0 or \s-1FITNESS
FOR A PARTICULAR PURPOSE\s0