Version constants plus functions to retrieve list of ...

[pnorbert]

available engines, operators and features. This is a C header but it's part of the core library.

Fixes #3630

$ bpls -Vv
blps: ADIOS file introspection utility

Build configuration:
ADIOS version: 2.9.0.144 (9a69cb875)
C++ Compiler:  GNU 9.4.0
Target OS:     Linux-5.15.90.1-microsoft-standard-WSL2
Target Arch:   x86_64
Available engines = 10: BP3, BP4, BP5, SST, SSC, Inline, MHS, ParaViewADIOSInSituEngine, Null, Skeleton
Available operators = 6: BZip2, Blosc, MGARD, MGARDPlus, ZFP, None
Available features = 4: MPI, Fortran, Python, AWSSDK

C example:

#include <stdio.h>
#include "adios2_libinfo.h"

int main (int argc, char *argv[])
{
    printf("ADIOS2 C lib version %d.%d.%d\n", adios2_version_major,
            adios2_version_minor, adios2_version_patch);
    printf("ADIOS2 C lib version str %s\n", adios2_version_str);

    int nengines;
    char const **list_engines;
    adios2_available_engines(&nengines, &list_engines);
    printf("Available engines = %d:", nengines);
    for (int i = 0; i < nengines; ++i)
    {
        printf(" %s", list_engines[i]);
        if (i < nengines - 1)
        {
            printf(",");
        }
    }
    printf("\n");
    adios2_free_list(nengines, &list_engines);

    int noperators;
    char const **list_operators;
    adios2_available_operators(&noperators, &list_operators);
    printf("Available operators = %d:", noperators);
    for (int i = 0; i < noperators; ++i)
    {
        printf(" %s", list_operators[i]);
        if (i < noperators - 1)
        {
            printf(",");
        }
    }
    printf("\n");
    adios2_free_list(noperators, &list_operators);

    int nfeatures;
    char const **list_features;
    adios2_available_features(&nfeatures, &list_features);
    printf("Available features = %d:", nfeatures);
    for (int i = 0; i < nfeatures; ++i)
    {
        printf(" %s", list_features[i]);
        if (i < nfeatures - 1)
        {
            printf(",");
        }
    }
    printf("\n");
    adios2_free_list(nfeatures, &list_features);

    return 0;
}

Build C example:

gcc -o test_adios2_libinfo -I/opt/adios2/include test_adios2_libinfo.c -Wl,-rpath,/opt/adios2/lib /opt/adios2/lib/libadios2_core.so.2.9

[pnorbert]

@eschnett @ax3l Please review.

[pnorbert]

@vicentebolea What went wrong here in the Ascent test? The Install.cmake.* tests failed but it's not clear what was wrong and what could be done about it.

[vicentebolea]

Those tests failures are unrelated to this change. They have something to do with the ascent DFS. I am disabling them for a little while.

…

On Mon, Jun 26, 2023, 17:37 pnorbert ***@***.***> wrote: @vicentebolea <https://github.com/vicentebolea> What went wrong here in the Ascent test? The Install.cmake.* tests failed but it's not clear what was wrong and what could be done about it. — Reply to this email directly, view it on GitHub <#3676 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAHFOFXGBCS6CO7GNQMUCD3XNITLVANCNFSM6AAAAAAZTHRCMM> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[anagainaru]

Tested with the GPU backends and it looks good:

Available features = 4: MPI, Fortran, Python, Kokkos (Host, CUDA)

[vicentebolea]

Looks good, I am not too strong on the const char/char const, I can see that you are trying to make the char const *const ** easier to read. I can see both trade-offs, I am happy both ways :)

[vicentebolea]

Clicking update branch with rebase should get rid of the failed tests in Ascent.

[vicentebolea]

@pnorbert I made the edit as per your request, I added a unit test just to be complete and made a few changes.

[vicentebolea]

@eisenhauer Norbert needs this in the incoming 2.9.1 release, he asked me to finish the task instead of him as he is not available at the moment. I wonder if you could review this

[eisenhauer]

Looks good to me...

[pnorbert]

Looks good to me, just please make sure a C code can still use this, nothing breaks with expecting C++.