spack/lib/spack/docs
Harmen Stoppels 1db6cd5d16
Make -j flag less exceptional (#22360)
* Make -j flag less exceptional

The -j flag in spack behaves differently from make, ctest, ninja, etc,
because it caps the number of jobs to an arbitrary number 16.
Spack will behave like other tools if `spack install` uses a reasonable
default, and `spack install -j <num>` *overrides* that default.

This will be particularly useful for Spack usage outside of a traditional
HPC context and for HPC centers that encourage users to compile on
login nodes with many cores instead of on compute nodes, which has
become increasingly common as individual nodes have more cores.

This maintains the existing default value of min(num_cpus, 16). However, 
as it is right now, Spack does a poor job at determining the number of 
cpus on linux, since it doesn't take cgroups into account. This is
particularly problematic when using distributed builds with slurm. This PR
also introduces `spack.util.cpus.cpus_available()` to consolidate
knowledge on determining the number of available cores, and improves
core detection for linux. This should also improve core detection for Docker/
Kubernetes, which also use cgroups.
2021-03-30 12:03:50 -07:00
..
_gh_pages_redirect Use https for links (#19244) 2020-10-09 11:24:09 -05:00
_static
build_systems Oneapi packages: update URLs, environment management, and dependencies (#22202) 2021-03-22 17:35:45 -07:00
example_files Implement an optional compiler bootstrapping phase 2019-09-13 22:57:15 -07:00
images docs: document releases and branches in Spack 2020-07-06 11:39:19 -07:00
.gitignore tutorial: move tutorial to standalone site (#13450) 2019-10-25 21:49:27 -07:00
_spack_root docs: make docs build relocatable for localized builds 2019-05-26 18:23:44 -07:00
basic_usage.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
binary_caches.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
build_settings.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
build_systems.rst Oneapi packages: update URLs, environment management, and dependencies (#22202) 2021-03-22 17:35:45 -07:00
chain.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
command_index.in
conf.py Update the docs footer copyright (#20741) 2021-01-11 08:00:08 +01:00
config_yaml.rst Make -j flag less exceptional (#22360) 2021-03-30 12:03:50 -07:00
configuration.rst Document cli syntax for environment scopes (#20344) 2021-03-21 10:14:13 +00:00
containers.rst containerize: fix typo in documentation (#22331) 2021-03-16 21:02:26 +00:00
contribution_guide.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
developer_guide.rst spack python: allow use of IPython (#20329) 2021-01-05 16:54:47 -08:00
dockerhub_spack.png spack containerize generates containers from envs (#14202) 2020-01-30 17:19:55 -08:00
environments.rst Document cli syntax for environment scopes (#20344) 2021-03-21 10:14:13 +00:00
extensions.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
features.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
getting_started.rst Bootstrap clingo from sources (#21446) 2021-03-03 09:37:46 -08:00
index.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
known_issues.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
Makefile docs: match ReadTheDocs; use -W (warnings as errors) with Sphinx 2019-05-26 18:23:44 -07:00
mirrors.rst Add doc for mirror of env (#22525) 2021-03-24 20:55:15 +00:00
module_file_generation.svg
module_file_support.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
package_list.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
packaging_guide.rst Correct the reference to the staged examples files (#21557) 2021-02-13 08:14:38 -08:00
pipelines.rst Pipelines: DAG Pruning (#20435) 2021-02-16 09:12:37 -07:00
repositories.rst Package Repositories docs: num packages has grown (#20735) 2021-01-11 11:00:14 +01:00
requirements.txt Docs: unlock requirement versions (#13384) 2019-10-31 14:21:05 -05:00
spack.yaml copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
workflows.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00