PCGetFailedReason#
Gets the reason a PCSetUp() failed or PC_NOERROR if it did not fail
Synopsis#
#include "petscksp.h"
PetscErrorCode PCGetFailedReason(PC pc, PCFailedReason *reason)
Logically Collective
Input Parameter#
pc - the preconditioner context
Output Parameter#
reason - the reason it failed
Note#
This is the maximum over reason over all ranks in the PC communicator. It is only valid after
a call KSPCheckDot() or KSPCheckNorm() inside a KSPSolve() or PCReduceFailedReason().
It is not valid immediately after a PCSetUp() or PCApply(), then use PCGetFailedReasonRank()
See Also#
KSP: Linear System Solvers, PC, ``PCCreate(), PCApply(), PCDestroy(), PCGetFailedReasonRank(), PCSetFailedReason()`
Level#
advanced
Location#
Index of all PC routines
Table of Contents for all manual pages
Index of all manual pages