auxerror(3)

💖 auxerror — the MEPACK error-handling page (yes, that auxerror(3), bestie)

okay so this is the manual page for auxerror from MEPACK, and it's literally all about error handling. Sit down, grab a strawberry 🍓, we're doing this.

---

✨ NAME ✨

auxerror — Error Handling Routines

• Error Handling and Error call back routines.

that's it, that's the whole vibe. errors happen, we handle them, we move on 💅

---

🌸 SYNOPSIS 🌸

Functions

subroutine xerror_handler (name, info)
    Error handler callback subroutine.
subroutine xerror_set_handler_c (routine)
    Set a C routine as error handling callback.
subroutine xerror_set_handler_f (routine)
    Set a Fortran routine as error handling callback.

three little functions, all serving cunt, all about catching those errors before they ruin the whole function's moment 🫶

---

🦋 Detailed Description 🦋

Error Handling and Error call back routines.

MEPACK uses a similar error handling as LAPACK. In contrast to LAPACK, the error handler in MEPACK is realized as a callback routine, which can be exchanged via passing a pointer to the new function. The callback function can either be a C or a Fortran function.

not me being obsessed with the fact that you can just swap out the error handler by passing a pointer. iconic behaviour, honestly. LAPACK could never 💀

---

👑 Function Documentation 👑

🌈 subroutine xerror_handler ( name, info )

Error handler callback subroutine.

Purpose:

!>  The XERROR_HANDLER subroutine is the callback function used by the sanity checks
!>  of the computational subroutines. It either displays an error message of
!>  if an alternative error handler is set before via XERROR_SET_HANDLER_C or
!>  XERROR_SET_HANDLER_F it delegates the error to this function.
!>

See also

xerror_set_handler_c

xerror_set_handler_f

Arguments:

Parameters

NAME

!>           NAME is CHARACTER(*)
!>           Specifies the name of the function where the error appeared.
!>

INFO

!>           INFO is INTEGER
!>           Specifies the error which appeared in the subroutine NAME.
!>

Author

Martin Koehler, MPI Magdeburg

Date

October 2025

Definition at line 63 of file xerror_handler_doc.f90.

---

💜 subroutine xerror_set_handler_c ( routine )

Set a C routine as error handling callback.

Purpose:

!>  The XERROR_SET_HANDLER_C subroutine sets the error callback in XERROR_HANDLER to
!>  a C function with the following signature:
!>
!>      void error_handler(const char *name, int info);
!>
!>  where name is a 0 terminated C compatible string. In order to avoid memory leaks
!>  the function must return to its call or exit the whole program.
!>

See also

xerror_handler

xerror_set_handler_f

Arguments:

Parameters

ROUTINE

!>           ROUTINE is an EXTERNAL SUBROUTINE
!>           Specifies a C subroutine which is executed as alternative error handler.
!>

Authors:

Author

Martin Koehler, MPI Magdeburg

Date

October 2025

Definition at line 108 of file xerror_handler_doc.f90.

lowkey important reminder: that C handler must return to its caller or exit the whole program, fr fr. do NOT let it wander off, the memory leaks will find you 😭

---

🎀 subroutine xerror_set_handler_f ( routine )

Set a Fortran routine as error handling callback.

Purpose:

!>  The XERROR_SET_HANDLER_F subroutine sets the error callback in XERROR_HANDLER to
!>  a Fortran function with the following signature:
!>
!>      SUBROUTINE ERROR_HANDLER(NAME, INFO)
!>          CHARACTER NAME(*)
!>          INTEGER INFO
!>
!>  where NAME is a Fortran-like string. In order to avoid memory leaks
!>  the function must return to its call or exit the whole program.
!>

See also

xerror_handler

xerror_set_handler_c

Arguments:

Parameters

ROUTINE

!>           ROUTINE is an EXTERNAL SUBROUTINE
!>           Specifies a Fortran subroutine which is executed as alternative error handler.
!>

Authors:

Author

Martin Koehler, MPI Magdeburg

Date

October 2025

Definition at line 155 of file xerror_handler_doc.f90.

same energy as the C one bestie — return to your call or exit the whole program. no wandering, no leaks, we stay ✨responsible✨ 🧚

---

⭐ Author ⭐

Generated automatically by Doxygen for MEPACK from the source code.

---

and that's the whole page!! 🌈

cute little sign-off for you: this absolute banger of a page is Version 1.1.2, dated Thu Oct 9 2025 00:00:00, and it lives under the manual name auxerror(3). periodt 💅✨🦋