createrepo(8)															     createrepo(8)

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.

       -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,dis-
	      trotag

       --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://cre-
       aterepo.baseurl.org

Seth Vidal							    2005 Jan 2							     createrepo(8)