RINSE(8)						 Perl Programmers Reference Guide						  RINSE(8)

NAME

       rinse - RPM Installation Entity.

SYNOPSIS

	 rinse [options]

	 Help Options:
	  --help     Show help information.
	  --manual   Read the manual for this script.
	  --version  Show the version information and exit.

	 Mandatory Options:

	  --arch	 Specify the architecture to install.
	  --directory	 The directory to install the distribution within.
	  --distribution The distribution to install.

	 Customization Options:

	  --add-pkg-list	Additional packages to download and install

	  --after-post-install	Additionally run the specified script after
				the post install script.
	  --before-post-install Additionally run the specified script before
				the post install script.
	  --post-install	Run the given post-install script instead of the
				default files in /usr/lib/rinse/$distro

	 Misc Options:

	  --cache		Should we use a local cache?  (Default is 1)
	  --cache-dir		Specify the directory we should use for the cache.
	  --clean-cache 	Clean our cache of .rpm files.
	  --config		Specify a different configuration file.
				(Default is /etc/rinse/rinse.conf)
	  --pkgs-dir		Specify a different directory containing
				<distribution>.packages files.
	  --mirror		Specify the URL of the mirror.
				(Default is to read it from /etc/rinse/rinse.conf)
	  --list-distributions	Show installable distributions.
	  --print-uris		Only show the RPMs which should be downloaded.
				default files in /usr/lib/rinse/$distro
	  --verbose		Enable verbose output.

OPTIONS

       --arch Specify the architecture to install.  Valid choices are 'amd64' and 'i386' only.
       --add-pkg-list Add a list of additional packages.
       --cache Specify whether to cache packages (1) or not (0).
       --cache-dir Specify the directory we should use for the cache.
       --clean-cache Remove all cached .rpm files.
       --directory Specify the directory into which the distribution should be installed.
       --distribution Specify the distribution to be installed.
       --help Show help information.
       --mirror Specify the URL of the mirror. Normally this is read from /etc/rinse/rinse.conf.
       --list-distributions Show the distributions which are installable.
       --manual Read the manual for this script.
       --print-uris Only show the files we would download, don't actually do so.
       --verbose Enable verbose output.
       --version Show the version number and exit.

DESCRIPTION

	 rinse is a simple script which is designed to be able to install
	a minimal working installation of an RPM-based distribution into
	a directory.

	 The tool is analogous to the standard Debian GNU/Linux debootstrap
	utility.

USAGE

	 To use this script you will need to be root.  This is required
	to mount /proc, run chroot, and more.

	 Basic usage is as simple as:

	  rinse --distribution fedora-core-6 --directory /tmp/test

	 This will download the required RPM files and unpack them into
	a minimal installation of Fedora Core 6.

	 To see which RPM files would be downloaded, without actually
	performing an installation or downloading anything, then you
	may run the following:

	  rinse --distribution fedora-core-6 --print-uris

TODO

	 Short of supporting more distributions or architectures there aren't
	really any outstanding issues.

AUTHOR

	Steve
	--
	http://www.steve.org.uk/

LICENSE

       Copyright (c) 2007-2010 by Steve Kemp.  All rights reserved.

       Copyright (c) 2011-2013 by Thomas Lange.

       This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.  The LICENSE file contains the
       full text of the license.

2.0.1								    2013-01-28								  RINSE(8)