TechLibrary

Table of Contents

Guide That Contains This Content

[+] Expand All

[-] Collapse All

traceoptions (Ethernet Switching Options)

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 OS Release 11.1 for the QFX Series.

Note: The traceoptions statement is not supported on the QFX3000 QFabric system.

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.
analyzer—Trace analyzer events.
config-internal—Trace internal configuration operations.
filter—Trace filter transaction events.
forwarding-database—Trace forwarding database events.
general—Trace general events.
interface—Trace interface events.
krt—Trace communications over routing sockets.
lib—Trace library calls.
nexthop—Trace next-hop events.
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.
unknown-unicast-forwarding—Trace unknown unicast forwarding events.
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.