You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

SLIC Bug Reports

There are many possible sources of errors when the simulator crashes or exhibits "anomalous" or incorrect behavior. Also, some types of crashes, especially those that occur during batch jobs after a lot of events have been executed, can be difficult to produce.

Therefore, it is imperative to make all bug reports as detailed as possible, with step-by-step information on repeating the error.

At a minimum, a good bug report should have the following information.

Jira

Simulator bugs are tracked using the SLIC Jira.

This is preferable to an email, because the Jira automatically emails the SLIC project lead when a bug report is filed. (This saves time from having to fill this out manually based on an email report.)

Information for the Bug Report

SLIC Version

The version is very important, because bugs (sometimes) get fixed in newer versions.

This is a string stored in the file $SLIC_BASE/VERSION.

Simply print the contents of this file.

cat VERSION

And paste it into your bug report.

Operating System.

On a Unix system, execute this command.

uname -a

And paste the output into the bug report.

Compiler Version

From the command-line, execute this command.

g++

And paste the last line.

Input StdHep File

It is vitally important that the StdHep file be listed in the bug report, because many types of errors can occur from malformed or incorrectly processed StdHep files.

Place the file in an accessible location, such as a WWW directory or a publically readable AFS or SLAC NFS directory.

List the full path to this file in the report.

Event Number or List

Oftentimes, errors will occur only on certain event numbers. Please list the event numbers that will reproduce the error in question.

Repeating the Error

If special steps are required to repeat the error, please list them.

Caveats

Older versions of SLIC and the corresponding Geant4 versions are considered deprecated. If you are using an older version, please consider upgrading to the latest versions of SLIC and LCDD and attempt to repeat the error with this configuration.

  • No labels