Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

rinse(8) [debian man page]

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)

Check Out this Related Man Page

XT-INSTALL-IMAGE(8)					 Perl Programmers Reference Guide				       XT-INSTALL-IMAGE(8)

NAME

       xt-install-image - Install a fresh copy of GNU/Linux into a directory

SYNOPSIS

	 xt-install-image [options]

	 Help Options:
	  --help	   Show this scripts help information.
	  --manual	   Read this scripts manual.
	  --version	   Show the version number and exit.

	 Debugging Options:
	  --verbose	   Be verbose in our execution.

	 Mandatory Options:
	  --location	   The location to use for the new installation
	  --dist	   The name of the distribution which has been installed.

	 Misc Options:
	  --arch	   Pass the given arch setting to debootstrap or rpmstrap.
	  --config	   Read the specified config file in addition to the global
			   configuration file.
	  --mirror	   The mirror to use when installing with 'debootstrap'.
	  --apt_proxy	   The proxy to use when installing with 'debootstrap'.

	 Installation Options:
	  --install-method  Specify the installation method to use.
	  --install-source  Specify the installation source to use.
	  --debootstrap-cmd Specify which debootstrap command to
			    use. Defaults to debootstrap if both, debootstrap
			    and cdebootstrap are installed.

	 All other options from xen-create-image will be passed as environmental
	variables.

NOTES

	 This script is invoked by xen-create-image after to create a new
	distribution of Linux.	Once the script has been created the companion
	script xt-customize-image will be invoked to perform the network
	configuration, etc.

INSTALLATION METHODS

	 There are several available methods of installation, depending upon the
	users choice.  Only one option may be chosen at any given time.

	 The methods available are:

       debootstrap Install the distribution specified by the --dist argument using the debootstrap.  If you use this option you must specify a
       mirror with --mirror.
       copy Copy the given directory recursively.  This local directory is assumed to contain a complete installation.	Specify the directory to
       copy with the --install-source argument.
       rinse Install the distribution specified by --dist using the rinse command.
       rpmstrap Install the distribution specified by --dist using the rpmstrap command.
       tar Untar a .tar file into the new installation location.  This tarfile is assumed to contain a complete archived system.   Specify the
       directory to copy with the --install-source argument.

AUTHORS

	Steve Kemp, http://www.steve.org.uk/
	Axel Beckert, http://noone.org/abe/
	Dmitry Nedospasov, http://nedos.net/
	StA~Xphane Jourdois

LICENSE

       Copyright (c) 2005-2009 by Steve Kemp, (c) 2010 by The Xen-Tools Development Team. All rights reserved.

       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.

4.3.1								    2012-06-30						       XT-INSTALL-IMAGE(8)
Man Page