Create a new library property list with default values

saf_createProps_lib is a function defined in libprops.c.

Synopsis:

SAF_LibProps * saf_createProps_lib(void)

Description: This function creates a library property list which can be passed to the saf_init function. All properties in this list are set to their default values…

1
 ErrFunc = NULL;

1
 ErrMsgMode = <ignored>;

1
 ErrLoggingMode = none;

1
 ErrorMode = SAF_ERRMODE_RETURN;

1
 LibComm = MPI_COMM_WORLD;

1
 StrMode = SAF_STRMODE_LIB;

1
 StrPoolSize = 4096;

Return Value: A handle to a new library properties list initialized to default values. NULL on failure or an exception is thrown depending on the error handling library property currently in effect (See *Properties*).

Parallel Notes: This function must be called collectively by all processors in MPI_COMM_WORLD.

Issues: Since this function is called before saf_init, the only communicator we can use to work correctly is MPI_COMM_WORLD. However, it we allowed the client to pass a communicator here, then we could avoid that.

See Also: