UDP helper commands -- display udp-helper interface

Use display udp-helper interface to display information about broadcast to unicast conversion by UDP helper on an interface.

Syntax

display udp-helper interface interface-type interface-number

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

interface-type interface-number: Specifies an interface by its type and number.

Usage guidelines

This command displays information about destination servers and total number of unicast packets converted from UDP broadcast packets by UDP helper.

Examples

# Display information about broadcast to unicast conversion by UDP helper on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> display udp-helper interface gigabitethernet 1/0/1

Interface Server VPN instance Server address Packets sent

GigabitEthernet1/0/1 N/A 192.1.1.2 0

GigabitEthernet1/0/1 N/A 192.1.1.2 0

# Display information about broadcast to unicast conversion by UDP helper on VLAN-interface 100. (Applicable to switches.)

<Sysname> display udp-helper interface vlan-interface 100

Interface Server VPN instance Server address Packets sent

Vlan-interface100 N/A 192.1.1.2 0

Vlan-interface100 N/A 192.1.1.2 0

Table 1 Command output

Field | Description
Interface | Interface name.
Server VPN instance | ‌ VPN instance to which the destination server belongs.
Server address | Destination server to which UDP packets are forwarded.
Packets sent | Number of unicast packets that are converted from broadcast packets by UDP helper.

Related commands

reset udp-helper statistics

udp-helper server

UDP helper commands -- reset udp-helper statistics

Use reset udp-helper statistics to clear statistics about broadcast to unicast conversion by UDP helper.

Syntax

reset udp-helper statistics

Views

User view

Predefined user roles

network-admin

mdc-admin

Examples

# Clear the statistics about broadcast to unicast conversion by UDP helper.

<Sysname> reset udp-helper statistics

Related commands

display udp-helper interface

UDP helper commands -- udp-helper broadcast-map

Use udp-helper broadcast-map to specify a multicast address for UDP helper to convert broadcast to multicast.

Use undo udp-helper broadcast-map to restore the default.

Syntax

udp-helper broadcast-map multicast-address [ acl acl-number ]

undo udp-helper broadcast-map multicast-address

Default

No multicast address is specified for UDP helper to convert broadcast to multicast.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

multicast-address: Specifies the destination multicast address to which the destination broadcast address is converted.

acl acl-number: Specifies an ACL by its number. The ACL filters incoming broadcast packets for UDP helper. Packets permitted by the ACL can be converted. If no ACL is specified, all incoming broadcast packets are checked for UDP helper.

· For a basic ACL, the value range is 2000 to 2999.

· For an advanced ACL, the value range is 3000 to 3999.

Usage guidelines

Use this command on the interface that receives broadcast packets.

You can configure a maximum of 20 unicast and multicast addresses for UDP helper to convert broadcast packets.

Examples

# Configure UDP helper to convert received broadcast packets on GigabitEthernet 1/0/1 to multicast packets destined for 225.0.0.1. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] udp-helper broadcast-map 225.0.0.1

# Configure UDP helper to convert received broadcast packets on VLAN-interface 100 to multicast packets destined for 225.0.0.1. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] udp-helper broadcast-map 225.0.0.1

UDP helper commands -- udp-helper enable

Use udp-helper enable to enable UDP helper.

Use undo udp-helper enable to disable UDP helper.

Syntax

udp-helper enable

undo udp-helper enable

Default

UDP helper is disabled.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

For UDP helper to take effect on an interface, make sure the following conditions are met:

· UDP helper is enabled.

· A UDP port number is specified by using the udp-helper port command.

· Packet conversion for UDP helper is configured on the interface.

Examples

# Enable UDP helper.

<Sysname> system-view

[Sysname] udp-helper enable

Related commands

udp-helper port

udp-helper server

udp-helper multicast-map

udp-helper broadcast-map

UDP helper commands -- udp-helper multicast-map

Use udp-helper multicast-map to map a multicast address to a directed broadcast or a unicast address for UDP helper.

Use undo udp-helper multicast-map to restore the default.

Syntax

udp-helper multicast-map multicast-address ip-address [ global | vpn-instance vpn-instance-name ] [ acl acl-number ]

undo udp-helper multicast-map multicast-address ip-address [ global | vpn-instance vpn-instance-name ]

Default

No address mapping is specified for UDP helper to convert multicast to broadcast or unicast.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

multicast-address: Specifies the destination address of the multicast packets.

ip-address: Specifies a unicast address or a directed broadcast address to which a destination multicast address is converted.

global: Forwards converted packets on the public network.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance to which the destination unicast or broadcast address belongs. The vpn-instance-name argument represents the VPN instance name, a case-sensitive string of 1 to 31 characters.

acl acl-number: Specifies an ACL by its number. The ACL filters incoming multicast packets. Packets permitted by the ACL can be converted. If no ACL is specified, all incoming multicast packets are checked for UDP helper.

· For a basic ACL, the value range is 2000 to 2999.

· For an advanced ACL, the value range is 3000 to 3999.

Usage guidelines

Use this command on the interface that receives multicast packets.

You can map one multicast address to a maximum of 16 broadcast and unicast addresses. The packets destined for the multicast address are forwarded to all mapping addresses.

Examples

# Configure UDP helper to convert the multicast packets destined for 225.0.0.1 to broadcast packets destined for 192.168.1.255. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] udp-helper multicast-map 225.0.0.1 192.168.1.255

# Configure UDP helper to convert the multicast packets destined for 225.0.0.1 to unicast packets destined for 192.168.1.3 in VPN instance a. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] udp-helper multicast-map 225.0.0.1 192.168.1.3 vpn-instance a

# Configure UDP helper to convert the multicast packets destined for 225.0.0.1 to broadcast packets destined for 192.168.1.255. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] udp-helper multicast-map 225.0.0.1 192.168.1.255

# Configure UDP helper to convert the multicast packets destined for 225.0.0.1 to unicast packets destined for 192.168.1.3 in VPN instance a. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] udp-helper multicast-map 225.0.0.1 192.168.1.3 vpn-instance a

UDP helper commands -- udp-helper port

Use udp-helper port to specify a UDP port number for UDP helper.

Use undo udp-helper port to remove UDP port numbers.

Syntax

udp-helper port { port-number | dns | netbios-ds | netbios-ns | tacacs | tftp | time }

undo udp-helper port { port-number | dns | netbios-ds | netbios-ns | tacacs | tftp | time }

Default

No UDP port numbers are specified for UDP helper.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

port-number: Specifies a UDP port number in the range of 1 to 65535 (except 67 and 68).

dns: Specifies the UDP port 53 used by DNS packets.

netbios-ds: Specifies the UDP port 138 used by NetBIOS distribution service packets.

netbios-ns: Specifies the UDP port 137 used by NetBIOS name service packets.

tacacs: Specifies the UDP port 49 used by TACACS packets.

tftp: Specifies the UDP port 69 used by TFTP packets.

time: Specifies the UDP port 37 used by time protocol packets.

Usage guidelines

Upon receiving a UDP broadcast or multicast packet, UDP helper uses the specified UDP ports to match the UDP destination port number of the packet.

To specify a UDP port, you can specify the port number or the protocol keyword. For example, udp-helper port 53 and udp-helper port dns specify the same UDP port.

You can specify a maximum of 256 UDP ports on a device.

Examples

# Specify the UDP port 100 for UDP helper.

<Sysname> system-view

[Sysname] udp-helper port 100

UDP helper commands -- udp-helper server

Use udp-helper server to specify a destination server for UDP helper to convert broadcast to unicast.

Use undo udp-helper server to remove a destination server.

Syntax

udp-helper server ip-address [ global | vpn-instance vpn-instance-name ]

undo udp-helper server [ ip-address [ global | vpn-instance vpn-instance-name ] ]

Default

No destination server is specified for UDP helper to convert broadcast to unicast.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

ip-address: Specifies the IP address of a destination server, in dotted decimal notation.

global: Forwards converted unicast packets to the server on the public network.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance to which the server belongs. The vpn-instance-name argument represents the VPN instance name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

Specify destination servers on an interface that receives UDP broadcast packets. If the packets' destination UDP port numbers match the UDP helper ports, UDP helper forwards the broadcasts to the specified servers.

You can specify a maximum of 20 unicast and multicast addresses for UDP helper to convert broadcast packets on an interface.

If you do not specify the ip-address argument, the undo udp-helper server command removes all destination servers on the interface.

A destination server with the global keyword and the same destination server with the vpn-instance vpn-instance-name option do not overwrite each other. If you specify only the IP address, UDP helper forwards converted unicast packets in the VPN to which the receiving interface belongs. If the interface is not bound to any VPN instance, UDP helper forwards the unicast packets on the public network.

Examples

# Specify the destination server 192.1.1.2 for UDP helper to convert broadcast to unicast on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] udp-helper server 192.1.1.2

# Specify the destination server 192.1.1.2 in VPN instance a for UDP helper to convert broadcast to unicast on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] udp-helper server 192.1.1.2 vpn-instance a

# Specify the destination server 192.1.1.2 for UDP helper to convert broadcast to unicast on VLAN-interface 100. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] udp-helper server 192.1.1.2

# Specify the destination server 192.1.1.2 on the public network for UDP helper to convert broadcast to unicast on VLAN-interface 100. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] udp-helper server 192.1.1.2 global

Related commands

display udp-helper interface