# Remote trace utility: rtrace

Use this utility to monitor trace messages from local or remote instances of Natural Access Server (ctdaemon), set a global trace mask, and log trace messages to a file.

Note: The rtrace utility is available under Linux and Solaris only.

#### Usage

rtrace [options]

where options are the following values:

Option | Use this option to...
-? or -h | Access Help and terminate rtrace.
-@ host_name | Specify the name or IP address of the server to monitor. If unspecified, the default is localhost.
-f filename | Specify the name of a file to maintain a log of trace messages.

#### Description

When rtrace starts up, it connects to the specified server and waits for trace messages. All of the received messages are displayed and optionally logged to the specified file. Press Q or Esc to exit from rtrace.

To run rtrace, Natural Access Server (ctdaemon) must be running. If Natural Access Server (ctdaemon) disconnects from rtrace because of a system restart or failure, rtrace waits for Natural Access Server (ctdaemon) to restore the connection.

#### Procedure

To run rtrace:

Enter the following command at the prompt:

rtrace [-@ host_name] [-f filename]

For example, if you enter:

rtrace -@ localhost -f trace.log

rtrace connects to localhost and begins logging messages to trace.log.