CATALYST(1)
===========
:man source:   catalyst {catalystversion}
:man manual:   catalyst {catalystversion}


NAME
----
catalyst - The Gentoo Linux Release Engineering meta-tool


SYNOPSIS
--------
*catalyst* ['OPTIONS'] [*-f* 'FILE' | *-C* 'KEY'='VALUE' ... | *-s* 'DATE']


DESCRIPTION
-----------
*catalyst* is the tool that the Gentoo Release Engineering team
utilizes to build all Gentoo Linux releases. It is capable of building
installation stages, bootable LiveCDs, and netboot images.

For more information, please visit the *catalyst* project page
on the web at 'https://wiki.gentoo.org/wiki/Catalyst'.


OPTIONS
-------
*--clear-autoresume*::
*-a*::
This option is to be used to clear any autoresume points that have been saved
for this target. It is used in conjunction with *-f*, *-C*, or both.

*--config*|*-c* 'FILE'::
Tell *catalyst* to use a user-defined configuration file. A sample
configuration file is installed at '/etc/catalyst/catalyst.conf'.

*--debug*::
*-d*::
Enable debugging mode

*--enter-chroot*::
Enter the chroot before starting the build.

*--fetchonly*::
*-F*::
This tells *catalyst* to only fetch distfiles for the given packages without
performing any building.

*--file*|*-f* 'FILE'::
Tell *catalyst* to use the user supplied specfile.

*--help*::
*-h*::
Print the help message and exit

*--purge*::
*-p*::
Tell *catalyst* to clear all temporary directories, package caches, and
autoresume flags for the given target.

*--snapshot*|*-s* 'DATE'::
Create a Portage snapshot using the specified identifier stamp.

*--verbose*::
*-v*::
Enable verbose mode.

*--version*::
*-V*::
Print the version information and exit


EXAMPLES
--------
Using the specfile option (*-f*, *--file*) to build a stage target:
---------------------------------------------------
# catalyst -f stage1-specfile.spec
---------------------------------------------------

Using the snapshot option (*-s*, *--snapshot*) to package a Portage snapshot
using the datestamp 20051208:
---------------------------------------------------
# catalyst -s 20051208
---------------------------------------------------


FILES
-----
Example specfiles can be found in '/usr/share/doc/catalyst-{catalystversion}/examples'.
An example configuration file can be found at '/etc/catalyst/catalyst.conf'.


SUPPORTED ARCHITECTURES
-----------------------
The following table shows the list of supported architectures as well as
the list of valid strings for key 'subarch'.

include::subarches.generated.txt[tabsize=4]


BUGS
----
An up-to-date list of Catalyst bugs can always be found listed on the Gentoo
Linux bug-tracking system at 'https://bugs.gentoo.org'.


NOTES
-----
*catalyst* is conceptually derived from the Gentoo livecd-ng and Gentoo
stager projects, both of which were used to create pre-1.4 Gentoo releases.

*catalyst* was originally conceived and coded by both Daniel Robbins and
John Davis. It is currently maintained by the Catalyst Project Team and
has been mostly re-written.


AUTHORS
-------
- John Davis <zhen@gentoo.org>
- Chris Gianelloni <wolf31o2@gentoo.org>
- Raul Porcel <armin76@gentoo.org>
- Sebastian Pipping <sping@gentoo.org>
- Matt Turner <mattst88@gentoo.org>


SEE ALSO
--------
*catalyst-config(5)*
*catalyst-spec(5)*

Also, a more in-depth examination of Catalyst options and procedures can be found
linked from the *catalyst* project page, which is located at
'https://wiki.gentoo.org/wiki/Catalyst'.
