29-UDP-Helper Command

Download


Chapter 1  UDP-Helper Configuration Commands

1.1  UDP-Helper Configuration Commands

1.1.1  debugging udp-helper

Syntax

debugging udp-helper { event | packet [ receive | send ] }

undo debugging udp-helper { event | packet [ receive | send ] }

View

User view

Parameter

event: Enables/disables debugging for UDP-Helper events.

packet: Enables/disables debugging for sending/receiving UDP-Helper packets.

receive: Enables/disables debugging for receiving UDP-Helper packets.

send: Enables/disables debugging for sending UDP-Helper packets.

Description

Use the debugging udp-helper command to enable debugging for UDP-Helper.

Use the undo debugging udp-helper command to disable debugging for UDP-Helper.

By default, debugging for UDP-Helper is disabled.

Example

# Enable debugging for sending/receiving UDP-Helper packets.

<H3C> debugging udp-helper packet

1.1.2  display udp-helper server

Syntax

display udp-helper server [ interface vlan-interface vlan-id ]

View

Any view

Parameter

vlan-id: ID of a VLAN.

Description

Use the display udp-helper server command to display the information about the configured destination servers connected to a specified VLAN interface and the number of the packets forwarded to each destination server. If you do not specified the vlan-id argument, the corresponding information about all the VLAN interfaces is displayed.

Example

# Display the information about the configured destination servers connected to VLAN 1 interface and the number of the packets forwarded to the destination servers.

<H3C> display udp-helper server interface Vlan-interface 1

Interface name       Server address      Packets sent

Vlan-interface1      192.1.1.2           0

The information above shows that the server with its IP address being 192.1.1.2 is configured as a destination server and is connected to VLAN 1 interface, and no packets are forwarded to it so far.

1.1.3  reset udp-helper packet

Syntax

reset udp-helper packet

View

User view

Parameter

None

Description

Use the reset udp-helper packet command to clear the statistics about the packets forwarded by UDP-Helper.

Example

# Clear the statistics about the packets forwarded by UDP-Helper.

<H3C> reset udp-helper packet

1.1.4  udp-helper enable

Syntax

udp-helper enable

undo udp-helper enable

View

System view

Parameter

None

Description

Use the udp-helper enable command to enable the UDP-Helper function.

Use the undo udp-helper enable command to disable the UDP-Helper function.

By default, UDP-Helper is disabled.

Example

# Enable UDP-Helper.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] udp-helper enable

1.1.5  udp-helper port

Syntax

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

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

View

System view

Parameter

port: number of a UDP port to be configured as a UDP-Helper destination port, in the range 1 to 65535 (except for 67 and 68).

dns: Specifies the DNS UDP port (port 53) as a UDP-Helper destination port.

netbios-ds: Specifies the NetBIOS-DS UDP port (port 138) as a UDP-Helper destination port.

netbios-ns: Specifies the NetBIOS-NS UDP port (port 137) as a UDP-Helper destination port.

tacacs: Specifies the TACACS UDP port (port 49) as a UDP-Helper destination port.

tftp: Specifies the TFTP UDP port (port 69) as a UDP-Helper destination port.

time: Specifies the time service UDP port (port 37) as a UDP-Helper destination port.

Description

Use the udp-helper port command to specify a UDP-Helper destination port.

Use the undo udp-helper port command to disable a port from being a UDP-Helper destination port.

With UDP-Helper enabled, UDP broadcast packets with their destination port being the six default UDP ports (that is, port 69, 53, 37, 137, 138, and 49) are forwarded to the configured destination servers by default. After the UDP-Helper function is disabled, all the configured UDP-Helper destination ports are cancelled, including the default UDP ports.

Note that before configuring udp-helper port, you must enable UDP-Helper.

Example

# Configure the DNS UDP port as a UDP-Helper destination port.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] udp-helper port dns

1.1.6  udp-helper server

Syntax

udp-helper server ip-address

undo udp-helper server [ ip-address ]

View

VLAN interface view

Parameter

ip-address: IP address of the device to be configured as a destination server, in dotted decimal notation.

Description

Use the udp-helper server command to specify a destination server for the UDP broadcast packets to be forwarded.

Use the undo udp-helper server command to remove a configured destination server.

No destination server is configured by default.

Currently, you can configure up to 20 destination servers on a VLAN interface.

Note that if you do not provide the ip-address argument when executing the undo udp-helper server command, all the destination servers configured on the VLAN interface are removed.

Related command: display udp-helper server.

Example

# Configure the device with its IP address being 192.1.1.2 as a destination server for the UDP broadcast packets to be forwarded on VLAN 1 interface.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] nterface Vlan-interface 1

[H3C-Vlan-interface1] udp-helper server 192.1.1.2