traceoptions
Syntax
- traceoptions {
- file filename <files number> <size size> <world-readable
| no-world-readable> <match regex>;
- flag flag (detail | disable | receive
| send);
- }
Hierarchy Level
- [edit protocols igmp-snooping]
Release Information
Statement introduced in JUNOS Release 9.1 for EX Series switches.
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. 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.
- general—Trace general IGMP snooping protocol events.
- 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.
-
match regex —(Optional) Refine the output to include lines that contain the regular expression.
-
no-world-readable—(Optional) Restricted 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.
