SIC DEBUG

###
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.