diff options
author | Tamara Dahlgren <35777542+tldahlgren@users.noreply.github.com> | 2019-09-03 16:31:27 -0700 |
---|---|---|
committer | Peter Scheibel <scheibel1@llnl.gov> | 2019-09-03 16:31:27 -0700 |
commit | c141e99e062ba7fa5a140ebf4ca5d1abbe40987f (patch) | |
tree | 0530fdfe60197de5174b2b028f284b5ddb332bcf /lib/spack/docs/tutorial_configuration.rst | |
parent | 868f7869e0643d975aac7f8d4b82bd77a29ba036 (diff) | |
download | spack-c141e99e062ba7fa5a140ebf4ca5d1abbe40987f.tar.gz spack-c141e99e062ba7fa5a140ebf4ca5d1abbe40987f.tar.bz2 spack-c141e99e062ba7fa5a140ebf4ca5d1abbe40987f.tar.xz spack-c141e99e062ba7fa5a140ebf4ca5d1abbe40987f.zip |
Use spack/user-specific stage root by default; stage cleaning (#12516)
* When cleaning the stage root, only remove directories that appear
to be used for staging Spack packages. Previously Spack was clearing
all directories in the stage root, which could remove content not
related to Spack if the user chose a staging root which contains
files/directories not managed by Spack.
* The documentation is updated with warnings about choosing a stage
directory that is only managed by Spack (although generally the
check added in this PR for "spack clean" should avoid removing
content that was not created by Spack)
* The default stage directory (in config.yaml) is now
$tempdir/$user/spack-stage and the logic is updated to omit the
$user portion of this path if $tempdir already contains a $user
directory.
* When creating stage root assign user read/write permissions to all
directories in the path under $user. Previously Spack was assigning
the permissions of the first existing parent directory
Diffstat (limited to 'lib/spack/docs/tutorial_configuration.rst')
-rw-r--r-- | lib/spack/docs/tutorial_configuration.rst | 12 |
1 files changed, 11 insertions, 1 deletions
diff --git a/lib/spack/docs/tutorial_configuration.rst b/lib/spack/docs/tutorial_configuration.rst index 6b97687cb9..565a6c02b5 100644 --- a/lib/spack/docs/tutorial_configuration.rst +++ b/lib/spack/docs/tutorial_configuration.rst @@ -849,7 +849,17 @@ from this file system with the following ``config.yaml``: config: build_stage: - - /scratch/$user + - /scratch/$user/spack-stage + + +.. note:: + + It is important to distinguish the build stage directory from other + directories in your scratch space to ensure ``spack clean`` does not + inadvertently remove unrelated files. This can be accomplished by + including a combination of ``spack`` and or ``stage`` in each path + as shown in the default settings and documented examples. See + :ref:`config-yaml` for details. On systems with compilers that absolutely *require* environment variables |