xref: /petsc/src/sys/utils/pbarrier.c (revision 166c7f255c91bb243aa54e4217727fe58a0f23be)
1e5c89e4eSSatish Balay #define PETSC_DLL
2e5c89e4eSSatish Balay 
3e5c89e4eSSatish Balay #include "petsc.h"              /*I "petsc.h" I*/
4e5c89e4eSSatish Balay 
5e5c89e4eSSatish Balay /* Logging support */
6*166c7f25SBarry 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 @*/
28e5c89e4eSSatish Balay PetscErrorCode PETSC_DLLEXPORT 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