2013-12-10 12:17:08 +08:00
|
|
|
.. Spack documentation master file, created by
|
|
|
|
|
sphinx-quickstart on Mon Dec 9 15:32:41 2013.
|
|
|
|
|
You can adapt this file completely to your liking, but it should at least
|
|
|
|
|
contain the root `toctree` directive.
|
|
|
|
|
|
2016-08-24 06:03:29 +08:00
|
|
|
===================
|
2017-04-02 06:31:55 +08:00
|
|
|
Spack
|
2016-08-24 06:03:29 +08:00
|
|
|
===================
|
2013-12-10 12:17:08 +08:00
|
|
|
|
2017-04-02 06:31:55 +08:00
|
|
|
.. epigraph::
|
|
|
|
|
|
|
|
|
|
`These are docs for the Spack package manager. For sphere packing, see` `pyspack <https://pyspack.readthedocs.io>`_.
|
|
|
|
|
|
2013-12-19 03:02:31 +08:00
|
|
|
Spack is a package management tool designed to support multiple
|
|
|
|
|
versions and configurations of software on a wide variety of platforms
|
|
|
|
|
and environments. It was designed for large supercomputing centers,
|
|
|
|
|
where many users and application teams share common installations of
|
|
|
|
|
software on clusters with exotic architectures, using libraries that
|
|
|
|
|
do not have a standard ABI. Spack is non-destructive: installing a
|
|
|
|
|
new version does not break existing installations, so many
|
|
|
|
|
configurations can coexist on the same system.
|
|
|
|
|
|
|
|
|
|
Most importantly, Spack is *simple*. It offers a simple *spec* syntax
|
|
|
|
|
so that users can specify versions and configuration options
|
|
|
|
|
concisely. Spack is also simple for package authors: package files
|
2016-03-12 02:51:45 +08:00
|
|
|
are written in pure Python, and specs allow package authors to
|
2015-04-15 06:11:01 +08:00
|
|
|
maintain a single file for many different builds of the same package.
|
2013-12-19 03:02:31 +08:00
|
|
|
|
|
|
|
|
See the :doc:`features` for examples and highlights.
|
2013-12-12 20:25:31 +08:00
|
|
|
|
2014-01-08 18:02:12 +08:00
|
|
|
Get spack from the `github repository
|
2015-12-09 17:24:15 +08:00
|
|
|
<https://github.com/llnl/spack>`_ and install your first
|
2014-01-08 18:02:12 +08:00
|
|
|
package:
|
2013-12-12 20:25:31 +08:00
|
|
|
|
2016-08-27 05:41:00 +08:00
|
|
|
.. code-block:: console
|
2013-12-12 20:25:31 +08:00
|
|
|
|
2015-12-09 17:24:15 +08:00
|
|
|
$ git clone https://github.com/llnl/spack.git
|
2013-12-12 20:25:31 +08:00
|
|
|
$ cd spack/bin
|
2014-01-08 18:02:12 +08:00
|
|
|
$ ./spack install libelf
|
2013-12-12 20:25:31 +08:00
|
|
|
|
|
|
|
|
If you're new to spack and want to start using it, see :doc:`getting_started`,
|
|
|
|
|
or refer to the full manual below.
|
|
|
|
|
|
2013-12-10 12:17:08 +08:00
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 2
|
2016-11-12 23:45:50 +08:00
|
|
|
:caption: Basics
|
2013-12-10 12:17:08 +08:00
|
|
|
|
2013-12-12 20:25:31 +08:00
|
|
|
features
|
|
|
|
|
getting_started
|
|
|
|
|
basic_usage
|
2016-10-06 04:00:27 +08:00
|
|
|
workflows
|
2016-12-12 16:54:20 +08:00
|
|
|
tutorial_sc16
|
2016-10-06 04:00:27 +08:00
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 2
|
2016-12-12 16:54:20 +08:00
|
|
|
:caption: Reference
|
2016-10-06 04:00:27 +08:00
|
|
|
|
2016-05-22 05:33:05 +08:00
|
|
|
configuration
|
2016-10-29 07:17:58 +08:00
|
|
|
config_yaml
|
|
|
|
|
build_settings
|
2016-10-06 04:00:27 +08:00
|
|
|
mirrors
|
2016-10-31 03:41:41 +08:00
|
|
|
module_file_support
|
2016-12-12 16:54:20 +08:00
|
|
|
repositories
|
2016-10-06 04:00:27 +08:00
|
|
|
command_index
|
2016-12-12 16:54:20 +08:00
|
|
|
package_list
|
2016-10-06 04:00:27 +08:00
|
|
|
|
2016-11-12 23:45:50 +08:00
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 2
|
2016-12-12 16:54:20 +08:00
|
|
|
:caption: Contributing
|
2016-10-06 04:00:27 +08:00
|
|
|
|
2016-10-06 22:45:47 +08:00
|
|
|
contribution_guide
|
2016-10-06 04:00:27 +08:00
|
|
|
packaging_guide
|
|
|
|
|
developer_guide
|
2013-12-12 20:25:31 +08:00
|
|
|
API Docs <spack>
|
2013-12-10 12:17:08 +08:00
|
|
|
|
2016-08-24 06:03:29 +08:00
|
|
|
==================
|
2013-12-10 12:17:08 +08:00
|
|
|
Indices and tables
|
|
|
|
|
==================
|
|
|
|
|
|
|
|
|
|
* :ref:`genindex`
|
|
|
|
|
* :ref:`modindex`
|
|
|
|
|
* :ref:`search`
|
