Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

traceoptions (Protocols OpenFlow)

date_range 20-Nov-23

Syntax

content_copy zoom_out_map
traceoptions {
    file <filename> <files number> <match regular-expression> <size size> <world-readable | no-world-readable>;
    flag flag;
    no-remote-trace; 
}

Hierarchy Level

content_copy zoom_out_map
[edit protocols openflow]

Description

Define tracing operations for OpenFlow.

Default

If you do not include this statement, no OpenFlow-specific tracing operations are performed.

Options

file filename

Name of the file to receive the output of the tracing operation. All files are placed in the /var/log directory.

  • Default: /var/log/ofd

files number

(Optional) Maximum number of trace files. When a trace file named trace-file reaches its maximum size, it is renamed and compressed to trace-file.0.gz. When trace-file again reaches its maximum size, trace-file.0.gz is renamed trace-file.1.gz, and trace-file is renamed and compressed to trace-file.0.gz. This renaming scheme continues until the maximum number of trace files is reached. After this, the oldest trace file is overwritten.

If you specify a maximum number of files, you also must specify a maximum file size by using the size option and also a filename.

  • Range: 2 through 1000 files

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

  • barrier—OpenFlow barrier events.

  • configuration—OpenFlow configuration events.

  • filter—OpenFlow filter events.

  • flow—OpenFlow flow events.

  • function—OpenFlow entry and exit events.

  • group—(Appears only for Juniper Networks devices running OpenFlow v1.3.1 or later) OpenFlow group events.

  • interface—OpenFlow interface events.

  • nh—OpenFlow next-hop events.

  • packet-io—OpenFlow packet in and packet out events.

  • packets—OpenFlow packet events.

  • statistics—OpenFlow statistics request and reply events.

  • switch—OpenFlow switch events including controller connection messages and keepalives, and packets sent to and received from the controller.

match regular-expression

(Optional) Log only those lines that match the regular expression.

no-remote-trace

(Optional) Disable tracing and logging operations that track normal operations, error conditions, and packets that are generated by or have passed through the Juniper Networks device.

no-world-readable

(Optional) Disable unrestricted file access, which restricts file access to the owner. This is the default.

size size

(Optional) Maximum size of each trace file in bytes, kilobytes (KB), megabytes (MB), or gigabytes (GB). If you do not specify a unit, the default is bytes. If you specify a maximum file size, you also must specify a maximum number of trace files with the files option and a filename.

  • Syntax: size to specify bytes, sizek to specify KB, sizem to specify MB, or sizeg to specify GB

  • Range: 10,240 through 1,073,741,824 bytes

  • Default: 128 KB

world-readable

(Optional) Enable unrestricted file access.

Required Privilege Level

admin—To view this statement in the configuration.

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

Release Information

Statement introduced in Junos OS Release 13.3.

footer-navigation