petsc-3.14.6 2021-03-30
Report Typos and Errors

PetscOptionsInsert

Inserts into the options database from the command line, the environmental variable and a file.

Synopsis

#include "petscsys.h"   
PetscErrorCode PetscOptionsInsert(PetscOptions options,int *argc,char ***args,const char file[])
Collective on PETSC_COMM_WORLD

Input Parameters

options - options database or NULL for the default global database
argc - count of number of command line arguments
args - the command line arguments
file - [optional] PETSc database file, also checks ~/.petscrc, .petscrc and petscrc. Use NULL to not check for code specific file. Use -skip_petscrc in the code specific file (or command line) to skip ~/.petscrc, .petscrc and petscrc files.

Note

Since PetscOptionsInsert() is automatically called by PetscInitialize(), the user does not typically need to call this routine. PetscOptionsInsert() can be called several times, adding additional entries into the database.

Options Database Keys

-options_file <filename> - read options from a file

See PetscInitialize() for options related to option database monitoring.

See Also

PetscOptionsDestroy(), PetscOptionsView(), PetscOptionsInsertString(), PetscOptionsInsertFile(),
PetscInitialize()

Level

advanced

Location

src/sys/objects/options.c

Examples

src/sys/tutorials/ex19.c.html
src/snes/tutorials/ex22.c.html
src/snes/tutorials/ex30.c.html

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