petsc-3.12.0 2019-09-29
Report Typos and Errors

PetscOptionsSetValue

Sets an option name-value pair in the options database, overriding whatever is already present.

Synopsis

#include "petscsys.h"   
PetscErrorCode PetscOptionsSetValue(PetscOptions options,const char name[],const char value[])
Logically Collective

Input Parameters

options - options database, use NULL for the default global database
name - name of option, this SHOULD have the - prepended
value - the option value (not used for all options, so can be NULL)

Note

This function can be called BEFORE PetscInitialize()

The collectivity of this routine is complex; only the MPI processes that call this routine will have the affect of these options. If some processes that create objects call this routine and others do not the code may fail in complicated ways because the same parallel solvers may incorrectly use different options on different ranks.

Developers Note: Uses malloc() directly because PETSc may not be initialized yet.

See Also

PetscOptionsInsert(), PetscOptionsClearValue()

Level

intermediate

Location

src/sys/objects/options.c

Examples

src/sys/examples/tutorials/ex16.c.html
src/sys/examples/tutorials/ex16f.F90.html
src/vec/vec/examples/tutorials/ex5.c.html
src/vec/vec/examples/tutorials/ex10.c.html
src/vec/vec/examples/tutorials/ex5f.F90.html
src/snes/examples/tutorials/ex30.c.html
src/tao/unconstrained/examples/tutorials/eptorsion1.c.html
src/tao/unconstrained/examples/tutorials/rosenbrock1.c.html

Index of all Sys routines
Table of Contents for all manual pages
Index of all manual pages