xref: /petsc/src/sys/utils/pbarrier.c (revision 7087cfbefd1a42b179f217f9994fb6cb0d0c1824)
1e5c89e4eSSatish Balay #define PETSC_DLL
2e5c89e4eSSatish Balay 
3d382aafbSBarry Smith #include "petscsys.h"              /*I "petscsys.h" I*/
4e5c89e4eSSatish Balay 
5e5c89e4eSSatish Balay /* Logging support */
6166c7f25SBarry Smith PetscLogEvent PETSC_Barrier;
7e5c89e4eSSatish Balay 
8e5c89e4eSSatish Balay #undef __FUNCT__
9e5c89e4eSSatish Balay #define __FUNCT__ "PetscBarrier"
105075c446SSatish Balay /*@C
11e5c89e4eSSatish Balay     PetscBarrier - Blocks until this routine is executed by all
12e5c89e4eSSatish Balay                    processors owning the object A.
13e5c89e4eSSatish Balay 
14e5c89e4eSSatish Balay    Input Parameters:
15e5c89e4eSSatish Balay .  A - PETSc object  (Mat, Vec, IS, SNES etc...)
16e5c89e4eSSatish Balay         Must be caste with a (PetscObject), can use PETSC_NULL (for MPI_COMM_WORLD)
17e5c89e4eSSatish Balay 
18e5c89e4eSSatish Balay   Level: intermediate
19e5c89e4eSSatish Balay 
20e5c89e4eSSatish Balay   Notes:
21e5c89e4eSSatish Balay   This routine calls MPI_Barrier with the communicator of the PETSc Object "A".
22e5c89e4eSSatish Balay 
235075c446SSatish Balay   With fortran Use PETSC_NULL_OBJECT (instead of PETSC_NULL)
245075c446SSatish Balay 
25e5c89e4eSSatish Balay    Concepts: barrier
26e5c89e4eSSatish Balay 
27e5c89e4eSSatish Balay @*/
28*7087cfbeSBarry Smith PetscErrorCode  PetscBarrier(PetscObject obj)
29e5c89e4eSSatish Balay {
30e5c89e4eSSatish Balay   PetscErrorCode ierr;
31e5c89e4eSSatish Balay   MPI_Comm       comm;
32e5c89e4eSSatish Balay 
33e5c89e4eSSatish Balay   PetscFunctionBegin;
34e5c89e4eSSatish Balay   if (obj) PetscValidHeader(obj,1);
35e5c89e4eSSatish Balay   ierr = PetscLogEventBegin(PETSC_Barrier,obj,0,0,0);CHKERRQ(ierr);
36e5c89e4eSSatish Balay   if (obj) {
37e5c89e4eSSatish Balay     ierr = PetscObjectGetComm(obj,&comm);CHKERRQ(ierr);
38e5c89e4eSSatish Balay   } else {
39e5c89e4eSSatish Balay     comm = PETSC_COMM_WORLD;
40e5c89e4eSSatish Balay   }
41e5c89e4eSSatish Balay   ierr = MPI_Barrier(comm);CHKERRQ(ierr);
42e5c89e4eSSatish Balay   ierr = PetscLogEventEnd(PETSC_Barrier,obj,0,0,0);CHKERRQ(ierr);
43e5c89e4eSSatish Balay   PetscFunctionReturn(0);
44e5c89e4eSSatish Balay }
45e5c89e4eSSatish Balay 
46