int MPIR_Topology_put( MPID_Comm *comm_ptr, MPIR_Topology *topo_ptr ) { int mpi_errno = MPI_SUCCESS; MPIU_Assert(comm_ptr != NULL); if (MPIR_Topology_keyval == MPI_KEYVAL_INVALID) { /* Create a new keyval */ /* FIXME - thread safe code needs a thread lock here, followed by another test on the keyval to see if a different thread got there first */ mpi_errno = MPIR_Comm_create_keyval_impl( MPIR_Topology_copy_fn, MPIR_Topology_delete_fn, &MPIR_Topology_keyval, 0 ); /* Register the finalize handler */ if (mpi_errno) MPIR_ERR_POP(mpi_errno); MPIR_Add_finalize( MPIR_Topology_finalize, (void*)0, MPIR_FINALIZE_CALLBACK_PRIO-1); } mpi_errno = MPIR_Comm_set_attr_impl(comm_ptr, MPIR_Topology_keyval, topo_ptr, MPIR_ATTR_PTR); if (mpi_errno) MPIR_ERR_POP(mpi_errno); fn_exit: return mpi_errno; fn_fail: goto fn_exit; }
/*@ MPI_Keyval_create - Greates a new attribute key Input Parameters: + copy_fn - Copy callback function for 'keyval' . delete_fn - Delete callback function for 'keyval' - extra_state - Extra state for callback functions Output Parameters: . keyval - key value for future access (integer) Notes: Key values are global (available for any and all communicators). There are subtle differences between C and Fortran that require that the copy_fn be written in the same language that 'MPI_Keyval_create' is called from. This should not be a problem for most users; only programmers using both Fortran and C in the same program need to be sure that they follow this rule. .N ThreadSafe .N Deprecated The replacement for this routine is 'MPI_Comm_create_keyval'. .N Fortran .N Errors .N MPI_SUCCESS .N MPI_ERR_EXHAUSTED .N MPI_ERR_ARG .seealso MPI_Keyval_free, MPI_Comm_create_keyval @*/ int MPI_Keyval_create(MPI_Copy_function *copy_fn, MPI_Delete_function *delete_fn, int *keyval, void *extra_state) { static const char FCNAME[] = "MPI_Keyval_create"; int mpi_errno = MPI_SUCCESS; MPID_MPI_STATE_DECL(MPID_STATE_MPI_KEYVAL_CREATE); MPIR_ERRTEST_INITIALIZED_ORDIE(); MPIU_THREAD_CS_ENTER(ALLFUNC,); MPID_MPI_FUNC_ENTER(MPID_STATE_MPI_KEYVAL_CREATE); /* Validate parameters and objects (post conversion) */ # ifdef HAVE_ERROR_CHECKING { MPID_BEGIN_ERROR_CHECKS; { MPIR_ERRTEST_ARGNULL(keyval, "keyval", mpi_errno); } MPID_END_ERROR_CHECKS; } # endif /* HAVE_ERROR_CHECKING */ /* ... body of routine ... */ mpi_errno = MPIR_Comm_create_keyval_impl( copy_fn, delete_fn, keyval, extra_state ); if (mpi_errno != MPI_SUCCESS) goto fn_fail; /* ... end of body of routine ... */ fn_exit: MPID_MPI_FUNC_EXIT(MPID_STATE_MPI_KEYVAL_CREATE); MPIU_THREAD_CS_EXIT(ALLFUNC,); return mpi_errno; fn_fail: /* --BEGIN ERROR HANDLING-- */ # ifdef HAVE_ERROR_CHECKING { mpi_errno = MPIR_Err_create_code( mpi_errno, MPIR_ERR_RECOVERABLE, FCNAME, __LINE__, MPI_ERR_OTHER, "**mpi_keyval_create", "**mpi_keyval_create %p %p %p %p", copy_fn, delete_fn, keyval, extra_state); } # endif mpi_errno = MPIR_Err_return_comm( NULL, FCNAME, mpi_errno ); goto fn_exit; /* --END ERROR HANDLING-- */ }
/*@ MPI_Comm_create_keyval - Create a new attribute key Input Parameters: + comm_copy_attr_fn - Copy callback function for 'keyval' . comm_delete_attr_fn - Delete callback function for 'keyval' - extra_state - Extra state for callback functions Output Parameters: . comm_keyval - key value for future access (integer) Notes: Key values are global (available for any and all communicators). Default copy and delete functions are available. These are + MPI_COMM_NULL_COPY_FN - empty copy function . MPI_COMM_NULL_DELETE_FN - empty delete function - MPI_COMM_DUP_FN - simple dup function There are subtle differences between C and Fortran that require that the copy_fn be written in the same language from which 'MPI_Comm_create_keyval' is called. This should not be a problem for most users; only programmers using both Fortran and C in the same program need to be sure that they follow this rule. .N AttrErrReturn .N ThreadSafe .N Fortran .N Errors .N MPI_SUCCESS .seealso MPI_Comm_free_keyval @*/ int MPI_Comm_create_keyval(MPI_Comm_copy_attr_function *comm_copy_attr_fn, MPI_Comm_delete_attr_function *comm_delete_attr_fn, int *comm_keyval, void *extra_state) { int mpi_errno = MPI_SUCCESS; MPIR_FUNC_TERSE_STATE_DECL(MPID_STATE_MPI_COMM_CREATE_KEYVAL); MPIR_ERRTEST_INITIALIZED_ORDIE(); MPID_THREAD_CS_ENTER(GLOBAL, MPIR_THREAD_GLOBAL_ALLFUNC_MUTEX); MPIR_FUNC_TERSE_ENTER(MPID_STATE_MPI_COMM_CREATE_KEYVAL); /* Validate parameters and objects (post conversion) */ # ifdef HAVE_ERROR_CHECKING { MPID_BEGIN_ERROR_CHECKS; { MPIR_ERRTEST_ARGNULL(comm_keyval, "comm_keyval", mpi_errno); } MPID_END_ERROR_CHECKS; } # endif /* HAVE_ERROR_CHECKING */ /* ... body of routine ... */ mpi_errno = MPIR_Comm_create_keyval_impl(comm_copy_attr_fn, comm_delete_attr_fn, comm_keyval, extra_state); if (mpi_errno) goto fn_fail; /* ... end of body of routine ... */ fn_exit: MPIR_FUNC_TERSE_EXIT(MPID_STATE_MPI_COMM_CREATE_KEYVAL); MPID_THREAD_CS_EXIT(GLOBAL, MPIR_THREAD_GLOBAL_ALLFUNC_MUTEX); return mpi_errno; fn_fail: /* --BEGIN ERROR HANDLING-- */ # ifdef HAVE_ERROR_CHECKING { mpi_errno = MPIR_Err_create_code( mpi_errno, MPIR_ERR_RECOVERABLE, FCNAME, __LINE__, MPI_ERR_OTHER, "**mpi_comm_create_keyval", "**mpi_comm_create_keyval %p %p %p %p", comm_copy_attr_fn, comm_delete_attr_fn, comm_keyval, extra_state); } # endif mpi_errno = MPIR_Err_return_comm( NULL, FCNAME, mpi_errno ); goto fn_exit; /* --END ERROR HANDLING-- */ }