Field	Description
mDNS gateway status	mDNS gateway status. Options include: · Enabled. · Disabled.
mDNS gateway source IP	Source IP address of mDNS packets for each VLAN or VSI. · If an IP address is specified as the source IP address, this field displays this IP address. · If the primary IP address of the VLAN or VSI interface is used as the source IP address, this field displays the interface name and IP address in the format of interface-name (ip-address), for example, Ten-GigabitEthernet1/0/1 (1.1.1.3). · If the primary IP address of the VLAN or VSI interface is used as the source IP address but no IP address is configured for the interface, this field displays the interface name in the format of interface-name (--).
mDNS gateway probe is enabled in the following VLANs	Comma-separated IDs of VLANs enabled with mDNS gateway periodic probing. This field is empty if no VLAN is enabled with mDNS gateway periodic probing.
mDNS gateway probe is enabled in the following VSIs	Comma-separated names of VSIs enabled with mDNS gateway periodic probing. This field is empty if no VSI is enabled with mDNS gateway periodic probing.

display mdns gateway policy

Use display mdns gateway policy to display mDNS gateway policy information, including policy name, user VLANs, user VSIs, service VLANs, and service VSIs.

Syntax

display mdns gateway policy [ policy-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

policy-name: Specifies a policy by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a policy name, the command displays information about all policies.

Examples

# Display mDNS gateway policy information.

<Sysname> display mdns gateway policy

Total mDNS gateway policies: 2

mDNS policy name : test1

User VLANs : 4-5

User VSIs : vsia

Service VLANs : 6-7

Service VSIs : vsib

mDNS policy name : test2

User VLANs : 10-11

User VSIs : vsic

Service VLANs : 12-13

Service VSIs : vsid

Table 2 Command output

Field	Description
Total mDNS gateway policies	Total number of mDNS gateway policies.
User VLANs	Comma-separated IDs of user VLANs. This field is empty if no user VLAN is specified.
User VSIs	Comma-separated names of user VSIs. This field is empty if no user VSI is specified.
Service VLANs	Comma-separated IDs of service VLANs. This field is empty if no service VLAN is specified.
Service VSIs	Comma-separated names of service VSIs. This field is empty if no service VSI is specified.

‌

Related commands

mdns gateway policy

service vlan

service vsi

user vlan

user vsi

display mdns gateway service

Use display mdns gateway service to display information about services learned by the mDNS gateway.

Syntax

display mdns gateway service { all | predefined-service-type | user-defined user-defined-service-type | vlan vlan-id | vsi vsi-name }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Specifies all service types.

predefined-service-type: Specifies a pre-defined service type.

user-defined user-defined-service-type: Specifies a user-defined service type. The user-defined-service-type argument represents the service type name, a case-insensitive string of 13 to 27 characters.

vlan vlan-id: Specifies information in a specific VLAN. The vlan-id argument represents the VLAN ID in the range of 1 to 4094.

vsi vsi-name: Specifies information in a specific VSI. The vsi-name argument represents the VSI name, a case-sensitive string of 1 to 31 characters.

Examples

# Display information about all services learned by the mDNS gateway.

<Sysname> display mdns gateway service all

Instance name Service type VLAN/VSI name TTL Pro IP

Apple TV airplay 1 4500 TCP 192.168.10.2

B8782E5101E 7@Apple TV raop 2 4500 TCP 192.168.10.2

70-35-60-63.1 Apple TV sleep-proxy vsi1 4500 TCP 192.168.10.2

Total mDNS gateway services: 3

Table 3 Command output

Field	Description
Instance name	Instance name of the service, the unique identifier of a service.
Service type	Service type. Options include: · afpovertcp—AppleTalkFiling Protocol. · airplay—Airplay. · airport—Airport Base Station. · apple-sasl—Apple Password Server. · daap—Digital Audio Access Protocol. · dacp—Digital Audio Control Protocol. · distcc—Distributed Compiler. · dpap—Digital Photo Access Protocol. · eppc—Remote AppleEvents. · ftp—File Transfer Protocol. · http—Hypertext Transfer Protocol. · ica-networking—Image Capture Sharing. · ichat—iChat Instant Messaging Protocol. · ipp—Internet Printing Protocol. · ipps—Internet Printing Protocol. · nfs—Network File System. · pdl-stream—PDL Data Stream. · printer—Line Printer Daemon. · raop—Remote Audio Output Protocol. · riousbprint—Remote I/O USB Printer Protocol. · servermgr—Server Admin. · ssh—Secure Shell. · telnet—Remote Login. · webdav—WebDav File System. · workstation—Workgroup Manager. · xserveraid—Xerver RAID. · user-defined—User-defined service types.
VLAN/VSI name	VLAN or VSI in which the service provider resides.
TTL	TTL of the service recorded by the mDNS gateway upon receiving the most recent service response, in seconds.
IP	IP address used by the service.
Pro	Service protocol. Options include: · TCP. · UDP.
Total mDNS gateway services	Total number of services learned by the mDNS gateway.

‌

Related commands

mdns gateway permit service-type

display mdns gateway statistics

Use display mdns gateway statistics to display mDNS gateway packet statistics.

Syntax

display mdns gateway statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display mDNS gateway packet statistics.

<Sysname> display mdns gateway statistics

mDNS gateway packet statistics:

Total received : 100

Queries received : 20

Response received: 80

Total sent : 50

Queries sent : 30

Response sent : 20

Dropped : 10

Table 4 Command output

Field	Description
Total received	Total number of received mDNS packets.
Queries received	Number of received service queries.
Response received	Number of received service responses.
Total sent	Total number of sent mDNS packets.
Queries sent	Number of sent service queries.
Response sent	Number of sent service responses.
Dropped	Number of dropped mDNS packets.

‌

Related commands

reset mdns gateway statistics

mdns gateway enable

Use mdns gateway enable to enable mDNS gateway.

Use undo mdns gateway enable to disable mDNS gateway.

Syntax

mdns gateway enable

undo mdns gateway enable

Default

mDNS gateway is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Destination multicast address 224.0.0.251 used by mDNS for packet exchanging can be used only in Layer 2 broadcast domains and intra-VLAN or intra-VSI transmission. You can deploy an mDNS gateway in a large-scale network to enable inter-VLAN/VSI mDNS service discovery.

The gateway records a list of available services in the network, responds to service queries from mDNS clients, and performs mDNS service discovery as well as access control.

You cannot enable both mDNS gateway and mDNS relay on a device.

Examples

# Enable mDNS gateway.

<Sysname> system-view

[Sysname] mdns gateway enable

Related commands

display mdns gateway

mdns gateway permit service-type

mdns gateway policy

mdns gateway probe interval

mdns gateway source ip

mdns gateway trust source ip

mdns gateway permit service-type

Use mdns gateway permit service-type to specify a permitted service type for entry learning.

Use undo mdns gateway permit service-type to remove a permitted service type for entry learning

Syntax

mdns gateway permit service-type { predefined-service-type | user-defined user-defined-service-type } [ max-entry-count count ]

undo mdns gateway permit service-type { predefined-service-type | user-defined user-defined-service-type }

Default

The mDNS gateway can learn all mDNS services of a predefined service type.

Views

System view

Predefined user roles

network-admin

Parameters

pre-defined-service-type: Specifies a pre-defined service type. Table 5 displays the available pre-defined service types.

Table 5 Pre-defined service types

Field	Description
Afpovertcp	AppleTalkFiling Protocol
Airplay	Airplay
Airport	Airport Base Station
apple-sasl	Apple Password Server
Daap	Digital Audio Access Protocol
Dacp	Digital Audio Control Protocol
Distcc	Distributed Compiler
Dpap	Digital Photo Access Protocol
Eppc	Remote AppleEvents
ftp	File Transfer Protocol
http	Hypertext Transfer Protocol
ica-networking	Image Capture Sharing
Ichat	iChat Instant Messaging Protocol
Ipp	Internet Printing Protocol
Ipps	Internet Printing Protocol
Nfs	Network File System
pdl-stream	PDL Data Stream
Printer	Line Printer Daemon
Raop	Remote Audio Output Protocol
Riousbprint	Remote I/O USB Printer Protocol
Servermgr	Server Admin
Ssh	Secure Shell
telnet	Remote Login
Webdav	WebDav File System
Workstation	Workgroup Manager
Xserveraid	Xerver RAID

‌

user-defined user-defined-service-type: Specifies a user-defined service type. The user-defined-service-type argument represents the name of the type, a case-insensitive string of 1 to 15 characters in the _type._protocol.local format. Make sure the user-defined service type has a different name from any predefined service type.

max-entry-count count: Specifies the maximum number of entries that can be recorded for the service type. The value range for the count argument is 1 to 1024. If you do not specify this option, the command does not limit the number of entries that can be recorded for the service type.

Usage guidelines

By default, the mDNS gateway can learn all services of a predefined type, which can be memory-consuming if a large number of service providers exist. You can perform this task to specify the permitted service types that can be learned by the mDNS gateway for the gateway to learn only required services.

This configuration takes effect only when mDNS gateway is enabled.

If the maximum number of entries for a service type has been reached, the system stops learning service information for the type.

Changes on the max-entry-count setting takes effect only on services learned afterward and will not affect recorded entries.

Removing a type from the permitted list clears all service entries for the type.

Examples

# Permit the mDNS gateway to learn services of the airport type and set the maximum number of recorded entries for the service type to 10.

<Sysname> system-view

[Sysname] mdns gateway permit service-type airport max-entry-count 10

Related commands

mdns gateway enable

mdns gateway policy

Use mdns gateway policy to create an mDNS gateway policy and enter its view or enter the view of an existing mDNS gateway policy.

Use undo mdns gateway policy to delete an mDNS gateway policy.

Syntax

mdns gateway policy policy-name

undo mdns gateway policy policy-name

Default

No mDNS gateway policy exists.

Views

System view

Predefined user roles

network-admin

Parameters

policy-name: Specifies the policy name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

An mDNS gateway policy defines user VLAN/VSI and service VLAN/VSI mappings to ensure that endpoint devices in specific VLANs/VSIs can access only service providers in specific service VLANs/VSIs.

This configuration takes effect only when mDNS gateway is enabled.

You can execute this command multiple times to add multiple mDNS gateway policies.

Examples

# Create an mDNS gateway policy named test.

<Sysname> system-view

[Sysname] mdns gateway policy test

[Sysname-mdns-gateway-policy-test]

Related commands

display mdns gateway policy

mdns gateway enable

mdns gateway probe interval

Use mdns gateway probe interval to enable periodic probing on the mDNS gateway and set the probe interval.

Use undo mdns gateway probe interval to disable periodic probing on the mDNS gateway.

Syntax

mdns gateway probe interval interval

undo mdns gateway probe interval

Default

Periodic probing is disabled on the mDNS gateway.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Parameters

interval: Specifies a probe interval in seconds. The value range is 60 to 38400.

Usage guidelines

mDNS service providers broadcast their services at network association. For the mDNS gateway to discover services offered by service providers that accessed the network earlier than the gateway, enable mDNS gateway periodic probing.

This feature enables the mDNS gateway to send mDNS probe queries at intervals. Each mDNS service provider sends a response to the gateway after receiving the query. The mDNS gateway can learn the latest service information of all mDNS service providers in the network in a timely manner.

For an mDNS device, you can enable periodic probing on its directly connected mDNS gateway or mDNS relay.

This configuration takes effect only when mDNS gateway is enabled.

If you execute this command multiple times, the most recent one takes effect.

Examples

# Enable periodic probing and set the probe interval to 300 seconds in VLAN 10.

<Sysname> system-view

[Sysname] vlan 10

[Sysname-vlan10] mdns gateway probe interval 300

# Enable periodic probing and set the probe interval to 300 seconds in VSI vsia.

<Sysname> system-view

[Sysname] vsi vsia

[Sysname-vsia] mdns gateway probe interval 300

Related commands

mdns gateway enable

mdns gateway source ip

Use mdns gateway source ip to specify the source address for mDNS packets.

Use undo mdns gateway source ip to restore the default.

Syntax

mdns gateway source ip { interface interface-type interface-number | ip-address }

undo mdns gateway source ip

Default

The mDNS gateway uses the primary IP address of the VLAN or VSI interface for packet output as the source IP address of mDNS packets.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Parameters

interface interface-type interface-number: Specifies an interface whose primary IP address will be used as the source address. The interface-type argument represents the interface type and the interface-number argument represents the interface number.

ip-address: Specifies the source IP address in dotted decimal notation.

Usage guidelines

For responses destined for endpoint devices and mDNS queries and probe queries sent within a VLAN or VSI, the default source IP address is the primary IP address of the VLAN interface or VSI interface. If no IP address is configured for the VLAN interface or VSI interface, the mDNS gateway cannot send out the queries.

If the mDNS gateway is connected to a large number of VLANs or VSIs, configuring an IP address to each VLAN interface or VSI interface wastes IP address resources. You can use this command to specify a specific IP address for the mDNS gateway to use.

This configuration takes effect only when mDNS gateway is enabled.

Make sure the specified source address already exists on the mDNS gateway. Otherwise, the gateway cannot receive responses.

If the specified interface does not have an IP address, the system uses the primary IP address of the packet output interface. If the packet output interface does not have an IP address, packets cannot be sent.

You can specify only one source address for a VLAN or VSI. If you execute this command in the same view multiple times, the most recent one takes effect.

Examples

# Specify the source address for mDNS packets as 1.1.1.1 in VLAN 10.

<Sysname> system-view

[Sysname] vlan 10

[Sysname-vlan10] mdns gateway source ip 1.1.1.1

# Specify the primary IP address of VLAN-interface 10 as the source address for mDNS packets in VSI vsia.

<Sysname> system-view

[Sysname] vsi vsia

[Sysname-vsi-vsia] mdns gateway source ip interface vlan-interface 10

Related commands

mdns gateway enable

mdns gateway trust device-ip

Use mdns gateway trust device-ip to specify a trusted mDNS device.

Use undo mdns gateway trust device-ip to delete a trusted mDNS device.

Syntax

mdns gateway trust device-ip ip-address [ vpn-instance vpn-instance-name ]

undo mdns gateway trust device-ip ip-address [ vpn-instance vpn-instance-name ]

Default

No trusted device is specified.

Views

System view

Predefined user roles

network-admin

Parameters

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

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. To specify a device for the public network, do not specify this option.

Usage guidelines

To prevent security issues and resource waste caused by attacks performed by rogue mDNS devices, you can specify trustworthy mDNS relays as trusted mDNS devices. With trusted devices specified, the mDNS gateway processes only unicast queries from the trusted mDNS devices.

This configuration takes effect only when mDNS gateway is enabled.

You can execute this command multiple times to add multiple trusted devices.

Examples

# Specify the mDNS device that uses IP address 1.1.1.1 as a trusted mDNS device.

<Sysname> system-view

[Sysname] mdns gateway trust device-ip 1.1.1.1

Related commands

mdns gateway enable

reset mdns gateway service

Use reset mdns gateway service to clear information about services learned by the mDNS gateway.

Syntax

reset mdns gateway service { all | predefined-service-type | user-defined user-defined-service-type | vlan vlan-id | vsi vsi-name }

Views

User view

Predefined user roles

network-admin

Parameters

all: Specifies services of all types.

pre-defined-service-type: Specifies a predefined service type.

user-defined user-defined-service-type: Specifies a user-defined service type, a case-insensitive string of 1 to 15 characters.

vlan vlan-id: Specifies a VLAN by its ID, in the range of 1 to 4094.

vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters.

Examples

# Clear information about services learned by the mDNS gateway in VLAN 10.

<Sysname> reset mdns gateway service vlan 10

# Clear information about services of predefined type printer.

<Sysname> reset mdns gateway service printer

Related commands

display mdns gateway service

reset mdns gateway statistics

Use reset mdns gateway service to clear packet statistics on the mDNS gateway.

Syntax

reset mdns gateway statistics

Views

User view

Predefined user roles

network-admin

Usage guidelines

IMPORTANT:

The cleared statistics cannot be restored.

‌

For debugging or maintenance purposes, you can execute this command to restart the statistics collection period.

To view the collected packet statistics, execute the display mdns gateway statistics command.

Examples

# Clear packet statistics on the mDNS gateway.

<Sysname> reset mdns gateway statistics

Related commands

display mdns gateway statistics

service vlan

Use service vlan to specify service VLANs for an mDNS gateway policy.

Use undo service vlan to remove service VLANs for an mDNS gateway policy.

Syntax

service vlan vlan-id-list

undo service vlan [ vlan-id-list ]

Default

No service VLAN is specified for an mDNS gateway policy.

Views

mDNS gateway policy view

Predefined user roles

network-admin

Parameters

vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each VLAN item specifies a VLAN by VLAN ID or specifies a range of VLANs in the form of vlan-id1 to vlan-id2. The value range for the VLAN IDs is 1 to 4094. If you specify a VLAN range, the value for the vlan-id2 argument must be greater than the value for the vlan-id1 argument.

Usage guidelines

Service VLANs isolate mDNS service providers and allows the mDNS gateway to control services accessible to users by VLANs, helping achieve refined service management.

You can specify a service VLAN for multiple mDNS gateway policies and specify multiple service VLANs for an mDNS gateway policy.

You can specify a maximum of 128 service VLANs for an mDNS gateway policy.

Examples

# Specify service VLANs 100 through 200 for mDNS gateway policy test.

<Sysname> system-view

[Sysname] mdns gateway policy test

[Sysname-mdns-gateway-policy-test] service vlan 100 to 200

Related commands

display mdns gateway policy

user vlan

service vsi

Use service vsi to specify a service VSI for an mDNS gateway policy.

Use undo service vsi to remove a service VSI for an mDNS gateway policy.

Syntax

service vsi vsi-name

undo service vsi vsi-name

Default

No service VSI is specified for an mDNS gateway policy.

Views

mDNS gateway policy view

Predefined user roles

network-admin

Parameters

vsi-name: Specifies the name of a VSI, a case-sensitive string of 1 to 31 characters.

Usage guidelines

Service VSIs isolate mDNS service providers and allows the mDNS gateway to control services accessible to users by VSIs, helping achieve refined service management.

You can specify a service VSI for multiple mDNS gateway policies and specify multiple service VSIs for an mDNS gateway policy.

You can specify a maximum of 128 service VSIs for an mDNS gateway policy.

Examples

# Specify service VSI vsia for mDNS gateway policy test.

<Sysname> system-view

[Sysname] mdns gateway policy test

[Sysname-mdns-gateway-policy-test] service vsi vsia

Related commands

display mdns gateway policy

user vsi

user vlan

Use user vlan to specify user VLANs for an mDNS gateway policy.

Use undo user vlan to remove user VLANs for an mDNS gateway policy.

Syntax

user vlan vlan-id-list

undo user vlan [ vlan-id-list ]

Default

No user VLAN is specified for an mDNS gateway policy.

Views

mDNS gateway policy view

Predefined user roles

network-admin

Parameters

Usage guidelines

User VLANs isolate mDNS endpoint devices and allows the mDNS gateway to filter service queries of endpoint devices by VLANs. With mDNS gateway policies configured, the gateway processes only service queries from endpoint devices in a VLAN defined in a policy.

You can specify a user VLAN for multiple mDNS gateway policies and specify multiple user VLANs for an mDNS gateway policy.

You can specify a maximum of 128 user VLANs for an mDNS gateway policy.

Examples

# Specify user VLANs 100 through 200 for mDNS gateway policy test.

<Sysname> system-view

[Sysname] mdns gateway policy test

[Sysname-mdns-gateway-policy-test] user vlan 100 to 200

Related commands

display mdns gateway policy

service vlan

user vsi

Use user vsi to specify a user VSI for an mDNS gateway policy.

Use undo user vsi to remove a user VSI for an mDNS gateway policy.

Syntax

user vsi vsi-name

undo user vsi vsi-name

Default

No user VSI is specified for an mDNS gateway policy.

Views

mDNS gateway policy view

Predefined user roles

network-admin

Parameters

vsi-name: Specifies the name of a VSI, a case-sensitive string of 1 to 31 characters.

Usage guidelines

User VSIs isolate mDNS endpoint devices and allows the mDNS gateway to filter service queries of endpoint devices by VSIs. With mDNS gateway policies configured, the gateway processes only service queries from endpoint devices in a VSI defined in a policy.

You can specify a user VSI for multiple mDNS gateway policies and specify multiple user VSIs for an mDNS gateway policy.

You can specify a maximum of 128 user VSIs for an mDNS gateway policy.

Examples

# Specify user VSI test for mDNS gateway policy test.

<Sysname> system-view

[Sysname] mdns gateway policy test

[Sysname-mdns-gateway-policy-test] user vsi vsib

Related commands

display mdns gateway policy

service vsi

05-Layer 3—IP Services Command Reference

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us