diff options
author | Sam Doran <sdoran@ansible.com> | 2016-11-22 11:00:01 -0500 |
---|---|---|
committer | John R Barker <john@johnrbarker.com> | 2016-11-22 16:00:01 +0000 |
commit | bb901bbfcc8edaa9a2da3a17d661658845e18762 (patch) | |
tree | 5ae48731aa28ffa8d0ee50f992af84e61f4aa98c | |
parent | f5658f4e5048ae6f2cf1d8eb434be3602fc6bb3a (diff) | |
download | ansible-modules-core-bb901bbfcc8edaa9a2da3a17d661658845e18762.tar.gz |
vyos_command Document ANSIBLE_VYOS_TERMINAL_LENGTH (#5676)
* Update documentation for vyos_command
Add information on new environment variable added in #18546.
Add note on command that should not be run via Ansible.
* White space changes
Two spaces after period.
-rw-r--r-- | network/vyos/vyos_command.py | 14 |
1 files changed, 11 insertions, 3 deletions
diff --git a/network/vyos/vyos_command.py b/network/vyos/vyos_command.py index 4c24e9e7..cced7b2c 100644 --- a/network/vyos/vyos_command.py +++ b/network/vyos/vyos_command.py @@ -28,6 +28,10 @@ description: to validate key parameters before returning successfully. If the conditional statements are not met in the wait period, the task fails. + - Certain C(show) commands in VyOS produce many lines of output and + use a custom pager that can cause this module to hang. If the + value of the environment variable C(ANSIBLE_VYOS_TERMINAL_LENGTH) + is not set, the default number of 10000 is used. extends_documentation_fragment: vyos options: commands: @@ -43,15 +47,15 @@ options: - Specifies what to evaluate from the output of the command and what conditionals to apply. This argument will cause the task to wait for a particular conditional to be true - before moving forward. If the conditional is not true - by the configured I(retries), the task fails. See examples. + before moving forward. If the conditional is not true + by the configured I(retries), the task fails. See examples. required: false default: null aliases: ['waitfor'] match: description: - The I(match) argument is used in conjunction with the - I(wait_for) argument to specify the match policy. Valid + I(wait_for) argument to specify the match policy. Valid values are C(all) or C(any). If the value is set to C(all) then all conditionals in the wait_for must be satisfied. If the value is set to C(any) then only one of the values must be @@ -75,6 +79,10 @@ options: trying the command again. required: false default: 1 + +notes: + - Running C(show system boot-messages all) will cause the module to hang since + VyOS is using a custom pager setting to display the output of that command. """ EXAMPLES = """ |