thorlabs_tsi_logger.cfg

// Specifies the path where the log files are created.
// This setting is optional and if ommitted, the log files are
// are created in the same directory that the logger DLL resides in.
THORLABS_TSI_LOGGER_LOG_FILE_PATH "C:\SDK_log_files\"

// Format for global log specification:
// GLOBAL [log channel options] [logging priority] [Log file size limit in MB] [Number of log files to keep] [Log statement format]  
// [log channel options] ~= 'c', 'a', 'm', 'g', 'u'
//    c - log to the console
//    a - log to the master log file
//    m - log to the module log file
//    g - log to the group log file(s)
//    u - log to the unique (module + group) log file
// [logging priority] ~= [Fatal, Critical, Error, Warning, Notice, Information, Debug, Trace]
// [Log file size limit in MB] ~= specifies an integral limit in MB for the log file size.
//    All surplus log statements will be sent to a newly created log file with a name that
//    is derived from the original log file name.
//    This setting is optional - if it is ommitted, then the log file is allowed to grow
//    unbounded.
// [Number of log files to keep] ~= specifies the number of log files of this type to preserve.
//    If the number of log files exceeds this number, the logger will delete extra log files to
//    maintain this log file count.  The logger will always delete the oldest log files first.
//    This setting is optional - if it is omitted, then the number of log files are allowed to
//    proliferate unbounded.
// [Log statement format] ~= 'n', 'd', 'm', 'p', 'l', 't'
//    n - include the sequence number
//    d - include the date/time stamp
//    m - include the module name
//    p - include the log priority
//    t - include the thread ID
//    l - include the source file location
//    This setting is optional.  If it is ommitted, none of the above
//    metadata is prepended to the log statement.
//
// NOTE: The global settings will override the corresponding settings for group and module
//       loggers with the exception of the log file size limit.  The global log file size limit
//       does NOT override any other limit settings.
THORLABS_TSI_LOGGER_GLOBAL camgu Trace ndmplt

// Format for group log specification:
// GROUP [logging priority] [Log file size limit in MB] [Number of log files to keep] [Log statement format]  
// [logging priority] ~= [Fatal, Critical, Error, Warning, Notice, Information, Debug, Trace]
// [Log file size limit in MB] ~= specifies an integral limit in MB for the log file size.
//    All surplus log statements will be sent to a newly created log file with a name that
//    is derived from the original log file name.
//    This setting is optional - if it is ommitted, then the log file is allowed to grow
//    unbounded.
// [Number of log files to keep] ~= specifies the number of log files of this type to preserve.
//    If the number of log files exceeds this number, the logger will delete extra log files to
//    maintain this log file count.  The logger will always delete the oldest log files first.
//    This setting is optional - if it is omitted, then the number of log files are allowed to
//    proliferate unbounded.
// [Log statement format] ~= 'n', 'd', 'm', 'p', 'l', 't'
//    n - include the sequence number
//    d - include the date/time stamp
//    m - include the module name
//    p - include the log priority
//    t - include the thread ID
//    l - include the source file location
//    This setting is optional.  If it is ommitted, none of the above
//    metadata is prepended to the log statement.
THORLABS_TSI_LOGGER_GROUP Trace ndmplt

// Format for console log specification:
// CONSOLE [logging priority] [Log statement format]  
// [logging priority] ~= [Fatal, Critical, Error, Warning, Notice, Information, Debug, Trace]
// [Log statement format] ~= 'n', 'd', 'm', 'p', 'l', 't'
//    This setting is optional.  If it is ommitted, none of the above
//    metadata is prepended to the log statement.
THORLABS_TSI_LOGGER_CONSOLE Trace ndmplt

// The field separator character that is used in the log files and console loggers.
THORLABS_TSI_LOGGER_FIELD_SEPARATOR_CHARACTER ,

// The field decorator character is used to surround the text of each field of the log statement.
THORLABS_TSI_LOGGER_FIELD_DECORATOR_CHARACTER "

// The log file extension that will be used for all the generated log files.
THORLABS_TSI_LOGGER_LOG_FILE_EXTENSION log

// This setting allows the user to disable file buffering.
// If file buffering is off, the logger will persist every log statement to disk.
// This can be advantageous if the user wants to minimize data loss in the event of a catastrophic failure.
// The disadvantage is that this can affect application performance - significantly if large
// numbers of log statements are generated in a short period of time.
// If file buffering is on, then the logging system will buffer an implementation dependent number of log statements
// before writing the batch to disk.
// The recommended setting is on.
THORLABS_TSI_LOGGER_FILE_BUFFERING on

// Format for a log module:
// [Module name] [log channel options] [logging priority] [Log file size limit in MB] [Number of log files to keep] [Log statement format] [[function filter]]
// [log channel options] ~= 'c', 'a', 'm', 'g', 'u'
//    c - log to the console
//    a - log to the master log file
//    m - log to the module log file
//    g - log to the group log file(s)
//    u - log to the unique (module + group) log file
// [logging priority] ~= [Fatal, Critical, Error, Warning, Notice, Information, Debug, Trace]
// [Log file size limit in MB] ~= specifies an integral limit in MB for the log file size.
//    All surplus log statements will be sent to a newly created log file with a name that
//    is derived from the original log file name.
//    This setting is optional - if it is ommitted, then the log file is allowed to grow
//    unbounded.
// [Number of log files to keep] ~= specifies the number of log files of this type to preserve.
//    If the number of log files exceeds this number, the logger will delete extra log files to
//    maintain this log file count.  The logger will always delete the oldest log files first.
//    This setting is optional - if it is omitted, then the number of log files are allowed to
//    proliferate unbounded.
// [Log statement format] ~= 'n', 'd', 'm', 'p', 'l', 't'
//    n - include the sequence number
//    d - include the date/time stamp
//    m - include the module name
//    p - include the log priority
//    t - include the thread ID
//    l - include the source file location
//    This setting is optional.  If it is ommitted, none of the above
//    metadata is prepended to the log statement.
// [[function filter]] ~= a comma separated list of function names.  The function names
//    must exactly match the implementation dependent __FUNCTION__ macro expansion.
//    An empty function filter includes all functions.  A non-empty list logs statements
//    from only those functions.
::MODULE_1 camgu Trace ndmplt []
::MODULE_2 camgu Trace ndmplt []