Technical Documentation

traceoptions (DHCP Relay Agent)


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 forwarding-options dhcp-relay],[edit logical-systems logical-system-name forwarding-options dhcp-relay],[edit logical-systems logical-system-name routing-instances routing-instance-name forwarding-options dhcp-relay],[edit routing-instances routing-instance-name forwarding-options dhcp-relay]

Release Information

Statement introduced in JUNOS Release 8.5.


Configure tracing operations for extended DHCP relay agent processes.


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


file-name—Name of the file to receive the output of the tracing operation. Enclose the name in quotation marks (“ ”). All files are placed in a file named jdhcpd in the directory /var/log. If you include the file statement, you must specify a filename.

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. 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:

  • all—Trace all events
  • auth—Trace authentication events
  • 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) Disable unrestricted file access.

size size—(Optional) Maximum size of each trace file, in kilobytes (KB), megabytes (MB), or gigabytes (GB). If you specify a maximum file size, you also must specify a maximum number of trace files with the files option.

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 unrestricted file access.

The remaining statements are explained separately.

Required Privilege Level

interface—To view this statement in the configuration.

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

Published: 2010-04-15