1 History

1.1 5:0:2

1.1.1 Feature Changes

The changes introduced in 5:0:2 are the following:

• A monitor based on the Solaris/Illumos File Events Notification API has been added.
• The possibility of watching for directories only during a recursive scan. This feature helps reducing the number of open file descriptors if a generic change event for a directory is acceptable instead of events on directory children.

1.1.2 C++ Interface Changes

• Added the fsw::fen_monitor class has been added to provide a monitor based on the Solaris/Illumos File Events Notification API.
• Added the monitor::set_directory_only method to set a flag to only watch directories during a recursive scan.

1.1.3 C Interface Changes

• Added the fsw_set_directory_only function to set a flag to only watch directories during a recursive scan.
• Added the fsw_logf_perror function to log a printf-compatible message using perror.

1.2 4:0:1

1.2.1 Feature Changes

The changes introducted in 4:0:1 are the following:

• A monitor for Microsoft Windows was added.
• A logging function has been added to the library to log verbose messages.

1.2.2 C++ Interface Changes

• The windows_monitor class has been added to provide a monitor that uses the Windows API.

1.2.3 C Interface Changes

• A family of functions and macros have been added to log diagnostic messages and conditionally print them only in verbose mode:
  • fsw_log
  • fsw_flog
  • fsw_logf
  • fsw_flogf
  • fsw_log_perror
  • FSW_LOG
  • FSW_ELOG
  • FSW_LOGF
  • FSW_ELOGF
  • FSW_FLOGF

1.3 3:0:0

1.3.1 Feature Changes

The changes introduced in 3:0:0 are the following:

• The possibility of filtering events by event type was added.
• All the monitors were refactored and the callback invocation logic was moved to the base monitor class.
• All the monitors were refactored and the filtering logic (both by path and event type) was moved to the base monitor class.

1.3.2 C++ Interface Changes

• Added the monitor::add_event_type_filter method to add an event type filter.
• Added the monitor::set_event_type_filters method to set the event type filters.
• Added the monitor::notify_events method to centralize event filtering and dispatching into the base monitor class.
• Added the event::get_event_flag_by_name method to lookup an event type by name.
• Added the event::get_event_flag_name method to get the name of an event type.
• Added the overloaded ostream& operator<<(ostream& out, const fsw_event_flag flag) operator to simplify printing the name of an event type on a stream.

1.3.3 C Interface Changes

• Added the fsw_event_type_filter structure to represent a event type filter.
• Added the FSW_ERR_UNKNOWN_VALUE exit code.
• Added the fsw_add_event_type_filter function to add an event type filter.
• Added the fsw_get_event_flag_by_name function to lookup an event type by name.
• Added the fsw_get_event_flag_name function to get the name of an event type.