[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

6. Invoking GNU Anubis

The anubis executable acts like a daemon. The behavior of program is controlled by two configuration files, which have a higher priority than command line options. See section Configuration, for details.

GNU anubis supports the following command line options:

--altrc file

Specify alternate system configuration file.

--bind [host:]port
-b

Specify the TCP port on which GNU Anubis listens for connections. The default host value is ‘INADDR_ANY’, and default port number is 24 (private mail system).

--check-config[=level]
-c[level]

Run the configuration file syntax checker. Optional level specifies the verbosity level. The following levels are allowed:

0

Display only errors. This is the default.

1

Print the syntax tree after parsing the file.

2

As ‘1’, but also prints the parser traces.

3

As ‘2’, but also prints the lexical analyzer traces.

--debug
-D

Debug mode.

--foreground
-f

Foreground mode.

--help

Print short usage summary and exit.

--local-mta file
-l

Execute a local SMTP server, which works on standard input and output (inetd-type program). This option excludes the ‘--remote-mta’ option.

--mode mode-name
-m mode-name

Selects Anubis operation mode. Allowed values for mode-name are ‘transparent’ (default) and ‘auth’. See section Authentication, for the detailed discussion of Anubis operation modes.

--norc

Ignore system configuration file.

--relax-perm-check

Do not check a user config file permissions.

--remote-mta host[:port]
-r

Specify a remote SMTP host name or IP address, which GNU Anubis will connect and forward mail to (after a processing). The default port number is 25.

--silent
-s

Work silently.

--show-config-options

Print a list of configuration options used to build GNU Anubis.

--stdio
-i

Use the SMTP protocol (OMP/Tunnel) as described in RFC 821 on standard input and output.

--verbose
-v

Work noisily.

--version

Print version number and copyright.

Examples:

 
$ anubis --remote-mta smtp-host:25

Run GNU Anubis on port number 24 (private mail system). Note that you must have root privileges to use port number lower than 1024. Make the tunnel between your localhost:24 and smtp-host:25.

 
$ anubis -f --remote-mta smtp-host:25

Same as above, but run GNU Anubis in a foreground mode.

 
$ anubis -f --local-mta /usr/sbin/sendmail -- sendmail -bs

Similar to above, but create a tunnel between localhost:24 and a local program (local MTA). In this example local program is sendmail with ‘-bs’ command line option. The ‘-bs’ option forces sendmail to work on standard input and output.

 
$ anubis --norc --remote-mta smtp-host:25

Do not read the system configuration file, make the tunnel between localhost:24 and smtp-host:25.

 
$ anubis --bind localhost:1111 --remote-mta smtp-host:25

Create the tunnel between localhost:1111 and smtp-host:25.

 
$ anubis -i

Use the SMTP protocol (OMP/Tunnel) as described in RFC 821 on standard input and output.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]

This document was generated by Sergey Poznyakoff on December, 20 2008 using texi2html 1.78.