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 on dm
Input Parameters#
dm - the
DMbeginhook - function to run at the beginning of
DMLocalToGlobalBegin()endhook - function to run after
DMLocalToGlobalEnd()has completedctx - [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
DMl - 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
DMl - local vector
mode - mode
g - global vector
ctx - optional user-defined function context
See Also#
DMLocalToGlobal(), DMRefineHookAdd(), DMGlobalToLocalHookAdd(), SNESFASGetInterpolation(), SNESFASGetInjection(), PetscObjectCompose(), PetscContainerCreate()
Level#
advanced
Location#
Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages