/*@ MPI_Type_delete_attr - Deletes an attribute value associated with a key on a datatype Input Parameters: + datatype - MPI datatype to which attribute is attached (handle) - type_keyval - The key value of the deleted attribute (integer) .N ThreadSafe .N Fortran .N Errors .N MPI_SUCCESS .N MPI_ERR_OTHER .N MPI_ERR_KEYVAL @*/ int MPI_Type_delete_attr(MPI_Datatype datatype, int type_keyval) { static const char FCNAME[] = "MPI_Type_delete_attr"; int mpi_errno = MPI_SUCCESS; MPID_Datatype *type_ptr = NULL; MPID_Attribute *p, **old_p; MPID_Keyval *keyval_ptr = 0; MPID_MPI_STATE_DECL(MPID_STATE_MPI_TYPE_DELETE_ATTR); MPIR_ERRTEST_INITIALIZED_ORDIE(); /* The thread lock prevents a valid attr delete on the same datatype but in a different thread from causing problems */ MPIU_THREAD_CS_ENTER(ALLFUNC,); MPID_MPI_FUNC_ENTER(MPID_STATE_MPI_TYPE_DELETE_ATTR); /* Validate parameters, especially handles needing to be converted */ # ifdef HAVE_ERROR_CHECKING { MPID_BEGIN_ERROR_CHECKS; { MPIR_ERRTEST_DATATYPE(datatype, "datatype", mpi_errno); MPIR_ERRTEST_KEYVAL(type_keyval, MPID_DATATYPE, "datatype", mpi_errno); MPIR_ERRTEST_KEYVAL_PERM(type_keyval, mpi_errno); } MPID_END_ERROR_CHECKS; } # endif /* Validate parameters and objects (post conversion) */ MPID_Datatype_get_ptr( datatype, type_ptr ); MPID_Keyval_get_ptr( type_keyval, keyval_ptr ); /* Validate parameters and objects (post conversion) */ # ifdef HAVE_ERROR_CHECKING { MPID_BEGIN_ERROR_CHECKS; { /* Validate type_ptr */ MPID_Datatype_valid_ptr( type_ptr, mpi_errno ); /* If type_ptr is not valid, it will be reset to null */ /* Validate keyval_ptr */ if (mpi_errno) goto fn_fail; } MPID_END_ERROR_CHECKS; } # endif /* HAVE_ERROR_CHECKING */ /* ... body of routine ... */ /* Look for attribute. They are ordered by keyval handle */ old_p = &type_ptr->attributes; p = type_ptr->attributes; while (p) { if (p->keyval->handle == keyval_ptr->handle) { break; } old_p = &p->next; p = p->next; } /* We can't unlock yet, because we must not free the attribute until we know whether the delete function has returned with a 0 status code */ if (p) { /* Run the delete function, if any, and then free the attribute storage */ mpi_errno = MPIR_Call_attr_delete( datatype, p ); /* --BEGIN ERROR HANDLING-- */ if (!mpi_errno) { int in_use; /* We found the attribute. Remove it from the list */ *old_p = p->next; /* Decrement the use of the keyval */ MPIR_Keyval_release_ref( p->keyval, &in_use); if (!in_use) { MPIU_Handle_obj_free( &MPID_Keyval_mem, p->keyval ); } MPID_Attr_free(p); } /* --END ERROR HANDLING-- */ } if (mpi_errno != MPI_SUCCESS) goto fn_fail; /* ... end of body of routine ... */ fn_exit: MPID_MPI_FUNC_EXIT(MPID_STATE_MPI_TYPE_DELETE_ATTR); 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_type_delete_attr", "**mpi_type_delete_attr %D %d", datatype, type_keyval); } # endif mpi_errno = MPIR_Err_return_comm( NULL, FCNAME, mpi_errno ); goto fn_exit; /* --END ERROR HANDLING-- */ }
/*@ MPI_Comm_delete_attr - Deletes an attribute value associated with a key on a communicator Input Parameters: + comm - communicator to which attribute is attached (handle) - comm_keyval - The key value of the deleted attribute (integer) .N ThreadSafe .N Fortran .N Errors .N MPI_SUCCESS .N MPI_ERR_COMM .N MPI_ERR_PERM_KEY .seealso MPI_Comm_set_attr, MPI_Comm_create_keyval @*/ int MPI_Comm_delete_attr(MPI_Comm comm, int comm_keyval) { int mpi_errno = MPI_SUCCESS; MPIR_Comm *comm_ptr = NULL; MPII_Keyval *keyval_ptr; MPIR_FUNC_TERSE_STATE_DECL(MPID_STATE_MPI_COMM_DELETE_ATTR); MPIR_ERRTEST_INITIALIZED_ORDIE(); MPID_THREAD_CS_ENTER(GLOBAL, MPIR_THREAD_GLOBAL_ALLFUNC_MUTEX); MPIR_FUNC_TERSE_ENTER(MPID_STATE_MPI_COMM_DELETE_ATTR); /* Validate parameters, especially handles needing to be converted */ #ifdef HAVE_ERROR_CHECKING { MPID_BEGIN_ERROR_CHECKS; { MPIR_ERRTEST_COMM(comm, mpi_errno); MPIR_ERRTEST_KEYVAL(comm_keyval, MPIR_COMM, "communicator", mpi_errno); MPIR_ERRTEST_KEYVAL_PERM(comm_keyval, mpi_errno); } MPID_END_ERROR_CHECKS; } #endif /* Convert MPI object handles to object pointers */ MPIR_Comm_get_ptr(comm, comm_ptr); MPII_Keyval_get_ptr(comm_keyval, keyval_ptr); /* Validate parameters and objects (post conversion) */ #ifdef HAVE_ERROR_CHECKING { MPID_BEGIN_ERROR_CHECKS; { /* Validate comm_ptr */ MPIR_Comm_valid_ptr(comm_ptr, mpi_errno, TRUE); /* If comm_ptr is not valid, it will be reset to null */ /* Validate keyval_ptr */ MPII_Keyval_valid_ptr(keyval_ptr, mpi_errno); if (mpi_errno) goto fn_fail; } MPID_END_ERROR_CHECKS; } #endif /* HAVE_ERROR_CHECKING */ /* ... body of routine ... */ mpi_errno = MPIR_Comm_delete_attr_impl(comm_ptr, keyval_ptr); if (mpi_errno) goto fn_fail; /* ... end of body of routine ... */ fn_exit: MPIR_FUNC_TERSE_EXIT(MPID_STATE_MPI_COMM_DELETE_ATTR); 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, __func__, __LINE__, MPI_ERR_OTHER, "**mpi_comm_delete_attr", "**mpi_comm_delete_attr %C %d", comm, comm_keyval); } #endif mpi_errno = MPIR_Err_return_comm(comm_ptr, __func__, mpi_errno); goto fn_exit; /* --END ERROR HANDLING-- */ }
/*@ MPI_Comm_free_keyval - Frees an attribute key for communicators Input Parameters: . comm_keyval - Frees the integer key value (integer) Notes: Key values are global (they can be used with any and all communicators) .N ThreadSafe .N Fortran .N Errors .N MPI_SUCCESS .N MPI_ERR_ARG .N MPI_ERR_PERM_KEY @*/ int MPI_Comm_free_keyval(int *comm_keyval) { MPID_Keyval *keyval_ptr = NULL; int mpi_errno = MPI_SUCCESS; MPID_MPI_STATE_DECL(MPID_STATE_MPI_COMM_FREE_KEYVAL); MPIR_ERRTEST_INITIALIZED_ORDIE(); MPIU_THREAD_CS_ENTER(ALLFUNC,); MPID_MPI_FUNC_ENTER(MPID_STATE_MPI_COMM_FREE_KEYVAL); /* Validate parameters, especially handles needing to be converted */ # ifdef HAVE_ERROR_CHECKING { MPID_BEGIN_ERROR_CHECKS; { MPIR_ERRTEST_ARGNULL(comm_keyval, "comm_keyval", mpi_errno); MPIR_ERRTEST_KEYVAL(*comm_keyval, MPID_COMM, "communicator", mpi_errno); MPIR_ERRTEST_KEYVAL_PERM(*comm_keyval, mpi_errno); } MPID_END_ERROR_CHECKS; } # endif /* Convert MPI object handles to object pointers */ MPID_Keyval_get_ptr( *comm_keyval, keyval_ptr ); /* Validate parameters and objects (post conversion) */ # ifdef HAVE_ERROR_CHECKING { MPID_BEGIN_ERROR_CHECKS; { MPID_Keyval_valid_ptr( keyval_ptr, mpi_errno ); if (mpi_errno) goto fn_fail; } MPID_END_ERROR_CHECKS; } # endif /* HAVE_ERROR_CHECKING */ /* ... body of routine ... */ MPIR_Comm_free_keyval_impl(*comm_keyval); *comm_keyval = MPI_KEYVAL_INVALID; /* ... end of body of routine ... */ #ifdef HAVE_ERROR_CHECKING fn_exit: #endif MPID_MPI_FUNC_EXIT(MPID_STATE_MPI_COMM_FREE_KEYVAL); MPIU_THREAD_CS_EXIT(ALLFUNC,); return mpi_errno; /* --BEGIN ERROR HANDLING-- */ # ifdef HAVE_ERROR_CHECKING fn_fail: { mpi_errno = MPIR_Err_create_code( mpi_errno, MPIR_ERR_RECOVERABLE, FCNAME, __LINE__, MPI_ERR_OTHER, "**mpi_comm_free_keyval", "**mpi_comm_free_keyval %p", comm_keyval); } mpi_errno = MPIR_Err_return_comm( NULL, FCNAME, mpi_errno ); goto fn_exit; # endif /* --END ERROR HANDLING-- */ }
/*@ MPI_Win_free_keyval - Frees an attribute key for MPI RMA windows Input Parameters: . win_keyval - key value (integer) .N ThreadSafe .N Fortran .N Errors .N MPI_SUCCESS .N MPI_ERR_WIN .N MPI_ERR_OTHER .N MPI_ERR_KEYVAL @*/ int MPI_Win_free_keyval(int *win_keyval) { #ifdef HAVE_ERROR_CHECKING static const char FCNAME[] = "MPI_Win_free_keyval"; #endif int mpi_errno = MPI_SUCCESS; MPID_Keyval *keyval_ptr = NULL; int in_use; MPID_MPI_STATE_DECL(MPID_STATE_MPI_WIN_FREE_KEYVAL); MPIR_ERRTEST_INITIALIZED_ORDIE(); MPID_THREAD_CS_ENTER(GLOBAL, MPIR_THREAD_GLOBAL_ALLFUNC_MUTEX); MPID_MPI_FUNC_ENTER(MPID_STATE_MPI_WIN_FREE_KEYVAL); /* Validate parameters, especially handles needing to be converted */ # ifdef HAVE_ERROR_CHECKING { MPID_BEGIN_ERROR_CHECKS; { MPIR_ERRTEST_ARGNULL(*win_keyval, "win_keyval", mpi_errno); MPIR_ERRTEST_KEYVAL(*win_keyval, MPID_WIN, "window", mpi_errno); MPIR_ERRTEST_KEYVAL_PERM(*win_keyval, mpi_errno); } MPID_END_ERROR_CHECKS; } # endif /* Convert MPI object handles to object pointers */ MPID_Keyval_get_ptr( *win_keyval, keyval_ptr ); /* Validate parameters and objects (post conversion) */ # ifdef HAVE_ERROR_CHECKING { MPID_BEGIN_ERROR_CHECKS; { MPID_Keyval_valid_ptr( keyval_ptr, mpi_errno ); if (mpi_errno) goto fn_fail; } MPID_END_ERROR_CHECKS; } # endif /* HAVE_ERROR_CHECKING */ /* ... body of routine ... */ if (!keyval_ptr->was_freed) { keyval_ptr->was_freed = 1; MPIR_Keyval_release_ref( keyval_ptr, &in_use); if (!in_use) { MPIU_Handle_obj_free( &MPID_Keyval_mem, keyval_ptr ); } } *win_keyval = MPI_KEYVAL_INVALID; /* ... end of body of routine ... */ #ifdef HAVE_ERROR_CHECKING fn_exit: #endif MPID_MPI_FUNC_EXIT(MPID_STATE_MPI_WIN_FREE_KEYVAL); MPID_THREAD_CS_EXIT(GLOBAL, MPIR_THREAD_GLOBAL_ALLFUNC_MUTEX); return mpi_errno; /* --BEGIN ERROR HANDLING-- */ # ifdef HAVE_ERROR_CHECKING fn_fail: { mpi_errno = MPIR_Err_create_code( mpi_errno, MPIR_ERR_RECOVERABLE, FCNAME, __LINE__, MPI_ERR_OTHER, "**mpi_win_free_keyval", "**mpi_win_free_keyval %p", win_keyval); } mpi_errno = MPIR_Err_return_comm( NULL, FCNAME, mpi_errno ); goto fn_exit; # endif /* --END ERROR HANDLING-- */ }
int MPIR_WinSetAttr( MPI_Win win, int win_keyval, void *attribute_val, MPIR_AttrType attrType ) { static const char FCNAME[] = "MPI_Win_set_attr"; int mpi_errno = MPI_SUCCESS; MPID_Win *win_ptr = NULL; MPID_Keyval *keyval_ptr = NULL; MPID_Attribute *p, **old_p; MPID_MPI_STATE_DECL(MPID_STATE_MPIR_WIN_SET_ATTR); MPIR_ERRTEST_INITIALIZED_ORDIE(); /* The thread lock prevents a valid attr delete on the same window but in a different thread from causing problems */ MPIU_THREAD_CS_ENTER(ALLFUNC,); MPID_MPI_FUNC_ENTER(MPID_STATE_MPIR_WIN_SET_ATTR); /* Validate parameters, especially handles needing to be converted */ # ifdef HAVE_ERROR_CHECKING { MPID_BEGIN_ERROR_CHECKS; { MPIR_ERRTEST_WIN(win, mpi_errno); MPIR_ERRTEST_KEYVAL(win_keyval, MPID_WIN, "window", mpi_errno); MPIR_ERRTEST_KEYVAL_PERM(win_keyval, mpi_errno); } MPID_END_ERROR_CHECKS; } # endif /* Convert MPI object handles to object pointers */ MPID_Win_get_ptr( win, win_ptr ); MPID_Keyval_get_ptr( win_keyval, keyval_ptr ); /* Validate parameters and objects (post conversion) */ # ifdef HAVE_ERROR_CHECKING { MPID_BEGIN_ERROR_CHECKS; { /* Validate win_ptr */ MPID_Win_valid_ptr( win_ptr, mpi_errno ); /* If win_ptr is not valid, it will be reset to null */ /* Validate keyval */ MPID_Keyval_valid_ptr( keyval_ptr, mpi_errno ); if (mpi_errno) goto fn_fail; } MPID_END_ERROR_CHECKS; } # endif /* HAVE_ERROR_CHECKING */ /* ... body of routine ... */ /* Look for attribute. They are ordered by keyval handle. This uses a simple linear list algorithm because few applications use more than a handful of attributes */ old_p = &win_ptr->attributes; p = win_ptr->attributes; while (p) { if (p->keyval->handle == keyval_ptr->handle) { /* If found, call the delete function before replacing the attribute */ mpi_errno = MPIR_Call_attr_delete( win, p ); /* --BEGIN ERROR HANDLING-- */ if (mpi_errno) { /* FIXME : communicator of window? */ goto fn_fail; } /* --END ERROR HANDLING-- */ p->value = (MPID_AttrVal_t)(MPIR_Pint)attribute_val; p->attrType = attrType; /* Does not change the reference count on the keyval */ break; } else if (p->keyval->handle > keyval_ptr->handle) { MPID_Attribute *new_p = MPID_Attr_alloc(); MPIU_ERR_CHKANDJUMP1(!new_p,mpi_errno,MPI_ERR_OTHER, "**nomem", "**nomem %s", "MPID_Attribute" ); new_p->keyval = keyval_ptr; new_p->attrType = attrType; new_p->pre_sentinal = 0; new_p->value = (MPID_AttrVal_t)(MPIR_Pint)attribute_val; new_p->post_sentinal = 0; new_p->next = p->next; MPIR_Keyval_add_ref( keyval_ptr ); p->next = new_p; break; } old_p = &p->next; p = p->next; } if (!p) { MPID_Attribute *new_p = MPID_Attr_alloc(); MPIU_ERR_CHKANDJUMP1(!new_p,mpi_errno,MPI_ERR_OTHER, "**nomem", "**nomem %s", "MPID_Attribute" ); /* Did not find in list. Add at end */ new_p->attrType = attrType; new_p->keyval = keyval_ptr; new_p->pre_sentinal = 0; new_p->value = (MPID_AttrVal_t)(MPIR_Pint)attribute_val; new_p->post_sentinal = 0; new_p->next = 0; MPIR_Keyval_add_ref( keyval_ptr ); *old_p = new_p; } /* Here is where we could add a hook for the device to detect attribute value changes, using something like MPID_Dev_win_attr_hook( win_ptr, keyval, attribute_val ); */ /* ... end of body of routine ... */ fn_exit: MPID_MPI_FUNC_EXIT(MPID_STATE_MPIR_WIN_SET_ATTR); 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_win_set_attr", "**mpi_win_set_attr %W %d %p", win, win_keyval, attribute_val); } # endif mpi_errno = MPIR_Err_return_win( win_ptr, FCNAME, mpi_errno ); goto fn_exit; /* --END ERROR HANDLING-- */ }