Create a log file

A log file can provide invaluable information to help diagnose and resolve a problem you are reporting to Forge Support. To generate a log file, either select the Help ‣ Logging ‣ Automatic menu option or start Linaro Forge with the --debug and --log arguments:

$ ddt --debug --log=<logfilename>
$ map --debug --log=<logfilename>

<logfilename> is the name of the log file to generate.

Reproduce the problem using as few processors and commands as possible, and when complete, close the program as usual.

On some systems, this file might be quite large. If so, compress it using a program such as gzip or bzip2 before sending it to Forge Support.

If your problem can only be replicated on large process counts, do not use the Help ‣ Logging ‣ Debug menu item or the --debug argument because these generate very large log files. Instead, use the Help ‣ Logging ‣ Standard menu option or the --log argument.

Note

If you are connecting to a remote system, the log file is generated on the remote host and copied back to the client when the connection is closed. The copy does not happen if the target application crashes or the network connection is lost.

In these cases, the remote copy of the log file is in the tmp subdirectory of the Linaro configuration directory for the remote user account. The directory is ~/.allinea, unless overridden by the FORGE_CONFIG_DIR environment variable.