diff options
Diffstat (limited to 'share/doc/bashtard.1.scd')
-rw-r--r-- | share/doc/bashtard.1.scd | 21 |
1 files changed, 20 insertions, 1 deletions
diff --git a/share/doc/bashtard.1.scd b/share/doc/bashtard.1.scd index aabc2d7..1a681e0 100644 --- a/share/doc/bashtard.1.scd +++ b/share/doc/bashtard.1.scd @@ -1,6 +1,6 @@ bashtard(1) -; SPDX-FileCopyrightText: 2022 Patrick Spek <p.spek@tyil.nl> +; SPDX-FileCopyrightText: 2024 Patrick Spek <p.spek@tyil.nl> ; SPDX-License-Identifier: AGPL-3.0-or-later # NAME @@ -12,13 +12,16 @@ bashtard - A Bash-based configuration management utility *bashtard* -h++ *bashtard* add <_playbook_>++ *bashtard* del <_playbook_>++ +*bashtard* diff++ *bashtard* init [_repository_]++ *bashtard* pkg <_install_|_uninstall_> <_name_>++ +*bashtard* pull++ *bashtard* ssh <_command_>++ *bashtard* sync [_playbook_]++ *bashtard* var [-p _playbook_] <_key_>++ *bashtard* var [-s] <_key_> <_value_>++ *bashtard* sysinfo +*bashtard* zap <playbook> # DESCRIPTION @@ -40,6 +43,10 @@ function of the *playbook.bash* file in the root of the playbook directory. It also removes the playbook name from the host's registry, no longer including it during a *sync*. +## diff + +Show current uncommitted changes present in the etcdir. + ## init Initializes *bashtard*, creating the required directory structure in @@ -56,6 +63,11 @@ Allows direct interaction with the *pkg_\*()* functions provided by the *bashtard* utility library. This in turn makes allows a user to use a single package management interface accross all their machines. +## pull + +Perform a git pull on the etcdir, but without syncing all the playbooks +afterwards. + ## ssh Run a given command over SSH to all configured nodes. Every node needs to have @@ -80,6 +92,13 @@ configuration file. This variant accepts the *-s* option, to instead save it to the *secrets* file, which should only be readable by the user maintaining the system through *bashtard*. +## zap + +Removes a playbook from the registry. Unlike *del*, this will not attempt to run +the *del* function defined within the playbook. This functionality can be used +to remove the entry of a misbehaving playbook, or to be able to re-run the *add* +function on it. + # SEE ALSO - _bashtard(3)_ -- Functions and variables exposed by *bashtard* for use in |