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.