7. 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 5. 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 4. 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.