xt-customize-image(8) [debian man page]

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

NAME

       xt-customize-image - Customize a freshly installed copy of GNU/Linux

SYNOPSIS

	 xt-customize-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 of the new installation
	  --dist     The name of the distribution which has been installed.

	 All other options from xen-create-image, such as the new IP address(es)
	to give to the new instance, will be passed as environmental variables.

NOTES

	 This script is invoked by xen-create-image after it has created a
	fresh installation of Linux withing a temporary location.

	 This script will be invoked with a full copy of the arguments from
	xen-create-image in its environment, along with several command line
	arguments.

	 The command line arguments which are mandatory are:

	  --location  - The temporary installation root of the new install
	  --dist      - The distribution which has been installed.

HOOK SCRIPTS

	 The distribution name is used to locate an appropriate collection
	of scripts, or hooks, to execute to do the actual customisation.

	 The hooks will each be executed with a single parameter which is
	the directory path to the new instance.  This argument is taken from
	the --location option.

	 For the distribution named 'foo' the scripts will be loaded and
	executed from '/usr/lib/xen-tools/foo.d'.  Each executable will
	be loaded and executed in sorted order.

AUTHORS

	Steve Kemp, http://www.steve.org.uk/
	Axel Beckert, http://noone.org/abe/
	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-CUSTOMIZE-IMAGE(8)

DEBIAN-BUILDER(1)					User Contributed Perl Documentation					 DEBIAN-BUILDER(1)

NAME

       debian-builder - Rebuild a Debian package from its source code.

SYNOPSIS

	 debian-builder [options]

	 Help Options:
	  --debug    Show useful debugging information.
	  --help     Show this scripts help information.
	  --manual   Read this scripts manual.
	  --version  Show the version number and exit.
	  --verbose  Show verbose output.

	 Building options:

	  --sign	 Force package signing, disabled by default.
	  --debuild foo  Pass arguments 'foo' onto debuild when building
	  --suffix  foo  Give the built package versions the suffix 'foo'.

OPTIONS

       --debug Show the commands this script executes as an aid to debugging.
       --help Show the brief help information.
       --verbose Show verbose information useful to debugging.

DESCRIPTION

	 debian-builder is a simple script which is designed to facilitate the
	rebuilding of a Debian GNU/Linux package from its source code.	It will
	correctly handle the installation of any required build-dependencies,
	and remove them once building is complete.

AUTHOR

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

	$Id: debian-builder,v 1.14 2006/06/04 18:24:04 steve Exp $

LICENSE

       Copyright (c) 2005 by Steve Kemp.  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.

       buildPackage

	  Do all the work of building the given package.

	  Return '>0' on success, '0' on failure of any kind.  (The result is the
	number of binary files moved into the results directory.)

       parseCommandLineArguments

	 Parse any command line arguments, and set the appropriate values
	in the global CONFIG hash.

       getSourcePackageName

	 Return the name of the source package required to build package 'foo'

       getPackageSource

	 Download the source of the package to the specified directory
	and return the name of the unpacked directory.

       updateChangeLog

	 If the Debian changelog file doesn't already refer to the specified
	version then add it.

       saveDebianPackage

	 Move the build Debian package, associated .diff.gz file, .changes file,
	etc.  From the build directory into the binary directory.

	 Return the number of files moved into the binary directory.

       tidySystem

	 Uninstall all the build dependency packages we installed.

	 We do this by finding the list of all packages which are currently
	installed and removing those that were not present when we started.

       getInstalledPackages

	 Return a hash of all the currently installed packages.

       installBuildDependencies

	 Install the build-dependencies required to build the given package.

       removePackages

	 Remove the given array of packages from the system.

       END

	 Desperately try to reset the host system to the same starting point
	as it initially had.

	 This should be taken care of in situations where the script doesn't
	abort on an error condition.

perl v5.8.8							    2008-03-13							 DEBIAN-BUILDER(1)