Technical Documentation

traceoptions (DHCP Local Server)

Syntax

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

Hierarchy Level

[edit logical-systems logical-system-name routing-instances routing-instance-name system services dhcp-local-server],[edit logical-systems logical-system-name system services dhcp-local-server],[edit routing-instances routing-instance-name system services dhcp-local-server],[edit system services dhcp-local-server]

Release Information

Statement introduced in JUNOS Release 9.0.

Description

Define tracing operations for DHCP processes.

Options

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 to create before overwriting the oldest one. When a trace file named trace-file reaches the configured maximum size, it is renamed trace-file.0 and a new trace-file is created. When the new trace-file reaches the maximum size, trace-file.0 is renamed trace-file.1, trace-file is renamed trace-file.0, and a new trace-file is created. This renaming scheme continues until the maximum number of trace files is reached. Then the oldest trace file is overwritten. To change the maximum file size from its default, include the size statement.

Range: 2 through 1000
Default: 3 files

flag flag—Operation type for which to include a trace in the log. To specify more than one tracing operation, include multiple flag statements. You can include the following flags:

  • all—Trace all operations.
  • auth—Trace authentication operations.
  • database—Trace database events.
  • dhcpv6-general—Trace miscellaneous DHCPv6 events.
  • dhcpv6-io—Trace I/O operations for DHCPv6.
  • dhcpv6-packet—Trace DHCPv6 packet decoding operations.
  • dhcpv6-packet-option—Trace DHCPv6 option decoding operations.
  • dhcpv6-rpd—Trace routing protocol process events for DHCPv6.
  • dhcpv6-session-db—Trace session database operations for DHCPv6.
  • dhcpv6-state—Trace changes in state for DHCPv6 operations.
  • fwd—Trace firewall process events.
  • general—Trace miscellaneous events.
  • ha—Trace high availability-related events.
  • interface—Trace interface operations.
  • io—Trace I/O operations.
  • packet—Trace packet decoding operations.
  • packet-option—Trace DHCP option decoding operations.
  • performance—Trace performance measurement operations.
  • profile—Trace profile operations.
  • rpd—Trace routing protocol process events.
  • rtsock—Trace routing socket operations.
  • session-db—Trace session database operations.
  • state—Trace changes in state.
  • statistics—Trace baseline statistics.
  • ui—Trace user interface operations.

match regex—(Optional) Refine the output to include lines that contain the regular expression.

no-remote-trace—Disable remote tracing.

no-world-readable—(Optional) Allow only the user root and users who have the JUNOS maintenance permission to access the trace files.

size size—(Optional) Maximum size of each trace file, in kilobytes (KB), megabytes (MB), or gigabytes (GB). This setting interacts with the configured maximum number of trace files to determine the amount of tracing data that is saved before the oldest data is overwritten. To change the maximum number of files from its default, include the files statement.

Syntax: xk to specify KB, xm to specify MB, or xg to specify GB
Range: 10 KB through 1 GB
Default: 128 KB

world-readable—(Optional) Enable all users to access the trace files.

Required Privilege Level

system—To view this statement in the configuration.

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

Published: 2010-04-26