Skip to content

Change one selected Policy Pack.

Usage

rootform update policy-pack <name> [source] [options]
SHELL

Options

FlagTypeDefaultDescription
--dry-runboolfalseprint the planned change and write nothing
--formatstring""output format: text|json; default: text
--offlineboolfalseuse no network; accept local and installed sources
--projectstring""change rootform.lock and vendored copies in project dir; paths stay relative to the working directory; default: the working directory

Global options

FlagTypeDefaultDescription
-h, --helpboolfalseshow how to use rootform update policy-pack
--colormodeautocolor human output: auto|always|never; default: auto
--no-pagerboolfalseprint a long report in full instead of opening it in less

Behavior

Change one selected Policy Pack. Without a source, a local selection is read again from its recorded path, which records content you edited. With a source, the selection switches to it. The source must declare the same name; a registry selection needs a source because no tag is recorded.

When the project vendors this family under .rootform/, the vendored copy changes together with rootform.lock.

The summary goes to standard output. Diagnostics go to standard error.

Exit status

StatusDescription
0rootform.lock matches the request
1a source is invalid or a named selection is absent
2the command was used incorrectly
3rootform.lock is invalid, selections conflict, or --offline needs content that is not installed
4a file, Rootform home, or network operation failed

Examples

rootform update policy-pack baseline
rootform update policy-pack baseline ./policies
rootform update policy-pack baseline \
registry.example.com/acme/policies:policy-pack-baseline-0.2.0
Shell