e0ac1b4
.TH "scl" "1"
e0ac1b4
.SH "NAME"
e0ac1b4
scl \- Setup and run software from Software Collection environment
e0ac1b4
.SH "SYNOPSIS"
e0ac1b4
.PP
e0ac1b4
\fBscl\fP \fI<action>\fR [\fI<collection1> <collection2> ...\fR] \fI<command>\fR
e0ac1b4
.PP
e0ac1b4
\fBscl\fP {\fB-l|--list\fP}
e0ac1b4
.SH "DESCRIPTION"
e0ac1b4
.PP
e0ac1b4
This manual page documents \fBscl\fP, a
e0ac1b4
program which is an utility for running software packaged as a Software Collection.
e0ac1b4
.PP
e0ac1b4
\fBscl\fP utility allows to execute an application which is not located in the filesystem
e0ac1b4
root hierarchy but is present in an alternative location. This application can still use
e0ac1b4
and benefit from software installed in the root filesystem. In order to let an application
e0ac1b4
be visible to the system one has to use \fBscl\fP utility as an interface.
e0ac1b4
.PP
e0ac1b4
\fI<action>\fR is a script name to execute in a bash environment before the application
e0ac1b4
itself takes in executed. Currently only \fBenable\fP scriptlet is mandatory which is needed
e0ac1b4
to update search paths, etc.
e0ac1b4
.PP
e0ac1b4
One can enable more Software Collections if needed and therefore one can use multiple
e0ac1b4
collections which are enabled by the left-right order as present on \fBscl\fP command-line.
e0ac1b4
.PP
e0ac1b4
\fI<command>\fR is an arbitrary command or set of commands to execute within the Software
e0ac1b4
Collection environment enabled. Control is returned back to the caller with the original
e0ac1b4
environment as soon as the command finishes. It \fI<command>\fR is '-' (dash) then it is
e0ac1b4
read from the standard input.
e0ac1b4
.SH "OPTIONS"
e0ac1b4
.PP
e0ac1b4
.IP "\fB-l, --list\fP" 10
e0ac1b4
Lists all installed Software Collections on the system
e0ac1b4
.SH "EXAMPLES"
e0ac1b4
.TP
e0ac1b4
scl enable example 'less --version'
e0ac1b4
runs command 'less --version' in the environment with collection 'example' enabled
e0ac1b4
.TP
e0ac1b4
scl enable foo bar bash
e0ac1b4
runs bash instance with foo and bar Software Collections enabled
e0ac1b4
.TP
e0ac1b4
cat my_command | scl enable baz -
e0ac1b4
run set of commands listed in my_command file in the environment with baz Software Collection
e0ac1b4
enabled
e0ac1b4
.SH "AUTHOR"
e0ac1b4
.PP
e0ac1b4
\fBscl\fP was written by Jindrich Novy <jnovy@redhat.com>.