.TH "createrepo" "8" "2005 Jan 2" "Seth Vidal" ""

.SH "NAME"
createrepo \- Create repomd (xml-rpm-metadata) repository

.SH "SYNOPSIS"
\fBcreaterepo\fP [options] <directory>
.PP

.SH "DESCRIPTION"
\fBcreaterepo\fP is a program that creates a repomd (xml-based rpm metadata) repository from a set of rpms.

.SH "OPTIONS"
.IP "\fB\-u --baseurl\fP <url>"
Optional base url location for all files. (not used by any clients at this
time)
.IP "\fB\-o --outputdir\fP <url>"
Optional output directory (useful for read only media).
.IP "\fB\-x --exclude\fP <package>"
File globs to exclude, can be specified multiple times.
.IP "\fB\-i --pkglist\fP <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.
.IP "\fB\-q --quiet\fP"
Run quietly.
.IP "\fB\-g --groupfile\fP <groupfile>"
A precreated xml filename to point to for group information.
.br
See examples section below for further explanation.
.IP "\fB\-v --verbose\fP"
Run verbosely.
.IP "\fB\-c --cachedir\fP <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.
.br
.IP "\fB\--update\fP"
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.
.br
.IP "\fB\-C --checkts\fP"
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.
.br
.IP "\fB\--split\fP"
Run in split media mode. Rather than pass a single directory, take a set of
directories corresponding to different volumes in a media set.
.br
.IP "\fB\-p --pretty\fP"
Output xml files in pretty format.
.IP "\fB\-V --version\fP"
Output version.
.IP "\fB\-h --help\fP"
Show help menu.

.IP "\fB\-d --database\fP"
Generate sqlite databases for use with yum.

.SH "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).
.br
.PP
\fBcreaterepo\fP \-g comps.xml /path/to/rpms

.SH "FILES"
.nf
repodata/filelists.xml.gz
repodata/other.xml.gz
repodata/primary.xml.gz
repodata/repomd.xml 
.fi
.PP 
.SH "SEE ALSO"
.I yum (8) yum.conf (5)

.PP 
.SH "AUTHORS"
.nf 
Seth Vidal <skvidal@phy.duke.edu>
.fi 

.PP 
.SH "BUGS"
Any bugs which are found should be emailed to the mailing list:
rpm-metadata@linux.duke.edu
.fi