1 # Copyright (C) 2020-2021 all contributors <meta@public-inbox.org>
2 # License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
4 # implements the small subset of Linux::Inotify2 functionality we use
5 # using IO::KQueue on *BSD systems.
6 package PublicInbox::KQNotify;
10 use PublicInbox::DSKQXS; # wraps IO::KQueue for fork-safe DESTROY
11 use PublicInbox::FakeInotify qw(fill_dirlist on_dir_change);
12 use Time::HiRes qw(stat);
14 # NOTE_EXTEND detects rename(2), NOTE_WRITE detects link(2)
15 sub MOVED_TO_OR_CREATE () { NOTE_EXTEND|NOTE_WRITE }
19 bless { dskq => PublicInbox::DSKQXS->new, watch => {} }, $class;
23 my ($self, $path, $mask) = @_;
26 opendir($fh, $path) or return;
28 $watch = bless [ $fh, $path, $st[10] ],
29 'PublicInbox::KQNotify::Watchdir';
31 open($fh, '<', $path) or return;
32 $watch = bless [ $fh, $path ],
33 'PublicInbox::KQNotify::Watch';
35 my $ident = fileno($fh);
36 $self->{dskq}->{kq}->EV_SET($ident, # ident
37 EVFILT_VNODE, # filter
38 EV_ADD | EV_CLEAR, # flags
41 if ($mask & (MOVED_TO_OR_CREATE | NOTE_DELETE)) {
42 $self->{watch}->{$ident} = $watch;
43 fill_dirlist($self, $path, $fh) if $mask & NOTE_DELETE;
45 die "TODO Not implemented: $mask";
50 # emulate Linux::Inotify::fileno
51 sub fileno { ${$_[0]->{dskq}->{kq}} }
53 # noop for Linux::Inotify2 compatibility. Unlike inotify,
54 # kqueue doesn't seem to overflow since it's limited by the number of
55 # open FDs the process has
58 # noop for Linux::Inotify2 compatibility, we use `0' timeout for ->kevent
61 # behave like Linux::Inotify2->read
64 my @kevents = $self->{dskq}->{kq}->kevent(0);
66 for my $kev (@kevents) {
67 my $ident = $kev->[KQ_IDENT];
68 my $mask = $kev->[KQ_FFLAGS];
69 my ($dh, $path, $old_ctime) = @{$self->{watch}->{$ident}};
70 if (!defined($old_ctime)) {
72 bless(\$path, 'PublicInbox::FakeInotify::Event')
73 } elsif ($mask & (MOVED_TO_OR_CREATE | NOTE_DELETE)) {
74 my @new_st = stat($path) or next;
75 $self->{watch}->{$ident}->[3] = $new_st[10]; # ctime
77 on_dir_change($events, $dh, $path, $old_ctime,
84 package PublicInbox::KQNotify::Watch;
87 sub name { $_[0]->[1] }
89 sub cancel { close $_[0]->[0] or die "close: $!" }
91 package PublicInbox::KQNotify::Watchdir;
94 sub name { $_[0]->[1] }
96 sub cancel { closedir $_[0]->[0] or die "closedir: $!" }