NAME

ungrey-robins - pf spamd auto-whitelister of round-robin SMTP clients

SYNOPSIS

ungrey-robins [-d] [-g grace threshold]

DESCRIPTION

ungrey-robins assists postmasters by automatically whitelisting round robin SMTP clients (which often fail to pass greylisting), without resorting to manual maintenance of whitelists.

Normal Usage

Running ungrey-robins at the same frequency as spamd(8)'s -G greyexp period (4 hours by default) is entirely adequate. There is no benefit in consuming CPU, I/O & network resources in running it more often.

Scheduling

Intermittent runs of the lightweight korn(1) shell script via cron(8) has proved to be effective simplicity.

OPTIONS

-d

Run in debug mode.

-g grace threshold

The threshold at which grace is granted to whitelist a spamdb(8) greylisted IP address, which defaults to 7.

ENVIRONMENT

DEBUG

Enable debugging when set to anything.

TMPDIR

Directory in which to place temporary files made with mktemp(1). If unset, /tmp is used.

FILES

/etc/mail/ungrey-robins.ptrn mandatory domains pattern file.

SECURITY

For unprivileged, non-root usage:

To both read and write to spamd(8)'s database file /var/db/spamd via the spamdb(8) tool, it is suggested to run ungrey-robins from the _spamd user's crontab(5).

The source code distribution contains an example crontab file.

SEE ALSO

ungrey-robins.ptrn(5), spamd(8), spamdb(8), crontab(5), crontab(1), mktemp(1)

AVAILABILITY

For your convenience, the project offers:

The source code distribution README file contains specifics.

While designed specifically for OpenBSD, it might function on Unix-like pf spamd enabled OSs, such as NetBSD, FreeBSD, DragonFly BSD, etc.

LICENCE

ungrey-robins has an ISC, or 'two-term BSD' styled open source copyright. Refer to the LICENCE file within the source distribution.

HISTORY

Craig Skinner developed ungrey-robins, mostly in 2016. The ChangeLog file in the source distribution contains more information.