.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "REPOD-FILE" "1" "Apr 13, 2024" "" "repod"
.sp
File actions for packages, management repository and sync databases.

.INDENT 0.0
.INDENT 3.5
.sp
.EX
usage: repod\-file [\-h] [\-c CONFIG] [\-d] [\-s] [\-v] {package,repo,schema} ...
.EE
.UNINDENT
.UNINDENT
.SH POSITIONAL ARGUMENTS
.INDENT 0.0
.TP
.B subcommand
Possible choices: package, repo, schema
.UNINDENT
.SH NAMED ARGUMENTS
.INDENT 0.0
.TP
.B \-c, \-\-config
configuration file
.TP
.B \-d, \-\-debug
debug output
.sp
Default: False
.TP
.B \-s, \-\-system
system mode
.sp
Default: False
.TP
.B \-v, \-\-verbose
verbose output
.sp
Default: False
.UNINDENT
.SH SUB-COMMANDS
.SS package
.sp
interact with package files
.INDENT 0.0
.INDENT 3.5
.sp
.EX
repod\-file package [\-h] {inspect} ...
.EE
.UNINDENT
.UNINDENT
.SS Positional Arguments
.INDENT 0.0
.TP
.B package
Possible choices: inspect
.UNINDENT
.SS Sub\-commands
.SS inspect
.sp
inspect package files
.INDENT 0.0
.INDENT 3.5
.sp
.EX
repod\-file package inspect [\-h] [\-B | \-M | \-P] [\-p] [\-s] file [file ...]
.EE
.UNINDENT
.UNINDENT
.SS Positional Arguments
.INDENT 0.0
.TP
.B file
package files
.UNINDENT
.SS Named Arguments
.INDENT 0.0
.TP
.B \-B, \-\-buildinfo
only inspect .BUILDINFO
.sp
Default: False
.TP
.B \-M, \-\-mtree
only inspect .MTREE
.sp
Default: False
.TP
.B \-P, \-\-pkginfo
only inspect .PKGINFO
.sp
Default: False
.TP
.B \-p, \-\-pretty
pretty print output
.sp
Default: False
.TP
.B \-s, \-\-with\-signature
locate and use a signature file for each provided package file
.sp
Default: False
.UNINDENT
.SS repo
.sp
interact with repositories
.INDENT 0.0
.INDENT 3.5
.sp
.EX
repod\-file repo [\-h] {importdb,importpkg,writedb} ...
.EE
.UNINDENT
.UNINDENT
.SS Positional Arguments
.INDENT 0.0
.TP
.B repo
Possible choices: importdb, importpkg, writedb
.UNINDENT
.SS Sub\-commands
.SS importdb
.sp
import state from a repository sync database
.INDENT 0.0
.INDENT 3.5
.sp
.EX
repod\-file repo importdb [\-h] [\-a ARCHITECTURE] [\-D | \-S | \-T] file name
.EE
.UNINDENT
.UNINDENT
.SS Positional Arguments
.INDENT 0.0
.TP
.B file
repository sync database
.TP
.B name
name of repository to import to
.UNINDENT
.SS Named Arguments
.INDENT 0.0
.TP
.B \-a, \-\-architecture
target a repository with a specific architecture (if multiple of the same name but differing architecture exist)
.TP
.B \-D, \-\-debug
import to debug repository
.sp
Default: False
.TP
.B \-S, \-\-staging
import to staging repository
.sp
Default: False
.TP
.B \-T, \-\-testing
import to testing repository
.sp
Default: False
.UNINDENT
.SS importpkg
.sp
import packages to a repo
.INDENT 0.0
.INDENT 3.5
.sp
.EX
repod\-file repo importpkg [\-h] [\-a ARCHITECTURE] [\-d] [\-p] [\-s]
                          [\-u SOURCE_URL [SOURCE_URL ...]] [\-D | \-S | \-T]
                          file [file ...] name
.EE
.UNINDENT
.UNINDENT
.SS Positional Arguments
.INDENT 0.0
.TP
.B file
package files
.TP
.B name
name of repository to import to
.UNINDENT
.SS Named Arguments
.INDENT 0.0
.TP
.B \-a, \-\-architecture
target a repository with a specific architecture (if multiple of the same name but differing architecture exist)
.TP
.B \-d, \-\-dry\-run
only show output, but do not write output to file
.sp
Default: False
.TP
.B \-p, \-\-pretty
pretty print output (only applies to dry\-run mode)
.sp
Default: False
.TP
.B \-s, \-\-with\-signature
locate and use a signature file for each provided package file
.sp
Default: False
.TP
.B \-u, \-\-source\-url
list of source URLs for added pkgbases (provided as one or more pkgbase=url strings)
.sp
Default: []
.TP
.B \-D, \-\-debug
import to debug repository
.sp
Default: False
.TP
.B \-S, \-\-staging
import to staging repository
.sp
Default: False
.TP
.B \-T, \-\-testing
import to testing repository
.sp
Default: False
.UNINDENT
.SS writedb
.sp
export state to repository sync database
.INDENT 0.0
.INDENT 3.5
.sp
.EX
repod\-file repo writedb [\-h] [\-a ARCHITECTURE] [\-D | \-S | \-T] name
.EE
.UNINDENT
.UNINDENT
.SS Positional Arguments
.INDENT 0.0
.TP
.B name
name of repository to write to
.UNINDENT
.SS Named Arguments
.INDENT 0.0
.TP
.B \-a, \-\-architecture
target a repository with a specific architecture (if multiple of the same name but differing architecture exist)
.TP
.B \-D, \-\-debug
export from debug repository
.sp
Default: False
.TP
.B \-S, \-\-staging
export from staging repository
.sp
Default: False
.TP
.B \-T, \-\-testing
export from testing repository
.sp
Default: False
.UNINDENT
.SS schema
.sp
JSON schema commands
.INDENT 0.0
.INDENT 3.5
.sp
.EX
repod\-file schema [\-h] {export} ...
.EE
.UNINDENT
.UNINDENT
.SS Positional Arguments
.INDENT 0.0
.TP
.B schema
Possible choices: export
.UNINDENT
.SS Sub\-commands
.SS export
.sp
export JSON schemas to directory
.INDENT 0.0
.INDENT 3.5
.sp
.EX
repod\-file schema export [\-h] dir
.EE
.UNINDENT
.UNINDENT
.SS Positional Arguments
.INDENT 0.0
.TP
.B dir
directory to which to write JSON files to
.UNINDENT
.SH EXAMPLES
.SS TRANSFORM REPOSITORY SYNC DATABASE TO MANAGEMENT REPOSITORY
.sp
\fI\%Sync Database\fP files can be transformed to representations used in the
context of a \fI\%Management Repository\fP\&.
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fI\%Files Database\fP files are required to create \fI\%Management Repository\fP files, that contain information on files contained in the
respective packages they represent! This data is not contained in the
\fI\%Default Database\fP files!
.UNINDENT
.UNINDENT
.sp
For testing purposes, the system\(aqs  sync databases in
\fB/var/lib/pacman/sync/\fP can be used (this assumes a system that makes use of
pacman as package manager).
.sp
To import \fI\%Default Database\fP files and output them to the management
repository directory of a configured repository, use:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
repod\-file repo importdb /var/lib/pacman/sync/core.db default
.EE
.UNINDENT
.UNINDENT
.sp
To be able to use \fI\%Files Database\fP files, make sure to update them
first.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pacman \-Fy
.EE
.UNINDENT
.UNINDENT
.sp
Afterwards it is possible to import those files analogous to how it is done
with \fI\%Default Database\fP files:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
repod\-file repo importdb /var/lib/pacman/sync/core.files default
.EE
.UNINDENT
.UNINDENT
.sp
The above assumes the repository named \fIdefault\fP is present (e.g. when no
configuration file for repod is present).
.SS TRANSFORM MANAGEMENT REPOSITORY TO REPOSITORY SYNC DATABASE
.sp
The JSON files contained in a \fI\%Management Repository\fP can be transformed
into a \fI\%Sync Database\fP (both \fI\%Default Database\fP and \fI\%Files Database\fP files are created).
.sp
After following the examples in \fI\%TRANSFORM REPOSITORY SYNC DATABASE TO MANAGEMENT REPOSITORY\fP, it is
possible to use the created files and turn them back into \fI\%Sync Database\fP
files.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
repod\-file repo writedb default
.EE
.UNINDENT
.UNINDENT
.sp
The above creates \fBdefault.db\fP as well as \fBdefault.files\fP in the binary
repository location of the repository named \fIdefault\fP\&.
.SH SEE ALSO
.sp
\fBrepod.conf(5)\fP, \fBBUILDINFO(5)\fP, \fBmtree(5)\fP, \fBpacman(8)\fP
.SH AUTHOR
David Runge
.SH COPYRIGHT
2024, David Runge
.\" Generated by docutils manpage writer.
.