Debian Codegraph @

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