Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

TechLibrary
Navigation

traceoptions (Protocols OpenFlow)

Syntax

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

Hierarchy Level

[edit protocols openflow]

Release Information

Statement introduced in Junos OS Release 13.3.

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. 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 size option and 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.
  • configuration—OpenFlow configuration events.
  • filter—OpenFlow filter events.
  • flow—OpenFlow flow events.
  • function—OpenFlow entry and exit events.
  • interface—OpenFlow interface 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) Only log lines that match the regular expression.

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: 10240 through 1073741824 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.

 

Related Documentation

 

Published: 2014-04-29

Previous Page Next Page