Debian Codegraph @

upstream/debian-unstable/man8/libdnf5-local.8

raw
1 .\" Man page generated from reStructuredText
2 .\" by the Docutils 0.22.4 manpage writer.
3 .
4 .
5 .nr rst2man-indent-level 0
6 .
7 .de1 rstReportMargin
8 \\$1 \\n[an-margin]
9 level \\n[rst2man-indent-level]
10 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
11 -
12 \\n[rst2man-indent0]
13 \\n[rst2man-indent1]
14 \\n[rst2man-indent2]
15 ..
16 .de1 INDENT
17 .\" .rstReportMargin pre:
18 . RS \\$1
19 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
20 . nr rst2man-indent-level +1
21 .\" .rstReportMargin post:
22 ..
23 .de UNINDENT
24 . RE
25 .\" indent \\n[an-margin]
26 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
27 .nr rst2man-indent-level -1
28 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30 ..
31 .TH "LIBDNF5-LOCAL" "8" "May 09, 2026" "" "dnf5"
32 .SH NAME
33 libdnf5-local \- Local Plugin
34 .SH DESCRIPTION
35 .sp
36 After each libdnf5 transaction copy all downloaded packages to local repositories on the filesystem and generate repository metadata.
37 .sp
38 The plugin creates two repositories:
39 .INDENT 0.0
40 .IP \(bu 2
41 \fB_dnf_local\fP for packages from repositories with \fBpkg_gpgcheck\fP enabled.
42 The \fBpkg_gpgcheck\fP setting is inherited from the main configuration.
43 The repository doesn\(aqt specify any \fBgpgkey\fP, it assumes all required keys
44 were already imported.
45 .IP \(bu 2
46 \fB_dnf_local_nogpgcheck\fP for packages from repositories with \fBpkg_gpgcheck\fP
47 disabled. This repository has \fBpkg_gpgcheck\fP set to \fBfalse\fP\&.
48 .UNINDENT
49 .sp
50 Each repository is only created when there are cached packages in it.
51 .sp
52 Both repositories are configured with the following options:
53 .INDENT 0.0
54 .INDENT 3.5
55 .sp
56 .EX
57 skip_if_unavailable = true
58 metadata_expire = 0
59 .EE
60 .UNINDENT
61 .UNINDENT
62 .sp
63 The \fB_dnf_local\fP repository has \fBcost = 500\fP and the \fB_dnf_local_nogpgcheck\fP
64 repository has \fBcost = 501\fP, so the gpgcheck\-enabled repository is preferred
65 when both contain the same package.
66 .sp
67 To generate the metadata \fIcreaterepo_c\fP is required.
68 .SH CONFIGURATION
69 .sp
70 The plugin configuration is in \fB/etc/dnf/libdnf5\-plugins/local.conf\fP\&.
71 The minimal content of the conf file should contain \fBmain\fP and \fBcreaterepo\fP sections.
72 .sp
73 The \fBmain\fP section requires:
74 .INDENT 0.0
75 .TP
76 .B \fBname\fP
77 string \%<#\:string-label>
78 .sp
79 The plugin\(aqs name is \fBlocal\fP
80 .TP
81 .B \fBenabled\fP
82 Whether or where the plugin is enabled: \fBtrue\fP, \fBfalse\fP, \fBhost\-only\fP, \fBinstallroot\-only\fP\&.
83 .INDENT 7.0
84 .IP \(bu 2
85 For \fBhost\-only\fP the plugin will run only on transactions in the default installroot \fB/\fP\&.
86 .IP \(bu 2
87 For \fBinstallroot\-only\fP the plugin will run only on transactions in installroots different from \fB/\fP\&.
88 .UNINDENT
89 .UNINDENT
90 .sp
91 It can also contain:
92 .INDENT 0.0
93 .TP
94 .B \fBrepodir\fP
95 string \%<#\:string-label>
96 .sp
97 Path where the local repository is located.
98 By default it is in persistdir \%<#\:persistdir-options-label> in \fBplugins/local\fP subdirectory.
99 .TP
100 .B \fBrepodir_nogpgcheck\fP
101 string \%<#\:string-label>
102 .sp
103 Path where the local repository for packages from repos with \fBpkg_gpgcheck\fP
104 disabled is located.
105 By default it is in persistdir \%<#\:persistdir-options-label> in \fBplugins/local\-nogpgcheck\fP subdirectory.
106 .UNINDENT
107 .sp
108 The \fBcreaterepo\fP section requires:
109 .INDENT 0.0
110 .TP
111 .B \fBenabled\fP
112 boolean \%<#\:boolean-label>
113 .sp
114 Whether running \fBcreaterepo\fP to generate repodata is enabled: \fBtrue\fP or \fBfalse\fP\&.
115 .UNINDENT
116 .sp
117 Additionally it can contain:
118 .INDENT 0.0
119 .TP
120 .B \fBcachedir\fP
121 string \%<#\:string-label>
122 .sp
123 If you want to speed up \fBcreaterepo\fP with the \fB\-\-cachedir\fP option.
124 Not used by default.
125 .TP
126 .B \fBquiet\fP
127 boolean \%<#\:boolean-label>
128 .sp
129 Whether to run \fBcreaterepo\fP with \fB\-\-quiet\fP option. On by default.
130 .TP
131 .B \fBverbose\fP
132 boolean \%<#\:boolean-label>
133 .sp
134 Whether to run \fBcreaterepo\fP with \fB\-\-verbose\fP option. Off by default.
135 .UNINDENT
136 .SH Author
137 See AUTHORS.md in dnf5 source distribution.
138 .SH Copyright
139 Contributors to the dnf5 project.
140 .\" End of generated man page.