# IGMP

The `nv unset` commands remove the configuration you set with the equivalent `nv set` commands. This guide only describes an `nv unset` command if it differs from the `nv set` command.

## nv set interface <interface-id>ipv4 igmp state

Enables and disables IGMP on the specified interface. The default setting is `disabled`.

In Cumulus Linux 5.14 and earlier:

- The command is `nv set interface <interface-id>ip igmp state`.
- You specify `enable on` or `enable off` instead of `state enabled` or `state disabled`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv4 igmp state enabled

## nv set interface <interface-id> ipv4 igmp fast-leave

Enables and disables fast leave processing on the interface. The default setting is `disabled`.

In Cumulus Linux 5.14 and earlier:

- The command is `nv set interface <interface-id>ip igmp fast-leave`.
- You specify `enable on` or `enable off` instead of `enabled` or `disabled`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.6.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv4 igmp fast-leave enabled

## nv set interface <interface-id> ipv4 igmp last-member-query-count

Sets the number of group-specific queries that a querier sends after receiving a leave message on the interface. You can set a value between 1 and 255. The default setting is 2.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip igmp last-member-query-count`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.6.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv4 igmp last-member-query-count 5

## nv set interface <interface-id> ipv4 igmp last-member-query-interval

Configures the maximum response time advertised in IGMP group-specific queries. You can specify a value between 1 and 6553 seconds. The default setting is 10.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip igmp last-member-query-interval`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv4 igmp last-member-query-interval 100

## nv set interface <interface-id> ipv4 igmp query-interval

Configures how often IGMP sends query-host messages to discover which multicast groups have members on the attached networks.

- In Cumulus Linux 5.6 and later, you can specify a value between 1 and 65535 seconds. The default setting is 100.
- In Cumulus Linux 5.5 and earlier, you can specify a value between 1 and 1800 seconds. The default setting is 180.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip igmp query-interval`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv4 igmp query-interval 1000

## nv set interface <interface-id> ipv4 igmp query-max-response-time

Configures the maximum response time for IGMP general queries. You can specify a value between 10 and 6553 seconds. The default setting is 100.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip igmp query-max-response-time`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv4 igmp query-max-response-time 200

## nv set interface <interface-id> ipv4 igmp static-group <static-group-id>

Configures the IGMP static multicast mroute destination. This is the IPv4 address of the member associated with the specified multicast group address.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip igmp static-group <static-group-id>`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<static-group-id>` | The IGMP static multicast mroute destination.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv4 igmp static-group 234.10.10.10

## nv set interface <interface-id> ipv4 igmp static-group <static-group-id> source-address <ipv4-unicast>

Configures the IPv4 unicast address of the IGMP static multicast mroute source.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip igmp static-group <static-group-id> source-address <ipv4-unicast>`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<static-group-id>` | The IGMP static multicast mroute destination.
`<ipv4-unicast>` | The IPv4 unicast address.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv4 igmp static-group 234.10.10.10 source-address 234.1.1.1

## nv set interface <interface-id> ipv4 igmp version

Configures the IGMP version on the specified interface. You can specify version 2 or version 3. The default setting is `3`.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip igmp version`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv4 igmp version 2

## nv set router igmp state

Enables and disables IGMP globally. The default setting is `disabled`.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set router igmp state enabled