MPI_T_cvar_get_info(3) MPI MPI_T_cvar_get_info(3) NAME MPI_T_cvar_get_info - Get the information about a control variable SYNOPSIS int MPI_T_cvar_get_info(int cvar_index, char *name, int *name_len, int *verbosity, MPI_Datatype *datatype, MPI_T_enum *enumtype, char *desc, int *desc_len, int *bind, int *scope) INPUT PARAMETERS cvar_index - index of the control variable to be queried, value between $0$ and $num_cvar-1$ (integer) INPUT/OUTPUT PARAMETERS name_len - length of the string and/or buffer for name (integer) desc_len - length of the string and/or buffer for desc (integer) OUTPUT PARAMETERS name - buffer to return the string containing the name of the control variable (string) verbosity - verbosity level of this variable (integer) datatype - mpi datatype of the information stored in the control variable (handle) enumtype - optional descriptor for enumeration information (handle) desc - buffer to return the string containing a description of the con- trol variable (string) bind - type of mpi object to which this variable must be bound (integer) scope - scope of when changes to this variable are possible (integer) THREAD AND INTERRUPT SAFETY This routine is thread-safe. This means that this routine may be safely used by multiple threads without the need for any user-provided thread locks. However, the routine is not interrupt safe. Typically, this is due to the use of memory allocation routines such as malloc or other non-MPICH runtime routines that are themselves not interrupt-safe. ERRORS All MPI routines (except MPI_Wtime and MPI_Wtick ) return an error value; C routines as the value of the function and Fortran routines in the last ar- gument. Before the value is returned, the current MPI error handler is called. By default, this error handler aborts the MPI job. The error han- dler may be changed with MPI_Comm_set_errhandler (for communicators), MPI_File_set_errhandler (for files), and MPI_Win_set_errhandler (for RMA windows). The MPI-1 routine MPI_Errhandler_set may be used but its use is deprecated. The predefined error handler MPI_ERRORS_RETURN may be used to cause error values to be returned. Note that MPI does not guarantee that an MPI program can continue past an error; however, MPI implementations will attempt to continue whenever possible. MPI_SUCCESS - No error; MPI routine completed successfully. MPI_T_ERR_INVALID_INDEX - Index is invalid or has been deleted. MPI_T_ERR_NOT_INITIALIZED - The MPI tool information interface is not initialized. MPI_ERR_OTHER - Other error; use MPI_Error_string to get more information about this error code. 4/10/2026 MPI_T_cvar_get_info(3)
NAME | SYNOPSIS | INPUT PARAMETERS | INPUT/OUTPUT PARAMETERS | OUTPUT PARAMETERS | THREAD AND INTERRUPT SAFETY | ERRORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=MPI_T_cvar_get_info&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>
