MPIAttrdelete(3OpenMPI) MPIAttrdelete(3OpenMPI)

NAME
       MMPPIIAAttttrrddeelleettee  - Deletes attribute value associated with a key - use
       of this routine is deprecated.


SSYYNNTTAAXX
CC SSyynnttaaxx
       #include 
       int MPIAttrdelete(MPIComm comm, int keyval)


FFoorrttrraann SSyynnttaaxx
       INCLUDE 'mpif.h'
       MPIATTRDELETE(COMM, KEYVAL, IERROR)
            INTEGER   COMM, KEYVAL, IERROR



IINNPPUUTT PPAARRAAMMEETTEERRSS
       comm      Communicator to which attribute is attached (handle).

       keyval    The key value of the deleted attribute (integer).


OOUUTTPPUUTT PPAARRAAMMEETTEERR
       IERROR    Fortran only: Error status (integer).


DESCRIPTION
       This deprecated routine is not available in C++.

       Note that use of this routine is deprecated as  of  MPI-2.  Please  use
       MPICommdeleteattr.

       Delete attribute from cache by key. This function invokes the attribute
       delete function deletefn specified when the keyval  was  created.  The
       call  will  fail  if the deletefn function returns an error code other
       than MPISUCCESS.

       Whenever a communicator is replicated using the function  MPICommdup,
       all  callback  copy functions for attributes that are currently set are
       invoked (in arbitrary order). Whenever a communicator is deleted  using
       the   function   MPICommfree,   all  callback  delete  functions  for
       attributes that are currently set are invoked.


EERRRROORRSS
       Almost all MPI routines return an error value; C routines as the  value
       of  the  function  and Fortran routines in the last argument. C++ func-
       tions do not return errors. If the default  error  handler  is  set  to
       MPI::ERRORSTHROWEXCEPTIONS, then on error the C++ exception mechanism
       will be used to throw an MPI:Exception object.

       Before the error value is returned, the current MPI  error  handler  is
       called.  By  default, this error handler aborts the MPI job, except for
       I/O  function  errors.  The  error  handler   may   be   changed   with
       MPICommseterrhandler; the predefined error handler MPIERRORSRETURN
       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.





Open MPI 1.2                    September 2006       MPIAttrdelete(3OpenMPI)