petsc-3.14.6 2021-03-30
DMLocalToGlobalHookAdd
adds a callback to be run when a local to global is called
Synopsis
#include "petscdm.h"
#include "petscdmlabel.h"
#include "petscds.h"
PetscErrorCode DMLocalToGlobalHookAdd(DM dm,PetscErrorCode (*beginhook)(DM,Vec,InsertMode,Vec,void*),PetscErrorCode (*endhook)(DM,Vec,InsertMode,Vec,void*),void *ctx)
Logically Collective
Input Arguments
| dm | - the DM
|
| beginhook | - function to run at the beginning of DMLocalToGlobalBegin()
|
| endhook | - function to run after DMLocalToGlobalEnd() has completed
|
| ctx | - [optional] user-defined context for provide data for the hooks (may be NULL)
|
Calling sequence for beginhook
beginhook(DM fine,Vec l,InsertMode mode,Vec g,void *ctx)
| dm | - global DM
|
| l | - local vector
|
| mode | - mode
|
| g | - global vector
|
| ctx | - optional user-defined function context
|
Calling sequence for endhook
endhook(DM fine,Vec l,InsertMode mode,Vec g,void *ctx)
| global | - global DM
|
| l | - local vector
|
| mode | - mode
|
| g | - global vector
|
| ctx | - optional user-defined function context
|
See Also
DMRefineHookAdd(), SNESFASGetInterpolation(), SNESFASGetInjection(), PetscObjectCompose(), PetscContainerCreate()
Level
advanced
Location
src/dm/interface/dm.c
Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages