saltstack/salt
1
0
Fork 0
mirror of https://github.com/saltstack/salt.git synced 2025-04-17 10:10:20 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Further clarifications on "unless" and "onlyif" requisites.

Browse source 
Fixes #14634

- "unless" is actually a NAND operator
- remove usage of "opposite of unless" as that is confusing
This commit is contained in:
rallytime 2015-12-15 15:42:56 -07:00
parent 7c50533d3f
commit 15c466cc12
1 changed files with 3 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
doc/ref/states/requisites.rst
View file

@ -462,7 +462,7 @@ Unless
The ``unless`` requisite specifies that a state should only run when any of
the specified commands return ``False``. The ``unless`` requisite operates
as NOR and is useful in giving more granular control over when a state should
as NANDg and is useful in giving more granular control over when a state should
execute.
**NOTE**: Under the hood ``unless`` calls ``cmd.retcode`` with
@ -506,12 +506,12 @@ Onlyif
.. versionadded:: 2014.7.0
``onlyif`` is the opposite of ``unless``. If all of the commands in ``onlyif``
The ``onlyif`` requisite specifies that if each command listed in ``onlyif``
return ``True``, then the state is run. If any of the specified commands
return ``False``, the state will not run.
**NOTE**: Under the hood ``onlyif`` calls ``cmd.retcode`` with
``python_shell=True``. This means the commands referenced by unless will be
``python_shell=True``. This means the commands referenced by ``unless`` will be
parsed by a shell, so beware of side-effects as this shell will be run with the
same privileges as the salt-minion.