< Home

tracert ipv6 (upgrade-compatible command)

Function

The tracert ipv6 command enables the system to trace gateways that packets pass through from the source to the destination with an IPv6 address. This command is used to check whether a network is reachable and detect faults.

Format

tracert ipv6 [ -f first-ttl | -m max-ttl | -p port | -q nqueries | -w timeout | vpn6-instance vpn6-instance-name | -a source-ipv6-address | -s byte-number ] * ipv6-host

Parameters

Parameter Description Value
-f first-ttl Specifies an initial TTL.

The TTL (time o live) field is carried in the IP header. It indicates the lifetime of packets and specifies the maximum routers that packets can pass through. The TTL value is set on the source host and reduced by 1 each time the packet passes through a router. When the TTL value is reduced to 0, the packet is discarded. At the same time, an ICMP Timeout packet is sent to notify the source host. If first-TTL is specified and the number of hops is smaller than the value of first-TTL, no ICMP timeout packet is sent to the source host when the packet passes through these hops. If max-TTL is specified, the value of first-TTL must be smaller than the value of max-TTL.

The value is an integer ranging from 1 to max-ttl. The default value is 1.
-m max-ttl Specifies a maximum TTL. Usually, the maximum TTL is set to the number of hops the packet passes through. You need to use this parameter to change the TTL. If first-TTL is specified, the value of max-TTL must be greater than the value of first-TTL. The value is an integer ranging from first-ttl to 255. The default value is 30.
-p port Specifies an UDP port number of the destination host.
  • If no UDP port number is specified for the destination host, when you run the tracert command, a port with the port number greater than 32768 is randomly chosen for the destination host to receive tracert packets.
  • Before specifying the UDP port number for the destination host, ensure that the port is not in use; otherwise, the tracert test fails.
The value is an integer ranging from 1 to 65535. The default value is 33434.
-q nqueries Specifies the number of probe packets to be sent each time. In the case of poor network qualities, you can set this parameter to a comparatively larger value to ensure that the probe packet can reach the destination. The value is an integer ranging from 1 to 65535. The default value is 3.
-w timeout Specifies a period of time for waiting for a response. If a test packet times out when reaching a gateway, "*" is displayed.

In the case of poor network qualities and a low network transmission rate, it is recommended to prolong the timeout period.

The value is an integer ranging from 1 to 65535, in ms. The default value is 5000.
-vpn6-instance vpn6-instance-name Specifies a name of the VPN instance to which the destination address belongs. The value is a string of 1 to 31 characters without spaces.
-a source-ipv6-address Specifies the source address of a probe packet. source-ip-address specifies the IPv6 address of the local interface.
-s packet-size Specifies an UDP payload of packets to be sent in the tracert command.

The value is an integer ranging from 20 to 9600, in bytes. The default value is 20.

ipv6-host Specifies a domain name or an IPv6 address of the destination host. -

Views

All views

Default Level

0: Visit level

Usage Guidelines

This command is available to aid upgrade compatibility. It can only be run during the configuration restoration phase of the upgrade.

After the upgrade, this command is no longer supported, and it is replaced by the tracert ipv6 [ -f first-ttl | -m max-ttl | -p port | -q nqueries | -w timeout | -a source-ipv6-address | -s byte-number | vpn-instance vpn-instance-name ] * ipv6-host command.

Copyright © Huawei Technologies Co., Ltd.
Copyright © Huawei Technologies Co., Ltd.
Next topic >