NAME¶
createrepo - Create repomd (xml-rpm-metadata) repository
SYNOPSIS¶
createrepo [options] <directory>
DESCRIPTION¶
createrepo is a program that creates a repomd (xml-based rpm metadata)
repository from a set of rpms.
OPTIONS¶
- -u --baseurl <url>
- Optional base URL location for all files.
- -o --outputdir <url>
- Optional output directory (useful for read only
media).
- -x --excludes <package>
- File globs to exclude, can be specified multiple
times.
- -i --pkglist <filename>
- specify a text file which contains the complete list of
files to include in the repository from the set found in the directory.
File format is one package per line, no wildcards or globs.
- -n --includepkg
- specify pkgs to include on the command line. Takes urls as
well as local paths.
- -q --quiet
- Run quietly.
- -g --groupfile <groupfile>
- A precreated xml filename to point to for group
information.
See examples section below for further explanation.
- -v --verbose
- Run verbosely.
- -c --cachedir <path>
- Specify a directory to use as a cachedir. This allows
createrepo to create a cache of checksums of packages in the repository.
In consecutive runs of createrepo over the same repository of files that
do not have a complete change out of all packages this decreases the
processing time dramatically.
- --update
- If metadata already exists in the outputdir and an rpm is
unchanged (based on file size and mtime) since the metadata was generated,
reuse the existing metadata rather than recalculating it. In the case of a
large repository with only a few new or modified rpms this can
significantly reduce I/O and processing time.
- --skip-stat
- skip the stat() call on a --update, assumes if the filename
is the same then the file is still the same (only use this if you're
fairly trusting or gullible).
- -C --checkts
- Don't generate repo metadata, if their timestamps are newer
than its rpms. This option decreases the processing time drastically
again, if you happen to run it on an unmodified repo, but it is
(currently) mutual exclusive with the --split option.
- --split
- Run in split media mode. Rather than pass a single
directory, take a set of directories corresponding to different volumes in
a media set.
- -p --pretty
- Output xml files in pretty format.
- -V --version
- Output version.
- -h --help
- Show help menu.
- -d --database
- Generate sqlite databases for use with yum. This is now the
default.
- --no-database
- Do not generate sqlite databases in the repository.
- -S --skip-symlinks
- Ignore symlinks of packages
- -s --checksum
- Choose the checksum type used in repomd.xml and for
packages in the metadata. The default is now "sha256" (if python
has hashlib). The older default was "sha", which is actually
"sha1", however explicitly using "sha1" doesn't work
on older (3.0.x) versions of yum, you need to specify
"sha".
- --profile
- Output time based profiling information.
- --changelog-limit CHANGELOG_LIMIT
- Only import the last N changelog entries, from each rpm,
into the metadata
- --unique-md-filenames
- Include the file's checksum in the metadata filename, helps
HTTP caching (default)
- --simple-md-filenames
- Do not include the file's checksum in the metadata
filename.
- --distro
- Specify distro tags. Can be specified more than once.
Optional syntax specifying a cpeid(http://cpe.mitre.org/)
--distro=cpeid,distrotag
- --content
- Specify keyword/tags about the content of the repository.
Can be specified more than once.
- --repo
- Specify keyword/tags about the repository itself. Can be
specified more than once.
- --revision
- Arbitrary string for a repository revision.
- --deltas
- Tells createrepo to generate deltarpms and the delta
metadata
- --oldpackagedirs PATH
- paths to look for older pkgs to delta against. Can be
specified multiple times
- --num-deltas int
- the number of older versions to make deltas against.
Defaults to 1
EXAMPLES¶
Here is an example of a repository with a groups file. Note that the groups file
should be in the same directory as the rpm packages (i.e.
/path/to/rpms/comps.xml).
createrepo -g comps.xml /path/to/rpms
FILES¶
repodata/filelists.xml.gz
repodata/other.xml.gz
repodata/primary.xml.gz
repodata/repomd.xml
SEE ALSO¶
yum (8) yum.conf (5)
AUTHORS¶
See the Authors file
BUGS¶
Any bugs which are found should be emailed to the mailing list:
rpm-metadata@lists.baseurl.org or reported in trac at:
http://createrepo.baseurl.org