Added documentation about -DLAMMPS_EXCEPTIONS flag

This commit is contained in:
Richard Berger 2016-08-27 22:13:36 -04:00
parent e5c37bc7cb
commit f5a50c3cd1
1 changed files with 9 additions and 0 deletions

View File

@ -262,6 +262,7 @@ within the LAMMPS code. The options that are currently recogized are:
-DLAMMPS_BIGBIG
-DLAMMPS_SMALLSMALL
-DLAMMPS_LONGLONG_TO_LONG
-DLAMMPS_EXCEPTIONS
-DPACK_ARRAY
-DPACK_POINTER
-DPACK_MEMCPY :ul
@ -334,6 +335,14 @@ MPI version does not recognize "long long" data types. In this case a
"long" data type is likely already 64-bits, in which case this setting
will convert to that data type.
The -DLAMMPS_EXCEPTIONS setting can be used to activate alternative
versions of error handling inside of LAMMPS. This is useful for external
codes driving LAMMPS as a library. Using this option, errors do not exit
the driving process. Instead, the call stack is unwinded and the library
functions can return. The library interface provides the lammps_has_error
and lammps_get_last_error_message functions to detect and find out more
about an LAMMPS error.
Using one of the -DPACK_ARRAY, -DPACK_POINTER, and -DPACK_MEMCPY
options can make for faster parallel FFTs (in the PPPM solver) on some
platforms. The -DPACK_ARRAY setting is the default. See the