| 1 |
.\" Man page generated from reStructuredText. |
| 2 |
. |
| 3 |
. |
| 4 |
.nr rst2man-indent-level 0 |
| 5 |
. |
| 6 |
.de1 rstReportMargin |
| 7 |
\\$1 \\n[an-margin] |
| 8 |
level \\n[rst2man-indent-level] |
| 9 |
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] |
| 10 |
- |
| 11 |
\\n[rst2man-indent0] |
| 12 |
\\n[rst2man-indent1] |
| 13 |
\\n[rst2man-indent2] |
| 14 |
.. |
| 15 |
.de1 INDENT |
| 16 |
.\" .rstReportMargin pre: |
| 17 |
. RS \\$1 |
| 18 |
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] |
| 19 |
. nr rst2man-indent-level +1 |
| 20 |
.\" .rstReportMargin post: |
| 21 |
.. |
| 22 |
.de UNINDENT |
| 23 |
. RE |
| 24 |
.\" indent \\n[an-margin] |
| 25 |
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] |
| 26 |
.nr rst2man-indent-level -1 |
| 27 |
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] |
| 28 |
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u |
| 29 |
.. |
| 30 |
.TH "DNF4-COPR" "8" "Sep 27, 2025" "4.10.1" "dnf-plugins-core" |
| 31 |
.SH NAME |
| 32 |
dnf4-copr \- DNF copr Plugin |
| 33 |
.sp |
| 34 |
Work with Copr & Playground repositories on the local system. |
| 35 |
.INDENT 0.0 |
| 36 |
.IP \(bu 2 |
| 37 |
The \fBcopr\fP command is used to add or remove Copr repositories to the local system |
| 38 |
.IP \(bu 2 |
| 39 |
The \fBplayground\fP is used to enable or disable the Playground repository |
| 40 |
.UNINDENT |
| 41 |
.SH SYNOPSIS |
| 42 |
.sp |
| 43 |
\fBdnf copr [enable|disable|remove|list|search] <parameters>\fP |
| 44 |
.sp |
| 45 |
\fBdnf playground [enable|disable|upgrade]\fP |
| 46 |
.SH ARGUMENTS (COPR) |
| 47 |
.INDENT 0.0 |
| 48 |
.TP |
| 49 |
.B \fBenable name/project [chroot]\fP |
| 50 |
Enable the \fBname/project\fP Copr repository with the optional \fBchroot\fP\&. |
| 51 |
.TP |
| 52 |
.B \fBdisable name/project\fP |
| 53 |
Disable the \fBname/project\fP Copr repository. |
| 54 |
.TP |
| 55 |
.B \fBremove name/project\fP |
| 56 |
Remove the \fBname/project\fP Copr repository. |
| 57 |
.TP |
| 58 |
.B \fBlist \-\-installed\fP |
| 59 |
List installed Copr repositories (default). |
| 60 |
.TP |
| 61 |
.B \fBlist \-\-enabled\fP |
| 62 |
List enabled Copr repositories. |
| 63 |
.TP |
| 64 |
.B \fBlist \-\-disabled\fP |
| 65 |
List disabled Copr repositories. |
| 66 |
.TP |
| 67 |
.B \fBlist \-\-available\-by\-user=name\fP |
| 68 |
List available Copr repositories for a given \fBname\fP\&. |
| 69 |
.TP |
| 70 |
.B \fBsearch project\fP |
| 71 |
Search for a given \fBproject\fP\&. |
| 72 |
.TP |
| 73 |
.B \fBenable hub/name/project\fP |
| 74 |
Enable the \fBname/project\fP Copr repository from the specified Copr \fBhub\fP, |
| 75 |
Hub is be specified either by its hostname (eg. \fIcopr.fedorainfracloud.org\fP) |
| 76 |
or by an ID that’s defined in a configuration file. |
| 77 |
.UNINDENT |
| 78 |
.SH OPTIONS (COPR) |
| 79 |
.sp |
| 80 |
All general DNF options are accepted, see \fIOptions\fP in \fBdnf(8)\fP for details. |
| 81 |
.INDENT 0.0 |
| 82 |
.TP |
| 83 |
.B \fB\-\-hub Copr\fP |
| 84 |
Specify a Copr hub to use. Default is the Fedora Copr: \fBhttps://copr.fedorainfracloud.org\fP\&. |
| 85 |
.UNINDENT |
| 86 |
.SH CONFIGURATION (COPR) |
| 87 |
.sp |
| 88 |
\fB/etc/dnf/plugins/copr.conf\fP |
| 89 |
\fB/etc/dnf/plugins/copr.d/\fP |
| 90 |
\fB/usr/share/dnf/plugins/copr.vendor.conf\fP |
| 91 |
.INDENT 0.0 |
| 92 |
.TP |
| 93 |
.B Configuration file should contain a section for each hub, each section having \fBhostname\fP |
| 94 |
(mandatory), \fBprotocol\fP (default \fBhttps\fP) and \fBport\fP (default \fB443\fP) parameters.: |
| 95 |
.INDENT 7.0 |
| 96 |
.INDENT 3.5 |
| 97 |
.sp |
| 98 |
.EX |
| 99 |
[fedora] |
| 100 |
hostname = copr.fedorainfracloud.org |
| 101 |
protocol = https |
| 102 |
port = 443 |
| 103 |
.EE |
| 104 |
.UNINDENT |
| 105 |
.UNINDENT |
| 106 |
.UNINDENT |
| 107 |
.sp |
| 108 |
There is also a vendor configuration that allows a vendor to specify the distro ID that copr should use by default. |
| 109 |
This is useful for vendors that want to use Copr for their own distro. The vendor configuration is in |
| 110 |
\fB/usr/share/dnf/plugins/copr.vendor.conf\fP (optional) or \fB/etc/dnf/plugins/copr.conf\fP: |
| 111 |
.INDENT 0.0 |
| 112 |
.INDENT 3.5 |
| 113 |
.sp |
| 114 |
.EX |
| 115 |
[main] |
| 116 |
distribution = fedora |
| 117 |
releasever = 37 |
| 118 |
.EE |
| 119 |
.UNINDENT |
| 120 |
.UNINDENT |
| 121 |
.SH ARGUMENTS (PLAYGROUND) |
| 122 |
.INDENT 0.0 |
| 123 |
.TP |
| 124 |
.B \fBenable\fP |
| 125 |
Enable the Playground repository. |
| 126 |
.TP |
| 127 |
.B \fBdisable\fP |
| 128 |
Disable the Playground repository. |
| 129 |
.TP |
| 130 |
.B \fBupgrade\fP |
| 131 |
Upgrade the Playground repository settings (same as \fBdisable\fP and then \fBenable\fP). |
| 132 |
.UNINDENT |
| 133 |
.SH OPTIONS (PLAYGROUND) |
| 134 |
.sp |
| 135 |
All general DNF options are accepted, see \fIOptions\fP in \fBdnf(8)\fP for details. |
| 136 |
.SH EXAMPLES |
| 137 |
.INDENT 0.0 |
| 138 |
.TP |
| 139 |
.B \fBcopr enable rhscl/perl516 epel\-6\-x86_64\fP |
| 140 |
Enable the \fBrhscl/perl516\fP Copr repository, using the \fBepel\-6\-x86_64\fP chroot. |
| 141 |
.TP |
| 142 |
.B \fBcopr disable rhscl/perl516\fP |
| 143 |
Disable the \fBrhscl/perl516\fP Copr repository |
| 144 |
.TP |
| 145 |
.B \fBcopr list \-\-available\-by\-user=rita\fP |
| 146 |
List available Copr projects for user \fBrita\fP\&. |
| 147 |
.TP |
| 148 |
.B \fBcopr search tests\fP |
| 149 |
Search for Copr projects named \fBtests\fP\&. |
| 150 |
.UNINDENT |
| 151 |
.SH KNOWN ISSUES |
| 152 |
.sp |
| 153 |
Copr plugin does not respect \fI\-4\fP and \fI\-6\fP options of \fIdnf\fP command when enabling a Copr |
| 154 |
respository. Users are advised to configure a global address preference in /etc/gai.conf. |
| 155 |
.SH AUTHOR |
| 156 |
See AUTHORS in your Core DNF Plugins distribution |
| 157 |
.SH COPYRIGHT |
| 158 |
2014, Red Hat, Licensed under GPLv2+ |
| 159 |
.\" Generated by docutils manpage writer. |
| 160 |
. |