=head1 NAME public-inbox-pop3d - POP3 server for sharing public-inboxes =head1 SYNOPSIS public-inbox-pop3d [OPTIONS] =head1 DESCRIPTION public-inbox-pop3d provides a POP3 daemon for public-inbox. It uses options and environment variables common to all read-only L implementations, but requires additional read-write storage to keep track of deleted messages on a per-user basis. Like L, C will never require write access to the directory where the public-inboxes are stored. It is designed for anonymous access, thus the password is always C (all lower-case). Usernames are of the format: C<$UUID@$NEWSGROUP_NAME> Where C<$UUID> is the output of the L command. Dash (C<->) characters in UUIDs are ignored, and C<[A-F]> hex characters are case-insensitive. Users should keep their UUIDs private to prevent others from deleting unretrieved messages. Users may switch to a new UUID at any time to retrieve previously-retrieved messages. Historical slices of 50K messages are available by suffixing the integer L<$SLICE>, where C<0> is the oldest. C<$UUID@$NEWSGROUP_NAME.$SLICE> It may be run as a different user than the user running L, L, or L. To save storage, L only stores the highest-numbered deleted message =head1 OPTIONS See common options in L. =over =item -l PROTOCOL://ADDRESS/?cert=/path/to/cert,key=/path/to/key =item --listen PROTOCOL://ADDRESS/?cert=/path/to/cert,key=/path/to/key In addition to the normal C<-l>/C<--listen> switch described in L, the C prefix (e.g. C or C) may be specified to force a given protocol. For STARTTLS and POP3S support, the C and C may be specified on a per-listener basis after a C character and separated by C<,>. These directives are per-directive, and it's possible to use a different cert for every listener. =item --cert /path/to/cert The default TLS certificate for optional STARTTLS and POP3S support if the C option is not given with C<--listen>. If using systemd-compatible socket activation and a TCP listener on port 995 is inherited, it is automatically POP3S when this option is given. When a listener on port 110 is inherited and this option is given, it automatically gets STARTTLS support. =item --key /path/to/key The default private TLS certificate key for optional STARTTLS and POP3S support if the C option is not given with C<--listen>. The private key may be concatenated into the path used by C<--cert>, in which case this option is not needed. =back =head1 CONFIGURATION Aside from C, C uses the same configuration knobs as L, see L and L. =over 8 =item publicInbox.pop3state A directory containing per-user/mailbox account information; must be writable to the C process. =item publicInbox..newsgroup The newsgroup name maps to a POP3 folder name. =back =head1 CONTACT Feedback welcome via plain-text mail to L The mail archives are hosted at L, and L, L =head1 COPYRIGHT Copyright all contributors L License: AGPL-3.0+ L =head1 SEE ALSO L, L, L, L, L, L