-
-
Notifications
You must be signed in to change notification settings - Fork 3
batv.1
batv - Bounce Address Tag Validation Tester for indimail-mta
batv -k signkey [ -t stale ] -s addr | -v addr
Where addr is the Mail From address.
BATV defines a method for tagging information to be included in the local part of the RFC2821 Return Path address. This permits encoding information that authenticates bounces to the envelope sender. The encoded information also contains DDD is the number of days elapsed since 1970 and modulus 1000. This can be used by BATV to limit the validity period of the BATV address. batv(1) is a Bounce Address Tag Validation tester. It can be used to encode a tag that can be included in addr or validate a BATV encoded address addr.
Usage Examples
$ date +%s
1632203830
$ batv -k 1632203830 -t 1 -s test@example.com
prvs=0891a9abd5=test@example.com
$ batv -k 1632203830 -v prvs=0891a9abd5=test@example.com
test@example.com
$ batv -k 1632203831 -v prvs=0891a9abd5=test@example.com
could not verify prvs=0891a9abd5=test@example.com: bad BATV address encoding
$ batv -k 1632203830 -v prvs=0881a9abd5=test@example.com
batv: could not verify prvs=0881a9abd5=test@example.com: expired BATV address [10 days]
-s
Generate a BATV address
-v
Validate a BATV address
-k signkey
An alphanumeric key to be used for generating a BATV tag that will be
used to encode the Mail From address.
-t stale
Used for defining the validity in days of the BATV encoded address. A
BATV encoded address contains the number of days elapsed since 1970 and
modulus of 1000. The value of stale is used to limit the validity of
the tagged address to a maximum of stale days. Default: 7 days.
batv(1) returns 0 for successful signing and validation. It returns the following codes if the BATV encoding doesn't validate
1 - address doesn't have BATV encoding
2 - address has an invalid BATV encoding
3 - address has an expired BATV encoding
batv(1) returns 111 for all system errors.
qmail-smtpd(8), qmail-remote(8), https://datatracker.ietf.org/doc/html/draft-levine-mass-batv-02