Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

traceoptions (Protocols IGMP Snooping)

Syntax

Hierarchy Level

Description

Define tracing operations for IGMP snooping.

Default

The traceoptions feature is disabled by default.

Enabling traceoptions under the igmp-snooping hierarchy enables igmp-snooping. Correspondingly, disabling traceoptions under the igmp-snooping hierarchy disables igmp-snooping.

Options

file filename—Name of the file to receive the output of the tracing operation. All files are placed in the directory /var/log.

files number—(Optional) Maximum number of trace files. When a trace file named trace-file reaches its maximum size, it is renamed trace-file.0, then trace-file.1, and so on, until the maximum number of trace files is reached (xk to specify KB, xm to specify MB, or xg to specify gigabytes), at which point the oldest trace file is overwritten. If you specify a maximum number of files, you also must specify a maximum file size with the size option.

  • Range: 2 through 1000

  • Default: 3 files

flag flag —Tracing operation to perform. To specify more than one tracing operation, include multiple flag statements. You can include the following flags:

  • all—All tracing operations.

  • client-notification—Trace notifications.

  • general—Trace general IGMP snooping protocol events.

  • group—Trace group operations.

  • host-notification—Trace host notifications.

  • leave—Trace leave group messages (IGMPv2 only).

  • normal—Trace normal IGMP snooping protocol events.

  • packets—Trace all IGMP packets.

  • policy—Trace policy processing.

  • query—Trace IGMP membership query messages.

  • report—Trace membership report messages.

  • route—Trace routing information.

  • state—Trace IGMP state transitions.

  • task—Trace routing protocol task processing.

  • timer—Trace routing protocol timer processing.

no-world-readable—(Optional) Restrict file access to the user who created the file.

size size—(Optional) Maximum size of each trace file, in kilobytes (KB), megabytes (MB), or gigabytes (GB). When a trace file named trace-file reaches its maximum size, it is renamed trace-file.0, then trace-file.1, and so on, until the maximum number of trace files is reached. Then the oldest trace file is overwritten. If you specify a maximum number of files, you also must specify a maximum file size with the files option.

  • Syntax: xk to specify KB, xm to specify MB, or xg to specify gigabytes

  • Range: 10 KB through 1 gigabytes

  • Default: 128 KB

world-readable—(Optional) Enable unrestricted file access.

Required Privilege Level

routing—To view this statement in the configuration.routing-control—To add this statement to the configuration.

Release Information

Statement introduced in Junos OS Release 8.5.