next up previous contents index
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