cmueller/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Docs improvements to _config

Browse source
This commit is contained in:
John Barker 2016-09-14 12:06:18 +01:00 committed by Matt Clay
parent e375b4c61c
commit 42d5d7b21b
8 changed files with 45 additions and 42 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
lib/ansible/modules/network/dnos10/dnos10_config.py
View file

@ -35,7 +35,7 @@ options:
section. The commands must be the exact same commands as found
in the device running-config. Be sure to note the configuration
command syntax as some commands are automatically modified by the
device config parser. This argument is mutually exclusive with O(src).
device config parser. This argument is mutually exclusive with I(src).
required: false
default: null
aliases: ['commands']
@ -53,7 +53,7 @@ options:
or configuration template to load. The path to the source file can
either be the full path on the Ansible control host or a relative
path from the playbook or role root dir. This argument is mutually
exclusive with O(lines).
exclusive with I(lines).
required: false
default: null
before:
@ -68,7 +68,7 @@ options:
after:
description:
- The ordered set of commands to append to the end of the command
stack if a changed needs to be made. Just like with I(before) this
stack if a change needs to be made. Just like with I(before) this
allows the playbook designer to append a set of commands to be
executed after the command set.
required: false

18
lib/ansible/modules/network/eos/eos_config.py
View file

@ -53,7 +53,7 @@ options:
to load into the remote system. The path can either be a full
system path to the configuration file if the value starts with /
or relative to the root of the implemented role or playbook.
This arugment is mutually exclusive with the I(lines) and
This argument is mutually exclusive with the I(lines) and
I(parents) arguments.
required: false
default: null
@ -70,7 +70,7 @@ options:
after:
description:
- The ordered set of commands to append to the end of the command
stack if a changed needs to be made. Just like with I(before) this
stack if a change needs to be made. Just like with I(before) this
allows the playbook designer to append a set of commands to be
executed after the command set.
required: false
@ -81,8 +81,10 @@ options:
the set of commands against the current device config. If
match is set to I(line), commands are matched line by line. If
match is set to I(strict), command lines are matched with respect
to position. Finally if match is set to I(exact), command lines
must be an equal match.
to position. If match is set to I(exact), command lines
must be an equal match. Finally, if match is set to I(none), the
module will not attempt to compare the source configuration with
the running configuration on the remote device.
required: false
default: line
choices: ['line', 'strict', 'exact', 'none']
@ -104,7 +106,7 @@ options:
cause the module to push the contents of I(src) into the device
without first checking if already configured.
- Note this argument should be considered deprecated. To achieve
the equivalient, set the match argument to none. This argument
the equivalent, set the C(match=none) which is idempotent. This argument
will be removed in a future release.
required: false
default: false
@ -143,7 +145,7 @@ options:
version_added: "2.2"
save:
description:
- The I(save) argument will instruct the module to save the
- The C(save) argument instructs the module to save the
running-config to startup-config. This operation is performed
after any changes are made to the current running config. If
no changes are made, the configuration is still saved to the
@ -200,8 +202,8 @@ vars:
RETURN = """
updates:
description: The set of commands that will be pushed to the remote device
returned: when lines is specified
type: when lines is specified
returned: Only when C(lines) is specified.
type: list
sample: ['...', '...']
backup_path:
description: The full path to the backup file

8
lib/ansible/modules/network/ios/ios_config.py
View file

@ -94,7 +94,7 @@ options:
the modified lines are pushed to the device in configuration
mode. If the replace argument is set to I(block) then the entire
command block is pushed to the device in configuration mode if any
line is not correct
line is not correct.
required: false
default: line
choices: ['line', 'block']
@ -105,7 +105,7 @@ options:
cause the module to push the contents of I(src) into the device
without first checking if already configured.
- Note this argument should be considered deprecated. To achieve
the equivalient, set the match argument to none. This argument
the equivalent, set the C(match=none) which is idempotent. This argument
will be removed in a future release.
required: false
default: false
@ -204,8 +204,8 @@ vars:
RETURN = """
updates:
description: The set of commands that will be pushed to the remote device
returned: always
type: when lines is defined
returned: Only when C(lines) is specified.
type: list
sample: ['...', '...']
backup_path:
description: The full path to the backup file

12
lib/ansible/modules/network/iosxr/iosxr_config.py
View file

@ -63,13 +63,13 @@ options:
a change needs to be made. This allows the playbook designer
the opportunity to perform configuration commands prior to pushing
any changes without affecting how the set of commands are matched
against the system
against the system.
required: false
default: null
after:
description:
- The ordered set of commands to append to the end of the command
stack if a changed needs to be made. Just like with I(before) this
stack if a change needs to be made. Just like with I(before) this
allows the playbook designer to append a set of commands to be
executed after the command set.
required: false
@ -94,7 +94,7 @@ options:
the modified lines are pushed to the device in configuration
mode. If the replace argument is set to I(block) then the entire
command block is pushed to the device in configuration mode if any
line is not correct
line is not correct.
required: false
default: line
choices: ['line', 'block', 'config']
@ -105,7 +105,7 @@ options:
cause the module to push the contents of I(src) into the device
without first checking if already configured.
- Note this argument should be considered deprecated. To achieve
the equivalent, set the match argument to none. This argument
the equivalent, set the C(match=none) which is idempotent. This argument
will be removed in a future release.
required: false
default: false
@ -177,8 +177,8 @@ vars:
RETURN = """
updates:
description: The set of commands that will be pushed to the remote device
returned: always
type: when lines is defined
returned: Only when C(lines) is specified.
type: list
sample: ['...', '...']
backup_path:
description: The full path to the backup file

4
lib/ansible/modules/network/junos/junos_config.py
View file

@ -43,7 +43,7 @@ options:
to load into the remote system. The path can either be a full
system path to the configuration file if the value starts with /
or relative to the root of the implemented role or playbook.
This arugment is mutually exclusive with the I(lines) and
This argument is mutually exclusive with the I(lines) and
I(parents) arguments.
required: false
default: null
@ -133,7 +133,7 @@ requirements:
- junos-eznc
notes:
- This module requires the netconf system service be enabled on
the remote device being managed
the remote device being managed.
"""
EXAMPLES = """

20
lib/ansible/modules/network/nxos/nxos_config.py
View file

@ -53,7 +53,7 @@ options:
to load into the remote system. The path can either be a full
system path to the configuration file if the value starts with /
or relative to the root of the implemented role or playbook.
This arugment is mutually exclusive with the I(lines) and
This argument is mutually exclusive with the I(lines) and
I(parents) arguments.
required: false
default: null
@ -70,7 +70,7 @@ options:
after:
description:
- The ordered set of commands to append to the end of the command
stack if a changed needs to be made. Just like with I(before) this
stack if a change needs to be made. Just like with I(before) this
allows the playbook designer to append a set of commands to be
executed after the command set.
required: false
@ -81,11 +81,10 @@ options:
the set of commands against the current device config. If
match is set to I(line), commands are matched line by line. If
match is set to I(strict), command lines are matched with respect
to position. Finally if match is set to I(exact), command lines
must be an equal match.
- Version 2.2 added a new choice I(none). When match is set to
none, the configure is loaded into the remote device without
consulting the configuration.
to position. If match is set to I(exact), command lines
must be an equal match. Finally, if match is set to I(none), the
module will not attempt to compare the source configuration with
the running configuration on the remote device.
required: false
default: line
choices: ['line', 'strict', 'exact', 'none']
@ -107,7 +106,7 @@ options:
cause the module to push the contents of I(src) into the device
without first checking if already configured.
- Note this argument should be considered deprecated. To achieve
the equivalient, set the match argument to none. This argument
the equivalent, set the C(match=none) which is idempotent. This argument
will be removed in a future release.
required: false
default: false
@ -146,7 +145,7 @@ options:
version_added: "2.2"
save:
description:
- The I(save) argument will instruct the module to save the
- The C(save) argument instructs the module to save the
running-config to startup-config. This operation is performed
after any changes are made to the current running config. If
no changes are made, the configuration is still saved to the
@ -200,7 +199,7 @@ vars:
RETURN = """
updates:
description: The set of commands that will be pushed to the remote device
returned: when list is specified
returned: Only when C(lines) is specified.
type: list
sample: ['...', '...']
backup_path:
@ -331,5 +330,6 @@ def main():
module.exit_json(**result)
if __name__ == '__main__':
main()

13
lib/ansible/modules/network/openswitch/ops_config.py
View file

@ -52,7 +52,7 @@ options:
to load into the remote system. The path can either be a full
system path to the configuration file if the value starts with /
or relative to the root of the implemented role or playbook.
This arugment is mutually exclusive with the I(lines) and
This argument is mutually exclusive with the I(lines) and
I(parents) arguments.
required: false
default: null
@ -69,7 +69,7 @@ options:
after:
description:
- The ordered set of commands to append to the end of the command
stack if a changed needs to be made. Just like with I(before) this
stack if a change needs to be made. Just like with I(before) this
allows the playbook designer to append a set of commands to be
executed after the command set.
required: false
@ -80,8 +80,10 @@ options:
the set of commands against the current device config. If
match is set to I(line), commands are matched line by line. If
match is set to I(strict), command lines are matched with respect
to position. Finally if match is set to I(exact), command lines
must be an equal match.
to position. If match is set to I(exact), command lines
must be an equal match. Finally, if match is set to I(none), the
module will not attempt to compare the source configuration with
the running configuration on the remote device.
required: false
default: line
choices: ['line', 'strict', 'exact', 'none']
@ -103,7 +105,7 @@ options:
cause the module to push the contents of I(src) into the device
without first checking if already configured.
- Note this argument should be considered deprecated. To achieve
the equivalent, set the match argument to none. This argument
the equivalent, set the C(match=none) which is idempotent. This argument
will be removed in a future release.
required: false
default: false
@ -304,4 +306,3 @@ def main():
if __name__ == '__main__':
main()

6
lib/ansible/modules/network/sros/sros_config.py
View file

@ -63,7 +63,7 @@ options:
a change needs to be made. This allows the playbook designer
the opportunity to perform configuration commands prior to pushing
any changes without affecting how the set of commands are matched
against the system
against the system.
required: false
default: null
after:
@ -94,7 +94,7 @@ options:
the modified lines are pushed to the device in configuration
mode. If the replace argument is set to I(block) then the entire
command block is pushed to the device in configuration mode if any
line is not correct
line is not correct.
required: false
default: line
choices: ['line', 'block']
@ -105,7 +105,7 @@ options:
cause the module to push the contents of I(src) into the device
without first checking if already configured.
- Note this argument should be considered deprecated. To achieve
the equivalient, set the match argument to none. This argument
the equivalent, set the C(match=none) which is idempotent. This argument
will be removed in a future release.
required: false
default: false