diff --git a/changelogs/fragments/T9419_ospf_interfaces_passive_area.yml b/changelogs/fragments/T9419_ospf_interfaces_passive_area.yml
new file mode 100644
index 00000000..ecf1c79f
--- /dev/null
+++ b/changelogs/fragments/T9419_ospf_interfaces_passive_area.yml
@@ -0,0 +1,9 @@
+---
+bugfixes:
+ - vyos_ospf_interfaces - passive false for ipv4 renders "passive disable", which exempts the
+ interface from passive-interface default, and "passive disable" on the device is read back as
+ passive false; before, passive false rendered nothing and the exemption was not recognised
+ (T9419). For ipv6, OSPFv3 has no such exemption, so passive false means not passive.
+minor_changes:
+ - vyos_ospf_interfaces - new option address_family.area, the OSPF area of an interface (VyOS 1.4
+ and later).
diff --git a/docs/vyos.vyos.vyos_ospf_interfaces_module.rst b/docs/vyos.vyos.vyos_ospf_interfaces_module.rst
index 9cf292a9..a1c7be18 100644
--- a/docs/vyos.vyos.vyos_ospf_interfaces_module.rst
+++ b/docs/vyos.vyos.vyos_ospf_interfaces_module.rst
@@ -1,1320 +1,1339 @@
.. _vyos.vyos.vyos_ospf_interfaces_module:
******************************
vyos.vyos.vyos_ospf_interfaces
******************************
**OSPF Interfaces Resource Module.**
Version added: 1.2.0
.. contents::
:local:
:depth: 1
Synopsis
--------
- This module manages OSPF configuration of interfaces on devices running VYOS.
- The provided examples of commands are valid for VyOS 1.4+
Parameters
----------
.. raw:: html
| Parameter |
Choices/Defaults |
Comments |
|
config
list
/ elements=dictionary
|
|
A list of OSPF configuration for interfaces.
|
|
address_family
list
/ elements=dictionary
|
|
OSPF settings on the interfaces in address-family context.
|
|
|
afi
string
/ required
|
|
Address Family Identifier (AFI) for OSPF settings on the interfaces.
|
+
+ |
+ |
+
+
+ area
+
+
+ string
+
+ |
+
+ |
+
+ OSPF area of the interface, as a number or in dotted-decimal notation.
+ Supported on VyOS 1.4 and later.
+ |
+
|
|
authentication
dictionary
|
|
Authentication settings on the interface.
|
|
|
|
md5_key
dictionary
|
|
md5 parameters.
|
|
|
|
|
key
string
|
|
md5 key.
|
|
|
|
|
key_id
integer
|
|
key id.
|
|
|
|
plaintext_password
string
|
|
Plain Text password.
|
|
|
bandwidth
integer
|
|
Bandwidth of interface (kilobits/sec)
|
|
|
cost
integer
|
|
metric associated with interface.
|
|
|
dead_interval
integer
|
|
Time interval to detect a dead router.
|
|
|
hello_interval
integer
|
|
Timer interval between transmission of hello packets.
|
|
|
ifmtu
integer
|
|
interface MTU.
|
|
|
instance
string
|
|
Instance ID.
|
|
|
mtu_ignore
boolean
|
|
if True, Disable MTU check for Database Description packets.
|
|
|
network
string
|
|
Interface type.
|
|
|
passive
boolean
|
|
If True, disables forming adjacency.
+ For ipv4, false exempts the interface from passive-interface default (passive disable). OSPFv3 has no such exemption, so for ipv6, false means the interface is not passive.
|
|
|
priority
integer
|
|
Interface priority.
|
|
|
retransmit_interval
integer
|
|
LSA retransmission interval.
|
|
|
transmit_delay
integer
|
|
LSA transmission delay.
|
|
name
string
|
|
Name/Identifier of the interface.
|
|
running_config
string
|
|
This option is used only with state parsed.
The value of this option should be the output received from the VYOS device by executing the command show configuration commands | match "set interfaces".
The state parsed reads the configuration from running_config option and transforms it into Ansible structured data as per the resource module's argspec and the value is then returned in the parsed key within the result.
|
|
state
string
|
Choices:
merged ←
- replaced
- overridden
- deleted
- gathered
- parsed
- rendered
|
The state the configuration should be left in.
|