CP2K Open Source Molecular Dynamics

User Tools

Site Tools

Trace:
dev:error_handling

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
dev:error_handling [2015/10/02 11:24] – [Error Handling] vondeledev:error_handling [2025/03/08 13:41] (current) – oschuett
Line 1: Line 1:
 ====== Error Handling ====== ====== Error Handling ======
  
-In CP2K there exist three convenient macros for error handling. They are defined in [[src>cp2k/src/common/cp_common_uses.f90]], and are therefore always available. However, these macros can only be used for **short messages** (approximately less than 7 words), because of Fortran's line length limitation.+In CP2K there exist three convenient macros for error handling. They are defined in [[src>src/base/base_uses.f90]], and are therefore always available. However, these macros can only be used for **short messages** (approximately less than 7 words), because of Fortran's line length limitation.
 <code Fortran> <code Fortran>
    CPWARN("A short warning message")    CPWARN("A short warning message")
    CPABORT("A short error message")    CPABORT("A short error message")
-   CPASSERT(2>1) ! For sanity checks only, not for user errors.+   CPASSERT(2 > 1) ! For sanity checks only, not for user errors.
 </code> </code>
  
 For longer messages one can use these two routines: For longer messages one can use these two routines:
 <code Fortran> <code Fortran>
-   CALL cp_warn(__LOCATION__,"A long warning message "\\& +   CALL cp_warn(__LOCATION__,"A long warning message "//& 
-                "which can span multiple lines and contains "\\&+                "which can span multiple lines and contains "//&
                 "some valuable advice for the user.")                 "some valuable advice for the user.")
  
-   CALL cp_abort(__LOCATION__,"A long error message "\\& +   CALL cp_abort(__LOCATION__,"A long error message "//& 
-                 "with even more valuable advises.")      +                 "with even more valuable advice.")      
 </code> </code>
  
-cp_warn and CPWARN should be used sparingly, as they will produce output (and localLog files) from all MPI ranks. As such they are most useful for warning conditions that happen only on one of the ranks.+<note important> 
 +Messages from ''CPWARN'' and ''cp_warn'' are only printed on the first MPI-rank.\\ Warnings issued on other ranks are ignored. 
 +</note>
  
 ===== Cheat Sheet ===== ===== Cheat Sheet =====
dev/error_handling.1443785071.txt.gz · Last modified: 2020/08/21 10:14 (external edit)