bfd

bfd
+  micro-bfd-sessions
   +  lag-interface name reference 
      +  admin-state keyword
      +  desired-minimum-transmit-interval number
      +  detection-multiplier number
      +  local-address (ipv4-address | ipv6-address)
      -  member-interface name string 
         -  active-receive-interval number
         -  active-transmit-interval number
         -  async
            -  last-clear string
            -  last-packet-received string
            -  last-packet-transmitted string
            -  received-errored-packets number
            -  received-packets number
            -  transmitted-packets number
            -  up-transitions number
         -  failure-transitions number
         -  last-failure-time string
         -  last-state-transition string
         -  local-diagnostic-code keyword
         -  local-discriminator number
         -  remote-control-plane-independent boolean
         -  remote-diagnostic-code keyword
         -  remote-discriminator number
         -  remote-minimum-receive-interval number
         -  remote-multiplier number
         -  remote-session-state keyword
         -  session-state keyword
      +  remote-address (ipv4-address | ipv6-address)
      +  required-minimum-receive number
-  network-instance name string 
   -  peer local-discriminator number 
      -  active-receive-interval number
      -  active-transmit-interval number
      -  async
         -  last-clear string
         -  last-packet-received string
         -  last-packet-transmitted string
         -  received-errored-packets number
         -  received-packets number
         -  transmitted-packets number
         -  up-transitions number
      -  failure-transitions number
      -  ipv6-link-local-interface string
      -  last-failure-time string
      -  last-state-transition string
      -  local-address (ipv4-address | ipv6-address)
      -  local-diagnostic-code keyword
      -  oper-state keyword
      -  remote-address (ipv4-address | ipv6-address)
      -  remote-control-plane-independent boolean
      -  remote-diagnostic-code keyword
      -  remote-discriminator number
      -  remote-minimum-receive-interval number
      -  remote-multiplier number
      -  remote-session-state keyword
      -  session-state keyword
      -  subscribed-protocols string
+  subinterface id string 
   +  admin-state keyword
   +  desired-minimum-transmit-interval number
   +  detection-multiplier number
   +  minimum-echo-receive-interval number
   +  required-minimum-receive number
-  total-bfd-sessions number
-  total-unmatched-bfd-packets number

bfd Descriptions

bfd

Description Context to configure BFD parameters and report BFD sessions state
Contextbfd
Treebfd
ConfigurableTrue
PlatformsSupported on all platforms

micro-bfd-sessions

Description Context to configure micro-BFD session parameters and report sessions state
Contextbfd micro-bfd-sessions
Treemicro-bfd-sessions
ConfigurableTrue
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10

lag-interface name reference

Description List of ethernet interface references to associate a micro-BFD session config and state
Contextbfd micro-bfd-sessions lag-interface name reference
Treelag-interface
ConfigurableTrue
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
name reference
Description Reference ID for associated lag interface Example: lag1 (Reference Interface lag1).
Contextbfd micro-bfd-sessions lag-interface name reference
Referenceinterface name string
ConfigurableTrue
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
admin-state keyword
Description Administratively enable or disable BFD for this subinterface
Contextbfd micro-bfd-sessions lag-interface name reference admin-state keyword
Treeadmin-state
Defaultdisable
Options
  • enable

  • disable

Configurable True
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
desired-minimum-transmit-interval number
Description

The minimum interval between transmission of BFD control packets

This value is advertised to the peer, however the actual interval used is specified by taking the maximum of desired-minimum-transmit-interval and the value of the remote required-minimum-receive interval value. This value is specified as an integer number of microseconds.

Contextbfd micro-bfd-sessions lag-interface name reference desired-minimum-transmit-interval number
Treedesired-minimum-transmit-interval
Range10000 to 100000000
Default1000000
Unitsmicroseconds
ConfigurableTrue
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
detection-multiplier number
Description

The number of packets that must be missed to declare this session as down

The detection interval for the BFD session is calculated by multiplying the value of the negotiated transmission interval by this value.

Contextbfd micro-bfd-sessions lag-interface name reference detection-multiplier number
Treedetection-multiplier
Range3 to 20
Default3
ConfigurableTrue
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
local-address (ipv4-address | ipv6-address)
Description IP address to be used as source address in BFD packets
Contextbfd micro-bfd-sessions lag-interface name reference local-address (ipv4-address | ipv6-address)
Treelocal-address
ConfigurableTrue
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
member-interface name string
Description List of ethernet interface references to associate a micro-BFD session config and state
Contextbfd micro-bfd-sessions lag-interface name reference member-interface name string
Treemember-interface
ConfigurableFalse
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
name string
Description Reference ID for associated ethernet interface Example: ethernet-2/1 (Reference Interface ethernet-2/1).
Contextbfd micro-bfd-sessions lag-interface name reference member-interface name string
ConfigurableFalse
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
active-receive-interval number
Description

The receive interval currently being used by this BFD session

This is the amount of time the BFD state machine expects between receiving BFD messages from the remote peer.

Contextbfd micro-bfd-sessions lag-interface name reference member-interface name string active-receive-interval number
Treeactive-receive-interval
ConfigurableFalse
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
active-transmit-interval number
Description

The transmit interval currently being used by this BFD session

This is the amount of time the local BFD agent will wait between the sending of BFD messages to the remote peer

Contextbfd micro-bfd-sessions lag-interface name reference member-interface name string active-transmit-interval number
Treeactive-transmit-interval
ConfigurableFalse
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
async
Description Container for async BFD operational state parameters
Contextbfd micro-bfd-sessions lag-interface name reference member-interface name string async
Treeasync
ConfigurableFalse
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
last-state-transition string
Description Timestamp of the last micro-BFD session transition from any state to any state Time of the session in the current state can be calculated from this value.
Contextbfd micro-bfd-sessions lag-interface name reference member-interface name string last-state-transition string
Treelast-state-transition
String Length20 to 32
ConfigurableFalse
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
local-diagnostic-code keyword
Description The local BFD diagnostic code indicating the most recent reason for failure of this BFD session
Contextbfd micro-bfd-sessions lag-interface name reference member-interface name string local-diagnostic-code keyword
Treelocal-diagnostic-code
Options
  • NO_DIAGNOSTIC

    No diagnostic code was specified, or the session has not changed state

  • DETECTION_TIMEOUT

    The control detection time expired: no BFD packet was received within the required period

  • ECHO_FAILED

    The BFD echo function failed - echo packets have not been received for the required period of time

  • NEIGHBOR_SIGNALED_DOWN

    The neighbor signaled session down

  • FORWARDING_RESET

    The forwarding plane in the local system was reset

    The forwarding plane in the local system was reset The remote system cannot rely on the forwarding state of the device specifying this error code.

  • PATH_DOWN

    Signalling outside of BFD specified that the path underlying this session has failed

  • CONCATENATED_PATH_DOWN

    A segment on the path between source and destination has failed

    A segment on the path between source and destination has failed When a BFD session runs over a series of path segments, this error code indicates that a subsequent path segment (i.e., one in the transmit path between the source and destination of the session) has failed.

  • ADMIN_DOWN

    The BFD session has been administratively disabled by the peer

  • REVERSE_CONCATENATED_PATH_DOWN

    A segment on the reverse path between destination and source has failed

    A segment on the reverse path between destination and source has failed In the case that a BFD session is running over a series of path segments, this error code indicates that a path segment on the reverse path (i.e., in the transmit direction from the destination to the source of the session) has failed.

ConfigurableFalse
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
remote-diagnostic-code keyword
Description The remote BFD diagnostic code indicating the remote system's reason for failure of the BFD session
Contextbfd micro-bfd-sessions lag-interface name reference member-interface name string remote-diagnostic-code keyword
Treeremote-diagnostic-code
Options
  • NO_DIAGNOSTIC

    No diagnostic code was specified, or the session has not changed state

  • DETECTION_TIMEOUT

    The control detection time expired: no BFD packet was received within the required period

  • ECHO_FAILED

    The BFD echo function failed - echo packets have not been received for the required period of time

  • NEIGHBOR_SIGNALED_DOWN

    The neighbor signaled session down

  • FORWARDING_RESET

    The forwarding plane in the local system was reset

    The forwarding plane in the local system was reset The remote system cannot rely on the forwarding state of the device specifying this error code.

  • PATH_DOWN

    Signalling outside of BFD specified that the path underlying this session has failed

  • CONCATENATED_PATH_DOWN

    A segment on the path between source and destination has failed

    A segment on the path between source and destination has failed When a BFD session runs over a series of path segments, this error code indicates that a subsequent path segment (i.e., one in the transmit path between the source and destination of the session) has failed.

  • ADMIN_DOWN

    The BFD session has been administratively disabled by the peer

  • REVERSE_CONCATENATED_PATH_DOWN

    A segment on the reverse path between destination and source has failed

    A segment on the reverse path between destination and source has failed In the case that a BFD session is running over a series of path segments, this error code indicates that a path segment on the reverse path (i.e., in the transmit direction from the destination to the source of the session) has failed.

ConfigurableFalse
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
remote-minimum-receive-interval number
Description

The value of the minimum receive interval that was specified by the peer

This value references the value in the most recent BFD control packet received from the peer.

Contextbfd micro-bfd-sessions lag-interface name reference member-interface name string remote-minimum-receive-interval number
Treeremote-minimum-receive-interval
ConfigurableFalse
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
remote-multiplier number
Description

The current number of packets that must be missed to declare the session as down

The detection interval for the BFD session is calculated by multiplying the value of the negotiated transmission interval by this value.

Contextbfd micro-bfd-sessions lag-interface name reference member-interface name string remote-multiplier number
Treeremote-multiplier
ConfigurableFalse
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
remote-session-state keyword
Description

The reported state of the BFD session according to the remote system

This state reflects the last state reported in a BFD control packet.

Contextbfd micro-bfd-sessions lag-interface name reference member-interface name string remote-session-state keyword
Treeremote-session-state
Options
  • ADMIN_DOWN

    The BFD session is administratively disabled

  • DOWN

    The BFD session is perceived to be down by the system

  • INIT

    The BFD session is perceived to be initialising by the system

  • UP

    The BFD session is perceived to be up by the system

ConfigurableFalse
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
session-state keyword
Description The state of the BFD session perceived by the local system
Contextbfd micro-bfd-sessions lag-interface name reference member-interface name string session-state keyword
Treesession-state
Options
  • ADMIN_DOWN

    The BFD session is administratively disabled

  • DOWN

    The BFD session is perceived to be down by the system

  • INIT

    The BFD session is perceived to be initialising by the system

  • UP

    The BFD session is perceived to be up by the system

ConfigurableFalse
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
remote-address (ipv4-address | ipv6-address)
Description

The remote IP address for the far-end of the BFD session

This must be the same IP version as the local-address.

Contextbfd micro-bfd-sessions lag-interface name reference remote-address (ipv4-address | ipv6-address)
Treeremote-address
ConfigurableTrue
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10
required-minimum-receive number
Description

The minimum interval between received BFD control packets that this system should support

This value is advertised to the remote peer to indicate the maximum frequency (i.e., minimum inter-packet interval) between BFD control packets that is acceptable to the local system. This value is specified as an integer number of microseconds.

Contextbfd micro-bfd-sessions lag-interface name reference required-minimum-receive number
Treerequired-minimum-receive
Range10000 to 100000000
Default1000000
Unitsmicroseconds
ConfigurableTrue
Platforms7220 IXR-D2L, 7250 IXR-6, 7220 IXR-D3, 7220 IXR-D2, 7220 IXR-H3, 7220 IXR-H2, 7220 IXR-D1, 7220 IXR-D3L, 7250 IXR-10

network-instance name string

Description network-instance context for BFD session.
Contextbfd network-instance name string
Treenetwork-instance
ConfigurableFalse
PlatformsSupported on all platforms

name string

Description A unique name identifying the network instance
Contextbfd network-instance name string
ConfigurableFalse
PlatformsSupported on all platforms

peer local-discriminator number

Description BFD session state related to this peer
Contextbfd network-instance name string peer local-discriminator number
Treepeer
ConfigurableFalse
PlatformsSupported on all platforms
async
Description Container for async BFD operational state parameters
Contextbfd network-instance name string peer local-discriminator number async
Treeasync
ConfigurableFalse
PlatformsSupported on all platforms
local-diagnostic-code keyword
Description The local BFD diagnostic code indicating the most recent reason for failure of this BFD session
Contextbfd network-instance name string peer local-discriminator number local-diagnostic-code keyword
Treelocal-diagnostic-code
Options
  • NO_DIAGNOSTIC

    No diagnostic code was specified, or the session has not changed state

  • DETECTION_TIMEOUT

    The control detection time expired: no BFD packet was received within the required period

  • ECHO_FAILED

    The BFD echo function failed - echo packets have not been received for the required period of time

  • NEIGHBOR_SIGNALED_DOWN

    The neighbor signaled session down

  • FORWARDING_RESET

    The forwarding plane in the local system was reset

    The forwarding plane in the local system was reset The remote system cannot rely on the forwarding state of the device specifying this error code.

  • PATH_DOWN

    Signalling outside of BFD specified that the path underlying this session has failed

  • CONCATENATED_PATH_DOWN

    A segment on the path between source and destination has failed

    A segment on the path between source and destination has failed When a BFD session runs over a series of path segments, this error code indicates that a subsequent path segment (i.e., one in the transmit path between the source and destination of the session) has failed.

  • ADMIN_DOWN

    The BFD session has been administratively disabled by the peer

  • REVERSE_CONCATENATED_PATH_DOWN

    A segment on the reverse path between destination and source has failed

    A segment on the reverse path between destination and source has failed In the case that a BFD session is running over a series of path segments, this error code indicates that a path segment on the reverse path (i.e., in the transmit direction from the destination to the source of the session) has failed.

ConfigurableFalse
PlatformsSupported on all platforms
oper-state keyword
Description Details the operational state of the session
Contextbfd network-instance name string peer local-discriminator number oper-state keyword
Treeoper-state
Options
  • up

    Component or process is operational

  • down

    Component or process is not operational

  • empty

    Component slot is empty

  • downloading

    Component is downloading image into memory

  • booting

    Component is booting downloaded image

  • starting

    Component image operational, application processes starting

  • failed

    Component or process has failed

  • synchronizing

    Component is currently being synchronized

  • upgrading

    Component is currently being upgraded

  • low-power

    Component is offline due to insufficient system power

  • degraded

    Component or process is in a degraded state

  • warm-reboot

    Component or process is currently warm rebooting

    Component or process is currently warm rebooting This state is set during a warm reboot immediately following initiation of the reboot, continuing after startup until the system has completed audit. In this state the system will not accept configuration changes.

  • waiting

    Component or process is currently waiting

    Component or process is currently waiting This state can be set by event handler when the reinvoke-with-delay action is used, and indicates that the event handler is waiting for the provided delay before reinvoking the instance.

ConfigurableFalse
PlatformsSupported on all platforms
remote-diagnostic-code keyword
Description The remote BFD diagnostic code indicating the remote system's reason for failure of the BFD session
Contextbfd network-instance name string peer local-discriminator number remote-diagnostic-code keyword
Treeremote-diagnostic-code
Options
  • NO_DIAGNOSTIC

    No diagnostic code was specified, or the session has not changed state

  • DETECTION_TIMEOUT

    The control detection time expired: no BFD packet was received within the required period

  • ECHO_FAILED

    The BFD echo function failed - echo packets have not been received for the required period of time

  • NEIGHBOR_SIGNALED_DOWN

    The neighbor signaled session down

  • FORWARDING_RESET

    The forwarding plane in the local system was reset

    The forwarding plane in the local system was reset The remote system cannot rely on the forwarding state of the device specifying this error code.

  • PATH_DOWN

    Signalling outside of BFD specified that the path underlying this session has failed

  • CONCATENATED_PATH_DOWN

    A segment on the path between source and destination has failed

    A segment on the path between source and destination has failed When a BFD session runs over a series of path segments, this error code indicates that a subsequent path segment (i.e., one in the transmit path between the source and destination of the session) has failed.

  • ADMIN_DOWN

    The BFD session has been administratively disabled by the peer

  • REVERSE_CONCATENATED_PATH_DOWN

    A segment on the reverse path between destination and source has failed

    A segment on the reverse path between destination and source has failed In the case that a BFD session is running over a series of path segments, this error code indicates that a path segment on the reverse path (i.e., in the transmit direction from the destination to the source of the session) has failed.

ConfigurableFalse
PlatformsSupported on all platforms
remote-multiplier number
Description

The current number of packets that must be missed to declare the session as down

The detection interval for the BFD session is calculated by multiplying the value of the negotiated transmission interval by this value.

Contextbfd network-instance name string peer local-discriminator number remote-multiplier number
Treeremote-multiplier
ConfigurableFalse
PlatformsSupported on all platforms
remote-session-state keyword
Description

The reported state of the BFD session according to the remote system

This state reflects the last state reported in a BFD control packet.

Contextbfd network-instance name string peer local-discriminator number remote-session-state keyword
Treeremote-session-state
Options
  • ADMIN_DOWN

    The BFD session is administratively disabled

  • DOWN

    The BFD session is perceived to be down by the system

  • INIT

    The BFD session is perceived to be initialising by the system

  • UP

    The BFD session is perceived to be up by the system

ConfigurableFalse
PlatformsSupported on all platforms
session-state keyword
Description The state of the BFD session perceived by the local system
Contextbfd network-instance name string peer local-discriminator number session-state keyword
Treesession-state
Options
  • ADMIN_DOWN

    The BFD session is administratively disabled

  • DOWN

    The BFD session is perceived to be down by the system

  • INIT

    The BFD session is perceived to be initialising by the system

  • UP

    The BFD session is perceived to be up by the system

ConfigurableFalse
PlatformsSupported on all platforms

subinterface id string

Description List of subinterface references to associating BFD config and state
Contextbfd subinterface id string
Treesubinterface
ConfigurableTrue
PlatformsSupported on all platforms

id string

Description Reference ID for associated subinterface Example: ethernet-2/1.100 (Reference Interface ethernet-2/1, subinterface 100).
Contextbfd subinterface id string
String Length5 to 137
ConfigurableTrue
PlatformsSupported on all platforms

admin-state keyword

Description Administratively enable or disable BFD for this subinterface
Contextbfd subinterface id string admin-state keyword
Treeadmin-state
Defaultdisable
Options
  • enable

  • disable

Configurable True
PlatformsSupported on all platforms

desired-minimum-transmit-interval number

Description

The minimum interval between transmission of BFD control packets

This value is advertised to the peer, however the actual interval used is specified by taking the maximum of desired-minimum-transmit-interval and the value of the remote required-minimum-receive interval value. This value is specified as an integer number of microseconds.

Contextbfd subinterface id string desired-minimum-transmit-interval number
Treedesired-minimum-transmit-interval
Range10000 to 100000000
Default1000000
Unitsmicroseconds
ConfigurableTrue
PlatformsSupported on all platforms

detection-multiplier number

Description

The number of packets that must be missed to declare this session as down

The detection interval for the BFD session is calculated by multiplying the value of the negotiated transmission interval by this value.

Contextbfd subinterface id string detection-multiplier number
Treedetection-multiplier
Range3 to 20
Default3
ConfigurableTrue
PlatformsSupported on all platforms

required-minimum-receive number

Description

The minimum interval between received BFD control packets that this system should support

This value is advertised to the remote peer to indicate the maximum frequency (i.e., minimum inter-packet interval) between BFD control packets that is acceptable to the local system. This value is specified as an integer number of microseconds.

Contextbfd subinterface id string required-minimum-receive number
Treerequired-minimum-receive
Range10000 to 100000000
Default1000000
Unitsmicroseconds
ConfigurableTrue
PlatformsSupported on all platforms

total-bfd-sessions number

Description Counter for the total number of BFD sessions
Contextbfd total-bfd-sessions number
Treetotal-bfd-sessions
Default0
ConfigurableFalse
PlatformsSupported on all platforms