Next: , Previous: Running Options, Up: Invoking Cold

1.6 Debugging and Status Options:

-i level Interactivity - sets the level of interactivity for the program. Options are as follows: [The numerical values are the values that need to be given. Hopefully I will soon add support for inputting the macro versions]

-1LOGFILE send all messages to a log file.
0AWAY display messages, make default choices, don't ask for user input.
1VITAL only request user input when absolutely necessary.
2PRESENT request user input whenever it may be helpful to do so.
3ALL request user input on all irregularities, even when no input would usually be expected.
32START Perform all file loading and parsing operations at the start of execution, and prompt for user input at this time. Do not prompt for user input once optimisation has started.
33STARTCHECK Like START, but print a message indicating when the optimisation is ready to start.

-D level Debug level - controls the amount of debuging information output. The following options are available: [The numerical values are the values that need to be given. Hopefully I will soon add support for inputting the macro versions]

-1 SILENCE No Debugging or even status updates displayed.

0 NODEBUG Appropriate for most users. This provides basic status updates indicating the progress of the program. This should be sufficient to indicate whether the program is progressing normally. If a problem occurs, the program can be rerun with a higher debugging level to identify the problem.

1 BASICDEBUG Gives basic debugging output. May be helpful if something goes wrong. Might identify file format problems or similar things that may be fixed easily by the user.

2 FULLDEBUG Mostly only useful for developing Cold, or for users who want to extend Cold with their own code. if you want to send a bug report, please include the output from the command run with -D2.

Numbers greater than 2 default to 2, so running with -D3 is also OK, and will allow for any later extensions to the debugging options.

-q [Not yet implemented] quiet - does not print any information about the status of the program - just outputs the desired information at the end. This can be achieved with -D -1.

-v [Not yet implemented] verbose - provides a lot of information about the current state of the program. Useful for debugging. This can be achieved with -D 2

--showeverysite number controls the status display. When calculating a hessian, the program will print information about which site it is currently working on. The value number controls how often the program prints this message. If number is larger than the total number of sites, then the program never displays the message.