set trace

Use the set trace command to

Root privileges are required to execute the set trace command.

Command Syntax

Configuration Syntax

Enter the set trace command as shown below to configure tracing:

set trace [loghost=ip_addr] [mask=type:severity] [mode={historical|concurrent}] [state={on|off|dump}] [syslog={on|off}]

Display Syntax

Enter the set trace command as shown below to display the status of tracing information:

set trace

Command Fields

Command Field

Description

loghost

Specifies the IP address of a host to which trace messages should be sent.

This host must be running the syslog daemon.

mask=type:severity

Specifies the type and nature of event that should be traced.

type - is one of the following:

  • arp - Address Resolution Protocol
  • cache - Routing cache
  • connect - connect functionality
  • dhcp - DHCP functionality
  • dns - Domain Name System
  • ether - Ethernet
  • fwdr - Routing (forwarded IP packets) - Digi One RealPort and PortServer TS 2/4 only
  • icmp - Internet Control Message Protocol
  • inetd - Internet daemon (based on received packets)
  • ip - Internet Protocol
  • lpd - Line Printer Daemon
  • lpd_a - Line Printer Daemon (ASCII)
  • lpd_h - Line Printer Daemon (hex)
  • netd - Net daemon
  • radius - RADIUS (not supported on Digi One RealPort and PortServer TS 24/)
  • realp - RealPort
  • rlogin - rlogin
  • routed - Route daemon
  • serial - Serial ports
  • snmp - Simple Network Management Protocol
  • stream - STREAMS internal data processing methodology
  • tcp - Transmission Control Protocol
  • telnet - Telnet
  • udp - User Datagram Protocol
  • user - Users
  • * - All entities listed in this table

severity - is one of the following severity levels:

  • critical (the default) - This means that tracing is done on only the most severe events. This level produces the least amount of trace data.
  • warning - This means tracing is done on critical events and on less severe events as well. This level produces more trace data than critical, but less than info.
  • info - This means tracing is done on many events. It produces more trace data than previous levels. debug Is the level to use for debugging. Do not use this level for anything but debugging.
  • ignore - Turns off all trace messages.
  • debug - Provides the most verbose trace messages

mode

historical - means that all trace messages stored in the buffer may be displayed by issuing the following command: set trace state=dump.

concurrent - means that all trace messages are printed to the administrative terminal when state=on.

state

on - means that all messages in the trace buffer are displayed. Once they are displayed, the state remains on.

off - means that tracing off.

dump - means that all messages in the trace buffer are displayed. Once they are displayed, the state returns to off.

The default is off.

syslog

on - means that trace messages are sent to the host identified on the log-host field.

off - means that trace messages are not sent to a host.

The default is off.

Command Examples

Displaying Trace Settings

In this example, the set trace command displays current trace settings.

set trace

Configuring Trace Levels

In this example, the set trace command configures tracing for ARP events.

set trace mask=arp:warning mode=historical state=dump