petsc-3.7.7 2017-09-25
Report Typos and Errors

# SNESLineSearchMonitorSet

Sets an ADDITIONAL function that is to be used at every iteration of the nonlinear solver to display the iteration's progress.

### Synopsis

    #include "petscsnes.h"
    PetscErrorCode  SNESLineSearchMonitorSet(SNESLineSearch ls,PetscErrorCode (*f)(SNESLineSearch,void*),void *mctx,PetscErrorCode (*monitordestroy)(void**))

Logically Collective on SNESLineSearch

### Input Parameters

| ls | - the SNESLineSearch context
| f | - the monitor function
| mctx | - [optional] user-defined context for private data for the monitor routine (use NULL if no context is desired)
| monitordestroy | - [optional] routine that frees monitor context (may be NULL)

### Notes

Several different monitoring routines may be set by calling SNESLineSearchMonitorSet() multiple times; all will be called in the order in which they were set.

Fortran notes: Only a single monitor function can be set for each SNESLineSearch object

### Keywords

SNESLineSearch, nonlinear, set, monitor

### See Also

SNESLineSearchMonitorDefault(), SNESLineSearchMonitorCancel()

Level:intermediate
Location:src/snes/linesearch/interface/linesearch.c
Index of all SNES routines
Table of Contents for all manual pages
Index of all manual pages