v2.1.0

API documentation available on the stumpless website.

Added

• Custom function logging targets.
• Localizations for:
  • Bengali (bn-IN 🇮🇳)
  • Chinese (zh-CN 🇨🇳)
  • Czech (cz-CZ 🇨🇿)
  • Hindi (hi-IN 🇮🇳)
  • Polish (pl-PL 🇵🇱)
  • Portuguese (pt-BR 🇧🇷)
  • Spanish (es-ES 🇪🇸)
• Systemd journal logging targets (journald).
• Log source file tracing functions:
  • stump_trace
  • stumpless_trace_entry
  • stumpless_trace_log
  • stumpless_trace_message
  • stumplog_trace
  • vstump_trace
  • vstumpless_trace_log
  • vstumpless_trace_message
  • vstumplog_trace
• The TRACE log level severity shorthand function macros:
  • stump_t
  • stump_t_entry
  • stump_t_log
  • stump_t_message
  • stumplog_t
• Macro STUMPLESS_SEVERITY_TRACE_VALUE as an alias for
  STUMPLESS_SEVERITY_DEBUG_VALUE.
• Macro STUMPLESS_SEVERITY_TRACE for the new level as an alias for
  the STUMPLESS_SEVERITY_DEBUG enum member.
• Runtime filtering mechanism, as well as default support for log masks, via
  the following functions:
  • stumpless_get_target_filter
  • stumpless_get_target_mask
  • stumpless_mask_filter
  • stumpless_set_target_filter
  • stumpless_set_target_mask
  • stumplog_set_mask
• Safer and more performant _str versions of any function taking a format
  specifier string and variable number of arguments.
• Default Windows Event Log messages that can be used when none are specified.
• Full unicode support with Windows Event Log targets, along with the following
  new functions:
  • stumpless_add_default_wel_event_source
  • stumpless_add_wel_event_source
  • stumpless_add_wel_event_source_w
  • stumpless_get_wel_category
  • stumpless_get_wel_event_id
  • stumpless_get_wel_insertion_param
  • stumpless_get_wel_insertion_string_w
  • stumpless_get_wel_type
  • stumpless_remove_default_wel_event_source
  • stumpless_remove_wel_event_source
  • stumpless_remove_wel_event_source_w
  • stumpless_set_wel_insertion_string_w
  • stumpless_set_wel_insertion_strings_w
  • vstumpless_set_wel_insertion_strings_w
• STUMPLESS_OPTION_CONS is now supported with similar semantics to LOG_CONS
  from syslog.h.
• The procid and hostname can be overriden if the defaults are not wanted, via
  the functions:
  • stumpless_get_entry_hostname
  • stumpless_get_entry_procid
  • stumpless_set_entry_hostname
  • stumpless_set_entry_procid
• Other new functions:
  • stumpless_get_network_protocol
  • stumpless_get_target_type_string
  • stumpless_get_transport_protocol

Changed

• Auto-generated local socket names use abstract socket names if supported.
• Auto-generated local socket names are always stumpless-socket instead of
  being generated using mkstemp.

Fixed

• stumpless_perror segmentation faults after the following errors:
  • STUMPLESS_FILE_OPEN_ERROR
  • STUMPLESS_FILE_WRITE_ERROR
  • STUMPLESS_INVALID_ID
  • STUMPLESS_MEMORY_ALLOCATION_FAILURE
  • STUMPLESS_NETWORK_PROTOCOL_UNSUPPORTED
  • STUMPLESS_STREAM_WRITE_FAILURE
  • STUMPLESS_TRANSPORT_PROTOCOL_UNSUPPORTED
  • STUMPLESS_WINDOWS_EVENT_LOG_CLOSE_FAILURE
  • STUMPLESS_WINDOWS_EVENT_LOG_OPEN_FAILURE
• Several memory leaks:
  • Object cache leak in some allocation failure scenarios
  • Creating network target with unsupported protocols
• close syscall is no longer called on invalid socket handles
• TCP network targets do not hang when the session is closed by the receiver.