Skip to content
Manvendra Bhangui edited this page Feb 25, 2024 · 4 revisions

NAME

srs - command line interface to libsrs2

SYNOPSIS

srs [options]* address*

DESCRIPTION

srs is a frontend to the libsrs2 library. libsrs2 is the next generation SRS library from the original designer of SRS. It implements the Sender Rewriting Scheme, a part of the SPF/SRS protocol pair. Libsrs2 has been written from an entirely clean codebase with compliance, speed and versatility in mind. It is platform independent and has no external dependencies. It is thread-safe and heap-safe, and is suitable for large scale applications and embedded systems and can operate without many standard system facilities.

OPTIONS

srs programs follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-a address | --address=address
Provide an address to translate

-k secret | --secret=secret
Provide a cryptographic secret.

-f filename | --secretfile=filename
Provide a file containing cryptographic secrets.

-i domain | --alias=domain
Specify the alias for forwards rewriting.

-l length | --hashlength=length
Specify the hash length for forwards rewriting.

-r | --alwaysrewrite
Force rewriting even when optional.

-o | --forward
Perform forwards rewriting.

--separator=sep
Set the initial SRS separator.

-d | --daemon
Become a rewriting daemon.

-x | --nofork
Run fork daemon in foreground.

-s socket | --socket=socket

-v | --reverse
Perform reverse rewriting.

-h | --help
Display this help.

This program and library are documented fully at http://www.libsrs2.org/.

EXAMPLES

Rewrite postmaster@argos.indimail.org

$ srs -k 'kdjf93oupoxlpNlR[cUyXEY(YuYH' -i srs.argos.indimail.org \
		postmaster@argos.indimail.org
SRS0=B3Wp=2M=argos.indimail.org=postmaster@srs.argos.indimail.org

Translate SRS0=B3Wp=2M=argos.indimail.org=postmaster@srs.argos.indimail.org

$ srs -k 'kdjf93oupoxlpNlR[cUyXEY(YuYH' -i srs.argos.indimail.org \
	-v SRS0=B3Wp=2M=argos.indimail.org=postmaster@srs.argos.indimail.org
postmaster@argos.indimail.org

SEE ALSO

qmail-smtpd(8), srsfilter(1), qmail-send(8), slowq-send(8), qmta-send(8), qmail-inject(8), qmail-local(8), condredirect(1), forward(1)

Clone this wiki locally