scl(1)							      General Commands Manual							    scl(1)

NAME

       scl - Setup and run software from Software Collection environment

SYNOPSIS

       scl <action> <collection1> [<collection2> ...] <command>

       scl <action> <collection1> [<collection2> ...] -- <command>

       scl {-l|--list} [<collection1> <collection2> ...]

DESCRIPTION

       This manual page documents scl, a program which is an utility for running software packaged as a Software Collection.

       scl  utility  allows to execute an application which is not located in the filesystem root hierarchy but is present in an alternative loca-
       tion. This application can still use and benefit from software installed in the root filesystem. In order to let an application be  visible
       to the system one has to use scl utility as an interface.

       <action> is a script name to execute in a bash environment before the application itself takes in executed. Currently only enable scriptlet
       is mandatory which is needed to update search paths, etc.

       One can enable more Software Collections if needed and therefore one can use multiple collections which are enabled by the left-right order
       as present on scl command-line.

       <command>  is  an  arbitrary  command or set of commands to execute within the Software Collection environment enabled. Control is returned
       back to the caller with the original environment as soon as the command finishes. If <command> is '-' (dash) then it is read from the stan-
       dard input.

       Note:  if  you  use  <command> consisting of multiple arguments, you either need to use quotes or the -- command separator. Everything that
       follows the separator will be considered a command or its argument.

       Note: some commands modify user environment in some way. Those commands may potentially	break  SCLs,  as  their  activation  also  usually
       depends on env.	modification as well. Typical examples of such commands are su and sudo. Every collection modifies the environment differ-
       ently, thus more details may be found in the documentation of the particular collection.

OPTIONS

       -l, --list
	      Lists all installed Software Collections on the system.

       -l, --list <collection1> <collection2> ...
	      If a collection name is specified then list of installed packages belonging to the collection is listed.

EXAMPLES

       scl enable example 'less --version'
	      runs command 'less --version' in the environment with collection 'example' enabled

       scl enable foo bar bash
	      runs bash instance with foo and bar Software Collections enabled

       cat my_command | scl enable baz -
	      run set of commands listed in my_command file in the environment with baz Software Collection enabled

       scl -l list all installed collections

       scl -l example
	      list all packages within example collection

AUTHOR

       scl was written by Jindrich Novy <jnovy@redhat.com> and Jan Zeleny <jzeleny@redhat.com>

																	    scl(1)