Command Reference

This is a reference for all commands in the Spack command line interface. The same information is available through spack help.

Commands that also have sections in the main documentation have a link to “More documentation”.

Category

Commands

Administration

Query packages

Build packages

Configuration

Developer

Environments

Extensions

More help

Modules

Create packages

System


spack

A flexible package manager that supports multiple versions, configurations, platforms, and compilers.

spack [-hHdklLmpvV] [--color {always,never,auto}] [-C DIR] [--timestamp] [--pdb] [-e ENV | -D DIR | -E]
  [--use-env-repo] [--sorted-profile STAT] [--lines LINES] [--stacktrace] [--print-shell-vars PRINT_SHELL_VARS]
  COMMAND ...

Optional arguments

-h, --help

show this help message and exit

-H, --all-help

show help for all commands (same as spack help –all)

--color {always,never,auto}

when to colorize output (default: auto)

-C DIR, --config-scope DIR

add a custom configuration scope

-d, --debug

write out debug logs during compile

--timestamp

Add a timestamp to tty output

--pdb

run spack under the pdb debugger

-e ENV, --env ENV

run with a specific environment (see spack env)

-D DIR, --env-dir DIR

run with an environment directory (ignore named environments)

-E, --no-env

run without any environments activated (see spack env)

--use-env-repo

when running in an environment, use its package repository

-k, --insecure

do not check ssl certificates when downloading

-l, --enable-locks

use filesystem locking (default)

-L, --disable-locks

do not use filesystem locking (unsafe)

-m, --mock

use mock packages instead of real ones

-p, --profile

profile execution using cProfile

--sorted-profile STAT

profile and sort by one or more of: [calls, ncalls, cumtime, cumulative, filename, line, module]

--lines LINES

lines of profile output or ‘all’ (default: 20)

-v, --verbose

print additional output during builds

--stacktrace

add stacktraces to all printed statements

-V, --version

show version number and exit

--print-shell-vars PRINT_SHELL_VARS

print info needed by setup-env.[c]sh

Subcommands


spack activate

activate a package extension

spack activate [-hf] [-v VIEW] ...

More documentation

Positional arguments

spec

spec of package extension to activate

Optional arguments

-h, --help

show this help message and exit

-f, --force

activate without first activating dependencies

-v VIEW, --view VIEW

the view to operate on


spack add

add a spec to an environment

spack add [-h] [-l LIST_NAME] ...

Positional arguments

specs

specs of packages to add

Optional arguments

-h, --help

show this help message and exit

-l LIST_NAME, --list-name LIST_NAME

name of the list to add specs to


spack arch

print architecture information about this machine

spack arch [-h] [--known-targets] [-p | -o | -t] [-f | -b]

Optional arguments

-h, --help

show this help message and exit

--known-targets

show a list of all known targets and exit

-p, --platform

print only the platform

-o, --operating-system

print only the operating system

-t, --target

print only the target

-f, --frontend

print frontend

-b, --backend

print backend


spack blame

show contributors to packages

spack blame [-h] [-t | -p | -g] package_name

Positional arguments

package_name

name of package to show contributions for, or path to a file in the spack repo

Optional arguments

-h, --help

show this help message and exit

-t, --time

sort by last modification date (default)

-p, --percent

sort by percent of code

-g, --git

show git blame output instead of summary


spack bootstrap

Bootstrap packages needed for spack to run smoothly

spack bootstrap [-hnv] [-j JOBS] [--keep-prefix] [--keep-stage] [--use-cache | --no-cache | --cache-only]
            [--clean | --dirty]

Optional arguments

-h, --help

show this help message and exit

-j JOBS, --jobs JOBS

explicitly set number of parallel jobs

--keep-prefix

don’t remove the install prefix if installation fails

--keep-stage

don’t remove the build stage if installation succeeds

-n, --no-checksum

do not use checksums to verify downloaded files (unsafe)

-v, --verbose

display verbose build output while installing

--use-cache

check for pre-built Spack packages in mirrors (default)

--no-cache

do not check for pre-built Spack packages in mirrors

--cache-only

only install package from binary mirrors

--clean

unset harmful variables in the build environment (default)

--dirty

preserve user environment in the spack build environment (danger!)


spack build

DEPRECATED: stops at build stage when installing a package

spack build [-hv] ...

Positional arguments

package

spec of the package to install

Optional arguments

-h, --help

show this help message and exit

-v, --verbose

print additional output during builds


spack build-env

run a command in a spec’s install environment, or dump its environment to screen or file

spack build-env [-h] [--clean] [--dirty] [--dump FILE] [--pickle FILE] ...

Positional arguments

spec [–] [cmd]…

specs of package environment to emulate

Optional arguments

-h, --help

show this help message and exit

--clean

unset harmful variables in the build environment (default)

--dirty

preserve user environment in the spack build environment (danger!)

--dump FILE

dump a source-able environment to FILE

--pickle FILE

dump a pickled source-able environment to FILE


spack buildcache

create, download and install binary packages

spack buildcache [-h] SUBCOMMAND ...

More documentation

Optional arguments

-h, --help

show this help message and exit

Subcommands


spack buildcache create

spack buildcache create [-hrfua] [-k key] [-d directory] [--no-rebuild-index] [-y SPEC_YAML] [--no-deps] ...

Positional arguments

packages

specs of packages to create buildcache for

Optional arguments

-h, --help

show this help message and exit

-r, --rel

make all rpaths relative before creating tarballs.

-f, --force

overwrite tarball if it exists.

-u, --unsigned

create unsigned buildcache tarballs for testing

-a, --allow-root

allow install root string in binary files after RPATH substitution

-k key, --key key

Key for signing.

-d directory, --directory directory

directory in which to save the tarballs.

--no-rebuild-index

skip rebuilding index after building package(s)

-y SPEC_YAML, --spec-yaml SPEC_YAML

Create buildcache entry for spec from yaml file

--no-deps

Create buildcache entry wo/ dependencies


spack buildcache install

spack buildcache install [-hfmau] ...

Positional arguments

packages

specs of packages to install buildcache for

Optional arguments

-h, --help

show this help message and exit

-f, --force

overwrite install directory if it exists.

-m, --multiple

allow all matching packages

-a, --allow-root

allow install root string in binary files after RPATH substitution

-u, --unsigned

install unsigned buildcache tarballs for testing


spack buildcache list

spack buildcache list [-hlLvf] ...

Positional arguments

packages

specs of packages to search for

Optional arguments

-h, --help

show this help message and exit

-l, --long

show dependency hashes as well as versions

-L, --very-long

show full dependency hashes as well as versions

-v, --variants

show variants in output (can be long)

-f, --force

force new download of specs


spack buildcache keys

spack buildcache keys [-hitf]

Optional arguments

-h, --help

show this help message and exit

-i, --install

install Keys pulled from mirror

-t, --trust

trust all downloaded keys

-f, --force

force new download of keys


spack buildcache preview

spack buildcache preview [-h] packages [packages ...]

Positional arguments

packages

list of installed packages

Optional arguments

-h, --help

show this help message and exit


spack buildcache check

spack buildcache check [-h] [-m MIRROR_URL] [-o OUTPUT_FILE] [--scope {defaults,system,site,user}[/PLATFORM]]
                   [-s SPEC] [-y SPEC_YAML] [--rebuild-on-error]

Optional arguments

-h, --help

show this help message and exit

-m MIRROR_URL, --mirror-url MIRROR_URL

Override any configured mirrors with this mirror url

-o OUTPUT_FILE, --output-file OUTPUT_FILE

File where rebuild info should be written

--scope {defaults,system,site,user}[/PLATFORM]

configuration scope containing mirrors to check

-s SPEC, --spec SPEC

Check single spec instead of release specs file

-y SPEC_YAML, --spec-yaml SPEC_YAML

Check single spec from yaml file instead of release specs file

--rebuild-on-error

Default to rebuilding packages if errors are encountered during the process of checking whether rebuilding is needed


spack buildcache download

spack buildcache download [-hc] [-s SPEC] [-y SPEC_YAML] [-p PATH]

Optional arguments

-h, --help

show this help message and exit

-s SPEC, --spec SPEC

Download built tarball for spec from mirror

-y SPEC_YAML, --spec-yaml SPEC_YAML

Download built tarball for spec (from yaml file) from mirror

-p PATH, --path PATH

Path to directory where tarball should be downloaded

-c, --require-cdashid

Require .cdashid file to be downloaded with buildcache entry


spack buildcache get-buildcache-name

spack buildcache get-buildcache-name [-h] [-s SPEC] [-y SPEC_YAML]

Optional arguments

-h, --help

show this help message and exit

-s SPEC, --spec SPEC

Spec string for which buildcache name is desired

-y SPEC_YAML, --spec-yaml SPEC_YAML

Path to spec yaml file for which buildcache name is desired


spack buildcache save-yaml

spack buildcache save-yaml [-h] [--root-spec ROOT_SPEC] [--root-spec-yaml ROOT_SPEC_YAML] [-s SPECS] [-y YAML_DIR]

Optional arguments

-h, --help

show this help message and exit

--root-spec ROOT_SPEC

Root spec of dependent spec

--root-spec-yaml ROOT_SPEC_YAML

Path to yaml file containing root spec of dependent spec

-s SPECS, --specs SPECS

List of dependent specs for which saved yaml is desired

-y YAML_DIR, --yaml-dir YAML_DIR

Path to directory where spec yamls should be saved


spack buildcache copy

spack buildcache copy [-h] [--base-dir BASE_DIR] [--spec-yaml SPEC_YAML] [--destination-url DESTINATION_URL]

Optional arguments

-h, --help

show this help message and exit

--base-dir BASE_DIR

Path to mirror directory (root of existing buildcache)

--spec-yaml SPEC_YAML

Path to spec yaml file representing buildcache entry to copy

--destination-url DESTINATION_URL

Destination mirror url


spack buildcache update-index

spack buildcache update-index [-h] [-d MIRROR_URL]

Optional arguments

-h, --help

show this help message and exit

-d MIRROR_URL, --mirror-url MIRROR_URL

Destination mirror url


spack cd

cd to spack directories in the shell

spack cd [-h] [-m | -r | -i | -p | -P | -s | -S | -b | -e ENV] ...

More documentation

Positional arguments

spec

spec of package to fetch directory for

Optional arguments

-h, --help

show this help message and exit

-m, --module-dir

spack python module directory

-r, --spack-root

spack installation root

-i, --install-dir

install prefix for spec (spec need not be installed)

-p, --package-dir

directory enclosing a spec’s package.py file

-P, --packages

top-level packages directory for Spack

-s, --stage-dir

stage directory for a spec

-S, --stages

top level stage directory

-b, --build-dir

checked out or expanded source directory for a spec (requires it to be staged first)

-e ENV, --env ENV

location of an environment managed by spack


spack checksum

checksum available versions of a package

spack checksum [-h] [--keep-stage] package ...

More documentation

Positional arguments

package

package to checksum versions for

versions

versions to generate checksums for

Optional arguments

-h, --help

show this help message and exit

--keep-stage

don’t clean up staging area when command completes


spack clean

remove temporary build files and/or downloaded archives

spack clean [-hsdmpa] ...

More documentation

Positional arguments

specs

removes the build stages and tarballs for specs

Optional arguments

-h, --help

show this help message and exit

-s, --stage

remove all temporary build stages (default)

-d, --downloads

remove cached downloads

-m, --misc-cache

remove long-lived caches, like the virtual package index

-p, --python-cache

remove .pyc, .pyo files and __pycache__ folders

-a, --all

equivalent to -sdmp


spack clone

create a new installation of spack in another prefix

spack clone [-h] [-r REMOTE] prefix

Positional arguments

prefix

name of prefix where we should install spack

Optional arguments

-h, --help

show this help message and exit

-r REMOTE, --remote REMOTE

name of the remote to clone from


spack commands

list available spack commands

spack commands [-h] [--format {subcommands,rst,names}] [--header FILE] [--update FILE] ...

Positional arguments

rst_files

list of rst files to search for _cmd-spack-<cmd> cross-refs

Optional arguments

-h, --help

show this help message and exit

--format {subcommands,rst,names}

format to be used to print the output (default: names)

--header FILE

prepend contents of FILE to the output (useful for rst format)

--update FILE

write output to the specified file, if any command is newer


spack compiler

manage compilers

spack compiler [-h] SUBCOMMAND ...

Optional arguments

-h, --help

show this help message and exit

Subcommands


spack compiler find

spack compiler find [-h] [--scope {defaults,system,site,user}[/PLATFORM]] ...

More documentation

Positional arguments

add_paths

Optional arguments

-h, --help

show this help message and exit

--scope {defaults,system,site,user}[/PLATFORM]

configuration scope to modify


spack compiler remove

spack compiler remove [-ha] [--scope {defaults,system,site,user}[/PLATFORM]] compiler_spec

Positional arguments

compiler_spec

Optional arguments

-h, --help

show this help message and exit

-a, --all

remove ALL compilers that match spec

--scope {defaults,system,site,user}[/PLATFORM]

configuration scope to modify


spack compiler list

spack compiler list [-h] [--scope {defaults,system,site,user}[/PLATFORM]]

Optional arguments

-h, --help

show this help message and exit

--scope {defaults,system,site,user}[/PLATFORM]

configuration scope to read from


spack compiler info

spack compiler info [-h] [--scope {defaults,system,site,user}[/PLATFORM]] compiler_spec

More documentation

Positional arguments

compiler_spec

Optional arguments

-h, --help

show this help message and exit

--scope {defaults,system,site,user}[/PLATFORM]

configuration scope to read from


spack compilers

list available compilers

spack compilers [-h] [--scope {defaults,system,site,user}[/PLATFORM]]

More documentation

Optional arguments

-h, --help

show this help message and exit

--scope {defaults,system,site,user}[/PLATFORM]

configuration scope to read/modify


spack concretize

concretize an environment and write a lockfile

spack concretize [-hf]

Optional arguments

-h, --help

show this help message and exit

-f, --force

Re-concretize even if already concretized.


spack config

get and set configuration options

spack config [-h] [--scope {defaults,system,site,user}[/PLATFORM]] SUBCOMMAND ...

Optional arguments

-h, --help

show this help message and exit

--scope {defaults,system,site,user}[/PLATFORM]

configuration scope to read/modify

Subcommands


spack config get

spack config get [-h] [SECTION]

More documentation

Positional arguments

SECTION

configuration section to print. options: %(choices)s

Optional arguments

-h, --help

show this help message and exit


spack config blame

spack config blame [-h] SECTION

More documentation

Positional arguments

SECTION

configuration section to print. options: %(choices)s

Optional arguments

-h, --help

show this help message and exit


spack config edit

spack config edit [-h] [--print-file] [SECTION]

Positional arguments

SECTION

configuration section to edit. options: %(choices)s

Optional arguments

-h, --help

show this help message and exit

--print-file

print the file name that would be edited


spack configure

DEPRECATED: stage and configure a package but do not install

spack configure [-hv] ...

Positional arguments

package

spec of the package to install

Optional arguments

-h, --help

show this help message and exit

-v, --verbose

print additional output during builds


spack create

create a new package file

spack create [-hf] [--keep-stage] [-n NAME] [-t TEMPLATE] [-r REPO] [-N NAMESPACE] [--skip-editor] [url]

More documentation

Positional arguments

url

url of package archive

Optional arguments

-h, --help

show this help message and exit

--keep-stage

don’t clean up staging area when command completes

-n NAME, --name NAME

name of the package to create

-t TEMPLATE, --template TEMPLATE

build system template to use. options: %(choices)s

-r REPO, --repo REPO

path to a repository where the package should be created

-N NAMESPACE, --namespace NAMESPACE

specify a namespace for the package. must be the namespace of a repository registered with Spack

-f, --force

overwrite any existing package file with the same name

--skip-editor

skip the edit session for the package (e.g., automation)


spack deactivate

deactivate a package extension

spack deactivate [-hfa] [-v VIEW] ...

More documentation

Positional arguments

spec

spec of package extension to deactivate

Optional arguments

-h, --help

show this help message and exit

-f, --force

run deactivation even if spec is NOT currently activated

-v VIEW, --view VIEW

the view to operate on

-a, --all

deactivate all extensions of an extendable package, or deactivate an extension AND its dependencies


spack debug

debugging commands for troubleshooting Spack

spack debug [-h] SUBCOMMAND ...

Optional arguments

-h, --help

show this help message and exit

Subcommands


spack debug create-db-tarball

spack debug create-db-tarball [-h]

Optional arguments

-h, --help

show this help message and exit


spack dependencies

show dependencies of a package

spack dependencies [-hitV] [--deptype DEPTYPE] ...

Positional arguments

spec

spec or package name

Optional arguments

-h, --help

show this help message and exit

-i, --installed

List installed dependencies of an installed spec, instead of possible dependencies of a package.

-t, --transitive

show all transitive dependencies

--deptype DEPTYPE

comma-separated list of deptypes to traverse default=build,link,run,test

-V, --no-expand-virtuals

do not expand virtual dependencies


spack dependents

show packages that depend on another

spack dependents [-hit] ...

Positional arguments

spec

spec or package name

Optional arguments

-h, --help

show this help message and exit

-i, --installed

List installed dependents of an installed spec, instead of possible dependents of a package.

-t, --transitive

Show all transitive dependents.


spack deprecate

Replace one package with another via symlinks

spack deprecate [-hy] [-d | -D] [-i | -I] [-l {soft,hard}] ...

Positional arguments

specs

spec to deprecate and spec to use as deprecator

Optional arguments

-h, --help

show this help message and exit

-y, --yes-to-all

assume “yes” is the answer to every confirmation request

-d, --dependencies

Deprecate dependencies (default)

-D, --no-dependencies

Do not deprecate dependencies

-i, --install-deprecator

Concretize and install deprecator spec

-I, --no-install-deprecator

Deprecator spec must already be installed (default)

-l {soft,hard}, --link-type {soft,hard}

Type of filesystem link to use for deprecation (default soft)


spack dev-build

developer build: build from code in current working directory

spack dev-build [-hinq] [-j JOBS] [-d SOURCE_PATH] [--keep-prefix] [--skip-patch] [-u UNTIL] [--clean | --dirty] ...

Positional arguments

spec

specs to use for install. must contain package AND version

Optional arguments

-h, --help

show this help message and exit

-j JOBS, --jobs JOBS

explicitly set number of parallel jobs

-d SOURCE_PATH, --source-path SOURCE_PATH

path to source directory. defaults to the current directory

-i, --ignore-dependencies

don’t try to install dependencies of requested packages

-n, --no-checksum

do not use checksums to verify downloaded files (unsafe)

--keep-prefix

do not remove the install prefix if installation fails

--skip-patch

skip patching for the developer build

-q, --quiet

do not display verbose build output while installing

-u UNTIL, --until UNTIL

phase to stop after when installing (default None)

--clean

unset harmful variables in the build environment (default)

--dirty

preserve user environment in the spack build environment (danger!)


spack diy

DEPRECATED: do-it-yourself: build from local source directory

spack diy [-hinq] [-j JOBS] [-d SOURCE_PATH] [--keep-prefix] [--skip-patch] [-u UNTIL] [--clean | --dirty] ...

Positional arguments

spec

specs to use for install. must contain package AND version

Optional arguments

-h, --help

show this help message and exit

-j JOBS, --jobs JOBS

explicitly set number of parallel jobs

-d SOURCE_PATH, --source-path SOURCE_PATH

path to source directory. defaults to the current directory

-i, --ignore-dependencies

don’t try to install dependencies of requested packages

-n, --no-checksum

do not use checksums to verify downloaded files (unsafe)

--keep-prefix

do not remove the install prefix if installation fails

--skip-patch

skip patching for the developer build

-q, --quiet

do not display verbose build output while installing

-u UNTIL, --until UNTIL

phase to stop after when installing (default None)

--clean

unset harmful variables in the build environment (default)

--dirty

preserve user environment in the spack build environment (danger!)


spack docs

open spack documentation in a web browser

spack docs [-h]

Optional arguments

-h, --help

show this help message and exit


spack edit

open package files in $EDITOR

spack edit [-h] [-b | -c | -d | -t | -m | -r REPO | -N NAMESPACE] [name]

More documentation

Positional arguments

name

name of package to edit

Optional arguments

-h, --help

show this help message and exit

-b, --build-system

Edit the build system with the supplied name.

-c, --command

edit the command with the supplied name

-d, --docs

edit the docs with the supplied name

-t, --test

edit the test with the supplied name

-m, --module

edit the main spack module with the supplied name

-r REPO, --repo REPO

path to repo to edit package in

-N NAMESPACE, --namespace NAMESPACE

namespace of package to edit


spack env

manage virtual environments

spack env [-h] SUBCOMMAND ...

More documentation

Optional arguments

-h, --help

show this help message and exit

Subcommands


spack env activate

spack env activate [-hdp] [--sh | --csh] [-v | -V] env

Positional arguments

env

name of environment to activate

Optional arguments

-h, --help

show this help message and exit

--sh

print sh commands to activate the environment

--csh

print csh commands to activate the environment

-v, --with-view

update PATH etc. with associated view

-V, --without-view

do not update PATH etc. with associated view

-d, --dir

force spack to treat env as a directory, not a name

-p, --prompt

decorate the command line prompt when activating


spack env deactivate

spack env deactivate [-h] [--sh | --csh]

Optional arguments

-h, --help

show this help message and exit

--sh

print sh commands to deactivate the environment

--csh

print csh commands to deactivate the environment


spack env create

spack env create [-hd] [--without-view | --with-view WITH_VIEW] ENV [envfile]

Positional arguments

ENV

name of environment to create

envfile

optional init file; can be spack.yaml or spack.lock

Optional arguments

-h, --help

show this help message and exit

-d, --dir

create an environment in a specific directory

--without-view

do not maintain a view for this environment

--with-view WITH_VIEW

specify that this environment should maintain a view at the specified path (by default the view is maintained in the environment directory)


spack env remove

spack env remove [-hy] ENV [ENV ...]

Positional arguments

ENV

environment(s) to remove

Optional arguments

-h, --help

show this help message and exit

-y, --yes-to-all

assume “yes” is the answer to every confirmation request


spack env list

spack env list [-h]

Optional arguments

-h, --help

show this help message and exit


spack env status

spack env status [-h]

Optional arguments

-h, --help

show this help message and exit


spack env loads

spack env loads [-hr] [-m {tcl,lmod}] [--input-only] [-p PREFIX] [-x EXCLUDE] [env]

Positional arguments

env

name of env to generate loads file for

Optional arguments

-h, --help

show this help message and exit

-m {tcl,lmod}, --module-type {tcl,lmod}

type of module system to generate loads for

--input-only

generate input for module command (instead of a shell script)

-p PREFIX, --prefix PREFIX

prepend to module names when issuing module load commands

-x EXCLUDE, --exclude EXCLUDE

exclude package from output; may be specified multiple times

-r, --dependencies

recursively traverse spec dependencies


spack env view

spack env view [-h] {regenerate,enable,disable} [view_path]

Positional arguments

{regenerate,enable,disable}

action to take for the environment’s view

view_path

when enabling a view, optionally set the path manually

Optional arguments

-h, --help

show this help message and exit


spack extensions

list extensions for package

spack extensions [-hlLdp] [-s {packages,installed,activated,all}] [-v VIEW] ...

More documentation

Positional arguments

spec

spec of package to list extensions for

Optional arguments

-h, --help

show this help message and exit

-l, --long

show dependency hashes as well as versions

-L, --very-long

show full dependency hashes as well as versions

-d, --deps

output dependencies along with found specs

-p, --paths

show paths to package install directories

-s {packages,installed,activated,all}, --show {packages,installed,activated,all}

show only part of output

-v VIEW, --view VIEW

the view to operate on


spack fetch

fetch archives for packages

spack fetch [-hnmD] ...

More documentation

Positional arguments

packages

specs of packages to fetch

Optional arguments

-h, --help

show this help message and exit

-n, --no-checksum

do not use checksums to verify downloaded files (unsafe)

-m, --missing

fetch only missing (not yet installed) dependencies

-D, --dependencies

also fetch all dependencies


spack find

list and search installed packages

spack find [-hdplLcfumvMN] [--format FORMAT | --json] [--groups] [--no-groups] [-t TAGS] [--show-full-compiler]
       [-x | -X] [--deprecated] [--only-deprecated] [--start-date START_DATE] [--end-date END_DATE]
       ...

More documentation

Positional arguments

constraint

constraint to select a subset of installed packages

Optional arguments

-h, --help

show this help message and exit

--format FORMAT

output specs with the specified format string

--json

output specs as machine-readable json records

-d, --deps

output dependencies along with found specs

-p, --paths

show paths to package install directories

--groups

display specs in arch/compiler groups (default on)

--no-groups

do not group specs by arch/compiler

-l, --long

show dependency hashes as well as versions

-L, --very-long

show full dependency hashes as well as versions

-t TAGS, --tags TAGS

filter a package query by tags

-c, --show-concretized

show concretized specs in an environment

-f, --show-flags

show spec compiler flags

--show-full-compiler

show full compiler specs

-x, --explicit

show only specs that were installed explicitly

-X, --implicit

show only specs that were installed as dependencies

-u, --unknown

show only specs Spack does not have a package for

-m, --missing

show missing dependencies as well as installed specs

-v, --variants

show variants in output (can be long)

-M, --only-missing

show only missing dependencies

--deprecated

show deprecated packages as well as installed specs

--only-deprecated

show only deprecated packages

-N, --namespace

show fully qualified package names

--start-date START_DATE

earliest date of installation [YYYY-MM-DD]

--end-date END_DATE

latest date of installation [YYYY-MM-DD]


spack flake8

runs source code style checks on Spack. requires flake8

spack flake8 [-hkaorU] [-b BASE] ...

Positional arguments

files

specific files to check

Optional arguments

-h, --help

show this help message and exit

-b BASE, --base BASE

select base branch for collecting list of modified files

-k, --keep-temp

do not delete temporary directory where flake8 runs. use for debugging, to see filtered files

-a, --all

check all files, not just changed files

-o, --output

send filtered files to stdout as well as temp files

-r, --root-relative

print root-relative paths (default: cwd-relative)

-U, --no-untracked

exclude untracked files from checks


spack gpg

handle GPG actions for spack

spack gpg [-h] SUBCOMMAND ...

More documentation

Optional arguments

-h, --help

show this help message and exit

Subcommands


spack gpg verify

spack gpg verify [-h] package [signature]

Positional arguments

package

the package to verify

signature

the signature file

Optional arguments

-h, --help

show this help message and exit


spack gpg trust

spack gpg trust [-h] keyfile

Positional arguments

keyfile

add a key to the trust store

Optional arguments

-h, --help

show this help message and exit


spack gpg untrust

spack gpg untrust [-h] [--signing] keys [keys ...]

Positional arguments

keys

remove keys from the trust store

Optional arguments

-h, --help

show this help message and exit

--signing

allow untrusting signing keys


spack gpg sign

spack gpg sign [-h] [--output DEST] [--key KEY] [--clearsign] package

Positional arguments

package

the package to sign

Optional arguments

-h, --help

show this help message and exit

--output DEST

the directory to place signatures

--key KEY

the key to use for signing

--clearsign

if specified, create a clearsign signature


spack gpg create

spack gpg create [-h] [--comment COMMENT] [--expires EXPIRATION] [--export DEST] name email

Positional arguments

name

the name to use for the new key

email

the email address to use for the new key

Optional arguments

-h, --help

show this help message and exit

--comment COMMENT

a description for the intended use of the key

--expires EXPIRATION

when the key should expire

--export DEST

export the public key to a file


spack gpg list

spack gpg list [-h] [--trusted] [--signing]

Optional arguments

-h, --help

show this help message and exit

--trusted

list trusted keys

--signing

list keys which may be used for signing


spack gpg init

spack gpg init [-h]

Optional arguments

-h, --help

show this help message and exit

--from DIR

==SUPPRESS==


spack gpg export

spack gpg export [-h] location [keys [keys ...]]

Positional arguments

location

where to export keys

keys

the keys to export; all secret keys if unspecified

Optional arguments

-h, --help

show this help message and exit


spack graph

generate graphs of package dependency relationships

spack graph [-hsi] [-a | -d] [--deptype DEPTYPE] ...

More documentation

Positional arguments

specs

specs of packages to graph

Optional arguments

-h, --help

show this help message and exit

-a, --ascii

draw graph as ascii to stdout (default)

-d, --dot

generate graph in dot format and print to stdout

-s, --static

graph static (possible) deps, don’t concretize (implies –dot)

-i, --installed

graph all installed specs in dot format (implies –dot)

--deptype DEPTYPE

comma-separated list of deptypes to traverse default=build,link,run,test


spack help

get help on spack and its commands

spack help [-ha] [--spec] help_command]

More documentation

Positional arguments

help_command

command to get help on

Optional arguments

-h, --help

show this help message and exit

-a, --all

list all available commands and options

--spec

help on the package specification syntax


spack info

get detailed information on a particular package

spack info [-h] PACKAGE

More documentation

Positional arguments

PACKAGE

name of package to get info for

Optional arguments

-h, --help

show this help message and exit


spack install

build and install packages

spack install [-hInvy] [--only {package,dependencies}] [-u UNTIL] [-j JOBS] [--overwrite] [--keep-prefix]
          [--keep-stage] [--dont-restage] [--use-cache | --no-cache | --cache-only] [--show-log-on-error]
          [--source] [--fake] [--only-concrete] [-f SPEC_YAML_FILE] [--clean | --dirty]
          [--test {root,all} | --run-tests] [--log-format {None,junit,cdash}] [--log-file LOG_FILE]
          [--cdash-upload-url CDASH_UPLOAD_URL] [--cdash-build CDASH_BUILD] [--cdash-site CDASH_SITE]
          [--cdash-track CDASH_TRACK | --cdash-buildstamp CDASH_BUILDSTAMP]
          ...

More documentation

Positional arguments

package

spec of the package to install

Optional arguments

-h, --help

show this help message and exit

--only {package,dependencies}

select the mode of installation. the default is to install the package along with all its dependencies. alternatively one can decide to install only the package or only the dependencies

-u UNTIL, --until UNTIL

phase to stop after when installing (default None)

-j JOBS, --jobs JOBS

explicitly set number of parallel jobs

-I, --install-status

show install status of packages. packages can be: installed [+], missing and needed by an installed package [-], or not installed (no annotation)

--overwrite

reinstall an existing spec, even if it has dependents

--keep-prefix

don’t remove the install prefix if installation fails

--keep-stage

don’t remove the build stage if installation succeeds

--dont-restage

if a partial install is detected, don’t delete prior state

--use-cache

check for pre-built Spack packages in mirrors (default)

--no-cache

do not check for pre-built Spack packages in mirrors

--cache-only

only install package from binary mirrors

--show-log-on-error

print full build log to stderr if build fails

--source

install source files in prefix

-n, --no-checksum

do not use checksums to verify downloaded files (unsafe)

-v, --verbose

display verbose build output while installing

--fake

fake install for debug purposes.

--only-concrete

(with environment) only install already concretized specs

-f SPEC_YAML_FILE, --file SPEC_YAML_FILE

install from file. Read specs to install from .yaml files

--clean

unset harmful variables in the build environment (default)

--dirty

preserve user environment in the spack build environment (danger!)

--test {root,all}

If ‘root’ is chosen, run package tests during installation for top-level packages (but skip tests for dependencies). if ‘all’ is chosen, run package tests during installation for all packages. If neither are chosen, don’t run tests for any packages.

--run-tests

run package tests during installation (same as –test=all)

--log-format {None,junit,cdash}

format to be used for log files

--log-file LOG_FILE

filename for the log file. if not passed a default will be used

--cdash-upload-url CDASH_UPLOAD_URL

CDash URL where reports will be uploaded

--cdash-build CDASH_BUILD

The name of the build that will be reported to CDash. Defaults to spec of the package to install.

--cdash-site CDASH_SITE

The site name that will be reported to CDash. Defaults to current system hostname.

--cdash-track CDASH_TRACK

Results will be reported to this group on CDash. Defaults to Experimental.

--cdash-buildstamp CDASH_BUILDSTAMP

Instead of letting the CDash reporter prepare the buildstamp which, when combined with build name, site and project, uniquely identifies the build, provide this argument to identify the build yourself. Format: %%Y%%m%%d-%%H%%M-[cdash-track]

-y, --yes-to-all

assume “yes” is the answer to every confirmation request


spack license

list and check license headers on files in spack

spack license [-h] SUBCOMMAND ...

Optional arguments

-h, --help

show this help message and exit

Subcommands


spack license list-files

spack license list-files [-h]

Optional arguments

-h, --help

show this help message and exit


spack license verify

spack license verify [-h] [--root ROOT]

Optional arguments

-h, --help

show this help message and exit

--root ROOT

scan a different prefix for license issues


spack list

list and search available packages

spack list [-hd] [--format {name_only,version_json,html}] [--update FILE] [-t TAGS] ...

More documentation

Positional arguments

filter

optional case-insensitive glob patterns to filter results

Optional arguments

-h, --help

show this help message and exit

-d, --search-description

filtering will also search the description for a match

--format {name_only,version_json,html}

format to be used to print the output [default: name_only]

--update FILE

write output to the specified file, if any package is newer

-t TAGS, --tags TAGS

filter a package query by tags


spack load

add package to environment using module load

spack load [-hr] ...

More documentation

Positional arguments

spec

spec of package to load with modules

Optional arguments

-h, --help

show this help message and exit

-r, --dependencies

recursively traverse spec dependencies


spack location

print out locations of packages and spack directories

spack location [-h] [-m | -r | -i | -p | -P | -s | -S | -b | -e ENV] ...

More documentation

Positional arguments

spec

spec of package to fetch directory for

Optional arguments

-h, --help

show this help message and exit

-m, --module-dir

spack python module directory

-r, --spack-root

spack installation root

-i, --install-dir

install prefix for spec (spec need not be installed)

-p, --package-dir

directory enclosing a spec’s package.py file

-P, --packages

top-level packages directory for Spack

-s, --stage-dir

stage directory for a spec

-S, --stages

top level stage directory

-b, --build-dir

checked out or expanded source directory for a spec (requires it to be staged first)

-e ENV, --env ENV

location of an environment managed by spack


spack log-parse

filter errors and warnings from build logs

spack log-parse [-hp] [--show SHOW] [-c CONTEXT] [-w WIDTH] [-j JOBS] file

Positional arguments

file

a log file containing build output, or - for stdin

Optional arguments

-h, --help

show this help message and exit

--show SHOW

comma-separated list of what to show; options: errors, warnings

-c CONTEXT, --context CONTEXT

lines of context to show around lines of interest

-p, --profile

print out a profile of time spent in regexes during parse

-w WIDTH, --width WIDTH

wrap width: auto-size to terminal by default; 0 for no wrap

-j JOBS, --jobs JOBS

number of jobs to parse log file (default: 1 for short logs, ncpus for long logs)


spack maintainers

get information about package maintainers

spack maintainers [-ha] [--maintained | --unmaintained] [--by-user] ...

Positional arguments

pkg_or_user

names of packages or users to get info for

Optional arguments

-h, --help

show this help message and exit

--maintained

show names of maintained packages

--unmaintained

show names of unmaintained packages

-a, --all

show maintainers for all packages

--by-user

show packages for users instead of users for packages


spack mirror

manage mirrors (source and binary)

spack mirror [-hn] SUBCOMMAND ...

More documentation

Optional arguments

-h, --help

show this help message and exit

-n, --no-checksum

do not use checksums to verify downloaded files (unsafe)

Subcommands


spack mirror create

spack mirror create [-haD] [-d DIRECTORY] [-f FILE] [-n VERSIONS_PER_SPEC] ...

More documentation

Positional arguments

specs

specs of packages to put in mirror

Optional arguments

-h, --help

show this help message and exit

-d DIRECTORY, --directory DIRECTORY

directory in which to create mirror

-a, --all

mirror all versions of all packages in Spack, or all packages in the current environment if there is an active environment (this requires significant time and space)

-f FILE, --file FILE

file with specs of packages to put in mirror

-D, --dependencies

also fetch all dependencies

-n VERSIONS_PER_SPEC, --versions-per-spec VERSIONS_PER_SPEC

the number of versions to fetch for each spec, choose ‘all’ to retrieve all versions of each package


spack mirror add

spack mirror add [-h] [--scope {defaults,system,site,user}[/PLATFORM]] name url

More documentation

Positional arguments

name

mnemonic name for mirror

url

url of mirror directory from ‘spack mirror create’

Optional arguments

-h, --help

show this help message and exit

--scope {defaults,system,site,user}[/PLATFORM]

configuration scope to modify


spack mirror remove

spack mirror remove [-h] [--scope {defaults,system,site,user}[/PLATFORM]] name

More documentation

Positional arguments

name

Optional arguments

-h, --help

show this help message and exit

--scope {defaults,system,site,user}[/PLATFORM]

configuration scope to modify


spack mirror set-url

spack mirror set-url [-h] [--push] [--scope {defaults,system,site,user}[/PLATFORM]] name url

Positional arguments

name

mnemonic name for mirror

url

url of mirror directory from ‘spack mirror create’

Optional arguments

-h, --help

show this help message and exit

--push

set only the URL used for uploading new packages

--scope {defaults,system,site,user}[/PLATFORM]

configuration scope to modify


spack mirror list

spack mirror list [-h] [--scope {defaults,system,site,user}[/PLATFORM]]

More documentation

Optional arguments

-h, --help

show this help message and exit

--scope {defaults,system,site,user}[/PLATFORM]

configuration scope to read from


spack module

manipulate module files

spack module [-h] SUBCOMMAND ...

Optional arguments

-h, --help

show this help message and exit

Subcommands


spack module lmod

spack module lmod [-h] SUBCOMMAND ...

Optional arguments

-h, --help

show this help message and exit

Subcommands


spack module lmod refresh

spack module lmod refresh [-hy] [--delete-tree] [--upstream-modules] ...

Positional arguments

constraint

constraint to select a subset of installed packages

Optional arguments

-h, --help

show this help message and exit

--delete-tree

delete the module file tree before refresh

--upstream-modules

generate modules for packages installed upstream

-y, --yes-to-all

assume “yes” is the answer to every confirmation request


spack module lmod find

spack module lmod find [-hr] [--full-path] ...

Positional arguments

constraint

constraint to select a subset of installed packages

Optional arguments

-h, --help

show this help message and exit

--full-path

display full path to module file

-r, --dependencies

recursively traverse spec dependencies


spack module lmod rm

spack module lmod rm [-hy] ...

Positional arguments

constraint

constraint to select a subset of installed packages

Optional arguments

-h, --help

show this help message and exit

-y, --yes-to-all

assume “yes” is the answer to every confirmation request


spack module lmod loads

spack module lmod loads [-hr] [--input-only] [-p PREFIX] [-x EXCLUDE] ...

Positional arguments

constraint

constraint to select a subset of installed packages

Optional arguments

-h, --help

show this help message and exit

--input-only

generate input for module command (instead of a shell script)

-p PREFIX, --prefix PREFIX

prepend to module names when issuing module load commands

-x EXCLUDE, --exclude EXCLUDE

exclude package from output; may be specified multiple times

-r, --dependencies

recursively traverse spec dependencies


spack module lmod setdefault

spack module lmod setdefault [-h] ...

Positional arguments

constraint

constraint to select a subset of installed packages

Optional arguments

-h, --help

show this help message and exit


spack module tcl

spack module tcl [-h] SUBCOMMAND ...

Optional arguments

-h, --help

show this help message and exit

Subcommands


spack module tcl refresh

spack module tcl refresh [-hy] [--delete-tree] [--upstream-modules] ...

Positional arguments

constraint

constraint to select a subset of installed packages

Optional arguments

-h, --help

show this help message and exit

--delete-tree

delete the module file tree before refresh

--upstream-modules

generate modules for packages installed upstream

-y, --yes-to-all

assume “yes” is the answer to every confirmation request


spack module tcl find

spack module tcl find [-hr] [--full-path] ...

Positional arguments

constraint

constraint to select a subset of installed packages

Optional arguments

-h, --help

show this help message and exit

--full-path

display full path to module file

-r, --dependencies

recursively traverse spec dependencies


spack module tcl rm

spack module tcl rm [-hy] ...

Positional arguments

constraint

constraint to select a subset of installed packages

Optional arguments

-h, --help

show this help message and exit

-y, --yes-to-all

assume “yes” is the answer to every confirmation request


spack module tcl loads

spack module tcl loads [-hr] [--input-only] [-p PREFIX] [-x EXCLUDE] ...

Positional arguments

constraint

constraint to select a subset of installed packages

Optional arguments

-h, --help

show this help message and exit

--input-only

generate input for module command (instead of a shell script)

-p PREFIX, --prefix PREFIX

prepend to module names when issuing module load commands

-x EXCLUDE, --exclude EXCLUDE

exclude package from output; may be specified multiple times

-r, --dependencies

recursively traverse spec dependencies


spack patch

patch expanded archive sources in preparation for install

spack patch [-hn] ...

More documentation

Positional arguments

packages

specs of packages to stage

Optional arguments

-h, --help

show this help message and exit

-n, --no-checksum

do not use checksums to verify downloaded files (unsafe)


spack pkg

query packages associated with particular git revisions

spack pkg [-h] SUBCOMMAND ...

Optional arguments

-h, --help

show this help message and exit

Subcommands


spack pkg add

spack pkg add [-h] ...

Positional arguments

packages

names of packages to add to git repo

Optional arguments

-h, --help

show this help message and exit


spack pkg list

spack pkg list [-h] [rev]

Positional arguments

rev

revision to list packages for

Optional arguments

-h, --help

show this help message and exit


spack pkg diff

spack pkg diff [-h] [rev1] [rev2]

Positional arguments

rev1

revision to compare against

rev2

revision to compare to rev1 (default is HEAD)

Optional arguments

-h, --help

show this help message and exit


spack pkg added

spack pkg added [-h] [rev1] [rev2]

Positional arguments

rev1

revision to compare against

rev2

revision to compare to rev1 (default is HEAD)

Optional arguments

-h, --help

show this help message and exit


spack pkg changed

spack pkg changed [-h] [-t TYPE] [rev1] [rev2]

Positional arguments

rev1

revision to compare against

rev2

revision to compare to rev1 (default is HEAD)

Optional arguments

-h, --help

show this help message and exit

-t TYPE, --type TYPE

Types of changes to show (A: added, R: removed, C: changed); default is ‘C’


spack pkg removed

spack pkg removed [-h] [rev1] [rev2]

Positional arguments

rev1

revision to compare against

rev2

revision to compare to rev1 (default is HEAD)

Optional arguments

-h, --help

show this help message and exit


spack providers

list packages that provide a particular virtual package

spack providers [-h] [virtual_package [virtual_package ...]]

More documentation

Positional arguments

virtual_package

find packages that provide this virtual package

Optional arguments

-h, --help

show this help message and exit


spack pydoc

run pydoc from within spack

spack pydoc [-h] entity

Positional arguments

entity

run pydoc help on entity

Optional arguments

-h, --help

show this help message and exit


spack python

launch an interpreter as spack would launch a command

spack python [-h] [-c PYTHON_COMMAND] ...

More documentation

Positional arguments

python_args

file to run plus arguments

Optional arguments

-h, --help

show this help message and exit

-c PYTHON_COMMAND

command to execute


spack reindex

rebuild Spack’s package database

spack reindex [-h]

Optional arguments

-h, --help

show this help message and exit


spack release-jobs

generate release build set as .gitlab-ci.yml

spack release-jobs [-hp] [-o OUTPUT_FILE] [--cdash-credentials CDASH_CREDENTIALS]

Optional arguments

-h, --help

show this help message and exit

-o OUTPUT_FILE, --output-file OUTPUT_FILE

path to output file to write

-p, --print-summary

Print summary of staged jobs to standard output

--cdash-credentials CDASH_CREDENTIALS

Path to file containing CDash authentication token


spack remove

remove specs from an environment

spack remove [-haf] [-l LIST_NAME] ...

Positional arguments

specs

specs to be removed

Optional arguments

-h, --help

show this help message and exit

-a, --all

remove all specs from (clear) the environment

-l LIST_NAME, --list-name LIST_NAME

name of the list to remove specs from

-f, --force

remove concretized spec (if any) immediately


spack repo

manage package source repositories

spack repo [-h] SUBCOMMAND ...

More documentation

Optional arguments

-h, --help

show this help message and exit

Subcommands


spack repo create

spack repo create [-h] directory [namespace]

Positional arguments

directory

directory to create the repo in

namespace

namespace to identify packages in the repository. defaults to the directory name

Optional arguments

-h, --help

show this help message and exit


spack repo list

spack repo list [-h] [--scope {defaults,system,site,user}[/PLATFORM]]

Optional arguments

-h, --help

show this help message and exit

--scope {defaults,system,site,user}[/PLATFORM]

configuration scope to read from


spack repo add

spack repo add [-h] [--scope {defaults,system,site,user}[/PLATFORM]] path

Positional arguments

path

path to a Spack package repository directory

Optional arguments

-h, --help

show this help message and exit

--scope {defaults,system,site,user}[/PLATFORM]

configuration scope to modify


spack repo remove

spack repo remove [-h] [--scope {defaults,system,site,user}[/PLATFORM]] path_or_namespace

Positional arguments

path_or_namespace

path or namespace of a Spack package repository

Optional arguments

-h, --help

show this help message and exit

--scope {defaults,system,site,user}[/PLATFORM]

configuration scope to modify


spack resource

list downloadable resources (tarballs, repos, patches, etc.)

spack resource [-h] SUBCOMMAND ...

More documentation

Optional arguments

-h, --help

show this help message and exit

Subcommands


spack resource list

spack resource list [-h] [--only-hashes]

Optional arguments

-h, --help

show this help message and exit

--only-hashes

only print sha256 hashes of resources


spack resource show

spack resource show [-h] hash

Positional arguments

hash

Optional arguments

-h, --help

show this help message and exit


spack restage

revert checked out package source code

spack restage [-h] ...

More documentation

Positional arguments

packages

specs of packages to restage

Optional arguments

-h, --help

show this help message and exit


spack setup

create a configuration script and module, but don’t build

spack setup [-hinv] [--clean | --dirty] ...

Positional arguments

spec

specs to use for install. must contain package AND version

Optional arguments

-h, --help

show this help message and exit

-i, --ignore-dependencies

do not try to install dependencies of requested packages

-n, --no-checksum

do not use checksums to verify downloaded files (unsafe)

-v, --verbose

display verbose build output while installing

--clean

unset harmful variables in the build environment (default)

--dirty

preserve user environment in the spack build environment (danger!)


spack spec

show what would be installed, given a spec

spack spec [-hlLIyjNt] [-c {nodes,edges,paths}] ...

More documentation

Positional arguments

specs

specs of packages

Optional arguments

-h, --help

show this help message and exit

-l, --long

show dependency hashes as well as versions

-L, --very-long

show full dependency hashes as well as versions

-I, --install-status

show install status of packages. packages can be: installed [+], missing and needed by an installed package [-], or not installed (no annotation)

-y, --yaml

print concrete spec as YAML

-j, --json

print concrete spec as YAML

-c {nodes,edges,paths}, --cover {nodes,edges,paths}

how extensively to traverse the DAG (default: nodes)

-N, --namespaces

show fully qualified package names

-t, --types

show dependency types


spack stage

expand downloaded archive in preparation for install

spack stage [-hn] [-p PATH] ...

More documentation

Positional arguments

specs

specs of packages to stage

Optional arguments

-h, --help

show this help message and exit

-n, --no-checksum

do not use checksums to verify downloaded files (unsafe)

-p PATH, --path PATH

path to stage package, does not add to spack tree


spack test

run spack’s unit tests

spack test [-hH] [-l | -L] [--extension EXTENSION] ...

More documentation

Positional arguments

tests

list of tests to run (will be passed to pytest -k)

Optional arguments

-h, --help

show this help message and exit

-H, --pytest-help

print full pytest help message, showing advanced options

-l, --list

list basic test names

-L, --long-list

list the entire hierarchy of tests

--extension EXTENSION

run test for a given Spack extension


spack uninstall

remove installed packages

spack uninstall [-hfRya] ...

More documentation

Positional arguments

packages

specs of packages to uninstall

Optional arguments

-h, --help

show this help message and exit

-f, --force

remove regardless of whether other packages or environments depend on this one

-R, --dependents

also uninstall any packages that depend on the ones given via command line

-y, --yes-to-all

assume “yes” is the answer to every confirmation request

-a, --all

USE CAREFULLY. Remove ALL installed packages that match each supplied spec. i.e., if you uninstall –all libelf, ALL versions of libelf are uninstalled. If no spec is supplied, all installed packages will be uninstalled. If used in an environment, all packages in the environment will be uninstalled.


spack unload

remove package from environment using module unload

spack unload [-h] ...

Positional arguments

spec

spec of package to unload with modules

Optional arguments

-h, --help

show this help message and exit


spack upload-s3

temporary command to upload buildcaches to ‘s3.spack.io’

spack upload-s3 [-h] SUBCOMMAND ...

Optional arguments

-h, --help

show this help message and exit

Subcommands


spack upload-s3 spec

spack upload-s3 spec [-h] [-s SPEC] [-y SPEC_YAML] [-b BASE_DIR] [-e ENDPOINT_URL]

Optional arguments

-h, --help

show this help message and exit

-s SPEC, --spec SPEC

Spec to upload

-y SPEC_YAML, --spec-yaml SPEC_YAML

Path to spec yaml file containing spec to upload

-b BASE_DIR, --base-dir BASE_DIR

Path to root of buildcaches

-e ENDPOINT_URL, --endpoint-url ENDPOINT_URL

URL of mirror


spack upload-s3 index

spack upload-s3 index [-h] [-e ENDPOINT_URL]

Optional arguments

-h, --help

show this help message and exit

-e ENDPOINT_URL, --endpoint-url ENDPOINT_URL

URL of mirror


spack url

debugging tool for url parsing

spack url [-h] SUBCOMMAND ...

More documentation

Optional arguments

-h, --help

show this help message and exit

Subcommands


spack url parse

spack url parse [-hs] url

Positional arguments

url

url to parse

Optional arguments

-h, --help

show this help message and exit

-s, --spider

spider the source page for versions


spack url list

spack url list [-hce] [-n | -N | -v | -V]

Optional arguments

-h, --help

show this help message and exit

-c, --color

color the parsed version and name in the urls shown (versions will be cyan, name red)

-e, --extrapolation

color the versions used for extrapolation as well (additional versions will be green, names magenta)

-n, --incorrect-name

only list urls for which the name was incorrectly parsed

-N, --correct-name

only list urls for which the name was correctly parsed

-v, --incorrect-version

only list urls for which the version was incorrectly parsed

-V, --correct-version

only list urls for which the version was correctly parsed


spack url summary

spack url summary [-h]

Optional arguments

-h, --help

show this help message and exit


spack url stats

spack url stats [-h]

Optional arguments

-h, --help

show this help message and exit


spack verify

Check that all spack packages are on disk as installed

spack verify [-hlja] [-s | -f] ...

Positional arguments

files_or_specs

Files or specs to verify

Optional arguments

-h, --help

show this help message and exit

-l, --local

Verify only locally installed packages

-j, --json

Ouptut json-formatted errors

-a, --all

Verify all packages

-s, --specs

Treat entries as specs (default)

-f, --files

Treat entries as absolute filenames. Cannot be used with ‘-a’


spack versions

list available versions of a package

spack versions [-hs] PACKAGE

More documentation

Positional arguments

PACKAGE

package to list versions for

Optional arguments

-h, --help

show this help message and exit

-s, --safe-only

only list safe versions of the package


spack view

project packages to a compact naming scheme on the filesystem.

spack view [-hv] [-e EXCLUDE] [-d {true,false,yes,no}] ACTION ...

More documentation

Optional arguments

-h, --help

show this help message and exit

-v, --verbose

If not verbose only warnings/errors will be printed.

-e EXCLUDE, --exclude EXCLUDE

exclude packages with names matching the given regex pattern

-d {true,false,yes,no}, --dependencies {true,false,yes,no}

Link/remove/list dependencies.

Subcommands


spack view remove

spack view remove [-ha] [--no-remove-dependents] path [spec [spec ...]]

Positional arguments

path

path to file system view directory

spec

seed specs of the packages to view

Optional arguments

-h, --help

show this help message and exit

--no-remove-dependents

Do not remove dependents of specified specs.

-a, --all

act on all specs in view