NAME

smtprc - SMTP Relay Checker

SYNOPSIS

smtprc [OPTIONS] ...

DESCRIPTION

smtprc is a fully configurable multithreaded open mail relay scanner/checker. It can scan large networks for open relays and output the results to a web page. It is intended for Systems Administrators to check IP blocks under their control.

OPTIONS

-c config-file

The config file specified with this option contains a list of open relay checks to be performed when scanning. The file is comprised of three columns, each of which is a different check to be performed on the host being tested. The first column will be sent with the HELO command; the second column will be sent with the MAIL FROM: command; and the third column will be sent with the RCPT TO: command.

example:

If the file contains the line.

x.x diceman@dircon.co.uk diceman@dircon.co.uk

The following commands will be sent to the server.

HELO x.x

MAIL FROM:diceman@dircon.co.uk

RCPT TO:diceman@dircon.co.uk

The following macros can also be used.

--IP_ADDRESS-- Represents the IP address of the current server being checked.

--HOSTNAME-- Represents the domain name of the current server being checked.

--NAME-- Represents the name part of the email address specified with the -b option

--DOMAIN-- Represents the domain part of the email address specified with the -b option.

As long as the format of this file is adhered to then as many checks as is required can be added to this file.

-s ip-range

Specify the ip range to scan. Smtprc has a powerful notation that allows you to specify an IP address range using lists/ranges for each element. Thus you can scan the whole class 'B' network 192.168/16 by specifying 192.168.*.* or 192.168.0-255.0-255 or 192.168.0-255.* You can also specify multiple different ranges sepreated by ',' For example 192.168.1.*,172.16.1.* would scan both ranges 192.168.1.0/24 and 172.16.1.0/24

-i hostname-list

This option can be used instead of the -s option. The file specified should contain a list of hostnames/IP addresses to scan sepereated by newlines

-w output-html-page

Use this option to specify the name of a html file that the results should be written to.

-f output-text-file

Use this option to specify the name of a text file that the results should be written to.

-o output-machine-readable-format-file

Use this option to specify a file in which to save the scan results in machine readable format. Each scan will be saved on a single line with values seperated by commas. The values will be: IP address, Domain name, Rule no, STATUS, Banner, HELO reply, MAIL FROM: reply, RCPT TO: reply

-b email-address

This option specifies the email address that should be relayed to while testing.

-e <path to mailbox>

This option specifies the (mbox) mailbox relating to the email address specied with the -b option.

-u <path to mailbox>

This option specifies the (maildir) mailbox relating to the email address specied with the -b option.

-y email-template-file

This option specifies the template to be used for all emails sent while testing.

-j autoconfig-file

The auto config file contains a list of configuration options for running smtprc smtprc can then be run just by specifying the auto config file with this option. An auto config file can also be generated with the -k option.

-k autoconfig-file

Use this option to generate an auto config file comprised of the command line options currently being used. smtprc can then be run using the -j option.

-p number-of-threads

Specify the number of threads to use when scanning (default 1000).

-a

Display results of every scan (even those that passed all tests).

-n

Try to resolve all ip addresses into hostnames.

-m wait-for-mail-timeout

Specify the time in seconds to wait, after scanning, for relayed mails to arrive.

-l connection-timeout

Specify the connect timeout in seconds (default 30).

-r read-timeout

Specify the read timeout in seconds (default 30).

-v

Verbose output. Use twice for greater effect.

-h

Display the help page.

FILES

/usr/local/etc/smtprc/rcheck.conf

The relay check configuration file. smtprc(1) for further details.

/usr/local/etc/smtprc/email.tmpl

The email template file. smtprc(1) for further details.

/usr/local/etc/smtprc/auto.conf

The auto configuration file. smtprc(1) for further details.

/usr/share/doc/smtprc/README

The smtprc readme file. This file contains a detailed explanation of all of smtprc's features. smtprc(1) for further details.

EXAMPLES

The following will scan the range 192.168.1.0/24 using 250 threads trying to relay to smtprc@lippy.warg.co.uk. It will also check the mbox mail file /var/mail/smtprc 1 minute after scanning to see if any mails have been relayed. It also display the results in html to /usr/local/apache/htdocs/smtprc/html. The file /use/local/etc/smtprc/email.tmpl will be used as the template for emails that are sent through any servers that are scanned.

This scan will also create the file /usr/local/etc/smtprc/auto.conf containing all of the command line options just used.

This scan is being run from lippy.warg.co.uk. Sendmail is running on this machine and accepting all mail for smtprc@lippy.warg.co.uk.

smtprc -s 192.168.1.* -c /usr/local/etc/smtprc/rcheck.conf -e /var/mail/smtprc -b smtprc@lippy.warg.co.uk -p 255 -w /usr/local/apache/htdocs/smtprc.html -k /usr/local/etc/smtprc/auto.conf -y /usr/local/etc/smtprc/email.tmpl

The next example will run smtprc taking all of the run time options from the auto config file /usr/local/etc/smtprc/auto.conf

smtprc -j /usr/local/etc/smtprc/auto.conf

BUGS

Please report all bugs to diceman@dircon.co.uk.

AUTHOR

Spencer Hardy - diceman@dircon.co.uk