T. R. Bernstein
6375a23328
`IN_Q_OVERFLOW` arrives with watch descriptor -1, so the path lookup failed and the event was silently discarded. It is now delivered with an empty path so consumers can rescan after the kernel dropped events.
34 lines
1.1 KiB
Swift
34 lines
1.1 KiB
Swift
import SystemPackage
|
|
|
|
/// A filesystem event delivered by an ``Inotify`` instance.
|
|
///
|
|
/// When the kernel's event queue overflows, it drops events and reports a
|
|
/// single event whose ``mask`` contains ``InotifyEventMask/queueOverflow``.
|
|
/// Such an event belongs to no watch: its ``watchDescriptor`` is `-1` and
|
|
/// its ``path`` is empty. Consumers that must not miss changes should
|
|
/// rescan the watched trees when they receive one.
|
|
public struct InotifyEvent: Sendable, Hashable, CustomStringConvertible {
|
|
public let watchDescriptor: Int32
|
|
public let mask: InotifyEventMask
|
|
public let cookie: UInt32
|
|
public let path: FilePath
|
|
|
|
public var description: String {
|
|
var parts = ["InotifyEvent(wd: \(watchDescriptor), mask: \(mask), path: \"\(path)\""]
|
|
if cookie != 0 { parts.append("cookie: \(cookie)") }
|
|
return parts.joined(separator: ", ") + ")"
|
|
}
|
|
}
|
|
|
|
extension InotifyEvent {
|
|
public init(from rawEvent: RawInotifyEvent, inDirectory path: String) {
|
|
let dirPath = FilePath(path)
|
|
self.init(
|
|
watchDescriptor: rawEvent.watchDescriptor,
|
|
mask: rawEvent.mask,
|
|
cookie: rawEvent.cookie,
|
|
path: dirPath.appending(rawEvent.name)
|
|
)
|
|
}
|
|
}
|