All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Nothing yet.
This version of fsnotify needs Go 1.16 (this was already the case since 1.5.1, but not documented). It also increases the minimum Linux version to 2.6.32.
all: add Event.Has()
and Op.Has()
(#477)
This makes checking events a lot easier; for example:
if event.Op&Write == Write && !(event.Op&Remove == Remove) { }
Becomes:
if event.Has(Write) && !event.Has(Remove) { }
all: add cmd/fsnotify (#463)
A command-line utility for testing and some examples.
inotify: don‘t ignore events for files that don’t exist (#260, #470)
Previously the inotify watcher would call os.Lstat()
to check if a file still exists before emitting events.
This was inconsistent with other platforms and resulted in inconsistent event reporting (e.g. when a file is quickly removed and re-created), and generally a source of confusion. It was added in 2013 to fix a memory leak that no longer exists.
all: return ErrNonExistentWatch
when Remove()
is called on a path that's not watched (#460)
inotify: replace epoll() with non-blocking inotify (#434)
Non-blocking inotify was not generally available at the time this library was written in 2014, but now it is. As a result, the minimum Linux version is bumped from 2.6.27 to 2.6.32. This hugely simplifies the code and is faster.
kqueue: don't check for events every 100ms (#480)
The watcher would wake up every 100ms, even when there was nothing to do. Now it waits until there is something to do.
macos: retry opening files on EINTR (#475)
kqueue: skip unreadable files (#479)
kqueue requires a file descriptor for every file in a directory; this would fail if a file was unreadable by the current user. Now these files are simply skipped.
windows: fix renaming a watched directory if the parent is also watched (#370)
windows: increase buffer size from 4K to 64K (#485)
windows: close file handle on Remove() (#288)
kqueue: put pathname in the error if watching a file fails (#471)
inotify, windows: calling Close() more than once could race (#465)
kqueue: improve Close() performance (#233)
all: various documentation additions and clarifications.
Watcher.WatchList
#447raw.FileNameLength
exceeds syscall.MAX_PATH
#361poller.fd
twice in newFdPoller
#406(*T).Fatalf
from a non-test goroutine #416kqueue: Fix logic for CREATE after REMOVE #111 (thanks @bep)
code.google.com/p/go.exp/fsnotify
in preparation for inclusion in the Go standard library.ERROR_MORE_DATA
on Windows #49 (thanks @jbowtie)IN_MOVED_TO
#25 (requested by @cpisto)DELETE_SELF
(requested by @taralx)IN_IGNORED
events