Next: SIC COPY
Up: SIC
Previous: SIC DATE
Contents
Index
SIC DEBUG
[SIC\]SIC DEBUG LUN [Number]
[SIC\]SIC DEBUG IMAGE [Number]
[SIC\]SIC DEBUG MEMALIGN
[SIC\]SIC DEBUG MESSAGE
[SIC\]SIC DEBUG GFORTRAN
[SIC\]SIC DEBUG RESOURCES
[SIC\]SIC DEBUG PYTHON
[SIC\]SIC DEBUG VARIABLES
[SIC\]SIC DEBUG LOCALE [Value]
[SIC\]SIC DEBUG SYSTEM ON|OFF
Debugging command.
The first two keywords LUN and IMAGE print the status of reserved Logi-
cal UNit numbers (LUN), or of allocated image slots (IMAGE).
The MEMALIGN keyword will check if dynamically allocated buffers are
aligned on 4, 8, 16 and 32 bytes. Some applications (e.g. FFTW3) are
more or less faster dependending on the buffer alignment in memory.
The MESSAGE keyword swaps ON or OFF the debugging mode for messages.
When turning it ON, all messages to both screen and message files are
enabled. In this case it is a shortcut of the commands:
SIC MESSAGE GLOBAL ON
SIC MESSAGE GLOBAL A=FEWRIDTCU
When turning it OFF, standard message filters (maybe customized by user)
are re-enabled. It is a shortcut of the command:
SIC MESSAGE GLOBAL OFF
Default is debug mode turned OFF, unless a '-d' option has been provided
when invoking the Gildas executable.
The GFORTRAN keyword will check if the program is able to read and write
correctly Gildas binary files. Some versions of the Gfortran compiler
have an issue on this point, this command is intended to give a clear
status to the user.
The RESOURCES keyword will display current resource usage and limits
(memory, files, etc). See man pages for getrusage and getrlimit for de-
tails (Linux only).
The PYTHON keyword will display the Python version which was used to
compile Gildas against the one used at run time. If they are different,
this probably means troubles.
The VARIABLES keyword will display a technical list of the variables de-
fined in Sic.
The LOCALE keyword, with no more argument, will display the current
LC_ALL locale and some of its details. The current locale can be changed
with an extra argument. Take care that Gildas is English-speaking, e.g.
decimal point should be ".". If not, you are in trouble! It is wise to
use the standard default, i.e. the "C" locale.
The SYSTEM keyword enables (argument ON) or disables (argument OFF) a
debugging message displayed when a system() call is performed. system()
calls are convenient and flexible to execute shell commands, but under
Linux they need to fork a sub-process, duplicating temporarily the memo-
ry consumed by the current process. This may be a limiting factor on
many cases. Default is OFF, i.e. message are disabled.
Gildas manager
2024-03-29