traceoptions (Protocols Link Management)
Syntax
traceoptions {
file filename <files number> <size size> <world-readable | no-world-readable>;
flag flag <flag-modifier> <disable>;
}
Hierarchy Level
[edit logical-systems logical-system-name protocols link-management], [edit protocols link-management]
Description
Enabling tracing can adversely impact scale and performance and may increase security risk. We strongly recommend using the trace, tracing, or traceoptions commands only under the guidance of a JTAC support engineer. After collecting the debug information, immediately disable tracing to minimize risk and restore normal system performance.
Trace options for the LMP protocol.
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.
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.
Then the oldest trace file is overwritten.
Range: 2 through 1000
Default: 2 files
If you specify a maximum number of files, you must also include
the size statement to specify the maximum file size.
flag—Tracing operation
to perform. To specify more than one tracing operation, include multiple flag statements.
all—Trace all available operationshello-packets—Trace hello packets on any LMP control channelinit—Output from the initialization messagespackets—Trace all packets other than hello packets on any LMP control channelparse—Operation of the parserprocess—Operation of the general configurationroute-socket—Operation of route socket eventsrouting—Operation of the routing protocolsserver—Server processing operationsshow—showcommand servicing operationsstate—Trace state transitions of the LMP control channels and traffic engineering links
flag-modifier—(Optional)
Modifier for the tracing flag. You can specify one or more of these
modifiers:
detail—Provide detailed trace informationreceive—Packets being receivedsend—Packets being transmitted
no-world-readable—(Optional) Prevent all users
from reading the log 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 this size, it is renamed trace-file.0. When the trace-file again
reaches this size, trace-file.0 is
renamed trace-file.1 and trace-file is renamed trace-file.0. This renaming scheme continues until the maximum number
of trace files is reached. Then the oldest trace file is overwritten.
Syntax:
xkto specify KB,xmto specify MB, orxgto specify GB
Range: 10 KB through the maximum file size supported on your system
Default: 1 MB
If you specify a maximum file size, you must also include the files statement to specify the maximum number of files.
world-readable—(Optional) Enable log file access
for all users.
Required Privilege Level
routing and trace—To view this statement in the configuration.
routing-control and trace-control—To add this statement to the configuration.
Release Information
Statement introduced before Junos OS Release 7.4.
Support for hello-packets, packets, and state flags added in Junos OS Release 8.1.