traceoptions
Syntax
- traceoptions {
- file filename <files number> <no-stamp> <replace> <size size> <world-readable | no-world-readable>;
- flag flag <disable>;
- }
Hierarchy Level
- [edit ethernet-switching-options]
Release Information
Statement introduced in JUNOS Release 9.2 for EX Series switches.
Description
Define global tracing operations for access security features on Ethernet switches.
Default
The traceoptions feature is disabled by default.
Options
-
disable—(Optional) 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.
-
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:
- access-security—Trace access security events.
- all—All tracing operations.
- config-internals—Trace internal configuration operations.
- forwarding-database—Trace forwarding database and next-hop events.
- general—Trace general events.
- interface—Trace interface events.
- ip-source-guard—Trace IP source guard events.
- krt—Trace communications over routing sockets.
- lib—Trace library calls.
- normal—Trace normal events.
- parse—Trace reading of the configuration.
- regex-parse—Trace regular-expression parsing operations.
- rtg—Trace redundant trunk group events.
- state—Trace state transitions.
- stp—Trace spanning-tree events.
- task—Trace Ethernet-switching task processing.
- timer—Trace Ethernet-switching timer processing.
- vlan—Trace VLAN events.
-
no-stamp—(Optional) Do not timestamp the trace file.
- Default: If you omit this option, timestamp information is placed at the beginning of each line of the tracing output.
-
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 rather than appending to it.
- Default: 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 kilobytes (KB), megabytes (MB), or gigabytes. 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 gigabyte
- 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.