1CREATEREPO_C(8) CREATEREPO_C(8)
2
6 createrepo_c - Create rpm-md format (xml-rpm-metadata) repository
7
9 createrepo_c [options] <directory>
10
12 Uses rpm packages from <directory> to create repodata.
13 If compiled with libmodulemd support modular metadata inside <direc‐
15 tory> identified by the patterns below and all their compressed vari‐
16 ants are automatically collected, merged and added to the repodata.
17 The patterns are:
19 • *.modulemd.yaml (recommended file name: N:S:V:C:A.modulemd.yaml)
21 • *.modulemd-defaults.yaml (recommended file name: N.modulemd-de‐
23 faults.yaml)
24 • modules.yaml (recommended way of importing multiple documents at
26 once)
27
29 -V --version
30 Show program's version number and exit.
31 -q --quiet
33 Run quietly.
34 -v --verbose
36 Run verbosely.
37 -x --excludes PACKAGE_NAME_GLOB
39 Path patterns to exclude, can be specified multiple times. The pat‐
40 terns are matched against relative paths to RPMs. Note that the fea‐
41 ture uses g_pattern_match() function, not glob(), for semantic differ‐
42 ences see https://developer.gnome.org/glib/stable/glib-Glob-style-pat‐
43 tern-matching.html
44 --basedir BASEDIR
46 Basedir for path to directories.
47 -u --baseurl URL
49 Optional base URL location for all files.
50 -g --groupfile GROUPFILE
52 Path to groupfile to include in metadata.
53 -s --checksum CHECKSUM_TYPE
55 Choose the checksum type used in repomd.xml and for packages in the
56 metadata. The default is now sha256.
57 -p --pretty
59 Make sure all xml generated is formatted (default)
60 -d --database
62 Generate sqlite databases for use with yum.
63 --no-database
65 Do not generate sqlite databases in the repository.
66 --update
68 If metadata already exists in the outputdir and an rpm is unchanged
69 (based on file size and mtime) since the metadata was generated, reuse
70 the existing metadata rather than recalculating it. In the case of a
71 large repository with only a few new or modified rpms this can signifi‐
72 cantly reduce I/O and processing time.
73 --update-md-path
75 Existing metadata from this path are loaded and reused in addition to
76 those present in the outputdir (works only with --update). Can be spec‐
77 ified multiple times.
78 --skip-stat
80 Skip the stat() call on a --update, assumes if the filename is the same
81 then the file is still the same (only use this if you're fairly trust‐
82 ing or gullible).
83 --split
85 Run in split media mode. Rather than pass a single directory, take a
86 set of directories corresponding to different volumes in a media set.
87 Meta data is created in the first given directory
88 -i --pkglist FILENAME
90 Specify a text file which contains the complete list of files to in‐
91 clude in the repository from the set found in the directory. File for‐
92 mat is one package per line, no wildcards or globs.
93 -n --includepkg PACKAGE
95 Specify pkgs to include on the command line. Takes urls as well as lo‐
96 cal paths.
97 --recycle-pkglist
99 Useful only with --update. Read the list of packages from old meta‐
100 data, and reuse it instead of (perhaps expensive) directory traversal.
101 This doesn't collide with explicitly selected packages by --pkglist or
102 --includepkg, such packages are appended to the recycled list. This
103 option is useful for I/O optimal repo modifications (package removal by
104 --exclude, and additions with --pkglist).
105 -o --outputdir URL
107 Optional output directory.
108 -S --skip-symlinks
110 Ignore symlinks of packages.
111 --changelog-limit NUM
113 Only import the last N changelog entries, from each rpm, into the meta‐
114 data.
115 --unique-md-filenames
117 Include the file's checksum in the metadata filename, helps HTTP
118 caching (default).
119 --simple-md-filenames
121 Do not include the file's checksum in the metadata filename.
122 --retain-old-md NUM
124 Specify NUM to 0 to remove all repodata present in old repomd.xml or
125 any other positive number to keep all old repodata. Use --compatibility
126 flag to get the behavior of original createrepo: Keep around the latest
127 (by timestamp) NUM copies of the old repodata (works only for primary,
128 filelists, other and their DB variants).
129 --distro DISTRO
131 Distro tag and optional cpeid: --distro'cpeid,textname'.
132 --content CONTENT_TAGS
134 Tags for the content in the repository.
135 --repo REPO_TAGS
137 Tags to describe the repository itself.
138 --revision REVISION
140 User-specified revision for this repository.
141 --set-timestamp-to-revision
143 Set timestamp fields in repomd.xml and last modification times of cre‐
144 ated repodata to a value given with --revision. This requires --revi‐
145 sion to be a timestamp formatted in 'date +%s' format.
146 --read-pkgs-list READ_PKGS_LIST
148 Output the paths to the pkgs actually read useful with --update.
149 --workers
151 Number of workers to spawn to read rpms.
152 --xz
154 Use xz for repodata compression.
155 --compress-type COMPRESSION_TYPE
157 Which compression type to use. Supported compressions are: bzip2, gzip,
158 zck, zstd, xz.
159 --general-compress-type COMPRESSION_TYPE
161 Which compression type to use (even for primary, filelists and other
162 xml).
163 --zck
165 Generate zchunk files as well as the standard repodata.
166 --zck-dict-dir ZCK_DICT_DIR
168 Directory containing compression dictionaries for use by zchunk
169 --keep-all-metadata
171 Keep all additional metadata (not primary, filelists and other xml or
172 sqlite files, nor their compressed variants) from source repository
173 during update (default).
174 --discard-additional-metadata
176 Discard all additional metadata (not primary, filelists and other xml
177 or sqlite files, nor their compressed variants) from source repository
178 during update.
179 --compatibility
181 Enforce maximal compatibility with classical createrepo (Affects only:
182 --retain-old-md).
183 --retain-old-md-by-age AGE
185 During --update, remove all files in repodata/ which are older then the
186 specified period of time. (e.g. '2h', '30d', ...). Available units (m -
187 minutes, h - hours, d - days)
188 -c --cachedir CACHEDIR.
190 Set path to cache dir
191 --deltas
193 Tells createrepo to generate deltarpms and the delta metadata.
194 --oldpackagedirs PATH
196 Paths to look for older pkgs to delta against. Can be specified multi‐
197 ple times.
198 --num-deltas INT
200 The number of older versions to make deltas against. Defaults to 1.
201 --max-delta-rpm-size MAX_DELTA_RPM_SIZE
203 Max size of an rpm that to run deltarpm against (in bytes).
204 --local-sqlite
206 Gen sqlite DBs locally (into a directory for temporary files). Some‐
207 times, sqlite has a trouble to gen DBs on a NFS mount, use this option
208 in such cases. This option could lead to a higher memory consumption if
209 TMPDIR is set to /tmp or not set at all, because then the /tmp is used
210 and /tmp dir is often a ramdisk.
211 --cut-dirs NUM
213 Ignore NUM of directory components in location_href during repodata
214 generation
215 --location-prefix PREFIX
217 Append this prefix before location_href in output repodata
218 --repomd-checksum CHECKSUM_TYPE
220 Checksum type to be used in repomd.xml
221 --error-exit-val
223 Exit with retval 2 if there were any errors during processing (option
224 deprecated, on by default)
225 --ignore-lock
227 Expert (risky) option: Ignore an existing .repodata/. (Remove the ex‐
228 isting .repodata/ and create an empty new one to serve as a lock for
229 other createrepo instances. For the repodata generation, a different
230 temporary dir with the name in format .repodata.time.microseconds.pid/
231 will be used). NOTE: Use this option on your own risk! If two createre‐
232 pos run simultaneously, then the state of the generated metadata is not
233 guaranteed - it can be inconsistent and wrong.
234 2021-09-23 CREATEREPO_C(8)