+# returns the git config section name, e.g [imap "imaps://user@example.com"]
+# without the mailbox, so we can share connections between different inboxes
+sub imap_section ($) {
+ my ($uri) = @_;
+ $uri->scheme . '://' . $uri->authority;
+}
+
+sub cfg_intvl ($$) {
+ my ($cfg, $key) = @_;
+ defined(my $v = $cfg->{lc($key)}) or return;
+ $v =~ /\A[0-9]+\z/s and return $v + 0;
+ if (ref($v) eq 'ARRAY') {
+ $v = join(', ', @$v);
+ warn "W: $key has multiple values: $v\nW: $key ignored\n";
+ } else {
+ warn "W: $key=$v is not an integer value in seconds\n";
+ }
+}
+
+# flesh out common IMAP-specific data structures
+sub imap_common_init ($) {
+ my ($self) = @_;
+ my $cfg = $self->{config};
+ my $mic_args = {}; # scheme://authority => Mail:IMAPClient arg
+ for my $url (sort keys %{$self->{imap}}) {
+ my $uri = PublicInbox::URIimap->new($url);
+ my $sec = imap_section($uri);
+ for my $k (qw(Starttls Debug Compress)) {
+ my $key = lc("imap.$sec.$k");
+ defined(my $orig = $cfg->{$key}) or next;
+ my $v = PublicInbox::Config::_git_config_bool($orig);
+ if (defined($v)) {
+ $mic_args->{$sec}->{$k} = $v;
+ } else {
+ warn "W: $key=$orig is not boolean\n";
+ }
+ }
+ my $to = cfg_intvl($cfg, "imap.$sec.Timeout");
+ $mic_args->{$sec}->{Timeout} = $to if $to;
+ $to = cfg_intvl($cfg, "imap.$sec.PollInterval");
+ $self->{imap_opt}->{$sec}->{poll_intvl} = $to if $to;
+ $to = cfg_intvl($cfg, "imap.$sec.IdleInterval");
+ $self->{imap_opt}->{$sec}->{idle_intvl} = $to if $to;
+ }
+ $mic_args;
+}
+
+sub auth_anon_cb { '' }; # for Mail::IMAPClient::Authcallback
+
+sub mic_for ($$$) { # mic = Mail::IMAPClient
+ my ($self, $uri, $mic_args) = @_;
+ my $url = $uri->as_string;
+ my $cred = {
+ url => $url,
+ protocol => $uri->scheme,
+ host => $uri->host,
+ username => $uri->user,
+ password => $uri->password,
+ };
+ my $common = $mic_args->{imap_section($uri)} // {};
+ my $host = $cred->{host};
+ my $mic_arg = {
+ Port => $uri->port,
+ # IMAPClient mishandles `0', so we pass `127.0.0.1'
+ Server => $host eq '0' ? '127.0.0.1' : $host,
+ Ssl => $uri->scheme eq 'imaps',
+ Keepalive => 1, # SO_KEEPALIVE
+ %$common, # may set Starttls, Compress, Debug ....
+ };
+ my $mic = PublicInbox::IMAPClient->new(%$mic_arg) or
+ die "E: <$url> new: $@\n";
+
+ # default to using STARTTLS if it's available, but allow
+ # it to be disabled since I usually connect to localhost
+ if (!$mic_arg->{Ssl} && !defined($mic_arg->{Starttls}) &&
+ $mic->has_capability('STARTTLS') &&
+ $mic->can('starttls')) {
+ $mic->starttls or die "E: <$url> STARTTLS: $@\n";
+ }
+
+ # do we even need credentials?
+ if (!defined($cred->{username}) &&
+ $mic->has_capability('AUTH=ANONYMOUS')) {
+ $cred = undef;
+ }
+ if ($cred) {
+ Git::credential($cred, 'fill'); # may prompt user here
+ $mic->User($mic_arg->{User} = $cred->{username});
+ $mic->Password($mic_arg->{Password} = $cred->{password});
+ } else { # AUTH=ANONYMOUS
+ $mic->Authmechanism($mic_arg->{Authmechanism} = 'ANONYMOUS');
+ $mic->Authcallback($mic_arg->{Authcallback} = \&auth_anon_cb);
+ }
+ if ($mic->login && $mic->IsAuthenticated) {
+ # success! keep IMAPClient->new arg in case we get disconnected
+ $self->{mic_arg}->{imap_section($uri)} = $mic_arg;
+ } else {
+ warn "E: <$url> LOGIN: $@\n";
+ $mic = undef;
+ }
+ Git::credential($cred, $mic ? 'approve' : 'reject') if $cred;
+ $mic;
+}
+
+sub imap_start ($) {
+ my ($self) = @_;
+ eval { require PublicInbox::IMAPClient } or
+ die "Mail::IMAPClient is required for IMAP:\n$@\n";
+ eval { require Git } or
+ die "Git (Perl module) is required for IMAP:\n$@\n";
+ eval { require PublicInbox::IMAPTracker } or
+ die "DBD::SQLite is required for IMAP\n:$@\n";
+
+ my $mic_args = imap_common_init($self);
+ # make sure we can connect and cache the credentials in memory
+ $self->{mic_arg} = {}; # schema://authority => IMAPClient->new args
+ my $mics = $self->{mics} = {}; # schema://authority => IMAPClient obj
+ for my $url (sort keys %{$self->{imap}}) {
+ my $uri = PublicInbox::URIimap->new($url);
+ $mics->{imap_section($uri)} //= mic_for($self, $uri, $mic_args);
+ }
+}
+
+sub imap_fetch_all ($$$) {
+ my ($self, $mic, $uri) = @_;
+ my $sec = imap_section($uri);
+ my $mbx = $uri->mailbox;
+ my $url = $uri->as_string;
+ $mic->Clear(1); # trim results history
+ $mic->examine($mbx) or return "E: EXAMINE $mbx ($sec) failed: $!";
+ my ($r_uidval, $r_uidnext);
+ for ($mic->Results) {
+ /^\* OK \[UIDVALIDITY ([0-9]+)\].*/ and $r_uidval = $1;
+ /^\* OK \[UIDNEXT ([0-9]+)\].*/ and $r_uidnext = $1;
+ last if $r_uidval && $r_uidnext;
+ }
+ $r_uidval //= $mic->uidvalidity($mbx) //
+ return "E: $url cannot get UIDVALIDITY";
+ $r_uidnext //= $mic->uidnext($mbx) //
+ return "E: $url cannot get UIDNEXT";
+ my $itrk = PublicInbox::IMAPTracker->new;
+ my ($l_uidval, $l_uid) = $itrk->get_last($url);
+ $l_uidval //= $r_uidval; # first time
+ $l_uid //= 1;
+ if ($l_uidval != $r_uidval) {
+ return "E: $url UIDVALIDITY mismatch\n".
+ "E: local=$l_uidval != remote=$r_uidval";
+ }
+ my $r_uid = $r_uidnext - 1;
+ if ($l_uid != 1 && $l_uid > $r_uid) {
+ return "E: $url local UID exceeds remote ($l_uid > $r_uid)\n".
+ "E: $url strangely, UIDVALIDLITY matches ($l_uidval)\n";
+ }
+ return if $l_uid >= $r_uid; # nothing to do
+
+ $mic->Uid(1); # the default, we hope
+ my $req = $mic->imap4rev1 ? 'BODY.PEEK[]' : 'RFC822.PEEK';
+ my $key = $req;
+ $key =~ s/\.PEEK//;
+ my $inboxes = $self->{imap}->{$url};
+ warn "I: $url fetching $l_uid..$r_uid\n";
+ my $uid = -1;
+ my $warn_cb = $SIG{__WARN__} || sub { print STDERR @_ };
+ local $SIG{__WARN__} = sub {
+ $warn_cb->("$url UID:$uid\n");
+ $warn_cb->(@_);
+ };
+ my $err;
+ $itrk->{dbh}->begin_work;
+ for my $u ($l_uid..$r_uid) {
+ $uid = $u;
+ local $0 = "UID:$uid $mbx $sec";
+ my $r = $mic->fetch_hash($uid, $req);
+ unless ($r) { # network error?
+ $err = "E: $url UID FETCH $uid error: $!\n";
+ last;
+ }
+
+ # messages get deleted, so holes appear
+ defined(my $raw = delete $r->{$uid}->{$key}) or next;
+
+ # our target audience expects LF-only, save storage
+ $raw =~ s/\r\n/\n/sg;
+
+ if (ref($inboxes)) {
+ for my $ibx (@$inboxes) {
+ my $eml = PublicInbox::Eml->new($raw);
+ my $x = import_eml($self, $ibx, $eml);
+ }
+ } elsif ($inboxes eq 'watchspam') {
+ my $eml = PublicInbox::Eml->new($raw);
+ my $arg = [ $self, $eml, "$uri UID:$uid" ];
+ $self->{config}->each_inbox(\&remove_eml_i, $arg);
+ } else {
+ die "BUG: destination unknown $inboxes";
+ }
+ $itrk->update_last($url, $r_uidval, $uid);
+ last if $self->{quit};
+ }
+ _done_for_now($self);
+ $itrk->{dbh}->commit;
+ $err;
+}
+
+sub imap_idle_once ($$$$) {
+ my ($self, $mic, $intvl, $url) = @_;
+ my $i = $intvl //= (29 * 60);
+ my $end = now() + $intvl;
+ warn "I: $url idling for ${intvl}s\n";
+ local $0 = "IDLE $0";
+ unless ($mic->idle) {
+ return if $self->{quit};
+ return "E: IDLE failed on $url: $!";
+ }
+ $self->{idle_mic} = $mic; # for ->quit
+ my @res;
+ until ($self->{quit} || grep(/^\* [0-9]+ EXISTS/, @res) || $i <= 0) {
+ @res = $mic->idle_data($i);
+ $i = $end - now();
+ }
+ delete $self->{idle_mic};
+ unless ($self->{quit}) {
+ $mic->IsConnected or return "E: IDLE disconnected on $url";
+ $mic->done or return "E: IDLE DONE failed on $url: $!";
+ }
+ undef;
+}
+
+# idles on a single URI
+sub watch_imap_idle_1 ($$$) {
+ my ($self, $uri, $intvl) = @_;
+ my $sec = imap_section($uri);
+ my $mic_arg = $self->{mic_arg}->{$sec} or
+ die "BUG: no Mail::IMAPClient->new arg for $sec";
+ my $mic;
+ local $0 = $uri->mailbox." $sec";
+ until ($self->{quit}) {
+ $mic //= delete($self->{mics}->{$sec}) //
+ PublicInbox::IMAPClient->new(%$mic_arg);
+ my $err = imap_fetch_all($self, $mic, $uri);
+ $err //= imap_idle_once($self, $mic, $intvl, $uri->as_string);
+ if ($err && !$self->{quit}) {
+ warn $err, "\n";
+ $mic = undef;
+ sleep 60 unless $self->{quit};
+ }
+ }
+}
+
+sub watch_imap_idle_all ($$) {
+ my ($self, $idle) = @_; # $idle = [[ uri1, intvl1 ], [ uri2, intvl2 ]]
+ $self->{mics} = {}; # going to be forking, so disconnect
+ my $idle_pids = $self->{idle_pids} = {};
+ until ($self->{quit}) {
+ while (my $uri_intvl = shift @$idle) {
+ my ($uri, $intvl) = @$uri_intvl;
+ defined(my $pid = fork) or die "fork: $!";
+ if ($pid == 0) {
+ delete $self->{idle_pids};
+ watch_imap_idle_1($self, $uri, $intvl);
+ _exit(0);
+ }
+ $idle_pids->{$pid} = $uri_intvl;
+ }
+ my $pid = waitpid(-1, 0) or next;
+ if ($pid < 0) {
+ warn "W: no idling children: $!";
+ if (@$idle) {
+ sleep 60;
+ } else {
+ warn "W: nothing to respawn, quitting IDLE\n";
+ last;
+ }
+ }
+ if (my $uri_intvl = delete $idle_pids->{$pid}) {
+ my ($uri, $intvl) = @$uri_intvl;
+ my $url = $uri->as_string;
+ if ($? || !$self->{quit}) {
+ warn "W: PID=$pid on $url died: \$?=$?\n";
+ }
+ push @$idle, $uri_intvl;
+ } else {
+ warn "W: PID=$pid (unknown) reaped: \$?=$?\n";
+ }
+ }
+
+ # tear it all down
+ kill('QUIT', $_) for (keys %$idle_pids);
+ while (scalar keys %$idle_pids) {
+ if (my $pid = waitpid(-1, WNOHANG)) {
+ if ($pid < 0) {
+ warn "E: no children? $! (PIDs: ",
+ join(', ', keys %$idle_pids),")\n";
+ last;
+ } else {
+ delete $idle_pids->{$pid};
+ }
+ } else { # signals aren't that reliable w/o signalfd/kevent
+ sleep 1;
+ kill('QUIT', $_) for (keys %$idle_pids);
+ }
+ }
+}
+
+sub watch_imap ($) {
+ my ($self) = @_;
+ my $idle = []; # [ [ uri1, intvl1 ], [uri2, intvl2] ];
+ my $poll = {}; # intvl_seconds => [ uri1, uri2 ]
+ for my $url (keys %{$self->{imap}}) {
+ my $uri = PublicInbox::URIimap->new($url);
+ my $sec = imap_section($uri);
+ my $mic = $self->{mics}->{$sec};
+ my $intvl = $self->{imap_opt}->{$sec}->{poll_intvl};
+ if ($mic->has_capability('IDLE') && !$intvl) {
+ $intvl = $self->{imap_opt}->{$sec}->{idle_intvl};
+ push @$idle, [ $uri, $intvl // () ];
+ } else {
+ push @{$poll->{$intvl || 120}}, $uri;
+ }
+ }
+ my $nr_poll = scalar keys %$poll;
+ if (scalar @$idle && !$nr_poll) { # multiple idlers, need fork
+ watch_imap_idle_all($self, $idle);
+ }
+ # TODO: polling
+}
+
+sub watch {
+ my ($self) = @_;
+ if ($self->{mdre} && $self->{imap}) {
+ defined(my $pid = fork) or die "fork: $!";
+ if ($pid == 0) {
+ imap_start($self);
+ goto &watch_imap;
+ }
+ $self->{-imap_pid} = $pid;
+ } elsif ($self->{imap}) {
+ imap_start($self);
+ goto &watch_imap;
+ }
+ goto &watch_fs;
+}
+