## On this page

  

 

 # sos\_capi\_common.h File Reference

 Last update: 16.07.2025 

C-API for utility functions (load/unload library, license management, error handling) [More...](#details)

[Go to the source code of this file.](sos__capi__common_8h_source.xhtml)

## <a id="enum-members" name="enum-members"></a>Enumerations

Public type definitions

Pubic type definitions used within this API



enum [fmop\_error\_t](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec) {   
 [fmop\_success](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8beca41a0a2e83b0ac20d414f4b015522ce55) = 0 , [fmop\_invalid\_handle](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8becacef5c059b0dd649f97d5404db95c3ccf) = 1 , [fmop\_exception\_occurred](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8becadac3d9086cdab852d265dc924070c198) = 2 , [fmop\_settings\_error](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8beca4040927e4d05d13e93b9f2c7373ca0cd) = 3 ,   
 [fmop\_model\_missing](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8becaedda7a6dbd4f5dd3eedecca9ec7dc1e9) = 4 , [fmop\_license\_error](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8becacf8dfe2eaba2eada73a26e487a04f8fe) = 5 , [fmop\_script\_error](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8becab6e0160bb71d6930176d907409618f4d) = 6 , [fmop\_script\_no\_object](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8beca749f1c6edf13b1303018d7a3632dc316) = 7 ,   
 [fmop\_script\_wrong\_type](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8beca32eddc7d860101cdbb8e1571c726ee91) = 8 , [fmop\_not\_implemented](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8beca7fc167a096db0f31209791e0053de2ec) = 16382 , [fmop\_const\_max](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8beca41b2d8995eb66857227a50e49e8f6016) = 16383   
 } Error code definitions. [More...](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec)  
 enum [fmop\_license\_t](sos__capi__common_8h.xhtml#afe21e382a604ef55cba4d683d706422e) { [fmop\_mesh\_signal](sos__capi__common_8h.xhtml#afe21e382a604ef55cba4d683d706422ea5b9372ca962a29cf37faac2948897143) = 10 , [fmop\_mesh\_all](sos__capi__common_8h.xhtml#afe21e382a604ef55cba4d683d706422ea71a41e6fb1935010b6ed34037f7dae8c) = 30 } FMOP mesh features which need to be unlocked by a valid license. [More...](sos__capi__common_8h.xhtml#afe21e382a604ef55cba4d683d706422e)  
 enum [fmop\_dataobject\_types](sos__capi__common_8h.xhtml#a69eb42c1b3b49f22b9e73c6c9869cb75) { [fmop\_node\_data](sos__capi__common_8h.xhtml#a69eb42c1b3b49f22b9e73c6c9869cb75aaf0fb275c161febc56c4f10e62987049) = 0 , [fmop\_element\_data](sos__capi__common_8h.xhtml#a69eb42c1b3b49f22b9e73c6c9869cb75a1ec31fe31f3b8a9fd9dd902b014499ef) = 1 , [fmop\_scalar\_data](sos__capi__common_8h.xhtml#a69eb42c1b3b49f22b9e73c6c9869cb75a16a14aa0d55901638e165fb3a39b3870) = 3 } Data type definitions. [More...](sos__capi__common_8h.xhtml#a69eb42c1b3b49f22b9e73c6c9869cb75)  
 ## <a id="func-members" name="func-members"></a>Functions

License handling

API handling licenes requests



DYNARDO\_FMOP\_API [fmop\_error\_t](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec) [FMOP\_appendLicenseSearchPath](sos__capi__common_8h.xhtml#a7086f4db3e639526b2b7fe9ce9392a24) (const char \*abs\_path) Appends another license search path to the default ones. [More...](sos__capi__common_8h.xhtml#a7086f4db3e639526b2b7fe9ce9392a24)  
 DYNARDO\_FMOP\_API [fmop\_error\_t](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec) [FMOP\_acquireLicense](sos__capi__common_8h.xhtml#a1cdd0d44e0ea8172b1f7f1095395da89) () Acquires an optiSLang enterprise license. [More...](sos__capi__common_8h.xhtml#a1cdd0d44e0ea8172b1f7f1095395da89)  
 DYNARDO\_FMOP\_API bool [FMOP\_licenseLocked](sos__capi__common_8h.xhtml#a462a99c932a9b5704aae42a15826e4c3) () Check whether any license feature was acquired. [More...](sos__capi__common_8h.xhtml#a462a99c932a9b5704aae42a15826e4c3)  
 DYNARDO\_FMOP\_API [fmop\_error\_t](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec) [FMOP\_releaseLicense](sos__capi__common_8h.xhtml#a62d038d686a8183e10f52131697bce6c) () Release the acquired license. [More...](sos__capi__common_8h.xhtml#a62d038d686a8183e10f52131697bce6c)  
 Error Handling

API to access and interpret recent data object error messages



DYNARDO\_FMOP\_API const char \* [FMOP\_getLastErrorString](sos__capi__common_8h.xhtml#a5e19e7fe152759a80115e908c593245d) () Returns internal log messages of level warning and above. [More...](sos__capi__common_8h.xhtml#a5e19e7fe152759a80115e908c593245d)  
 DYNARDO\_FMOP\_API [fmop\_error\_t](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec) [FMOP\_getLastErrno](sos__capi__common_8h.xhtml#ac78d83f9f73afd90854e1d07657fc186) () Returns the error number which has been set at the last library call. [More...](sos__capi__common_8h.xhtml#ac78d83f9f73afd90854e1d07657fc186)  
 DYNARDO\_FMOP\_API const char \* [FMOP\_getLastErrnoString](sos__capi__common_8h.xhtml#aa838a7c375fc1d01d51636ad52a182ad) () Returns a pointer to a string that describes the error code which has been set at the last library call. [More...](sos__capi__common_8h.xhtml#aa838a7c375fc1d01d51636ad52a182ad)  
 DYNARDO\_FMOP\_API const char \* [FMOP\_getLastLogString](sos__capi__common_8h.xhtml#ad78d4b2f659d76cce9d16eb7b0e10e2c) () Returns internal log messages of log levels defined by FMOP\_setLogLevel. Serves as debug logger. [More...](sos__capi__common_8h.xhtml#ad78d4b2f659d76cce9d16eb7b0e10e2c)  
 DYNARDO\_FMOP\_API int [FMOP\_setLogLevel](sos__capi__common_8h.xhtml#ac13c87c4e4d30a83f4d041a908d0a1e7) (int log\_level) Defines the new log level filter. Valid for all subsequent library calls until a new log level gets set. [More...](sos__capi__common_8h.xhtml#ac13c87c4e4d30a83f4d041a908d0a1e7)  
 DYNARDO\_FMOP\_API const char \* [FMOP\_getErrnoString](sos__capi__common_8h.xhtml#a7e820b85d2ef2596b00bc82445dcf650) ([fmop\_error\_t](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec) error\_num) Returns a string description for the error number given. [More...](sos__capi__common_8h.xhtml#a7e820b85d2ef2596b00bc82445dcf650)  
 Miscellaneous

DYNARDO\_FMOP\_API const char \* [FMOP\_getVersionString](sos__capi__common_8h.xhtml#a4f2de6ba4f98c98d1c670fa4a9117150) () Returns a version string. [More...](sos__capi__common_8h.xhtml#a4f2de6ba4f98c98d1c670fa4a9117150)  
 FMOP library handling

DYNARDO\_FMOP\_API [fmop\_error\_t](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec) [FMOP\_initializeLibrary](sos__capi__common_8h.xhtml#a9c8f0f808d3f27c57a3a57d5f9cf4834) () Initialize the FMOP library Allocates memory for the global script engine. Call [FMOP\_unloadLibrary()](sos__capi__common_8h.xhtml#ae0af273cc642061f90933b4af2a958ad "Unload the FMOP library Clears the FMOP library from memory. A warning is logged if the library was u...") to release it. A warning is logged if the library was initialized already. [More...](sos__capi__common_8h.xhtml#a9c8f0f808d3f27c57a3a57d5f9cf4834)  
 <a id="ae0af273cc642061f90933b4af2a958ad"></a>DYNARDO\_FMOP\_API [fmop\_error\_t](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec) [FMOP\_unloadLibrary](sos__capi__common_8h.xhtml#ae0af273cc642061f90933b4af2a958ad) () Unload the FMOP library Clears the FMOP library from memory. A warning is logged if the library was unloaded already.   
 <a id="details" name="details"></a>## Detailed Description

C-API for utility functions (load/unload library, license management, error handling)

CopyrightDYNARDO Austria GmbH 

## Enumeration Type Documentation

<a id="a69eb42c1b3b49f22b9e73c6c9869cb75"></a>## [◆ ](#a69eb42c1b3b49f22b9e73c6c9869cb75)fmop\_dataobject\_types

 enum [fmop\_dataobject\_types](sos__capi__common_8h.xhtml#a69eb42c1b3b49f22b9e73c6c9869cb75)

Data type definitions.

Enumerator<a id="a69eb42c1b3b49f22b9e73c6c9869cb75aaf0fb275c161febc56c4f10e62987049"></a>fmop\_node\_data node data (one scalar per node)

<a id="a69eb42c1b3b49f22b9e73c6c9869cb75a1ec31fe31f3b8a9fd9dd902b014499ef"></a>fmop\_element\_data element data (one scalar per element)

<a id="a69eb42c1b3b49f22b9e73c6c9869cb75a16a14aa0d55901638e165fb3a39b3870"></a>fmop\_scalar\_data scalar data (vector of size 1)





<a id="a4847f3fa2943ffd694eb6cbe169a8bec"></a>## [◆ ](#a4847f3fa2943ffd694eb6cbe169a8bec)fmop\_error\_t

 enum [fmop\_error\_t](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec)

Error code definitions.

Enumerator<a id="a4847f3fa2943ffd694eb6cbe169a8beca41a0a2e83b0ac20d414f4b015522ce55"></a>fmop\_success Function execution returned successfully.

<a id="a4847f3fa2943ffd694eb6cbe169a8becacef5c059b0dd649f97d5404db95c3ccf"></a>fmop\_invalid\_handle The function got an unexpected NULL pointer.

<a id="a4847f3fa2943ffd694eb6cbe169a8becadac3d9086cdab852d265dc924070c198"></a>fmop\_exception\_occurred An internal error occurred. Request log messages.

<a id="a4847f3fa2943ffd694eb6cbe169a8beca4040927e4d05d13e93b9f2c7373ca0cd"></a>fmop\_settings\_error Input argument(s) is invalid or missing.

<a id="a4847f3fa2943ffd694eb6cbe169a8becaedda7a6dbd4f5dd3eedecca9ec7dc1e9"></a>fmop\_model\_missing The requested model identifier is not known.

<a id="a4847f3fa2943ffd694eb6cbe169a8becacf8dfe2eaba2eada73a26e487a04f8fe"></a>fmop\_license\_error No valid license available.

<a id="a4847f3fa2943ffd694eb6cbe169a8becab6e0160bb71d6930176d907409618f4d"></a>fmop\_script\_error An error appeare while executing Lua script.

<a id="a4847f3fa2943ffd694eb6cbe169a8beca749f1c6edf13b1303018d7a3632dc316"></a>fmop\_script\_no\_object Object with ident not found in script engine.

<a id="a4847f3fa2943ffd694eb6cbe169a8beca32eddc7d860101cdbb8e1571c726ee91"></a>fmop\_script\_wrong\_type Object with ident has wrong type.

<a id="a4847f3fa2943ffd694eb6cbe169a8beca7fc167a096db0f31209791e0053de2ec"></a>fmop\_not\_implemented This function is yet not implemented or has been removed.

<a id="a4847f3fa2943ffd694eb6cbe169a8beca41b2d8995eb66857227a50e49e8f6016"></a>fmop\_const\_max 2^14-1 non-modifiable for each API version





<a id="afe21e382a604ef55cba4d683d706422e"></a>## [◆ ](#afe21e382a604ef55cba4d683d706422e)fmop\_license\_t

 enum [fmop\_license\_t](sos__capi__common_8h.xhtml#afe21e382a604ef55cba4d683d706422e)

FMOP mesh features which need to be unlocked by a valid license.

Enumerator<a id="afe21e382a604ef55cba4d683d706422ea5b9372ca962a29cf37faac2948897143"></a>fmop\_mesh\_signal Unlocks signal meshes.

<a id="afe21e382a604ef55cba4d683d706422ea71a41e6fb1935010b6ed34037f7dae8c"></a>fmop\_mesh\_all Unlocks all mesh features.





## Function Documentation

<a id="a1cdd0d44e0ea8172b1f7f1095395da89"></a>## [◆ ](#a1cdd0d44e0ea8172b1f7f1095395da89)FMOP\_acquireLicense()

 DYNARDO\_FMOP\_API [fmop\_error\_t](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec) FMOP\_acquireLicense  ( ) 

Acquires an optiSLang enterprise license.

Returns- [fmop\_settings\_error](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8beca4040927e4d05d13e93b9f2c7373ca0cd "Input argument(s) is invalid or missing.") if a license has already been acquired successfully
- [fmop\_exception\_occurred](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8becadac3d9086cdab852d265dc924070c198 "An internal error occurred. Request log messages.") if any error occures while checking out the requested feature(s)
- [fmop\_success](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8beca41a0a2e83b0ac20d414f4b015522ce55 "Function execution returned successfully.") if a license has been acquired successfully

Call [FMOP\_getErrnoString()](sos__capi__common_8h.xhtml#a7e820b85d2ef2596b00bc82445dcf650 "Returns a string description for the error number given.") to get a human readable representation 



<a id="a7086f4db3e639526b2b7fe9ce9392a24"></a>## [◆ ](#a7086f4db3e639526b2b7fe9ce9392a24)FMOP\_appendLicenseSearchPath()

 DYNARDO\_FMOP\_API [fmop\_error\_t](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec) FMOP\_appendLicenseSearchPath  ( const char \*  *abs\_path*) 

Appends another license search path to the default ones.

**[Deprecated:](deprecated.xhtml#_deprecated000001)**By default the following license search paths will be checked in the order given:

- @localhost
- the current working directory
- the path pointed to by the environment variable 'LM\_LICENSE\_FILE'
- the path pointed to by the environment variable 'DYNARDO\_LICENSE\_FILE'

Parameters \[in\]abs\_pathAn absolute file system path, e.g. '/opt/DYNARDO/licensing', 'D:\\Licenses', ... Returns- [fmop\_settings\_error](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8beca4040927e4d05d13e93b9f2c7373ca0cd "Input argument(s) is invalid or missing.") if the path given does not exist
- [fmop\_exception\_occurred](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8becadac3d9086cdab852d265dc924070c198 "An internal error occurred. Request log messages.") if the path given invoces any other filesystem error
- [fmop\_success](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8beca41a0a2e83b0ac20d414f4b015522ce55 "Function execution returned successfully.") if the path has been appended successfully

Call [FMOP\_getErrnoString()](sos__capi__common_8h.xhtml#a7e820b85d2ef2596b00bc82445dcf650 "Returns a string description for the error number given.") to get a human readable representation 



<a id="a7e820b85d2ef2596b00bc82445dcf650"></a>## [◆ ](#a7e820b85d2ef2596b00bc82445dcf650)FMOP\_getErrnoString()

 DYNARDO\_FMOP\_API const char\* FMOP\_getErrnoString  ( [fmop\_error\_t](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec)  *error\_num*) 

Returns a string description for the error number given.

Parameters \[in\]error\_numThe error number ReturnsA human readable string description for the error number given.The returned string will be overwritten by this function at the next call and will be destroyed on program termination NoteCalling this function will neither manipulate the internal log message stack nor the errno state of the last library call DON'T USE ERRNO as agrument identifier as this seems to be defined as a macro identifier Refer to <http://www.cplusplus.com/reference/cerrno/errno/> for details 



<a id="ac78d83f9f73afd90854e1d07657fc186"></a>## [◆ ](#ac78d83f9f73afd90854e1d07657fc186)FMOP\_getLastErrno()

 DYNARDO\_FMOP\_API [fmop\_error\_t](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec) FMOP\_getLastErrno  ( ) 

Returns the error number which has been set at the last library call.

ReturnsThe error number which has been set at the last library call 



<a id="aa838a7c375fc1d01d51636ad52a182ad"></a>## [◆ ](#aa838a7c375fc1d01d51636ad52a182ad)FMOP\_getLastErrnoString()

 DYNARDO\_FMOP\_API const char\* FMOP\_getLastErrnoString  ( ) 

Returns a pointer to a string that describes the error code which has been set at the last library call.

ReturnsA human readable string description for the error code that has been set at the last library call. The returned string will be overwritten by this function at the next call and will be destroyed on program termination NoteCalling this function will neither manipulate the internal log message stack nor the errno state of the last library call 



<a id="a5e19e7fe152759a80115e908c593245d"></a>## [◆ ](#a5e19e7fe152759a80115e908c593245d)FMOP\_getLastErrorString()

 DYNARDO\_FMOP\_API const char\* FMOP\_getLastErrorString  ( ) 

Returns internal log messages of level warning and above.

This log level is immutable. [FMOP\_setLogLevel()](sos__capi__common_8h.xhtml#ac13c87c4e4d30a83f4d041a908d0a1e7 "Defines the new log level filter. Valid for all subsequent library calls until a new log level gets s...") can not modify it. If the internal logger is empty, the value of [FMOP\_getLastErrnoString()](sos__capi__common_8h.xhtml#aa838a7c375fc1d01d51636ad52a182ad "Returns a pointer to a string that describes the error code which has been set at the last library ca...") will be returned

ReturnsReturns all internal, formatted log messages of log level warning and above if either a warning or an error message occured during the last library call. Otherwise the return value of [FMOP\_getLastErrnoString()](sos__capi__common_8h.xhtml#aa838a7c375fc1d01d51636ad52a182ad "Returns a pointer to a string that describes the error code which has been set at the last library ca...") will be returned. The returned string will be overwritten by this function at its next call and will be destroyed on program termination NoteCalling this function will neither manipulate the internal log message stack nor the errno state of the last library call 



<a id="ad78d4b2f659d76cce9d16eb7b0e10e2c"></a>## [◆ ](#ad78d4b2f659d76cce9d16eb7b0e10e2c)FMOP\_getLastLogString()

 DYNARDO\_FMOP\_API const char\* FMOP\_getLastLogString  ( ) 

Returns internal log messages of log levels defined by FMOP\_setLogLevel. Serves as debug logger.

Initially all log levels are deactivated and no log messages will be buffered. Call FMOP\_setLogLevel ( &gt;0 ) to activate the logger and FMOP\_setLogLevel (0) to deactivate it again.

ReturnsReturns all internal, formatted log messages of the last library call. The returned string will be overwritten by this function at the next call and will be destroyed on program termination NoteCalling this function will not manipulate the internal log message stack. Though the errno number will be set and can be queried calling [FMOP\_getLastErrno()](sos__capi__common_8h.xhtml#ac78d83f9f73afd90854e1d07657fc186 "Returns the error number which has been set at the last library call.") 



<a id="a4f2de6ba4f98c98d1c670fa4a9117150"></a>## [◆ ](#a4f2de6ba4f98c98d1c670fa4a9117150)FMOP\_getVersionString()

 DYNARDO\_FMOP\_API const char\* FMOP\_getVersionString  ( ) 

Returns a version string.

ReturnsA const pointer to a character array holding the version string. Ownership is handled internally. NoteCalling this function will not manipulate the internal log message stack. Though the errno number will be set and can be queried calling [FMOP\_getLastErrno()](sos__capi__common_8h.xhtml#ac78d83f9f73afd90854e1d07657fc186 "Returns the error number which has been set at the last library call.") 



<a id="a9c8f0f808d3f27c57a3a57d5f9cf4834"></a>## [◆ ](#a9c8f0f808d3f27c57a3a57d5f9cf4834)FMOP\_initializeLibrary()

 DYNARDO\_FMOP\_API [fmop\_error\_t](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec) FMOP\_initializeLibrary  ( ) 

Initialize the FMOP library Allocates memory for the global script engine. Call [FMOP\_unloadLibrary()](sos__capi__common_8h.xhtml#ae0af273cc642061f90933b4af2a958ad "Unload the FMOP library Clears the FMOP library from memory. A warning is logged if the library was u...") to release it. A warning is logged if the library was initialized already.

NoteThis method must be called once, before requesting the global script engine with [FMOP\_globalScriptEngine()](sos__capi__script_8h.xhtml#ace6f8c522f626dddbf5fc12d4d1d7a11 "Get the handle to the global script engine from the initialized library. The routine checks if the Lu..."); 



<a id="a462a99c932a9b5704aae42a15826e4c3"></a>## [◆ ](#a462a99c932a9b5704aae42a15826e4c3)FMOP\_licenseLocked()

 DYNARDO\_FMOP\_API bool FMOP\_licenseLocked  ( ) 

Check whether any license feature was acquired.

ReturnsTrue if any license feature is locked, false otherwise 



<a id="a62d038d686a8183e10f52131697bce6c"></a>## [◆ ](#a62d038d686a8183e10f52131697bce6c)FMOP\_releaseLicense()

 DYNARDO\_FMOP\_API [fmop\_error\_t](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8bec) FMOP\_releaseLicense  ( ) 

Release the acquired license.

Note, that no previously acquired license is released if not all loaded Database and FMOP objects are already released

Returns- [fmop\_settings\_error](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8beca4040927e4d05d13e93b9f2c7373ca0cd "Input argument(s) is invalid or missing.") if any Database or FMOP object is not already released
- [fmop\_success](sos__capi__common_8h.xhtml#a4847f3fa2943ffd694eb6cbe169a8beca41a0a2e83b0ac20d414f4b015522ce55 "Function execution returned successfully.") in all other cases

Call [FMOP\_getErrnoString()](sos__capi__common_8h.xhtml#a7e820b85d2ef2596b00bc82445dcf650 "Returns a string description for the error number given.") to get a human readable representation 



<a id="ac13c87c4e4d30a83f4d041a908d0a1e7"></a>## [◆ ](#ac13c87c4e4d30a83f4d041a908d0a1e7)FMOP\_setLogLevel()

 DYNARDO\_FMOP\_API int FMOP\_setLogLevel  ( int  *log\_level*) 

Defines the new log level filter. Valid for all subsequent library calls until a new log level gets set.

Parameters \[in\]log\_levelDefines the new log level filter for messages returned by FMOP\_getLastLog. Accepts the following integer values only:- 0 ... filter all log levels
- 1 ... return only log messages of log level ERROR
- 2 ... return only log messages of log level WARNING and below
- 3 ... return only log messages of log level INFO and below
- 4 ... return only log messages of log level DEBUG and below
- 5 ... return all log messages, i.e. ERROR, WARNING INFO, DEBUG, TRACE. The log level TRACE is not existing in maintenance, i.e. in customer builds.

ReturnsThe former log level or -1 if the log\_level is unknown NoteCalling this function will not manipulate the internal log message stack. Though the errno number will be set and can be queried calling [FMOP\_getLastErrno()](sos__capi__common_8h.xhtml#ac78d83f9f73afd90854e1d07657fc186 "Returns the error number which has been set at the last library call.")