Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

traceoptions (IGMP Snooping)

 

Syntax

Hierarchy Level

Release Information

Statement introduced in Junos OS Release 9.1 for EX Series switches.

Statement introduced in Junos OS Release 13.2 for the QFX series.

Description

Define tracing operations for IGMP snooping.

Default

The traceoptions feature is disabled by default.

Options

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

files number—(Optional) Maximum number of trace files, including the active trace file. When a trace file reaches its maximum size, its contents are archived into a compressed file named filename.0 and the trace file is emptied. When the trace file reaches its maximum size again, the filename.0 archive file is renamed filename.1 and a new filename.0 archive file is created from the contents of the trace file. This process continues until the maximum number of trace files is reached, at which point the system starts overwriting the oldest archive file each time the trace file is archived. 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: 10 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.

  • general—Trace general IGMP snooping protocol events.

  • krt—Trace communication over routing socket.

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

  • nexthop—Trace nexthop-related events.

  • normal—Trace normal IGMP snooping protocol events. If you do not specify this flag, only unusual or abnormal operations are traced.

  • 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.

  • vlan—Trace VLAN-related events.

flag-modifier—(Optional) Modifier for the tracing flag. You can specify one or more of these modifiers per flag:

  • detail—Provide detailed trace information

  • disable—Disable the tracing operation. You can use this option to disable a single operation when you have defined a broad group of tracing operations, such as all.

  • receive—Packets being received.

  • send—Packets being transmitted.

no-stamp—(Optional) Omit the timestamp at the beginning of each line in the trace file.

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

replace—(Optional) Replace an existing trace file if there is one. If you do not include this option, tracing output is appended to an existing trace file.

size size —(Optional) Maximum size of each trace file, in bytes, kilobytes (KB), megabytes (MB), or gigabytes (GB). When a trace file named trace-file reaches its maximum size, it is zipped and 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 size, you also must specify a maximum number of files with the files option.

Syntax: x to specify bytes, xk to specify KB, xm to specify MB, or xg to specify GB

Range: 10240 through 4294967295 bytes

Default: 128 KB

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

Required Privilege Level

routing—To view this statement in the configuration.

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