# vim: set ft=c:

MPI_Aint_add:
    .desc: Returns the sum of base and disp
    .skip: ThreadSafe, Fortran, Errors, validate-ANY
    .seealso: MPI_Aint_diff
    .impl: direct
/*
    Notes:
    MPI_Aint_Add produces a new MPI_Aint value that is equivalent to the sum of the
    base and disp arguments, where base represents a base address returned by a call
    to MPI_GET_ADDRESS and disp represents a signed integer displacement. The resulting
    address is valid only at the process that generated base, and it must correspond
    to a location in the same object referenced by base. The addition is performed in
    a manner that results in the correct MPI_Aint representation of the output address,
    as if the process that originally produced base had called
    .vb
        MPI_Get_address((char *) base + disp, &result)
    .ve
*/
{
    MPI_Aint result;

    MPIR_ERRTEST_INITIALIZED_ORDIE();

    MPIR_FUNC_TERSE_ENTER;
    result = MPID_Aint_add(base, disp);
    MPIR_FUNC_TERSE_EXIT;

    return result;
}

MPI_Aint_diff:
    .desc: Returns the difference between addr1 and addr2
    .skip: ThreadSafe, Fortran, Errors, validate-ANY
    .seealso: MPI_Aint_add
    .impl: direct
/*
    Notes:
    MPI_Aint_diff produces a new MPI_Aint value that is equivalent to the difference
    between addr1 and addr2 arguments, where addr1 and addr2 represent addresses
    returned by calls to MPI_GET_ADDRESS. The resulting address is valid only at the
    process that generated addr1 and addr2, and addr1 and addr2 must correspond to
    locations in the same object in the same process. The difference is calculated
    in a manner that results the signed difference from addr1 to addr2, as if the
    process that originally produced the addresses had called
    .vb
        (char *) addr1 - (char *) addr2
    .ve
    on the addresses initially passed to MPI_GET_ADDRESS.
*/
{
    MPI_Aint result;

    MPIR_ERRTEST_INITIALIZED_ORDIE();

    MPIR_FUNC_TERSE_ENTER;
    result = MPID_Aint_diff(addr1, addr2);
    MPIR_FUNC_TERSE_EXIT;

    return result;
}

MPI_Get_processor_name:
    .desc: Gets the name of the processor
/*
    Notes:
    The name returned should identify a particular piece of hardware;
    the exact format is implementation defined.  This name may or may not
    be the same as might be returned by 'gethostname', 'uname', or 'sysinfo'.
*/
/* -- notes-2 --
     In Fortran, the character argument should be declared as a character string
     of 'MPI_MAX_PROCESSOR_NAME' rather than an array of dimension
     'MPI_MAX_PROCESSOR_NAME'.  That is,
    .vb
       character*(MPI_MAX_PROCESSOR_NAME) name
    .ve
     rather than
    .vb
       character name(MPI_MAX_PROCESSOR_NAME)
    .ve

     The sizes of MPI strings in Fortran are one less than the sizes of that string in C/C++ because the C/C++ versions provide room for the trailing null character required by C/C++. For example, MPI_MAX_ERROR_STRING is mpif.h is one smaller than the same value in mpi.h. See the MPI standard, sections 2.6.2 and 4.12.9. 
*/
{
    mpi_errno = MPID_Get_processor_name(name, MPI_MAX_PROCESSOR_NAME, resultlen);
    if (mpi_errno != MPI_SUCCESS)
        goto fn_fail;
}

MPI_Get_library_version:
    .desc: Return the version number of MPI library
    .skip: initcheck

MPI_Pcontrol:
    .desc: Controls profiling
    .skip: initcheck, ThreadSafe, validate-PROFILE_LEVEL, validate-VARARGS
    .impl: direct
/*
    Notes:
	This routine provides a common interface for profiling control.  The
	interpretation of 'level' and any other arguments is left to the
	profiling library.  The intention is that a profiling library will
	provide a replacement for this routine and define the interpretation
	of the parameters.
*/
{
    int mpi_errno = MPI_SUCCESS;
    va_list list;

    MPIR_ERRTEST_INITIALIZED_ORDIE();

    MPIR_FUNC_TERSE_ENTER;

    /* ... body of routine ...  */

    /* This is a dummy routine that does nothing.  It is intended for
     * use by the user (or a tool) with the profiling interface */
    /* We include a reference to va_start and va_end to (a) quiet some
     * compilers that warn when they are not present and (b) show how to
     * access any optional arguments */
    va_start(list, level);
    va_end(list);

    /* ... end of body of routine ... */
    MPIR_FUNC_TERSE_EXIT;
    return mpi_errno;
    /* There should never be any fn_fail case; this suppresses warnings from
     * compilers that object to unused labels */
}

MPI_Get_version:
    .desc: Return the version number of MPI
    .skip: initcheck

MPIX_GPU_query_support:
    gpu_type: GPU_TYPE, [MPIX_GPU_SUPPORT_CUDA, MPIX_GPU_SUPPORT_ZE, or MPIX_GPU_SUPPORT_HIP]
    is_supported: LOGICAL, direction=out, [true if gpu of given type is supported, false otherwise.]
    .desc: Returns whether the specific type of GPU is supported
    .skip: global_cs, validate-GPU_TYPE

MPIX_Query_cuda_support:
    .desc: Returns whether CUDA is supported
    .impl: direct
    .skip: global_cs, Errors
{
    int is_supported = 0;
    int mpi_errno ATTRIBUTE((unused));

    mpi_errno = PMPIX_GPU_query_support(MPIX_GPU_SUPPORT_CUDA, &is_supported);
    assert(mpi_errno == MPI_SUCCESS);

    return is_supported;
}

MPIX_Query_ze_support:
    .desc: Returns whether ZE (Intel GPU) is supported
    .impl: direct
    .skip: global_cs, Errors
{
    int is_supported = 0;
    int mpi_errno ATTRIBUTE((unused));

    mpi_errno = PMPIX_GPU_query_support(MPIX_GPU_SUPPORT_ZE, &is_supported);
    assert(mpi_errno == MPI_SUCCESS);

    return is_supported;
}

MPIX_Query_hip_support:
    .desc: Returns whether HIP (AMD GPU) is supported
    .impl: direct
    .skip: global_cs, Errors
{
    int is_supported = 0;
    int mpi_errno ATTRIBUTE((unused));

    mpi_errno = PMPIX_GPU_query_support(MPIX_GPU_SUPPORT_HIP, &is_supported);
    assert(mpi_errno == MPI_SUCCESS);

    return is_supported;
}