Debian Codegraph @

upstream/mageia-cauldron/man8/dnf5-reposync.8

raw
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 "DNF5-REPOSYNC" "8" "May 10, 2026" "" "dnf5"
31 .SH NAME
32 dnf5-reposync \- Reposync Command
33 .SH SYNOPSIS
34 .sp
35 \fBdnf5 [GLOBAL OPTIONS] reposync [OPTIONS]\fP
36 .SH DESCRIPTION
37 .sp
38 The \fBreposync\fP command creates local copies of remote repositories. It avoids re\-downloading packages that are already present in the local directory.
39 .sp
40 By default, \fBreposync\fP synchronizes all enabled repositories. However, you can customize the set of repositories to be synchronized using standard DNF5 options such as \fB\-\-repo\fP, \fB\-\-enable\-repo\fP, or \fB\-\-disable\-repo\fP\&.
41 .SH OPTIONS
42 .INDENT 0.0
43 .TP
44 .B \fB\-\-arch=<architecture>, \-a <architecture>\fP
45 Download only packages for the specified architecture. This option can be specified multiple times. The default behavior is to download packages for all architectures.
46 .TP
47 .B \fB\-\-delete\fP
48 Remove local packages that are no longer present in the remote repository.
49 .TP
50 .B \fB\-\-destdir=<path>\fP
51 Specifies the root path where downloaded repositories are stored, relative
52 to the current working directory. Defaults to the current working
53 directory. Each downloaded repository will have a subdirectory named after
54 its ID within this path.
55 .TP
56 .B \fB\-\-download\-metadata\fP
57 Download all repository metadata. The downloaded copy is instantly usable
58 as a repository without the need to run \fBcreaterepo_c\fP\&. When used with
59 \fB\-\-newest\-only\fP, only the latest package versions are downloaded. However,
60 the metadata will still reference also older packages. To avoid issues caused
61 by missing RPM files, consider updating the metadata using \fBcreaterepo_c \-\-update\fP\&.
62 Otherwise, DNF will encounter errors when attempting to install older packages.
63 .TP
64 .B \fB\-\-gpgcheck, \-g\fP
65 Remove packages that fail OpenPGP signature verification after downloading. The
66 command exits with a code of \fB1\fP if at least one package is removed.
67 .sp
68 Note: For repositories configured with \fBgpgcheck=0\fP, OpenPGP signatures are not
69 checked, even when this option is used.
70 .TP
71 .B \fB\-\-metadata\-path=<path>\fP
72 Specifies the root path where downloaded metadata files are stored. If not
73 specified, it defaults to the value of \fB\-\-destdir\fP\&.
74 .TP
75 .B \fB\-\-newest\-only, \-n\fP
76 Download only the latest package versions from each repository.
77 .TP
78 .B \fB\-\-norepopath\fP
79 Prevents the repository id from being added to the download path. This
80 option can only be used when syncing a single repository. (The default
81 behavior adds the repository id to the path.)
82 .TP
83 .B \fB\-\-remote\-time\fP
84 Attempts to set the timestamps of local downloaded files to match those on
85 the remote side.
86 .TP
87 .B \fB\-\-safe\-write\-path=<path>\fP
88 Defines the filesystem path prefix where reposync is allowed to write
89 files. If not specified, it defaults to the repository\(aqs download path.
90 This option is useful for repositories that use relative locations of
91 packages leading outside of the repository directory (e.g.,
92 \fB\&../packages_store/foo.rpm\fP).
93 .sp
94 Caution: Any file under the \fBsafe\-write\-path\fP can be overwritten. This option
95 can only be used when syncing a single repository.
96 .TP
97 .B \fB\-\-srpm\fP
98 Downloads source packages. Equivalent to using \fB\-\-arch=src\fP\&.
99 .TP
100 .B \fB\-\-urls, \-u\fP
101 Prints the URLs of the files that would be downloaded without actually
102 downloading them.
103 .UNINDENT
104 .SH EXAMPLES
105 .INDENT 0.0
106 .TP
107 .B \fBdnf reposync \-\-repoid=the_repo\fP
108 Synchronize all packages from the repository with id \fBthe_repo\fP\&. The
109 synchronized copy is saved in \fBthe_repo\fP subdirectory of the current
110 working directory.
111 .TP
112 .B \fBdnf reposync \-\-destdir=/my/repos/path \-\-repoid=the_repo\fP
113 Synchronize all packages from the repository with id \fBthe_repo\fP\&. In this
114 case files are saved in \fB/my/repos/path/the_repo\fP directory.
115 .TP
116 .B \fBdnf reposync \-\-repoid=the_repo \-\-download\-metadata\fP
117 Synchronize all packages and metadata from \fBthe_repo\fP repository.
118 .sp
119 Repository synchronized with \fB\-\-download\-metadata\fP option can be directly
120 used with DNF for example by using \fB\-\-repofrompath\fP option:
121 .sp
122 \fBdnf \-\-repofrompath=syncedrepo,the_repo \-\-repoid=syncedrepo list \-\-available\fP
123 .UNINDENT
124 .SH AUTHOR
125 See AUTHORS.md in dnf5 source distribution.
126 .SH COPYRIGHT
127 Contributors to the dnf5 project.
128 .\" Generated by docutils manpage writer.
129 .