コマンドリファレンス¶

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".

カテゴリー	コマンド
Administration	bootstrap, clone, reindex
Query packages	dependencies, dependents, find, graph, info, list, location, providers, resource
Build packages	build, build-env, clean, configure, diy, fetch, install, log-parse, patch, release-jobs, restage, setup, spec, stage, uninstall
Configuration	config, mirror, repo
Developer	blame, cd, commands, debug, flake8, license, pkg, pydoc, python, test, url
Environments	add, concretize, env, remove, view
Extensions	activate, deactivate, extensions
More help	docs, help
モジュール	load, module, unload, unuse, use
Create packages	buildcache, checksum, create, edit, gpg, upload-s3, versions
System	arch, compiler, compilers

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

activate
add
arch
blame
bootstrap
build
build-env
buildcache
cd
checksum
clean
clone
commands
compiler
compilers
concretize
config

configure
create
deactivate
debug
dependencies
dependents
diy
docs
edit
env
extensions
fetch
find
flake8
gpg
graph
help

info
install
license
list
load
location
log-parse
mirror
module
patch
pkg
providers
pydoc
python
reindex
release-jobs

remove
repo
resource
restage
setup
spec
stage
test
uninstall
unload
unuse
upload-s3
url
use
versions
view

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] ...

Positional arguments

specs: specs of packages to add

Optional arguments

-h, --help: show this help message and exit

spack arch¶

print architecture information about this machine

spack arch [-h] [-p | -o | -t]

Optional arguments

-h, --help: show this help message and exit
-p, --platform: print only the platform
-o, --operating-system: print only the operating system
-t, --target: print only the target

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] [--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
--clean: unset harmful variables in the build environment (default)
--dirty: preserve user environment in the spack build environment (danger!)

spack build¶

stops at build stage when installing a package, if possible

spack build [-hv] ...

Positional arguments

パッケージ: 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

buildcache create
buildcache install
buildcache list

buildcache keys
buildcache preview

buildcache check
buildcache download

buildcache get-buildcache-name
buildcache save-yaml

spack buildcache create¶

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

Positional arguments

パッケージ: 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

spack buildcache install¶

spack buildcache install [-hfmau] ...

Positional arguments

パッケージ: 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

パッケージ: 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

パッケージ: 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] [-r ROOT_SPEC] [-s SPECS] [-y YAML_DIR]

Optional arguments

-h, --help: show this help message and exit
-r ROOT_SPEC, --root-spec ROOT_SPEC: 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 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 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

compiler find

compiler remove

compiler list

compiler info

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

config get

config blame

config edit

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¶

stage and configure a package but do not install

spack configure [-hv] ...

Positional arguments

パッケージ: 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] [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

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

debug create-db-tarball

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] ...

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
-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 diy¶

do-it-yourself: build from an existing source directory

spack diy [-hinq] [-j JOBS] [-d SOURCE_PATH] [--keep-prefix] [--skip-patch] [--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 DIY build
-q, --quiet: do not 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 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

env activate
env deactivate

env create
env remove

env list
env status

env loads
env view

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 [-h] [-l | -p | -d] [-s TYPE] [-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
-p, --paths: show paths to extension install directories
-d, --deps: show full dependency DAG of extensions
-s TYPE, --show TYPE: one of packages, installed, activated, all
-v VIEW, --view VIEW: the view to operate on

spack fetch¶

fetch archives for packages

spack fetch [-hnmD] ...

More documentation

Positional arguments

パッケージ: 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 [-hlLcfumvMN] [-s | -p | -d] [-t TAGS] [--show-full-compiler] [-x | -X] [--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
-s, --short: show only specs (default)
-p, --paths: show paths to package install directories
-d, --deps: show full dependency DAG of installed packages
-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
-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

gpg verify
gpg trust

gpg untrust
gpg sign

gpg create
gpg list

gpg init
gpg export

spack gpg verify¶

spack gpg verify [-h] package [signature]

Positional arguments

パッケージ: 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

パッケージ: 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 [-hnsi] [-a | -d] [-t 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
-n, --normalize: skip concretization; only print normalized spec
-s, --static: use static information from packages, not dynamic spec info
-i, --installed: graph all installed specs in dot format (implies --dot)
-t DEPTYPE, --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: print all available commands
--spec: print all available commands

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}] [-j JOBS] [--overwrite] [--keep-prefix] [--keep-stage]
          [--dont-restage] [--use-cache | --no-cache] [--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

パッケージ: 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
-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
--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

license list-files

license verify

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,rst,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,rst,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 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

mirror create

mirror add

mirror remove

mirror list

spack mirror create¶

spack mirror create [-hD] [-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
-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

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 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

module dotkit

module lmod

module tcl

spack module dotkit¶

spack module dotkit [-h] SUBCOMMAND ...

Optional arguments

-h, --help: show this help message and exit

Subcommands

module dotkit refresh

module dotkit find

module dotkit rm

module dotkit loads

spack module dotkit refresh¶

spack module dotkit 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 dotkit find¶

spack module dotkit 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 dotkit rm¶

spack module dotkit 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 dotkit loads¶

spack module dotkit 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¶

spack module lmod [-h] SUBCOMMAND ...

Optional arguments

-h, --help: show this help message and exit

Subcommands

module lmod refresh
module lmod find

module lmod rm

module lmod loads

module lmod setdefault

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

module tcl refresh

module tcl find

module tcl rm

module tcl loads

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

パッケージ: 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

pkg add
pkg list

pkg diff

pkg added

pkg removed

spack pkg add¶

spack pkg add [-h] ...

Positional arguments

パッケージ: 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 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] [-s SPEC_SET] [-m MIRROR_URL] [-o OUTPUT_FILE] [-t SHARED_RUNNER_TAG] [-k SIGNING_KEY]
               [-c CDASH_URL] [--resolve-deps-locally] [--specs-deps-output SPECS_DEPS_OUTPUT]
               ...

Positional arguments

specs: These positional arguments are generally for internal use. The --spec-set argument should be used to identify a yaml file describing the set of release specs to include in the .gitlab-ci.yml file.

Optional arguments

-h, --help: show this help message and exit
-s SPEC_SET, --spec-set SPEC_SET: path to release spec-set yaml file
-m MIRROR_URL, --mirror-url MIRROR_URL: url of binary mirror where builds should be pushed
-o OUTPUT_FILE, --output-file OUTPUT_FILE: path to output file to write
-t SHARED_RUNNER_TAG, --shared-runner-tag SHARED_RUNNER_TAG: tag to add to jobs for shared runner selection
-k SIGNING_KEY, --signing-key SIGNING_KEY: hash of gpg key to use for package signing
-c CDASH_URL, --cdash-url CDASH_URL: Base url of CDash instance jobs should communicate with
-p, --print-summary: Print summary of staged jobs to standard output
--resolve-deps-locally: Use only the current machine to concretize specs, instead of iterating over items in os-container-mapping.yaml and using docker run. Assumes the current machine architecure is listed in the os-container-mapping.yaml config file.
--specs-deps-output SPECS_DEPS_OUTPUT: A file path to which spec deps should be written. This argument is generally for internal use, and should not be provided by end-users under normal conditions.

spack remove¶

remove specs from an environment

spack remove [-haf] ...

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
-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

repo create

repo list

repo add

repo remove

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

resource list

resource show

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

パッケージ: 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 [-hlLIyNt] [-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
-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

パッケージ: 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 unuse¶

remove package from environment using dotkit

spack unuse [-h] ...

Positional arguments

spec: spec of package to unuse with dotkit

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

upload-s3 spec

upload-s3 index

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

url parse

url list

url summary

url stats

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 use¶

add package to environment using dotkit

spack use [-hr] ...

Positional arguments

spec: spec of package to use with dotkit

Optional arguments

-h, --help: show this help message and exit
-r, --dependencies: recursively traverse spec dependencies

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

view symlink

view hardlink

view remove

view statlink

spack view symlink¶

spack view symlink [-hi] [--projection-file PROJECTION_FILE] 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
--projection-file PROJECTION_FILE: Initialize view using projections from file.

-i, --ignore-conflicts

spack view hardlink¶

spack view hardlink [-hi] [--projection-file PROJECTION_FILE] 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
--projection-file PROJECTION_FILE: Initialize view using projections from file.

-i, --ignore-conflicts

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

spack view statlink¶

spack view statlink [-h] 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