doc style adjustments: modules n*

This commit is contained in:
Alexei Znamensky 2025-07-23 18:56:57 +12:00
commit 3ce1262dcc
8 changed files with 72 additions and 70 deletions

View file

@ -22,11 +22,6 @@ description:
- The C(nagios) module is not idempotent. - The C(nagios) module is not idempotent.
- All actions require the O(host) parameter to be given explicitly. In playbooks you can use the C({{inventory_hostname}}) - All actions require the O(host) parameter to be given explicitly. In playbooks you can use the C({{inventory_hostname}})
variable to refer to the host the playbook is currently running on. variable to refer to the host the playbook is currently running on.
- You can specify multiple services at once by separating them with commas, for example O(services=httpd,nfs,puppet).
- When specifying what service to handle there is a special service value, O(host), which will handle alerts/downtime/acknowledge
for the I(host itself), for example O(services=host). This keyword may not be given with other services at the same time.
B(Setting alerts/downtime/acknowledge for a host does not affect alerts/downtime/acknowledge for any of the services running
on it.) To schedule downtime for all services on particular host use keyword "all", for example O(services=all).
extends_documentation_fragment: extends_documentation_fragment:
- community.general.attributes - community.general.attributes
attributes: attributes:
@ -88,6 +83,12 @@ options:
description: description:
- What to manage downtime/alerts for. Separate multiple services with commas. - What to manage downtime/alerts for. Separate multiple services with commas.
- 'B(Required) option when O(action) is one of: V(downtime), V(acknowledge), V(forced_check), V(enable_alerts), V(disable_alerts).' - 'B(Required) option when O(action) is one of: V(downtime), V(acknowledge), V(forced_check), V(enable_alerts), V(disable_alerts).'
- You can specify multiple services at once by separating them with commas, for example O(services=httpd,nfs,puppet).
- When specifying what O(services) to handle there is a special service value, V(host), which handles alerts/downtime/acknowledge
for the I(host itself), for example O(services=host). This keyword may not be given with other services at the same
time. B(Setting alerts/downtime/acknowledge for a host does not affect alerts/downtime/acknowledge for any of the
services running on it.) To schedule downtime for all O(services) on particular host use keyword V(all), for example
O(services=all).
aliases: ["service"] aliases: ["service"]
type: str type: str
servicegroup: servicegroup:
@ -97,8 +98,8 @@ options:
type: str type: str
command: command:
description: description:
- The raw command to send to nagios, which should not include the submitted time header or the line-feed. - The raw command to send to Nagios, which should not include the submitted time header or the line-feed.
- B(Required) option when using the V(command) O(action). - B(Required) option when O(action=command).
type: str type: str
author: "Tim Bielawa (@tbielawa)" author: "Tim Bielawa (@tbielawa)"

View file

@ -68,7 +68,7 @@ options:
default: false default: false
description: description:
- Whether the record should be the only one for that record type and record name. Only use with O(state=present). - Whether the record should be the only one for that record type and record name. Only use with O(state=present).
- This will delete all other records with the same record name and type. - This deletes all other records with the same record name and type.
priority: priority:
description: description:
- Record priority. Required for O(type=MX). - Record priority. Required for O(type=MX).

View file

@ -62,8 +62,8 @@ options:
required: false required: false
validate_certs: validate_certs:
description: description:
- If V(false), SSL certificates will not be validated. This should only be used on personally controlled sites using - If V(false), SSL certificates are not validated. This should only be used on personally controlled sites using self-signed
self-signed certificates. certificates.
required: false required: false
default: true default: true
type: bool type: bool

View file

@ -45,12 +45,12 @@ options:
msg: msg:
type: str type: str
description: description:
- Message to text to send. Messages longer than 160 characters will be split into multiple messages. - Message text to send. Messages longer than 160 characters are split into multiple messages.
required: true required: true
validate_certs: validate_certs:
description: description:
- If V(false), SSL certificates will not be validated. This should only be used on personally controlled sites using - If V(false), SSL certificates are not validated. This should only be used on personally controlled sites using self-signed
self-signed certificates. certificates.
type: bool type: bool
default: true default: true
extends_documentation_fragment: extends_documentation_fragment:

View file

@ -35,7 +35,7 @@ options:
type: str type: str
etherstub: etherstub:
description: description:
- Specifies that the nic tag will be attached to a created O(etherstub). - Specifies that the nic tag is attached to a created O(etherstub).
- Parameter O(etherstub) is mutually exclusive with both O(mtu), and O(mac). - Parameter O(etherstub) is mutually exclusive with both O(mtu), and O(mac).
type: bool type: bool
default: false default: false
@ -46,7 +46,7 @@ options:
type: int type: int
force: force:
description: description:
- When O(state=absent) this switch will use the C(-f) parameter and delete the nic tag regardless of existing VMs. - When O(state=absent) this switch uses the C(-f) parameter and delete the nic tag regardless of existing VMs.
type: bool type: bool
default: false default: false
state: state:
@ -83,7 +83,7 @@ mac:
type: str type: str
sample: 00:1b:21:a3:f5:4d sample: 00:1b:21:a3:f5:4d
etherstub: etherstub:
description: Specifies if the nic tag will create and attach to an etherstub. description: Specifies if the nic tag was created and attached to an etherstub.
returned: always returned: always
type: bool type: bool
sample: false sample: false
@ -93,7 +93,7 @@ mtu:
type: int type: int
sample: 1500 sample: 1500
force: force:
description: Shows if -f was used during the deletion of a nic tag. description: Shows if C(-f) was used during the deletion of a nic tag.
returned: always returned: always
type: bool type: bool
sample: false sample: false

View file

@ -21,10 +21,10 @@ extends_documentation_fragment:
description: description:
- Manage the network devices. Create, modify and manage various connection and device type, for example V(ethernet), V(team), - Manage the network devices. Create, modify and manage various connection and device type, for example V(ethernet), V(team),
V(bond), V(vlan) and so on. V(bond), V(vlan) and so on.
- 'On CentOS 8 and Fedora >=29 like systems, the requirements can be met by installing the following packages: NetworkManager.' - 'On CentOS 8 and Fedora >=29 like systems, the requirements can be met by installing the following packages: C(NetworkManager).'
- 'On CentOS 7 and Fedora <=28 like systems, the requirements can be met by installing the following packages: NetworkManager-tui.' - 'On CentOS 7 and Fedora <=28 like systems, the requirements can be met by installing the following packages: C(NetworkManager-tui).'
- 'On Ubuntu and Debian like systems, the requirements can be met by installing the following packages: network-manager.' - 'On Ubuntu and Debian like systems, the requirements can be met by installing the following packages: C(network-manager).'
- 'On openSUSE, the requirements can be met by installing the following packages: NetworkManager.' - 'On openSUSE, the requirements can be met by installing the following packages: C(NetworkManager).'
attributes: attributes:
check_mode: check_mode:
support: full support: full
@ -34,8 +34,8 @@ options:
state: state:
description: description:
- Whether the device should exist or not, taking action if the state is different from what is stated. - Whether the device should exist or not, taking action if the state is different from what is stated.
- Using O(state=present) to create connection will automatically bring connection up. - Using O(state=present) creates connection set to be brought up automaticall.
- Using O(state=up) and O(state=down) will not modify connection with other parameters. These states have been added - Using O(state=up) and O(state=down) does not modify connection with other parameters. These states have been added
in community.general 9.5.0. in community.general 9.5.0.
type: str type: str
required: true required: true
@ -48,7 +48,7 @@ options:
default: true default: true
autoconnect_priority: autoconnect_priority:
description: description:
- The priority of the connection profile for autoconnect. If set, connection profiles with higher priority will be preferred. - The priority of the connection profile for autoconnect. If set, connection profiles with higher priority are preferred.
type: int type: int
version_added: 11.0.0 version_added: 11.0.0
autoconnect_retries: autoconnect_retries:
@ -71,7 +71,7 @@ options:
ifname: ifname:
description: description:
- The interface to bind the connection to. - The interface to bind the connection to.
- The connection will only be applicable to this interface name. - The connection is only applicable to this interface name.
- A special value of V(*) can be used for interface-independent connections. - A special value of V(*) can be used for interface-independent connections.
- The ifname argument is mandatory for all connection types except bond, team, bridge, vlan and vpn. - The ifname argument is mandatory for all connection types except bond, team, bridge, vlan and vpn.
- This parameter defaults to O(conn_name) when left unset for all connection types except vpn that removes it. - This parameter defaults to O(conn_name) when left unset for all connection types except vpn that removes it.
@ -501,7 +501,7 @@ options:
runner_fast_rate: runner_fast_rate:
description: description:
- Option specifies the rate at which our link partner is asked to transmit LACPDU packets. If this is V(true) then packets - Option specifies the rate at which our link partner is asked to transmit LACPDU packets. If this is V(true) then packets
will be sent once per second. Otherwise they will be sent every 30 seconds. are sent once per second. Otherwise they are sent every 30 seconds.
- Only allowed for O(runner=lacp). - Only allowed for O(runner=lacp).
type: bool type: bool
version_added: 6.5.0 version_added: 6.5.0
@ -595,7 +595,7 @@ options:
- Indicates whether Fast Initial Link Setup (802.11ai) must be enabled for the connection. - Indicates whether Fast Initial Link Setup (802.11ai) must be enabled for the connection.
- One of V(0) (use global default value), V(1) (disable FILS), V(2) (enable FILS if the supplicant and the access - One of V(0) (use global default value), V(1) (disable FILS), V(2) (enable FILS if the supplicant and the access
point support it) or V(3) (enable FILS and fail if not supported). point support it) or V(3) (enable FILS and fail if not supported).
- When set to V(0) and no global default is set, FILS will be optionally enabled. - When set to V(0) and no global default is set, FILS is optionally enabled.
type: int type: int
choices: [0, 1, 2, 3] choices: [0, 1, 2, 3]
default: 0 default: 0
@ -639,7 +639,7 @@ options:
- Indicates whether Protected Management Frames (802.11w) must be enabled for the connection. - Indicates whether Protected Management Frames (802.11w) must be enabled for the connection.
- One of V(0) (use global default value), V(1) (disable PMF), V(2) (enable PMF if the supplicant and the access - One of V(0) (use global default value), V(1) (disable PMF), V(2) (enable PMF if the supplicant and the access
point support it) or V(3) (enable PMF and fail if not supported). point support it) or V(3) (enable PMF and fail if not supported).
- When set to V(0) and no global default is set, PMF will be optionally enabled. - When set to V(0) and no global default is set, PMF is optionally enabled.
type: int type: int
choices: [0, 1, 2, 3] choices: [0, 1, 2, 3]
default: 0 default: 0
@ -672,8 +672,8 @@ options:
description: description:
- Controls the interpretation of WEP keys. - Controls the interpretation of WEP keys.
- Allowed values are V(1), in which case the key is either a 10- or 26-character hexadecimal string, or a 5- or - Allowed values are V(1), in which case the key is either a 10- or 26-character hexadecimal string, or a 5- or
13-character ASCII password; or V(2), in which case the passphrase is provided as a string and will be hashed 13-character ASCII password; or V(2), in which case the passphrase is provided as a string and it is hashed using
using the de-facto MD5 method to derive the actual WEP key. the de-facto MD5 method to derive the actual WEP key.
type: int type: int
choices: [1, 2] choices: [1, 2]
wep-key0: wep-key0:
@ -708,8 +708,8 @@ options:
wps-method: wps-method:
description: description:
- Flags indicating which mode of WPS is to be used if any. - Flags indicating which mode of WPS is to be used if any.
- There is little point in changing the default setting as NetworkManager will automatically determine whether it - There is little point in changing the default setting as NetworkManager automatically determines whether it is
is feasible to start WPS enrollment from the Access Point capabilities. feasible to start WPS enrollment from the Access Point capabilities.
- WPS can be disabled by setting this property to a value of V(1). - WPS can be disabled by setting this property to a value of V(1).
type: int type: int
default: 0 default: 0
@ -753,8 +753,8 @@ options:
description: description:
- 802.11 frequency band of the network. - 802.11 frequency band of the network.
- One of V(a) for 5GHz 802.11a or V(bg) for 2.4GHz 802.11. - One of V(a) for 5GHz 802.11a or V(bg) for 2.4GHz 802.11.
- This will lock associations to the Wi-Fi network to the specific band, so for example, if V(a) is specified, the - This locks associations to the Wi-Fi network to the specific band, so for example, if V(a) is specified, the device
device will not associate with the same network in the 2.4GHz band even if the network's settings are compatible. does not associate with the same network in the 2.4GHz band even if the network's settings are compatible.
- This setting depends on specific driver capability and may not work with all drivers. - This setting depends on specific driver capability and may not work with all drivers.
type: str type: str
choices: [a, bg] choices: [a, bg]
@ -767,7 +767,7 @@ options:
channel: channel:
description: description:
- Wireless channel to use for the Wi-Fi connection. - Wireless channel to use for the Wi-Fi connection.
- The device will only join (or create for Ad-Hoc networks) a Wi-Fi network on the specified channel. - The device only joins (or creates for Ad-Hoc networks) a Wi-Fi network on the specified channel.
- Because channel numbers overlap between bands, this property also requires the O(wifi.band) property to be set. - Because channel numbers overlap between bands, this property also requires the O(wifi.band) property to be set.
type: int type: int
default: 0 default: 0
@ -782,7 +782,7 @@ options:
- With O(wifi.cloned-mac-address) setting V(random) or V(stable), by default all bits of the MAC address are scrambled - With O(wifi.cloned-mac-address) setting V(random) or V(stable), by default all bits of the MAC address are scrambled
and a locally-administered, unicast MAC address is created. This property allows to specify that certain bits and a locally-administered, unicast MAC address is created. This property allows to specify that certain bits
are fixed. are fixed.
- Note that the least significant bit of the first MAC address will always be unset to create a unicast MAC address. - Note that the least significant bit of the first MAC address is always unset to create a unicast MAC address.
- If the property is V(null), it is eligible to be overwritten by a default connection setting. - If the property is V(null), it is eligible to be overwritten by a default connection setting.
- If the value is still V(null) or an empty string, the default is to create a locally-administered, unicast MAC - If the value is still V(null) or an empty string, the default is to create a locally-administered, unicast MAC
address. address.
@ -792,12 +792,12 @@ options:
3 bytes using the V(random) or V(stable) algorithm. 3 bytes using the V(random) or V(stable) algorithm.
- If the value contains one additional MAC address after the mask, this address is used instead of the current MAC - If the value contains one additional MAC address after the mask, this address is used instead of the current MAC
address to fill the bits that shall not be randomized. address to fill the bits that shall not be randomized.
- For example, a value of V(FE:FF:FF:00:00:00 68:F7:28:00:00:00) will set the OUI of the MAC address to 68:F7:28, - For example, a value of V(FE:FF:FF:00:00:00 68:F7:28:00:00:00) sets the OUI of the MAC address to 68:F7:28, while
while the lower bits are randomized. the lower bits are randomized.
- A value of V(02:00:00:00:00:00 00:00:00:00:00:00) will create a fully scrambled globally-administered, burned-in - A value of V(02:00:00:00:00:00 00:00:00:00:00:00) creates a fully scrambled globally-administered, burned-in MAC
MAC address. address.
- If the value contains more than one additional MAC addresses, one of them is chosen randomly. For example, V(02:00:00:00:00:00 - If the value contains more than one additional MAC addresses, one of them is chosen randomly. For example, V(02:00:00:00:00:00
00:00:00:00:00:00 02:00:00:00:00:00) will create a fully scrambled MAC address, randomly locally or globally administered. 00:00:00:00:00:00 02:00:00:00:00:00) creates a fully scrambled MAC address, randomly locally or globally administered.
type: str type: str
hidden: hidden:
description: description:
@ -827,7 +827,7 @@ options:
choices: [0, 1, 2] choices: [0, 1, 2]
mac-address: mac-address:
description: description:
- If specified, this connection will only apply to the Wi-Fi device whose permanent MAC address matches. - If specified, this connection only applies to the Wi-Fi device whose permanent MAC address matches.
- This property does not change the MAC address of the device (for example for MAC spoofing). - This property does not change the MAC address of the device (for example for MAC spoofing).
type: str type: str
mode: mode:
@ -896,25 +896,25 @@ options:
apn: apn:
description: description:
- The GPRS Access Point Name specifying the APN used when establishing a data session with the GSM-based network. - The GPRS Access Point Name specifying the APN used when establishing a data session with the GSM-based network.
- The APN often determines how the user will be billed for their network usage and whether the user has access to - The APN often determines how the user is billed for their network usage and whether the user has access to the
the Internet or just a provider-specific walled-garden, so it is important to use the correct APN for the user's Internet or just a provider-specific walled-garden, so it is important to use the correct APN for the user's mobile
mobile broadband plan. broadband plan.
- The APN may only be composed of the characters a-z, 0-9, ., and - per GSM 03.60 Section 14.9. - The APN may only be composed of the characters a-z, 0-9, ., and - per GSM 03.60 Section 14.9.
type: str type: str
auto-config: auto-config:
description: When V(true), the settings such as O(gsm.apn), O(gsm.username), or O(gsm.password) will default to values description: When V(true), the settings such as O(gsm.apn), O(gsm.username), or O(gsm.password) default to values
that match the network the modem will register to in the Mobile Broadband Provider database. that match the network the modem registers to in the Mobile Broadband Provider database.
type: bool type: bool
default: false default: false
device-id: device-id:
description: description:
- The device unique identifier (as given by the V(WWAN) management service) which this connection applies to. - The device unique identifier (as given by the V(WWAN) management service) which this connection applies to.
- If given, the connection will only apply to the specified device. - If given, the connection only applies to the specified device.
type: str type: str
home-only: home-only:
description: description:
- When V(true), only connections to the home network will be allowed. - When V(true), only connections to the home network are allowed.
- Connections to roaming networks will not be made. - Connections to roaming networks are not made.
type: bool type: bool
default: false default: false
mtu: mtu:
@ -925,7 +925,7 @@ options:
network-id: network-id:
description: description:
- The Network ID (GSM LAI format, ie MCC-MNC) to force specific network registration. - The Network ID (GSM LAI format, ie MCC-MNC) to force specific network registration.
- If the Network ID is specified, NetworkManager will attempt to force the device to register only on the specified - If the Network ID is specified, NetworkManager attempts to force the device to register only on the specified
network. network.
- This can be used to ensure that the device does not roam when direct roaming control of the device is not otherwise - This can be used to ensure that the device does not roam when direct roaming control of the device is not otherwise
possible. possible.
@ -944,7 +944,7 @@ options:
- NMSettingSecretFlags indicating how to handle the O(gsm.password) property. - NMSettingSecretFlags indicating how to handle the O(gsm.password) property.
- 'Following choices are allowed: V(0) B(NONE): The system is responsible for providing and storing this secret - 'Following choices are allowed: V(0) B(NONE): The system is responsible for providing and storing this secret
(default), V(1) B(AGENT_OWNED): A user secret agent is responsible for providing and storing this secret; when (default), V(1) B(AGENT_OWNED): A user secret agent is responsible for providing and storing this secret; when
it is required agents will be asked to retrieve it V(2) B(NOT_SAVED): This secret should not be saved, but should it is required agents are asked to retrieve it V(2) B(NOT_SAVED): This secret should not be saved, but should
be requested from the user each time it is needed V(4) B(NOT_REQUIRED): In situations where it cannot be automatically be requested from the user each time it is needed V(4) B(NOT_REQUIRED): In situations where it cannot be automatically
determined that the secret is required (some VPNs and PPP providers do not require all secrets) this flag indicates determined that the secret is required (some VPNs and PPP providers do not require all secrets) this flag indicates
that the specific secret is not required.' that the specific secret is not required.'
@ -966,14 +966,14 @@ options:
sim-id: sim-id:
description: description:
- The SIM card unique identifier (as given by the C(WWAN) management service) which this connection applies to. - The SIM card unique identifier (as given by the C(WWAN) management service) which this connection applies to.
- If given, the connection will apply to any device also allowed by O(gsm.device-id) which contains a SIM card matching - If given, the connection applies to any device also allowed by O(gsm.device-id) which contains a SIM card matching
the given identifier. the given identifier.
type: str type: str
sim-operator-id: sim-operator-id:
description: description:
- A MCC/MNC string like V(310260) or V(21601I) identifying the specific mobile network operator which this connection - A MCC/MNC string like V(310260) or V(21601I) identifying the specific mobile network operator which this connection
applies to. applies to.
- If given, the connection will apply to any device also allowed by O(gsm.device-id) and O(gsm.sim-id) which contains - If given, the connection applies to any device also allowed by O(gsm.device-id) and O(gsm.sim-id) which contains
a SIM card provisioned by the given operator. a SIM card provisioned by the given operator.
type: str type: str
username: username:
@ -1032,8 +1032,8 @@ options:
ip4-auto-default-route: ip4-auto-default-route:
description: description:
- Whether to enable special handling of the IPv4 default route. - Whether to enable special handling of the IPv4 default route.
- If enabled, the IPv4 default route from O(wireguard.peer-routes) will be placed to a dedicated routing-table and - If enabled, the IPv4 default route from O(wireguard.peer-routes) is placed to a dedicated routing-table and two
two policy routing rules will be added. policy routing rules are added.
- The fwmark number is also used as routing-table for the default-route, and if fwmark is zero, an unused fwmark/table - The fwmark number is also used as routing-table for the default-route, and if fwmark is zero, an unused fwmark/table
is chosen automatically. This corresponds to what wg-quick does with Table=auto and what WireGuard calls "Improved is chosen automatically. This corresponds to what wg-quick does with Table=auto and what WireGuard calls "Improved
Rule-based Routing". Rule-based Routing".
@ -1043,7 +1043,7 @@ options:
- Like O(wireguard.ip4-auto-default-route), but for the IPv6 default route. - Like O(wireguard.ip4-auto-default-route), but for the IPv6 default route.
type: bool type: bool
listen-port: listen-port:
description: The WireGuard connection listen-port. If not specified, the port will be chosen randomly when the interface description: The WireGuard connection listen-port. If not specified, the port is chosen randomly when the interface
comes up. comes up.
type: int type: int
mtu: mtu:
@ -1056,12 +1056,12 @@ options:
peer-routes: peer-routes:
description: description:
- Whether to automatically add routes for the AllowedIPs ranges of the peers. - Whether to automatically add routes for the AllowedIPs ranges of the peers.
- If V(true) (the default), NetworkManager will automatically add routes in the routing tables according to C(ipv4.route-table) - If V(true) (the default), NetworkManager automatically adds routes in the routing tables according to C(ipv4.route-table)
and C(ipv6.route-table). Usually you want this automatism enabled. and C(ipv6.route-table). Usually you want this automatism enabled.
- If V(false), no such routes are added automatically. In this case, the user may want to configure static routes - If V(false), no such routes are added automatically. In this case, the user may want to configure static routes
in C(ipv4.routes) and C(ipv6.routes), respectively. in C(ipv4.routes) and C(ipv6.routes), respectively.
- Note that if the peer's AllowedIPs is V(0.0.0.0/0) or V(::/0) and the profile's C(ipv4.never-default) or C(ipv6.never-default) - Note that if the peer's AllowedIPs is V(0.0.0.0/0) or V(::/0) and the profile's C(ipv4.never-default) or C(ipv6.never-default)
setting is enabled, the peer route for this peer will not be added automatically. setting is enabled, the peer route for this peer is not added automatically.
type: bool type: bool
private-key: private-key:
description: The 256 bit private-key in base64 encoding. description: The 256 bit private-key in base64 encoding.
@ -1079,7 +1079,7 @@ options:
version_added: 5.1.0 version_added: 5.1.0
suboptions: suboptions:
permissions: permissions:
description: User that will have permission to use the connection. description: User that has permission to use the connection.
type: str type: str
required: true required: true
service-type: service-type:
@ -1096,7 +1096,7 @@ options:
- NMSettingSecretFlags indicating how to handle the C(vpn.password) property. - NMSettingSecretFlags indicating how to handle the C(vpn.password) property.
- 'Following choices are allowed: V(0) B(NONE): The system is responsible for providing and storing this secret - 'Following choices are allowed: V(0) B(NONE): The system is responsible for providing and storing this secret
(default); V(1) B(AGENT_OWNED): A user secret agent is responsible for providing and storing this secret; when (default); V(1) B(AGENT_OWNED): A user secret agent is responsible for providing and storing this secret; when
it is required agents will be asked to retrieve it; V(2) B(NOT_SAVED): This secret should not be saved, but should it is required agents are asked to retrieve it; V(2) B(NOT_SAVED): This secret should not be saved, but should
be requested from the user each time it is needed; V(4) B(NOT_REQUIRED): In situations where it cannot be automatically be requested from the user each time it is needed; V(4) B(NOT_REQUIRED): In situations where it cannot be automatically
determined that the secret is required (some VPNs and PPP providers do not require all secrets) this flag indicates determined that the secret is required (some VPNs and PPP providers do not require all secrets) this flag indicates
that the specific secret is not required.' that the specific secret is not required.'
@ -1115,7 +1115,8 @@ options:
ipsec-psk: ipsec-psk:
description: description:
- The pre-shared key in base64 encoding. - The pre-shared key in base64 encoding.
- "You can encode using this Ansible jinja2 expression: V(\"0s{{ '[YOUR PRE-SHARED KEY]' | ansible.builtin.b64encode }}\")." - >
You can encode using this Ansible Jinja2 expression: V("0s{{ '[YOUR PRE-SHARED KEY]' | ansible.builtin.b64encode }}").
- This is only used when O(vpn.ipsec-enabled=true). - This is only used when O(vpn.ipsec-enabled=true).
type: str type: str
sriov: sriov:

View file

@ -35,22 +35,22 @@ options:
required: false required: false
choices: [started, stopped, reset, restarted, reloaded] choices: [started, stopped, reset, restarted, reloaded]
description: description:
- V(started)/V(stopped) are idempotent actions that will not run commands unless necessary. - V(started)/V(stopped) are idempotent actions that do not run commands unless necessary.
- V(restarted) will always bounce the service. - V(restarted) always bounces the service.
- V(reloaded) will send a SIGHUP or start the service. - V(reloaded) sends a SIGHUP or starts the service.
- V(reset) will start or stop the service according to whether it is enabled or not. - V(reset) starts or stops the service according to whether it is enabled or not.
enabled: enabled:
required: false required: false
type: bool type: bool
description: description:
- Enable or disable the service, independently of C(*.preset) file preference or running state. Mutually exclusive with - Enable or disable the service, independently of C(*.preset) file preference or running state. Mutually exclusive with
O(preset). Will take effect prior to O(state=reset). O(preset). It takes effect prior to O(state=reset).
preset: preset:
required: false required: false
type: bool type: bool
description: description:
- Enable or disable the service according to local preferences in C(*.preset) files. Mutually exclusive with O(enabled). - Enable or disable the service according to local preferences in C(*.preset) files. Mutually exclusive with O(enabled).
Only has an effect if set to true. Will take effect prior to O(state=reset). Only has an effect if set to true. It takes effect prior to O(state=reset).
user: user:
required: false required: false
default: false default: false

View file

@ -63,8 +63,8 @@ options:
type: str type: str
zone: zone:
description: description:
- DNS record will be modified on this O(zone). - DNS record is modified on this O(zone).
- When omitted DNS will be queried to attempt finding the correct zone. - When omitted DNS, is queried to attempt finding the correct zone.
type: str type: str
record: record:
description: description: