petsc-3.3-p7 2013-05-11

PCShellSetApply

Sets routine to use as preconditioner.

#include "petscpc.h" 
PetscErrorCode  PCShellSetApply(PC pc,PetscErrorCode (*apply)(PC,Vec,Vec))

Logically Collective on PC

	pc	- the preconditioner context
	apply	- the application-provided preconditioning routine

   PetscErrorCode apply (PC pc,Vec xin,Vec xout)

	pc	- the preconditioner, get the application context with PCShellGetContext()
	xin	- input vector
	xout	- output vector

Notes: the function MUST return an error code of 0 on success and nonzero on failure.

Developer Notes: There should also be a PCShellSetApplySymmetricRight() and PCShellSetApplySymmetricLeft().

PC, shell, set, apply, user-provided