ansible/community.general
1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2024-09-14 20:13:21 +02:00
Code Releases Activity

[PR #6683/eff0cb0e backport][stable-7] Use semantic markup (modules r-s) (#6707)

Browse source 
Use semantic markup (modules r-s) (#6683)

* Use semantic markup.

* Use 'ignore:' for alias reference.

* Ignore sanity errors for older ansible-core versions.

* Improve markup for RHSM modules.

Co-authored-by: Pino Toscano <ptoscano@redhat.com>

* 'ignore:' is no longer needed.

* E() now works better.

---------

Co-authored-by: Pino Toscano <ptoscano@redhat.com>
(cherry picked from commit eff0cb0ed9)

Co-authored-by: Felix Fontein <felix@fontein.de>
This commit is contained in:
patchback[bot] 2023-06-15 19:05:11 +02:00 committed by GitHub
parent f4af31b76b
commit 34c4b1f367
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
49 changed files with 311 additions and 303 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

30
plugins/modules/rax.py
View file

@ -24,15 +24,15 @@ options:
auto_increment: auto_increment:
description: description:
- Whether or not to increment a single number with the name of the - Whether or not to increment a single number with the name of the
created servers. Only applicable when used with the I(group) attribute created servers. Only applicable when used with the O(group) attribute
or meta key. or meta key.
type: bool type: bool
default: true default: true
boot_from_volume: boot_from_volume:
description: description:
- Whether or not to boot the instance from a Cloud Block Storage volume. - Whether or not to boot the instance from a Cloud Block Storage volume.
If C(true) and I(image) is specified a new volume will be created at If V(true) and O(image) is specified a new volume will be created at
boot time. I(boot_volume_size) is required with I(image) to create a boot time. O(boot_volume_size) is required with O(image) to create a
new volume at boot time. new volume at boot time.
type: bool type: bool
default: false default: false
@ -45,11 +45,11 @@ options:
type: int type: int
description: description:
- Size of the volume to create in Gigabytes. This is only required with - Size of the volume to create in Gigabytes. This is only required with
I(image) and I(boot_from_volume). O(image) and O(boot_from_volume).
default: 100 default: 100
boot_volume_terminate: boot_volume_terminate:
description: description:
- Whether the I(boot_volume) or newly created volume from I(image) will - Whether the O(boot_volume) or newly created volume from O(image) will
be terminated when the server is terminated be terminated when the server is terminated
type: bool type: bool
default: false default: false
@ -72,16 +72,16 @@ options:
type: str type: str
description: description:
- Disk partitioning strategy - Disk partitioning strategy
- If not specified it will assume the value C(auto). - If not specified it will assume the value V(auto).
choices: choices:
- auto - auto
- manual - manual
exact_count: exact_count:
description: description:
- Explicitly ensure an exact count of instances, used with - Explicitly ensure an exact count of instances, used with
state=active/present. If specified as C(true) and I(count) is less than state=active/present. If specified as V(true) and O(count) is less than
the servers matched, servers will be deleted to match the count. If the servers matched, servers will be deleted to match the count. If
the number of matched servers is fewer than specified in I(count) the number of matched servers is fewer than specified in O(count)
additional servers will be added. additional servers will be added.
type: bool type: bool
default: false default: false
@ -116,7 +116,7 @@ options:
type: str type: str
description: description:
- image to use for the instance. Can be an C(id), C(human_id) or C(name). - image to use for the instance. Can be an C(id), C(human_id) or C(name).
With I(boot_from_volume), a Cloud Block Storage volume will be created With O(boot_from_volume), a Cloud Block Storage volume will be created
with this image with this image
instance_ids: instance_ids:
type: list type: list
@ -161,7 +161,7 @@ options:
type: str type: str
description: description:
- Data to be uploaded to the servers config drive. This option implies - Data to be uploaded to the servers config drive. This option implies
I(config_drive). Can be a file path or a string O(config_drive). Can be a file path or a string
wait: wait:
description: description:
- wait for the instance to be in state 'running' before returning - wait for the instance to be in state 'running' before returning
@ -176,11 +176,11 @@ author:
- "Jesse Keating (@omgjlk)" - "Jesse Keating (@omgjlk)"
- "Matt Martz (@sivel)" - "Matt Martz (@sivel)"
notes: notes:
- I(exact_count) can be "destructive" if the number of running servers in - O(exact_count) can be "destructive" if the number of running servers in
the I(group) is larger than that specified in I(count). In such a case, the the O(group) is larger than that specified in O(count). In such a case, the
I(state) is effectively set to C(absent) and the extra servers are deleted. O(state) is effectively set to V(absent) and the extra servers are deleted.
In the case of deletion, the returned data structure will have C(action) In the case of deletion, the returned data structure will have RV(ignore:action)
set to C(delete), and the oldest servers in the group will be deleted. set to V(delete), and the oldest servers in the group will be deleted.
extends_documentation_fragment: extends_documentation_fragment:
- community.general.rackspace.openstack - community.general.rackspace.openstack
- community.general.attributes - community.general.attributes

12
plugins/modules/rax_files_objects.py
View file

@ -23,7 +23,7 @@ options:
clear_meta: clear_meta:
description: description:
- Optionally clear existing metadata when applying metadata to existing objects. - Optionally clear existing metadata when applying metadata to existing objects.
Selecting this option is only appropriate when setting I(type=meta). Selecting this option is only appropriate when setting O(type=meta).
type: bool type: bool
default: false default: false
container: container:
@ -36,7 +36,7 @@ options:
description: description:
- The destination of a C(get) operation; i.e. a local directory, C(/home/user/myfolder). - The destination of a C(get) operation; i.e. a local directory, C(/home/user/myfolder).
Used to specify the destination of an operation on a remote object; i.e. a file name, Used to specify the destination of an operation on a remote object; i.e. a file name,
C(file1), or a comma-separated list of remote objects, C(file1,file2,file17). V(file1), or a comma-separated list of remote objects, V(file1,file2,file17).
expires: expires:
type: int type: int
description: description:
@ -50,8 +50,8 @@ options:
type: str type: str
description: description:
- > - >
The method of operation to be performed: C(put) to upload files, C(get) to download files or The method of operation to be performed: V(put) to upload files, V(get) to download files or
C(delete) to remove remote objects in Cloud Files. V(delete) to remove remote objects in Cloud Files.
choices: choices:
- get - get
- put - put
@ -61,8 +61,8 @@ options:
type: str type: str
description: description:
- Source from which to upload files. Used to specify a remote object as a source for - Source from which to upload files. Used to specify a remote object as a source for
an operation, i.e. a file name, C(file1), or a comma-separated list of remote objects, an operation, i.e. a file name, V(file1), or a comma-separated list of remote objects,
C(file1,file2,file17). Parameters I(src) and I(dest) are mutually exclusive on remote-only object operations V(file1,file2,file17). Parameters O(src) and O(dest) are mutually exclusive on remote-only object operations
structure: structure:
description: description:
- Used to specify whether to maintain nested directory structure when downloading objects - Used to specify whether to maintain nested directory structure when downloading objects

52
plugins/modules/rax_mon_check.py
View file

@ -29,7 +29,7 @@ options:
state: state:
type: str type: str
description: description:
- Ensure that a check with this C(label) exists or does not exist. - Ensure that a check with this O(label) exists or does not exist.
choices: ["present", "absent"] choices: ["present", "absent"]
default: present default: present
entity_id: entity_id:
@ -50,27 +50,27 @@ options:
that have a non-null C(agent_id). that have a non-null C(agent_id).
- | - |
Choices for this option are: Choices for this option are:
- C(remote.dns) - V(remote.dns)
- C(remote.ftp-banner) - V(remote.ftp-banner)
- C(remote.http) - V(remote.http)
- C(remote.imap-banner) - V(remote.imap-banner)
- C(remote.mssql-banner) - V(remote.mssql-banner)
- C(remote.mysql-banner) - V(remote.mysql-banner)
- C(remote.ping) - V(remote.ping)
- C(remote.pop3-banner) - V(remote.pop3-banner)
- C(remote.postgresql-banner) - V(remote.postgresql-banner)
- C(remote.smtp-banner) - V(remote.smtp-banner)
- C(remote.smtp) - V(remote.smtp)
- C(remote.ssh) - V(remote.ssh)
- C(remote.tcp) - V(remote.tcp)
- C(remote.telnet-banner) - V(remote.telnet-banner)
- C(agent.filesystem) - V(agent.filesystem)
- C(agent.memory) - V(agent.memory)
- C(agent.load_average) - V(agent.load_average)
- C(agent.cpu) - V(agent.cpu)
- C(agent.disk) - V(agent.disk)
- C(agent.network) - V(agent.network)
- C(agent.plugin) - V(agent.plugin)
required: true required: true
monitoring_zones_poll: monitoring_zones_poll:
type: str type: str
@ -81,15 +81,15 @@ options:
target_hostname: target_hostname:
type: str type: str
description: description:
- One of I(target_hostname) and I(target_alias) is required for remote.* checks, - One of O(target_hostname) and O(target_alias) is required for remote.* checks,
but prohibited for agent.* checks. The hostname this check should target. but prohibited for agent.* checks. The hostname this check should target.
Must be a valid IPv4, IPv6, or FQDN. Must be a valid IPv4, IPv6, or FQDN.
target_alias: target_alias:
type: str type: str
description: description:
- One of I(target_alias) and I(target_hostname) is required for remote.* checks, - One of O(target_alias) and O(target_hostname) is required for remote.* checks,
but prohibited for agent.* checks. Use the corresponding key in the entity's but prohibited for agent.* checks. Use the corresponding key in the entity's
I(ip_addresses) hash to resolve an IP address to target. C(ip_addresses) hash to resolve an IP address to target.
details: details:
type: dict type: dict
default: {} default: {}
@ -99,7 +99,7 @@ options:
256 items. 256 items.
disabled: disabled:
description: description:
- If C(true), ensure the check is created, but don't actually use it yet. - If V(true), ensure the check is created, but don't actually use it yet.
type: bool type: bool
default: false default: false
metadata: metadata:

6
plugins/modules/rax_scaling_group.py
View file

@ -36,7 +36,7 @@ options:
type: str type: str
description: description:
- Disk partitioning strategy - Disk partitioning strategy
- If not specified, it will fallback to C(auto). - If not specified, it will fallback to V(auto).
choices: choices:
- auto - auto
- manual - manual
@ -53,7 +53,7 @@ options:
image: image:
type: str type: str
description: description:
- image to use for the instance. Can be an C(id), C(human_id) or C(name) - image to use for the instance. Can be an C(id), C(human_id) or C(name).
required: true required: true
key_name: key_name:
type: str type: str
@ -113,7 +113,7 @@ options:
type: str type: str
description: description:
- Data to be uploaded to the servers config drive. This option implies - Data to be uploaded to the servers config drive. This option implies
I(config_drive). Can be a file path or a string O(config_drive). Can be a file path or a string
wait: wait:
description: description:
- wait for the scaling group to finish provisioning the minimum amount of - wait for the scaling group to finish provisioning the minimum amount of

8
plugins/modules/rax_scaling_policy.py
View file

@ -25,18 +25,18 @@ options:
description: description:
- The UTC time when this policy will be executed. The time must be - The UTC time when this policy will be executed. The time must be
formatted according to C(yyyy-MM-dd'T'HH:mm:ss.SSS) such as formatted according to C(yyyy-MM-dd'T'HH:mm:ss.SSS) such as
C(2013-05-19T08:07:08Z) V(2013-05-19T08:07:08Z)
change: change:
type: int type: int
description: description:
- The change, either as a number of servers or as a percentage, to make - The change, either as a number of servers or as a percentage, to make
in the scaling group. If this is a percentage, you must set in the scaling group. If this is a percentage, you must set
I(is_percent) to C(true) also. O(is_percent) to V(true) also.
cron: cron:
type: str type: str
description: description:
- The time when the policy will be executed, as a cron entry. For - The time when the policy will be executed, as a cron entry. For
example, if this is parameter is set to C(1 0 * * *) example, if this is parameter is set to V(1 0 * * *).
cooldown: cooldown:
type: int type: int
description: description:
@ -51,7 +51,7 @@ options:
many servers should be in the scaling group. many servers should be in the scaling group.
is_percent: is_percent:
description: description:
- Whether the value in I(change) is a percent value - Whether the value in O(change) is a percent value
default: false default: false
type: bool type: bool
name: name:

18
plugins/modules/read_csv.py
View file

@ -33,13 +33,13 @@ options:
key: key:
description: description:
- The column name used as a key for the resulting dictionary. - The column name used as a key for the resulting dictionary.
- If C(key) is unset, the module returns a list of dictionaries, - If O(key) is unset, the module returns a list of dictionaries,
where each dictionary is a row in the CSV file. where each dictionary is a row in the CSV file.
type: str type: str
dialect: dialect:
description: description:
- The CSV dialect to use when parsing the CSV file. - The CSV dialect to use when parsing the CSV file.
- Possible values include C(excel), C(excel-tab) or C(unix). - Possible values include V(excel), V(excel-tab) or V(unix).
type: str type: str
default: excel default: excel
fieldnames: fieldnames:
@ -50,29 +50,31 @@ options:
elements: str elements: str
unique: unique:
description: description:
- Whether the C(key) used is expected to be unique. - Whether the O(key) used is expected to be unique.
type: bool type: bool
default: true default: true
delimiter: delimiter:
description: description:
- A one-character string used to separate fields. - A one-character string used to separate fields.
- When using this parameter, you change the default value used by I(dialect). - When using this parameter, you change the default value used by O(dialect).
- The default value depends on the dialect used. - The default value depends on the dialect used.
type: str type: str
skipinitialspace: skipinitialspace:
description: description:
- Whether to ignore any whitespaces immediately following the delimiter. - Whether to ignore any whitespaces immediately following the delimiter.
- When using this parameter, you change the default value used by I(dialect). - When using this parameter, you change the default value used by O(dialect).
- The default value depends on the dialect used. - The default value depends on the dialect used.
type: bool type: bool
strict: strict:
description: description:
- Whether to raise an exception on bad CSV input. - Whether to raise an exception on bad CSV input.
- When using this parameter, you change the default value used by I(dialect). - When using this parameter, you change the default value used by O(dialect).
- The default value depends on the dialect used. - The default value depends on the dialect used.
type: bool type: bool
notes: seealso:
- Ansible also ships with the C(csvfile) lookup plugin, which can be used to do selective lookups in CSV files from Jinja. - plugin: community.general.csvfile
plugin_type: lookup
description: Can be used to do selective lookups in CSV files from Jinja.
''' '''
EXAMPLES = r''' EXAMPLES = r'''

50
plugins/modules/redhat_subscription.py
View file

@ -27,20 +27,20 @@ notes:
parameters, which is I(not) secure, as they can be easily stolen by checking the parameters, which is I(not) secure, as they can be easily stolen by checking the
process listing on the system. Due to limitations of the D-Bus interface of C(rhsm), process listing on the system. Due to limitations of the D-Bus interface of C(rhsm),
the module will I(not) use D-Bus for registation when trying either to register the module will I(not) use D-Bus for registation when trying either to register
using I(token), or when specifying I(environment), or when the system is old using O(token), or when specifying O(environment), or when the system is old
(typically RHEL 6 and older). (typically RHEL 6 and older).
- In order to register a system, subscription-manager requires either a username and password, or an activationkey and an Organization ID. - In order to register a system, subscription-manager requires either a username and password, or an activationkey and an Organization ID.
- Since 2.5 values for I(server_hostname), I(server_insecure), I(rhsm_baseurl), - Since 2.5 values for O(server_hostname), O(server_insecure), O(rhsm_baseurl),
I(server_proxy_hostname), I(server_proxy_port), I(server_proxy_user) and O(server_proxy_hostname), O(server_proxy_port), O(server_proxy_user) and
I(server_proxy_password) are no longer taken from the C(/etc/rhsm/rhsm.conf) O(server_proxy_password) are no longer taken from the C(/etc/rhsm/rhsm.conf)
config file and default to None. config file and default to V(null).
- It is possible to interact with C(subscription-manager) only as root, - It is possible to interact with C(subscription-manager) only as root,
so root permissions are required to successfully run this module. so root permissions are required to successfully run this module.
- Since community.general 6.5.0, credentials (that is, I(username) and I(password), - Since community.general 6.5.0, credentials (that is, O(username) and O(password),
I(activationkey), or I(token)) are needed only in case the the system is not registered, O(activationkey), or O(token)) are needed only in case the the system is not registered,
or I(force_register) is specified; this makes it possible to use the module to tweak an or O(force_register) is specified; this makes it possible to use the module to tweak an
already registered system, for example attaching pools to it (using I(pool), or I(pool_ids)), already registered system, for example attaching pools to it (using O(pool), or O(pool_ids)),
and modifying the C(syspurpose) attributes (using I(syspurpose)). and modifying the C(syspurpose) attributes (using O(syspurpose)).
requirements: requirements:
- subscription-manager - subscription-manager
- Optionally the C(dbus) Python library; this is usually included in the OS - Optionally the C(dbus) Python library; this is usually included in the OS
@ -55,7 +55,7 @@ attributes:
options: options:
state: state:
description: description:
- whether to register and subscribe (C(present)), or unregister (C(absent)) a system - whether to register and subscribe (V(present)), or unregister (V(absent)) a system
choices: [ "present", "absent" ] choices: [ "present", "absent" ]
default: "present" default: "present"
type: str type: str
@ -74,11 +74,11 @@ options:
version_added: 6.3.0 version_added: 6.3.0
server_hostname: server_hostname:
description: description:
- Specify an alternative Red Hat Subscription Management or Red Hat Satellite or Katello server - Specify an alternative Red Hat Subscription Management or Red Hat Satellite or Katello server.
type: str type: str
server_insecure: server_insecure:
description: description:
- Enable or disable https server certificate verification when connecting to C(server_hostname) - Enable or disable https server certificate verification when connecting to O(server_hostname).
type: str type: str
server_prefix: server_prefix:
description: description:
@ -104,7 +104,7 @@ options:
type: str type: str
server_proxy_scheme: server_proxy_scheme:
description: description:
- Specify an HTTP proxy scheme, for example C(http) or C(https). - Specify an HTTP proxy scheme, for example V(http) or V(https).
type: str type: str
version_added: 6.2.0 version_added: 6.2.0
server_proxy_port: server_proxy_port:
@ -123,8 +123,8 @@ options:
description: description:
- Upon successful registration, auto-consume available subscriptions - Upon successful registration, auto-consume available subscriptions
- | - |
Added in favor of the deprecated I(autosubscribe) option in Added in favor of the deprecated O(autosubscribe) option in
Ansible 2.5; please note that I(autosubscribe) will be removed in Ansible 2.5; please note that O(autosubscribe) will be removed in
community.general 9.0.0. community.general 9.0.0.
type: bool type: bool
aliases: [autosubscribe] aliases: [autosubscribe]
@ -144,9 +144,9 @@ options:
description: description:
- | - |
Specify a subscription pool name to consume. Regular expressions accepted. Specify a subscription pool name to consume. Regular expressions accepted.
Mutually exclusive with I(pool_ids). Mutually exclusive with O(pool_ids).
- | - |
Please use I(pool_ids) instead: specifying pool IDs is much faster, Please use O(pool_ids) instead: specifying pool IDs is much faster,
and it avoids to match new pools that become available for the and it avoids to match new pools that become available for the
system and are not explicitly wanted. Also, this option does not system and are not explicitly wanted. Also, this option does not
support quantities. support quantities.
@ -158,11 +158,11 @@ options:
pool_ids: pool_ids:
description: description:
- | - |
Specify subscription pool IDs to consume. Prefer over I(pool) when possible as it is much faster. Specify subscription pool IDs to consume. Prefer over O(pool) when possible as it is much faster.
A pool ID may be specified as a C(string) - just the pool ID (ex. C(0123456789abcdef0123456789abcdef)), A pool ID may be specified as a C(string) - just the pool ID (for example V(0123456789abcdef0123456789abcdef)),
or as a C(dict) with the pool ID as the key, and a quantity as the value (ex. or as a C(dict) with the pool ID as the key, and a quantity as the value (for example
C(0123456789abcdef0123456789abcdef: 2). If the quantity is provided, it is used to consume multiple V(0123456789abcdef0123456789abcdef: 2). If the quantity is provided, it is used to consume multiple
entitlements from a pool (the pool must support this). Mutually exclusive with I(pool). entitlements from a pool (the pool must support this). Mutually exclusive with O(pool).
default: [] default: []
type: list type: list
elements: raw elements: raw
@ -216,8 +216,8 @@ options:
elements: str elements: str
sync: sync:
description: description:
- When this option is true, then syspurpose attributes are synchronized with - When this option is V(true), then syspurpose attributes are synchronized with
RHSM server immediately. When this option is false, then syspurpose attributes RHSM server immediately. When this option is V(false), then syspurpose attributes
will be synchronized with RHSM server by rhsmcertd daemon. will be synchronized with RHSM server by rhsmcertd daemon.
type: bool type: bool
default: false default: false

6
plugins/modules/redis_data_incr.py
View file

@ -16,15 +16,15 @@ version_added: 4.0.0
description: description:
- Increment integers or float keys in Redis database and get new value. - Increment integers or float keys in Redis database and get new value.
- Default increment for all keys is 1. For specific increments use the - Default increment for all keys is 1. For specific increments use the
I(increment_int) and I(increment_float) options. O(increment_int) and O(increment_float) options.
author: "Andreas Botzner (@paginabianca)" author: "Andreas Botzner (@paginabianca)"
attributes: attributes:
check_mode: check_mode:
support: partial support: partial
details: details:
- For C(check_mode) to work, the specified I(redis_user) needs permission to - For C(check_mode) to work, the specified O(login_user) needs permission to
run the C(GET) command on the key, otherwise the module will fail. run the C(GET) command on the key, otherwise the module will fail.
- When using I(check_mode) the module will try to calculate the value that - When using C(check_mode) the module will try to calculate the value that
Redis would return. If the key is not present, 0.0 is used as value. Redis would return. If the key is not present, 0.0 is used as value.
diff_mode: diff_mode:
support: none support: none

8
plugins/modules/rhevm.py
View file

@ -141,14 +141,14 @@ options:
default: true default: true
cd_drive: cd_drive:
description: description:
- The CD you wish to have mounted on the VM when I(state = 'CD'). - The CD you wish to have mounted on the VM when O(state=cd).
type: str type: str
timeout: timeout:
description: description:
- The timeout you wish to define for power actions. - The timeout you wish to define for power actions.
- When I(state = 'up'). - When O(state=up).
- When I(state = 'down'). - When O(state=down).
- When I(state = 'restarted'). - When O(state=restarted).
type: int type: int
''' '''

8
plugins/modules/rhn_register.py
View file

@ -32,7 +32,7 @@ attributes:
options: options:
state: state:
description: description:
- Whether to register (C(present)), or unregister (C(absent)) a system. - Whether to register (V(present)), or unregister (V(absent)) a system.
type: str type: str
choices: [ absent, present ] choices: [ absent, present ]
default: present default: present
@ -47,7 +47,7 @@ options:
server_url: server_url:
description: description:
- Specify an alternative Red Hat Network server URL. - Specify an alternative Red Hat Network server URL.
- The default is the current value of I(serverURL) from C(/etc/sysconfig/rhn/up2date). - The default is the current value of C(serverURL) from C(/etc/sysconfig/rhn/up2date).
type: str type: str
activationkey: activationkey:
description: description:
@ -80,12 +80,12 @@ options:
default: [] default: []
enable_eus: enable_eus:
description: description:
- If C(false), extended update support will be requested. - If V(false), extended update support will be requested.
type: bool type: bool
default: false default: false
nopackages: nopackages:
description: description:
- If C(true), the registered node will not upload its installed packages information to Satellite server. - If V(true), the registered node will not upload its installed packages information to Satellite server.
type: bool type: bool
default: false default: false
deprecated: deprecated:

4
plugins/modules/rhsm_release.py
View file

@ -16,7 +16,7 @@ description:
- Sets or unsets the release version used by RHSM repositories. - Sets or unsets the release version used by RHSM repositories.
notes: notes:
- This module will fail on an unregistered system. - This module will fail on an unregistered system.
Use the C(redhat_subscription) module to register a system Use the M(community.general.redhat_subscription) module to register a system
prior to setting the RHSM release. prior to setting the RHSM release.
- It is possible to interact with C(subscription-manager) only as root, - It is possible to interact with C(subscription-manager) only as root,
so root permissions are required to successfully run this module. so root permissions are required to successfully run this module.
@ -33,7 +33,7 @@ options:
release: release:
description: description:
- RHSM release version to use. - RHSM release version to use.
- To unset either pass C(null) for this option, or omit this option. - To unset either pass V(null) for this option, or omit this option.
type: str type: str
author: author:
- Sean Myers (@seandst) - Sean Myers (@seandst)

6
plugins/modules/rhsm_repository.py
View file

@ -18,7 +18,7 @@ description:
author: Giovanni Sciortino (@giovannisciortino) author: Giovanni Sciortino (@giovannisciortino)
notes: notes:
- In order to manage RHSM repositories the system must be already registered - In order to manage RHSM repositories the system must be already registered
to RHSM manually or using the Ansible C(redhat_subscription) module. to RHSM manually or using the Ansible M(community.general.redhat_subscription) module.
- It is possible to interact with C(subscription-manager) only as root, - It is possible to interact with C(subscription-manager) only as root,
so root permissions are required to successfully run this module. so root permissions are required to successfully run this module.
@ -53,8 +53,8 @@ options:
elements: str elements: str
purge: purge:
description: description:
- Disable all currently enabled repositories that are not not specified in C(name). - Disable all currently enabled repositories that are not not specified in O(name).
Only set this to C(True) if passing in a list of repositories to the C(name) field. Only set this to V(true) if passing in a list of repositories to the O(name) field.
Using this with C(loop) will most likely not have the desired result. Using this with C(loop) will most likely not have the desired result.
type: bool type: bool
default: false default: false

16
plugins/modules/rocketchat.py
View file

@ -29,8 +29,8 @@ options:
domain: domain:
type: str type: str
description: description:
- The domain for your environment without protocol. (i.e. - The domain for your environment without protocol. (For example
C(example.com) or C(chat.example.com)) V(example.com) or V(chat.example.com).)
required: true required: true
token: token:
type: str type: str
@ -42,7 +42,7 @@ options:
protocol: protocol:
type: str type: str
description: description:
- Specify the protocol used to send notification messages before the webhook url. (i.e. http or https) - Specify the protocol used to send notification messages before the webhook URL (that is, V(http) or V(https)).
default: https default: https
choices: choices:
- 'http' - 'http'
@ -54,7 +54,7 @@ options:
channel: channel:
type: str type: str
description: description:
- Channel to send the message to. If absent, the message goes to the channel selected for the I(token) - Channel to send the message to. If absent, the message goes to the channel selected for the O(token)
specified during the creation of webhook. specified during the creation of webhook.
username: username:
type: str type: str
@ -70,18 +70,20 @@ options:
type: str type: str
description: description:
- Emoji for the message sender. The representation for the available emojis can be - Emoji for the message sender. The representation for the available emojis can be
got from Rocket Chat. (for example :thumbsup:) (if I(icon_emoji) is set, I(icon_url) will not be used) got from Rocket Chat.
- For example V(:thumbsup:).
- If O(icon_emoji) is set, O(icon_url) will not be used.
link_names: link_names:
type: int type: int
description: description:
- Automatically create links for channels and usernames in I(msg). - Automatically create links for channels and usernames in O(msg).
default: 1 default: 1
choices: choices:
- 1 - 1
- 0 - 0
validate_certs: validate_certs:
description: description:
- If C(false), SSL certificates will not be validated. This should only be used - If V(false), SSL certificates will not be validated. This should only be used
on personally controlled sites using self-signed certificates. on personally controlled sites using self-signed certificates.
type: bool type: bool
default: true default: true

6
plugins/modules/rundeck_job_run.py
View file

@ -42,7 +42,7 @@ options:
type: str type: str
description: description:
- Schedule the job execution to run at specific date and time. - Schedule the job execution to run at specific date and time.
- ISO-8601 date and time format like C(2021-10-05T15:45:00-03:00). - ISO-8601 date and time format like V(2021-10-05T15:45:00-03:00).
loglevel: loglevel:
type: str type: str
description: description:
@ -64,12 +64,12 @@ options:
description: description:
- Job execution wait timeout in seconds. - Job execution wait timeout in seconds.
- If the timeout is reached, the job will be aborted. - If the timeout is reached, the job will be aborted.
- Keep in mind that there is a sleep based on I(wait_execution_delay) after each job status check. - Keep in mind that there is a sleep based on O(wait_execution_delay) after each job status check.
default: 120 default: 120
abort_on_timeout: abort_on_timeout:
type: bool type: bool
description: description:
- Send a job abort request if exceeded the I(wait_execution_timeout) specified. - Send a job abort request if exceeded the O(wait_execution_timeout) specified.
default: false default: false
extends_documentation_fragment: extends_documentation_fragment:
- community.general.rundeck - community.general.rundeck

8
plugins/modules/scaleway_compute.py
View file

@ -37,8 +37,8 @@ options:
description: description:
- Manage public IP on a Scaleway server - Manage public IP on a Scaleway server
- Could be Scaleway IP address UUID - Could be Scaleway IP address UUID
- C(dynamic) Means that IP is destroyed at the same time the host is destroyed - V(dynamic) Means that IP is destroyed at the same time the host is destroyed
- C(absent) Means no public IP at all - V(absent) Means no public IP at all
default: absent default: absent
enable_ipv6: enable_ipv6:
@ -62,13 +62,13 @@ options:
type: str type: str
description: description:
- Organization identifier. - Organization identifier.
- Exactly one of I(project) and I(organization) must be specified. - Exactly one of O(project) and O(organization) must be specified.
project: project:
type: str type: str
description: description:
- Project identifier. - Project identifier.
- Exactly one of I(project) and I(organization) must be specified. - Exactly one of O(project) and O(organization) must be specified.
version_added: 4.3.0 version_added: 4.3.0
state: state:

4
plugins/modules/scaleway_compute_private_network.py
View file

@ -49,7 +49,7 @@ options:
region: region:
type: str type: str
description: description:
- Scaleway region to use (for example C(par1)). - Scaleway region to use (for example V(par1)).
required: true required: true
choices: choices:
- ams1 - ams1
@ -98,7 +98,7 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
scaleway_compute_private_network: scaleway_compute_private_network:
description: Information on the VPC. description: Information on the VPC.
returned: success when I(state=present) returned: success when O(state=present)
type: dict type: dict
sample: sample:
{ {

6
plugins/modules/scaleway_container.py
View file

@ -51,7 +51,7 @@ options:
region: region:
type: str type: str
description: description:
- Scaleway region to use (for example C(fr-par)). - Scaleway region to use (for example V(fr-par)).
required: true required: true
choices: choices:
- fr-par - fr-par
@ -109,7 +109,7 @@ options:
privacy: privacy:
description: description:
- Privacy policies define whether a container can be executed anonymously. - Privacy policies define whether a container can be executed anonymously.
- Choose C(public) to enable anonymous execution, or C(private) to protect your container with an authentication mechanism provided by the Scaleway API. - Choose V(public) to enable anonymous execution, or V(private) to protect your container with an authentication mechanism provided by the Scaleway API.
type: str type: str
default: public default: public
choices: choices:
@ -174,7 +174,7 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
container: container:
description: The container information. description: The container information.
returned: when I(state=present) returned: when O(state=present)
type: dict type: dict
sample: sample:
cpu_limit: 140 cpu_limit: 140

4
plugins/modules/scaleway_container_namespace.py
View file

@ -51,7 +51,7 @@ options:
region: region:
type: str type: str
description: description:
- Scaleway region to use (for example C(fr-par)). - Scaleway region to use (for example V(fr-par)).
required: true required: true
choices: choices:
- fr-par - fr-par
@ -110,7 +110,7 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
container_namespace: container_namespace:
description: The container namespace information. description: The container namespace information.
returned: when I(state=present) returned: when O(state=present)
type: dict type: dict
sample: sample:
description: "" description: ""

6
plugins/modules/scaleway_container_registry.py
View file

@ -49,7 +49,7 @@ options:
region: region:
type: str type: str
description: description:
- Scaleway region to use (for example C(fr-par)). - Scaleway region to use (for example V(fr-par)).
required: true required: true
choices: choices:
- fr-par - fr-par
@ -72,7 +72,7 @@ options:
type: str type: str
description: description:
- Default visibility policy. - Default visibility policy.
- Everyone will be able to pull images from a C(public) registry. - Everyone will be able to pull images from a V(public) registry.
choices: choices:
- public - public
- private - private
@ -99,7 +99,7 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
container_registry: container_registry:
description: The container registry information. description: The container registry information.
returned: when I(state=present) returned: when O(state=present)
type: dict type: dict
sample: sample:
created_at: "2022-10-14T09:51:07.949716Z" created_at: "2022-10-14T09:51:07.949716Z"

28
plugins/modules/scaleway_database_backup.py
View file

@ -32,10 +32,10 @@ options:
state: state:
description: description:
- Indicate desired state of the database backup. - Indicate desired state of the database backup.
- C(present) creates a backup. - V(present) creates a backup.
- C(absent) deletes the backup. - V(absent) deletes the backup.
- C(exported) creates a download link for the backup. - V(exported) creates a download link for the backup.
- C(restored) restores the backup to a new database. - V(restored) restores the backup to a new database.
type: str type: str
default: present default: present
choices: choices:
@ -46,7 +46,7 @@ options:
region: region:
description: description:
- Scaleway region to use (for example C(fr-par)). - Scaleway region to use (for example V(fr-par)).
type: str type: str
required: true required: true
choices: choices:
@ -57,37 +57,37 @@ options:
id: id:
description: description:
- UUID used to identify the database backup. - UUID used to identify the database backup.
- Required for C(absent), C(exported) and C(restored) states. - Required for V(absent), V(exported) and V(restored) states.
type: str type: str
name: name:
description: description:
- Name used to identify the database backup. - Name used to identify the database backup.
- Required for C(present) state. - Required for V(present) state.
- Ignored when I(state=absent), I(state=exported) or I(state=restored). - Ignored when O(state=absent), O(state=exported) or O(state=restored).
type: str type: str
required: false required: false
database_name: database_name:
description: description:
- Name used to identify the database. - Name used to identify the database.
- Required for C(present) and C(restored) states. - Required for V(present) and V(restored) states.
- Ignored when I(state=absent) or I(state=exported). - Ignored when O(state=absent) or O(state=exported).
type: str type: str
required: false required: false
instance_id: instance_id:
description: description:
- UUID of the instance associated to the database backup. - UUID of the instance associated to the database backup.
- Required for C(present) and C(restored) states. - Required for V(present) and V(restored) states.
- Ignored when I(state=absent) or I(state=exported). - Ignored when O(state=absent) or O(state=exported).
type: str type: str
required: false required: false
expires_at: expires_at:
description: description:
- Expiration datetime of the database backup (ISO 8601 format). - Expiration datetime of the database backup (ISO 8601 format).
- Ignored when I(state=absent), I(state=exported) or I(state=restored). - Ignored when O(state=absent), O(state=exported) or O(state=restored).
type: str type: str
required: false required: false
@ -145,7 +145,7 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
metadata: metadata:
description: Backup metadata. description: Backup metadata.
returned: when I(state=present), I(state=exported) or I(state=restored) returned: when O(state=present), O(state=exported), or O(state=restored)
type: dict type: dict
sample: { sample: {
"metadata": { "metadata": {

6
plugins/modules/scaleway_function.py
View file

@ -51,7 +51,7 @@ options:
region: region:
type: str type: str
description: description:
- Scaleway region to use (for example C(fr-par)). - Scaleway region to use (for example V(fr-par)).
required: true required: true
choices: choices:
- fr-par - fr-par
@ -121,7 +121,7 @@ options:
privacy: privacy:
description: description:
- Privacy policies define whether a function can be executed anonymously. - Privacy policies define whether a function can be executed anonymously.
- Choose C(public) to enable anonymous execution, or C(private) to protect your function with an authentication mechanism provided by the Scaleway API. - Choose V(public) to enable anonymous execution, or V(private) to protect your function with an authentication mechanism provided by the Scaleway API.
type: str type: str
default: public default: public
choices: choices:
@ -160,7 +160,7 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
function: function:
description: The function information. description: The function information.
returned: when I(state=present) returned: when O(state=present)
type: dict type: dict
sample: sample:
cpu_limit: 140 cpu_limit: 140

4
plugins/modules/scaleway_function_namespace.py
View file

@ -51,7 +51,7 @@ options:
region: region:
type: str type: str
description: description:
- Scaleway region to use (for example C(fr-par)). - Scaleway region to use (for example V(fr-par)).
required: true required: true
choices: choices:
- fr-par - fr-par
@ -110,7 +110,7 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
function_namespace: function_namespace:
description: The function namespace information. description: The function namespace information.
returned: when I(state=present) returned: when O(state=present)
type: dict type: dict
sample: sample:
description: "" description: ""

4
plugins/modules/scaleway_ip.py
View file

@ -94,8 +94,8 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
data: data:
description: This is only present when I(state=present). description: This is only present when O(state=present).
returned: when I(state=present) returned: when O(state=present)
type: dict type: dict
sample: { sample: {
"ips": [ "ips": [

4
plugins/modules/scaleway_private_network.py
View file

@ -48,7 +48,7 @@ options:
region: region:
type: str type: str
description: description:
- Scaleway region to use (for example C(par1)). - Scaleway region to use (for example V(par1)).
required: true required: true
choices: choices:
- ams1 - ams1
@ -93,7 +93,7 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
scaleway_private_network: scaleway_private_network:
description: Information on the VPC. description: Information on the VPC.
returned: success when I(state=present) returned: success when O(state=present)
type: dict type: dict
sample: sample:
{ {

6
plugins/modules/scaleway_security_group.py
View file

@ -45,7 +45,7 @@ options:
region: region:
description: description:
- Scaleway region to use (for example C(par1)). - Scaleway region to use (for example V(par1)).
type: str type: str
required: true required: true
choices: choices:
@ -110,8 +110,8 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
data: data:
description: This is only present when I(state=present). description: This is only present when O(state=present).
returned: when I(state=present) returned: when O(state=present)
type: dict type: dict
sample: { sample: {
"scaleway_security_group": { "scaleway_security_group": {

6
plugins/modules/scaleway_security_group_rule.py
View file

@ -44,7 +44,7 @@ options:
region: region:
type: str type: str
description: description:
- Scaleway region to use (for example C(par1)). - Scaleway region to use (for example V(par1)).
required: true required: true
choices: choices:
- ams1 - ams1
@ -119,8 +119,8 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
data: data:
description: This is only present when I(state=present). description: This is only present when O(state=present).
returned: when I(state=present) returned: when O(state=present)
type: dict type: dict
sample: { sample: {
"scaleway_security_group_rule": { "scaleway_security_group_rule": {

4
plugins/modules/scaleway_sshkey.py
View file

@ -72,8 +72,8 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
data: data:
description: This is only present when I(state=present). description: This is only present when O(state=present).
returned: when I(state=present) returned: when O(state=present)
type: dict type: dict
sample: { sample: {
"ssh_public_keys": [ "ssh_public_keys": [

4
plugins/modules/scaleway_volume.py
View file

@ -96,8 +96,8 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
data: data:
description: This is only present when I(state=present). description: This is only present when O(state=present).
returned: when I(state=present) returned: when O(state=present)
type: dict type: dict
sample: { sample: {
"volume": { "volume": {

36
plugins/modules/sefcontext.py
View file

@ -36,43 +36,43 @@ options:
description: description:
- The file type that should have SELinux contexts applied. - The file type that should have SELinux contexts applied.
- "The following file type options are available:" - "The following file type options are available:"
- C(a) for all files, - V(a) for all files,
- C(b) for block devices, - V(b) for block devices,
- C(c) for character devices, - V(c) for character devices,
- C(d) for directories, - V(d) for directories,
- C(f) for regular files, - V(f) for regular files,
- C(l) for symbolic links, - V(l) for symbolic links,
- C(p) for named pipes, - V(p) for named pipes,
- C(s) for socket files. - V(s) for socket files.
type: str type: str
choices: [ a, b, c, d, f, l, p, s ] choices: [ a, b, c, d, f, l, p, s ]
default: a default: a
setype: setype:
description: description:
- SELinux type for the specified I(target). - SELinux type for the specified O(target).
type: str type: str
substitute: substitute:
description: description:
- Path to use to substitute file context(s) for the specified I(target). The context labeling for the I(target) subtree is made equivalent to this path. - Path to use to substitute file context(s) for the specified O(target). The context labeling for the O(target) subtree is made equivalent to this path.
- This is also referred to as SELinux file context equivalence and it implements the C(equal) functionality of the SELinux management tools. - This is also referred to as SELinux file context equivalence and it implements the C(equal) functionality of the SELinux management tools.
version_added: 6.4.0 version_added: 6.4.0
type: str type: str
aliases: [ equal ] aliases: [ equal ]
seuser: seuser:
description: description:
- SELinux user for the specified I(target). - SELinux user for the specified O(target).
- Defaults to C(system_u) for new file contexts and to existing value when modifying file contexts. - Defaults to V(system_u) for new file contexts and to existing value when modifying file contexts.
type: str type: str
selevel: selevel:
description: description:
- SELinux range for the specified I(target). - SELinux range for the specified O(target).
- Defaults to C(s0) for new file contexts and to existing value when modifying file contexts. - Defaults to V(s0) for new file contexts and to existing value when modifying file contexts.
type: str type: str
aliases: [ serange ] aliases: [ serange ]
state: state:
description: description:
- Whether the SELinux file context must be C(absent) or C(present). - Whether the SELinux file context must be V(absent) or V(present).
- Specifying C(absent) without either I(setype) or I(substitute) deletes both SELinux type or path substitution mappings that match I(target). - Specifying V(absent) without either O(setype) or O(substitute) deletes both SELinux type or path substitution mappings that match O(target).
type: str type: str
choices: [ absent, present ] choices: [ absent, present ]
default: present default: present
@ -89,8 +89,8 @@ options:
default: false default: false
notes: notes:
- The changes are persistent across reboots. - The changes are persistent across reboots.
- I(setype) and I(substitute) are mutually exclusive. - O(setype) and O(substitute) are mutually exclusive.
- If I(state=present) then one of I(setype) or I(substitute) is mandatory. - If O(state=present) then one of O(setype) or O(substitute) is mandatory.
- The M(community.general.sefcontext) module does not modify existing files to the new - The M(community.general.sefcontext) module does not modify existing files to the new
SELinux context(s), so it is advisable to first create the SELinux SELinux context(s), so it is advisable to first create the SELinux
file contexts before creating files, or run C(restorecon) manually file contexts before creating files, or run C(restorecon) manually

6
plugins/modules/sendgrid.py
View file

@ -24,7 +24,7 @@ notes:
account." account."
- "In order to use api_key, cc, bcc, attachments, from_name, html_body, headers - "In order to use api_key, cc, bcc, attachments, from_name, html_body, headers
you must pip install sendgrid" you must pip install sendgrid"
- "since 2.2 I(username) and I(password) are not required if you supply an I(api_key)" - "Since Ansible 2.2 O(username) and O(password) are not required if you supply an O(api_key)"
requirements: requirements:
- sendgrid Python library 1.6.22 or lower (Sendgrid API V2 supported) - sendgrid Python library 1.6.22 or lower (Sendgrid API V2 supported)
extends_documentation_fragment: extends_documentation_fragment:
@ -39,12 +39,12 @@ options:
type: str type: str
description: description:
- Username for logging into the SendGrid account. - Username for logging into the SendGrid account.
- Since 2.2 it is only required if I(api_key) is not supplied. - Since 2.2 it is only required if O(api_key) is not supplied.
password: password:
type: str type: str
description: description:
- Password that corresponds to the username. - Password that corresponds to the username.
- Since 2.2 it is only required if I(api_key) is not supplied. - Since 2.2 it is only required if O(api_key) is not supplied.
from_address: from_address:
type: str type: str
description: description:

18
plugins/modules/sensu_check.py
View file

@ -16,7 +16,7 @@ short_description: Manage Sensu checks
description: description:
- Manage the checks that should be run on a machine by I(Sensu). - Manage the checks that should be run on a machine by I(Sensu).
- Most options do not have a default and will not be added to the check definition unless specified. - Most options do not have a default and will not be added to the check definition unless specified.
- All defaults except I(path), I(state), I(backup) and I(metric) are not managed by this module, - All defaults except O(path), O(state), O(backup) and O(metric) are not managed by this module,
- they are simply specified for your convenience. - they are simply specified for your convenience.
extends_documentation_fragment: extends_documentation_fragment:
- community.general.attributes - community.general.attributes
@ -42,8 +42,8 @@ options:
type: str type: str
description: description:
- Path to the json file of the check to be added/removed. - Path to the json file of the check to be added/removed.
- Will be created if it does not exist (unless I(state=absent)). - Will be created if it does not exist (unless O(state=absent)).
- The parent folders need to exist when I(state=present), otherwise an error will be thrown - The parent folders need to exist when O(state=present), otherwise an error will be thrown
default: /etc/sensu/conf.d/checks.json default: /etc/sensu/conf.d/checks.json
backup: backup:
description: description:
@ -54,7 +54,7 @@ options:
command: command:
type: str type: str
description: description:
- Path to the sensu check to run (not required when I(state=absent)) - Path to the sensu check to run (not required when O(state=absent))
handlers: handlers:
type: list type: list
elements: str elements: str
@ -82,7 +82,7 @@ options:
handle: handle:
description: description:
- Whether the check should be handled or not - Whether the check should be handled or not
- Default is C(false). - Default is V(false).
type: bool type: bool
subdue_begin: subdue_begin:
type: str type: str
@ -105,14 +105,14 @@ options:
standalone: standalone:
description: description:
- Whether the check should be scheduled by the sensu client or server - Whether the check should be scheduled by the sensu client or server
- This option obviates the need for specifying the I(subscribers) option - This option obviates the need for specifying the O(subscribers) option
- Default is C(false). - Default is V(false).
type: bool type: bool
publish: publish:
description: description:
- Whether the check should be scheduled at all. - Whether the check should be scheduled at all.
- You can still issue it via the sensu api - You can still issue it via the sensu api
- Default is C(false). - Default is V(false).
type: bool type: bool
occurrences: occurrences:
type: int type: int
@ -127,7 +127,7 @@ options:
description: description:
- Classifies the check as an aggregate check, - Classifies the check as an aggregate check,
- making it available via the aggregate API - making it available via the aggregate API
- Default is C(false). - Default is V(false).
type: bool type: bool
low_flap_threshold: low_flap_threshold:
type: int type: int

6
plugins/modules/shutdown.py
View file

@ -12,9 +12,9 @@ DOCUMENTATION = r'''
module: shutdown module: shutdown
short_description: Shut down a machine short_description: Shut down a machine
notes: notes:
- C(PATH) is ignored on the remote node when searching for the C(shutdown) command. Use I(search_paths) - C(PATH) is ignored on the remote node when searching for the C(shutdown) command. Use O(search_paths)
to specify locations to search if the default paths do not work. to specify locations to search if the default paths do not work.
- The I(msg) and I(delay) options are not supported when a shutdown command is not found in I(search_paths), instead - The O(msg) and O(delay) options are not supported when a shutdown command is not found in O(search_paths), instead
the module will attempt to shutdown the system by calling C(systemctl shutdown). the module will attempt to shutdown the system by calling C(systemctl shutdown).
description: description:
- Shut downs a machine. - Shut downs a machine.
@ -76,7 +76,7 @@ EXAMPLES = r'''
RETURN = r''' RETURN = r'''
shutdown: shutdown:
description: C(true) if the machine has been shut down. description: V(true) if the machine has been shut down.
returned: always returned: always
type: bool type: bool
sample: true sample: true

40
plugins/modules/slack.py
View file

@ -19,7 +19,7 @@ DOCUMENTATION = """
module: slack module: slack
short_description: Send Slack notifications short_description: Send Slack notifications
description: description:
- The C(slack) module sends notifications to U(http://slack.com) via the Incoming WebHook integration - The M(community.general.slack) module sends notifications to U(http://slack.com) via the Incoming WebHook integration
author: "Ramon de la Fuente (@ramondelafuente)" author: "Ramon de la Fuente (@ramondelafuente)"
extends_documentation_fragment: extends_documentation_fragment:
- community.general.attributes - community.general.attributes
@ -32,8 +32,8 @@ options:
domain: domain:
type: str type: str
description: description:
- Slack (sub)domain for your environment without protocol. (i.e. - Slack (sub)domain for your environment without protocol. (For example
C(example.slack.com)) In 1.8 and beyond, this is deprecated and may V(example.slack.com).) In Ansible 1.8 and beyond, this is deprecated and may
be ignored. See token documentation for information. be ignored. See token documentation for information.
token: token:
type: str type: str
@ -41,9 +41,9 @@ options:
- Slack integration token. This authenticates you to the slack service. - Slack integration token. This authenticates you to the slack service.
Make sure to use the correct type of token, depending on what method you use. Make sure to use the correct type of token, depending on what method you use.
- "Webhook token: - "Webhook token:
Prior to 1.8, a token looked like C(3Ffe373sfhRE6y42Fg3rvf4GlK). In Prior to Ansible 1.8, a token looked like V(3Ffe373sfhRE6y42Fg3rvf4GlK). In
1.8 and above, ansible adapts to the new slack API where tokens look Ansible 1.8 and above, Ansible adapts to the new slack API where tokens look
like C(G922VJP24/D921DW937/3Ffe373sfhRE6y42Fg3rvf4GlK). If tokens like V(G922VJP24/D921DW937/3Ffe373sfhRE6y42Fg3rvf4GlK). If tokens
are in the new format then slack will ignore any value of domain. If are in the new format then slack will ignore any value of domain. If
the token is in the old format the domain is required. Ansible has no the token is in the old format the domain is required. Ansible has no
control of when slack will get rid of the old API. When slack does control of when slack will get rid of the old API. When slack does
@ -55,8 +55,8 @@ options:
that the incoming webhooks can be added. The key is on the end of the that the incoming webhooks can be added. The key is on the end of the
URL given to you in that section." URL given to you in that section."
- "WebAPI token: - "WebAPI token:
Slack WebAPI requires a personal, bot or work application token. These tokens start with C(xoxp-), C(xoxb-) Slack WebAPI requires a personal, bot or work application token. These tokens start with V(xoxp-), V(xoxb-)
or C(xoxa-), eg. C(xoxb-1234-56789abcdefghijklmnop). WebAPI token is required if you intend to receive thread_id. or V(xoxa-), for example V(xoxb-1234-56789abcdefghijklmnop). WebAPI token is required if you intend to receive thread_id.
See Slack's documentation (U(https://api.slack.com/docs/token-types)) for more information." See Slack's documentation (U(https://api.slack.com/docs/token-types)) for more information."
required: true required: true
msg: msg:
@ -68,7 +68,7 @@ options:
channel: channel:
type: str type: str
description: description:
- Channel to send the message to. If absent, the message goes to the channel selected for the I(token). - Channel to send the message to. If absent, the message goes to the channel selected for the O(token).
thread_id: thread_id:
description: description:
- Optional. Timestamp of parent message to thread this message. https://api.slack.com/docs/message-threading - Optional. Timestamp of parent message to thread this message. https://api.slack.com/docs/message-threading
@ -76,7 +76,7 @@ options:
message_id: message_id:
description: description:
- Optional. Message ID to edit, instead of posting a new message. - Optional. Message ID to edit, instead of posting a new message.
- If supplied I(channel_id) must be in form of C(C0xxxxxxx). use C({{ slack_response.channel_id }}) to get I(channel_id) from previous task run. - If supplied O(channel) must be in form of C(C0xxxxxxx). use C({{ slack_response.channel_id }}) to get RV(ignore:channel_id) from previous task run.
- Corresponds to C(ts) in the Slack API (U(https://api.slack.com/messaging/modifying)). - Corresponds to C(ts) in the Slack API (U(https://api.slack.com/messaging/modifying)).
type: str type: str
version_added: 1.2.0 version_added: 1.2.0
@ -88,17 +88,17 @@ options:
icon_url: icon_url:
type: str type: str
description: description:
- URL for the message sender's icon (default C(https://docs.ansible.com/favicon.ico)) - URL for the message sender's icon.
default: https://docs.ansible.com/favicon.ico default: https://docs.ansible.com/favicon.ico
icon_emoji: icon_emoji:
type: str type: str
description: description:
- Emoji for the message sender. See Slack documentation for options. - Emoji for the message sender. See Slack documentation for options.
(if I(icon_emoji) is set, I(icon_url) will not be used) - If O(icon_emoji) is set, O(icon_url) will not be used.
link_names: link_names:
type: int type: int
description: description:
- Automatically create links for channels and usernames in I(msg). - Automatically create links for channels and usernames in O(msg).
default: 1 default: 1
choices: choices:
- 1 - 1
@ -112,7 +112,7 @@ options:
- 'none' - 'none'
validate_certs: validate_certs:
description: description:
- If C(false), SSL certificates will not be validated. This should only be used - If V(false), SSL certificates will not be validated. This should only be used
on personally controlled sites using self-signed certificates. on personally controlled sites using self-signed certificates.
type: bool type: bool
default: true default: true
@ -139,12 +139,12 @@ options:
prepend_hash: prepend_hash:
type: str type: str
description: description:
- Setting for automatically prepending a C(#) symbol on the passed in I(channel_id). - Setting for automatically prepending a V(#) symbol on the passed in O(channel).
- The C(auto) method prepends a C(#) unless I(channel_id) starts with one of C(#), C(@), C(C0), C(GF), C(G0), C(CP). - The V(auto) method prepends a V(#) unless O(channel) starts with one of V(#), V(@), V(C0), V(GF), V(G0), V(CP).
These prefixes only cover a small set of the prefixes that should not have a C(#) prepended. These prefixes only cover a small set of the prefixes that should not have a V(#) prepended.
Since an exact condition which I(channel_id) values must not have the C(#) prefix is not known, Since an exact condition which O(channel) values must not have the V(#) prefix is not known,
the value C(auto) for this option will be deprecated in the future. It is best to explicitly set the value V(auto) for this option will be deprecated in the future. It is best to explicitly set
I(prepend_hash=always) or I(prepend_hash=never) to obtain the needed behavior. O(prepend_hash=always) or O(prepend_hash=never) to obtain the needed behavior.
choices: choices:
- 'always' - 'always'
- 'never' - 'never'

4
plugins/modules/snap.py
View file

@ -36,7 +36,7 @@ options:
description: description:
- Desired state of the package. - Desired state of the package.
- > - >
When I(state=present) the module will use C(snap install) if the snap is not installed, When O(state=present) the module will use C(snap install) if the snap is not installed,
and C(snap refresh) if it is installed but from a different channel. and C(snap refresh) if it is installed but from a different channel.
default: present default: present
choices: [ absent, present, enabled, disabled ] choices: [ absent, present, enabled, disabled ]
@ -60,7 +60,7 @@ options:
options: options:
description: description:
- Set options with pattern C(key=value) or C(snap:key=value). If a snap name is given, the option will be applied - Set options with pattern C(key=value) or C(snap:key=value). If a snap name is given, the option will be applied
to that snap only. If the snap name is omitted, the options will be applied to all snaps listed in I(name). Options will to that snap only. If the snap name is omitted, the options will be applied to all snaps listed in O(name). Options will
only be applied to active snaps. only be applied to active snaps.
required: false required: false
type: list type: list

18
plugins/modules/snmp_facts.py
View file

@ -36,46 +36,46 @@ options:
required: true required: true
version: version:
description: description:
- SNMP Version to use, C(v2), C(v2c) or C(v3). - SNMP Version to use, V(v2), V(v2c) or V(v3).
type: str type: str
required: true required: true
choices: [ v2, v2c, v3 ] choices: [ v2, v2c, v3 ]
community: community:
description: description:
- The SNMP community string, required if I(version) is C(v2) or C(v2c). - The SNMP community string, required if O(version) is V(v2) or V(v2c).
type: str type: str
level: level:
description: description:
- Authentication level. - Authentication level.
- Required if I(version) is C(v3). - Required if O(version=v3).
type: str type: str
choices: [ authNoPriv, authPriv ] choices: [ authNoPriv, authPriv ]
username: username:
description: description:
- Username for SNMPv3. - Username for SNMPv3.
- Required if I(version) is C(v3). - Required if O(version=v3).
type: str type: str
integrity: integrity:
description: description:
- Hashing algorithm. - Hashing algorithm.
- Required if I(version) is C(v3). - Required if O(version=v3).
type: str type: str
choices: [ md5, sha ] choices: [ md5, sha ]
authkey: authkey:
description: description:
- Authentication key. - Authentication key.
- Required I(version) is C(v3). - Required O(version=v3).
type: str type: str
privacy: privacy:
description: description:
- Encryption algorithm. - Encryption algorithm.
- Required if I(level) is C(authPriv). - Required if O(level=authPriv).
type: str type: str
choices: [ aes, des ] choices: [ aes, des ]
privkey: privkey:
description: description:
- Encryption key. - Encryption key.
- Required if I(level) is C(authPriv). - Required if O(level=authPriv).
type: str type: str
timeout: timeout:
description: description:
@ -137,7 +137,7 @@ ansible_sysname:
type: str type: str
sample: ubuntu-user sample: ubuntu-user
ansible_syslocation: ansible_syslocation:
description: The physical location of this node (e.g., C(telephone closet, 3rd floor)). description: The physical location of this node (for example, V(telephone closet, 3rd floor)).
returned: success returned: success
type: str type: str
sample: Sitting on the Dock of the Bay sample: Sitting on the Dock of the Bay

22
plugins/modules/solaris_zone.py
View file

@ -29,16 +29,16 @@ attributes:
options: options:
state: state:
description: description:
- C(present), configure and install the zone. - V(present), configure and install the zone.
- C(installed), synonym for C(present). - V(installed), synonym for V(present).
- C(running), if the zone already exists, boot it, otherwise, configure and install - V(running), if the zone already exists, boot it, otherwise, configure and install
the zone first, then boot it. the zone first, then boot it.
- C(started), synonym for C(running). - V(started), synonym for V(running).
- C(stopped), shutdown a zone. - V(stopped), shutdown a zone.
- C(absent), destroy the zone. - V(absent), destroy the zone.
- C(configured), configure the ready so that it's to be attached. - V(configured), configure the ready so that it's to be attached.
- C(attached), attach a zone, but do not boot it. - V(attached), attach a zone, but do not boot it.
- C(detached), shutdown and detach a zone - V(detached), shutdown and detach a zone
type: str type: str
choices: [ absent, attached, configured, detached, installed, present, running, started, stopped ] choices: [ absent, attached, configured, detached, installed, present, running, started, stopped ]
default: present default: present
@ -47,7 +47,7 @@ options:
- Zone name. - Zone name.
- A zone name must be unique name. - A zone name must be unique name.
- A zone name must begin with an alpha-numeric character. - A zone name must begin with an alpha-numeric character.
- The name can contain alpha-numeric characters, underbars I(_), hyphens I(-), and periods I(.). - The name can contain alpha-numeric characters, underscores V(_), hyphens V(-), and periods V(.).
- The name cannot be longer than 64 characters. - The name cannot be longer than 64 characters.
type: str type: str
required: true required: true
@ -58,7 +58,7 @@ options:
type: str type: str
sparse: sparse:
description: description:
- Whether to create a sparse (C(true)) or whole root (C(false)) zone. - Whether to create a sparse (V(true)) or whole root (V(false)) zone.
type: bool type: bool
default: false default: false
root_password: root_password:

30
plugins/modules/sorcery.py
View file

@ -36,8 +36,8 @@ options:
description: description:
- Name of the spell - Name of the spell
- multiple names can be given, separated by commas - multiple names can be given, separated by commas
- special value '*' in conjunction with states C(latest) or - special value '*' in conjunction with states V(latest) or
C(rebuild) will update or rebuild the whole system respectively V(rebuild) will update or rebuild the whole system respectively
aliases: ["spell"] aliases: ["spell"]
type: list type: list
elements: str elements: str
@ -45,9 +45,9 @@ options:
state: state:
description: description:
- Whether to cast, dispel or rebuild a package - Whether to cast, dispel or rebuild a package
- state C(cast) is an equivalent of C(present), not C(latest) - state V(cast) is an equivalent of V(present), not V(latest)
- state C(latest) always triggers I(update_cache=true) - state V(latest) always triggers O(update_cache=true)
- state C(rebuild) implies cast of all specified spells, not only - state V(rebuild) implies cast of all specified spells, not only
those existed before those existed before
choices: ["present", "latest", "absent", "cast", "dispelled", "rebuild"] choices: ["present", "latest", "absent", "cast", "dispelled", "rebuild"]
default: "present" default: "present"
@ -57,31 +57,31 @@ options:
description: description:
- Comma-separated list of _optional_ dependencies to build a spell - Comma-separated list of _optional_ dependencies to build a spell
(or make sure it is built) with; use +/- in front of dependency (or make sure it is built) with; use +/- in front of dependency
to turn it on/off ('+' is optional though) to turn it on/off ('+' is optional though).
- this option is ignored if C(name) parameter is equal to '*' or - this option is ignored if O(name) parameter is equal to V(*) or
contains more than one spell contains more than one spell.
- providers must be supplied in the form recognized by Sorcery, e.g. - providers must be supplied in the form recognized by Sorcery, for example
'openssl(SSL)' 'openssl(SSL)'.
type: str type: str
update: update:
description: description:
- Whether or not to update sorcery scripts at the very first stage - Whether or not to update sorcery scripts at the very first stage.
type: bool type: bool
default: false default: false
update_cache: update_cache:
description: description:
- Whether or not to update grimoire collection before casting spells - Whether or not to update grimoire collection before casting spells.
type: bool type: bool
default: false default: false
aliases: ["update_codex"] aliases: ["update_codex"]
cache_valid_time: cache_valid_time:
description: description:
- Time in seconds to invalidate grimoire collection on update - Time in seconds to invalidate grimoire collection on update.
- especially useful for SCM and rsync grimoires - Especially useful for SCM and rsync grimoires.
- makes sense only in pair with C(update_cache) - Makes sense only in pair with O(update_cache).
type: int type: int
default: 0 default: 0
''' '''

14
plugins/modules/spectrum_device.py
View file

@ -9,7 +9,7 @@ from __future__ import absolute_import, division, print_function
__metaclass__ = type __metaclass__ = type
DOCUMENTATION = ''' DOCUMENTATION = r'''
--- ---
module: spectrum_device module: spectrum_device
short_description: Creates/deletes devices in CA Spectrum short_description: Creates/deletes devices in CA Spectrum
@ -36,7 +36,7 @@ options:
type: str type: str
description: description:
- SNMP community used for device discovery. - SNMP community used for device discovery.
- Required when I(state=present). - Required when O(state=present).
required: true required: true
landscape: landscape:
type: str type: str
@ -46,8 +46,8 @@ options:
state: state:
type: str type: str
description: description:
- On C(present) creates the device when it does not exist. - On V(present) creates the device when it does not exist.
- On C(absent) removes the device when it exists. - On V(absent) removes the device when it exists.
choices: ['present', 'absent'] choices: ['present', 'absent']
default: 'present' default: 'present'
url: url:
@ -55,7 +55,7 @@ options:
aliases: [ oneclick_url ] aliases: [ oneclick_url ]
required: true required: true
description: description:
- HTTP, HTTPS URL of the Oneclick server in the form C((http|https)://host.domain[:port]). - HTTP, HTTPS URL of the Oneclick server in the form V((http|https\)://host.domain[:port]).
url_username: url_username:
type: str type: str
aliases: [ oneclick_user ] aliases: [ oneclick_user ]
@ -70,12 +70,12 @@ options:
- Oneclick user password. - Oneclick user password.
use_proxy: use_proxy:
description: description:
- if C(false), it will not use a proxy, even if one is defined in an environment variable on the target hosts. - if V(false), it will not use a proxy, even if one is defined in an environment variable on the target hosts.
default: true default: true
type: bool type: bool
validate_certs: validate_certs:
description: description:
- If C(false), SSL certificates will not be validated. This should only be used - If V(false), SSL certificates will not be validated. This should only be used
on personally controlled sites using self-signed certificates. on personally controlled sites using self-signed certificates.
default: true default: true
type: bool type: bool

18
plugins/modules/ssh_config.py
View file

@ -38,20 +38,20 @@ options:
user: user:
description: description:
- Which user account this configuration file belongs to. - Which user account this configuration file belongs to.
- If none given and I(ssh_config_file) is not specified, C(/etc/ssh/ssh_config) is used. - If none given and O(ssh_config_file) is not specified, C(/etc/ssh/ssh_config) is used.
- If a user is given, C(~/.ssh/config) is used. - If a user is given, C(~/.ssh/config) is used.
- Mutually exclusive with I(ssh_config_file). - Mutually exclusive with O(ssh_config_file).
type: str type: str
group: group:
description: description:
- Which group this configuration file belongs to. - Which group this configuration file belongs to.
- If none given, I(user) is used. - If none given, O(user) is used.
type: str type: str
host: host:
description: description:
- The endpoint this configuration is valid for. - The endpoint this configuration is valid for.
- Can be an actual address on the internet or an alias that will - Can be an actual address on the internet or an alias that will
connect to the value of I(hostname). connect to the value of O(hostname).
required: true required: true
type: str type: str
hostname: hostname:
@ -70,7 +70,7 @@ options:
description: description:
- The path to an identity file (SSH private key) that will be used - The path to an identity file (SSH private key) that will be used
when connecting to this host. when connecting to this host.
- File need to exist and have mode C(0600) to be valid. - File need to exist and have mode V(0600) to be valid.
type: path type: path
user_known_hosts_file: user_known_hosts_file:
description: description:
@ -84,12 +84,12 @@ options:
proxycommand: proxycommand:
description: description:
- Sets the C(ProxyCommand) option. - Sets the C(ProxyCommand) option.
- Mutually exclusive with I(proxyjump). - Mutually exclusive with O(proxyjump).
type: str type: str
proxyjump: proxyjump:
description: description:
- Sets the C(ProxyJump) option. - Sets the C(ProxyJump) option.
- Mutually exclusive with I(proxycommand). - Mutually exclusive with O(proxycommand).
type: str type: str
version_added: 6.5.0 version_added: 6.5.0
forward_agent: forward_agent:
@ -100,8 +100,8 @@ options:
ssh_config_file: ssh_config_file:
description: description:
- SSH config file. - SSH config file.
- If I(user) and this option are not specified, C(/etc/ssh/ssh_config) is used. - If O(user) and this option are not specified, C(/etc/ssh/ssh_config) is used.
- Mutually exclusive with I(user). - Mutually exclusive with O(user).
type: path type: path
host_key_algorithms: host_key_algorithms:
description: description:

12
plugins/modules/stacki_host.py
View file

@ -30,13 +30,13 @@ options:
type: str type: str
stacki_user: stacki_user:
description: description:
- Username for authenticating with Stacki API, but if not specified, the environment variable C(stacki_user) is used instead. - Username for authenticating with Stacki API, but if not specified, the environment variable E(stacki_user) is used instead.
required: true required: true
type: str type: str
stacki_password: stacki_password:
description: description:
- Password for authenticating with Stacki API, but if not - Password for authenticating with Stacki API, but if not
specified, the environment variable C(stacki_password) is used instead. specified, the environment variable E(stacki_password) is used instead.
required: true required: true
type: str type: str
stacki_endpoint: stacki_endpoint:
@ -61,7 +61,7 @@ options:
type: str type: str
force_install: force_install:
description: description:
- Set value to C(true) to force node into install state if it already exists in stacki. - Set value to V(true) to force node into install state if it already exists in stacki.
type: bool type: bool
default: false default: false
state: state:
@ -73,20 +73,20 @@ options:
appliance: appliance:
description: description:
- Applicance to be used in host creation. - Applicance to be used in host creation.
- Required if I(state) is C(present) and host does not yet exist. - Required if O(state=present) and host does not yet exist.
type: str type: str
default: backend default: backend
rack: rack:
description: description:
- Rack to be used in host creation. - Rack to be used in host creation.
- Required if I(state) is C(present) and host does not yet exist. - Required if O(state=present) and host does not yet exist.
type: int type: int
default: 0 default: 0
rank: rank:
description: description:
- Rank to be used in host creation. - Rank to be used in host creation.
- In Stacki terminology, the rank is the position of the machine in a rack. - In Stacki terminology, the rank is the position of the machine in a rack.
- Required if I(state) is C(present) and host does not yet exist. - Required if O(state=present) and host does not yet exist.
type: int type: int
default: 0 default: 0
network: network:

12
plugins/modules/sudoers.py
View file

@ -31,13 +31,13 @@ options:
description: description:
- The commands allowed by the sudoers rule. - The commands allowed by the sudoers rule.
- Multiple can be added by passing a list of commands. - Multiple can be added by passing a list of commands.
- Use C(ALL) for all commands. - Use V(ALL) for all commands.
type: list type: list
elements: str elements: str
group: group:
description: description:
- The name of the group for the sudoers rule. - The name of the group for the sudoers rule.
- This option cannot be used in conjunction with I(user). - This option cannot be used in conjunction with O(user).
type: str type: str
name: name:
required: true required: true
@ -83,13 +83,13 @@ options:
user: user:
description: description:
- The name of the user for the sudoers rule. - The name of the user for the sudoers rule.
- This option cannot be used in conjunction with I(group). - This option cannot be used in conjunction with O(group).
type: str type: str
validation: validation:
description: description:
- If C(absent), the sudoers rule will be added without validation. - If V(absent), the sudoers rule will be added without validation.
- If C(detect) and visudo is available, then the sudoers rule will be validated by visudo. - If V(detect) and visudo is available, then the sudoers rule will be validated by visudo.
- If C(required), visudo must be available to validate the sudoers rule. - If V(required), visudo must be available to validate the sudoers rule.
type: str type: str
default: detect default: detect
choices: [ absent, detect, required ] choices: [ absent, detect, required ]

10
plugins/modules/supervisorctl.py
View file

@ -27,9 +27,9 @@ options:
type: str type: str
description: description:
- The name of the supervisord program or group to manage. - The name of the supervisord program or group to manage.
- The name will be taken as group name when it ends with a colon I(:) - The name will be taken as group name when it ends with a colon V(:).
- Group support is only available in Ansible version 1.6 or later. - Group support is only available in Ansible version 1.6 or later.
- If I(name=all), all programs and program groups will be managed. - If O(name=all), all programs and program groups will be managed.
required: true required: true
config: config:
type: path type: path
@ -62,9 +62,9 @@ options:
description: description:
- path to supervisorctl executable - path to supervisorctl executable
notes: notes:
- When C(state) = I(present), the module will call C(supervisorctl reread) then C(supervisorctl add) if the program/group does not exist. - When O(state=present), the module will call C(supervisorctl reread) then C(supervisorctl add) if the program/group does not exist.
- When C(state) = I(restarted), the module will call C(supervisorctl update) then call C(supervisorctl restart). - When O(state=restarted), the module will call C(supervisorctl update) then call C(supervisorctl restart).
- When C(state) = I(absent), the module will call C(supervisorctl reread) then C(supervisorctl remove) to remove the target program/group. - When O(state=absent), the module will call C(supervisorctl reread) then C(supervisorctl remove) to remove the target program/group.
requirements: [ "supervisorctl" ] requirements: [ "supervisorctl" ]
author: author:
- "Matt Wright (@mattupstate)" - "Matt Wright (@mattupstate)"

12
plugins/modules/svr4pkg.py
View file

@ -31,14 +31,14 @@ attributes:
options: options:
name: name:
description: description:
- Package name, e.g. C(SUNWcsr) - Package name, for example V(SUNWcsr).
required: true required: true
type: str type: str
state: state:
description: description:
- Whether to install (C(present)), or remove (C(absent)) a package. - Whether to install (V(present)), or remove (V(absent)) a package.
- If the package is to be installed, then I(src) is required. - If the package is to be installed, then O(src) is required.
- The SVR4 package system doesn't provide an upgrade operation. You need to uninstall the old, then install the new package. - The SVR4 package system doesn't provide an upgrade operation. You need to uninstall the old, then install the new package.
required: true required: true
choices: ["present", "absent"] choices: ["present", "absent"]
@ -46,13 +46,13 @@ options:
src: src:
description: description:
- Specifies the location to install the package from. Required when I(state=present). - Specifies the location to install the package from. Required when O(state=present).
- "Can be any path acceptable to the C(pkgadd) command's C(-d) option. e.g.: C(somefile.pkg), C(/dir/with/pkgs), C(http:/server/mypkgs.pkg)." - "Can be any path acceptable to the C(pkgadd) command's C(-d) option. For example: V(somefile.pkg), V(/dir/with/pkgs), V(http:/server/mypkgs.pkg)."
- If using a file or directory, they must already be accessible by the host. See the M(ansible.builtin.copy) module for a way to get them there. - If using a file or directory, they must already be accessible by the host. See the M(ansible.builtin.copy) module for a way to get them there.
type: str type: str
proxy: proxy:
description: description:
- HTTP[s] proxy to be used if I(src) is a URL. - HTTP[s] proxy to be used if O(src) is a URL.
type: str type: str
response_file: response_file:
description: description:

6
plugins/modules/swupd.py
View file

@ -50,8 +50,8 @@ options:
type: str type: str
state: state:
description: description:
- Indicates the desired (I)bundle state. C(present) ensures the bundle - Indicates the desired (I)bundle state. V(present) ensures the bundle
is installed while C(absent) ensures the (I)bundle is not installed. is installed while V(absent) ensures the (I)bundle is not installed.
default: present default: present
choices: [present, absent] choices: [present, absent]
type: str type: str
@ -62,7 +62,7 @@ options:
default: false default: false
url: url:
description: description:
- Overrides both I(contenturl) and I(versionurl). - Overrides both O(contenturl) and O(versionurl).
type: str type: str
verify: verify:
description: description:

22
plugins/modules/sysrc.py
View file

@ -33,28 +33,28 @@ options:
required: true required: true
value: value:
description: description:
- The value to set when I(state=present). - The value to set when O(state=present).
- The value to add when I(state=value_present). - The value to add when O(state=value_present).
- The value to remove when I(state=value_absent). - The value to remove when O(state=value_absent).
type: str type: str
state: state:
description: description:
- Use I(present) to add the variable. - Use V(present) to add the variable.
- Use I(absent) to remove the variable. - Use V(absent) to remove the variable.
- Use I(value_present) to add the value to the existing variable. - Use V(value_present) to add the value to the existing variable.
- Use I(value_absent) to remove the value from the existing variable. - Use V(value_absent) to remove the value from the existing variable.
type: str type: str
default: "present" default: "present"
choices: [ absent, present, value_present, value_absent ] choices: [ absent, present, value_present, value_absent ]
path: path:
description: description:
- Path to file to use instead of C(/etc/rc.conf). - Path to file to use instead of V(/etc/rc.conf).
type: str type: str
default: "/etc/rc.conf" default: "/etc/rc.conf"
delim: delim:
description: description:
- Delimiter to be used instead of C( ). - Delimiter to be used instead of V(" ") (space).
- Only used when I(state=value_present) or I(state=value_absent). - Only used when O(state=value_present) or O(state=value_absent).
default: " " default: " "
type: str type: str
jail: jail:
@ -62,7 +62,7 @@ options:
- Name or ID of the jail to operate on. - Name or ID of the jail to operate on.
type: str type: str
notes: notes:
- The C(name) cannot contain periods as sysrc does not support OID style names. - The O(name) cannot contain periods as sysrc does not support OID style names.
''' '''
EXAMPLES = r''' EXAMPLES = r'''

1
tests/sanity/ignore-2.11.txt
View file

@ -21,6 +21,7 @@ plugins/modules/parted.py validate-modules:parameter-state-invalid-choice
plugins/modules/rax_files_objects.py use-argspec-type-path # module deprecated - removed in 9.0.0 plugins/modules/rax_files_objects.py use-argspec-type-path # module deprecated - removed in 9.0.0
plugins/modules/rax_files.py validate-modules:parameter-state-invalid-choice # module deprecated - removed in 9.0.0 plugins/modules/rax_files.py validate-modules:parameter-state-invalid-choice # module deprecated - removed in 9.0.0
plugins/modules/rax.py use-argspec-type-path # module deprecated - removed in 9.0.0 plugins/modules/rax.py use-argspec-type-path # module deprecated - removed in 9.0.0
plugins/modules/read_csv.py validate-modules:invalid-documentation
plugins/modules/rhevm.py validate-modules:parameter-state-invalid-choice plugins/modules/rhevm.py validate-modules:parameter-state-invalid-choice
plugins/modules/xfconf.py validate-modules:return-syntax-error plugins/modules/xfconf.py validate-modules:return-syntax-error
tests/integration/targets/django_manage/files/base_test/simple_project/p1/manage.py compile-2.6 # django generated code tests/integration/targets/django_manage/files/base_test/simple_project/p1/manage.py compile-2.6 # django generated code

1
tests/sanity/ignore-2.12.txt
View file

@ -16,5 +16,6 @@ plugins/modules/parted.py validate-modules:parameter-state-invalid-choice
plugins/modules/rax_files_objects.py use-argspec-type-path # module deprecated - removed in 9.0.0 plugins/modules/rax_files_objects.py use-argspec-type-path # module deprecated - removed in 9.0.0
plugins/modules/rax_files.py validate-modules:parameter-state-invalid-choice # module deprecated - removed in 9.0.0 plugins/modules/rax_files.py validate-modules:parameter-state-invalid-choice # module deprecated - removed in 9.0.0
plugins/modules/rax.py use-argspec-type-path # module deprecated - removed in 9.0.0 plugins/modules/rax.py use-argspec-type-path # module deprecated - removed in 9.0.0
plugins/modules/read_csv.py validate-modules:invalid-documentation
plugins/modules/rhevm.py validate-modules:parameter-state-invalid-choice plugins/modules/rhevm.py validate-modules:parameter-state-invalid-choice
plugins/modules/xfconf.py validate-modules:return-syntax-error plugins/modules/xfconf.py validate-modules:return-syntax-error

1
tests/sanity/ignore-2.13.txt
View file

@ -16,5 +16,6 @@ plugins/modules/parted.py validate-modules:parameter-state-invalid-choice
plugins/modules/rax_files_objects.py use-argspec-type-path # module deprecated - removed in 9.0.0 plugins/modules/rax_files_objects.py use-argspec-type-path # module deprecated - removed in 9.0.0
plugins/modules/rax_files.py validate-modules:parameter-state-invalid-choice # module deprecated - removed in 9.0.0 plugins/modules/rax_files.py validate-modules:parameter-state-invalid-choice # module deprecated - removed in 9.0.0
plugins/modules/rax.py use-argspec-type-path # module deprecated - removed in 9.0.0 plugins/modules/rax.py use-argspec-type-path # module deprecated - removed in 9.0.0
plugins/modules/read_csv.py validate-modules:invalid-documentation
plugins/modules/rhevm.py validate-modules:parameter-state-invalid-choice plugins/modules/rhevm.py validate-modules:parameter-state-invalid-choice
plugins/modules/xfconf.py validate-modules:return-syntax-error plugins/modules/xfconf.py validate-modules:return-syntax-error

1
tests/sanity/ignore-2.14.txt
View file

@ -17,6 +17,7 @@ plugins/modules/parted.py validate-modules:parameter-state-invalid-choice
plugins/modules/rax_files_objects.py use-argspec-type-path # module deprecated - removed in 9.0.0 plugins/modules/rax_files_objects.py use-argspec-type-path # module deprecated - removed in 9.0.0
plugins/modules/rax_files.py validate-modules:parameter-state-invalid-choice # module deprecated - removed in 9.0.0 plugins/modules/rax_files.py validate-modules:parameter-state-invalid-choice # module deprecated - removed in 9.0.0
plugins/modules/rax.py use-argspec-type-path # module deprecated - removed in 9.0.0 plugins/modules/rax.py use-argspec-type-path # module deprecated - removed in 9.0.0
plugins/modules/read_csv.py validate-modules:invalid-documentation
plugins/modules/rhevm.py validate-modules:parameter-state-invalid-choice plugins/modules/rhevm.py validate-modules:parameter-state-invalid-choice
plugins/modules/udm_user.py import-3.11 # Uses deprecated stdlib library 'crypt' plugins/modules/udm_user.py import-3.11 # Uses deprecated stdlib library 'crypt'
plugins/modules/xfconf.py validate-modules:return-syntax-error plugins/modules/xfconf.py validate-modules:return-syntax-error