### set trace

Use the set trace command to

- Configure a device/terminal server for tracing

- Display tracing information

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`