NAME

proxy-helper - helper for smtp-gated remote-udp mode

SYNOPSIS

proxy-helper [ -I address ] [ -P port ] [ -i interface ] [ -p pidfile ] [ -n priority ] [ -s secret ] [ -d level ] [ -f ] [ -u user ] [ -g group ]

DESCRIPTION

proxy-helper identifies originating and target IP for NAT-ted connections.

OPTIONS

-d, --debug <level>

Debugging log level (see syslog(3))

-f, --foreground

Do not fork, run in foreground.

-g, --group <group>

Run as specified group.

-I, --address <ip>

Bind to this IP.

-i, --interface <NAME>

Bind to this interface.

-l, -log-queries <level>

Log queries: 0=do not log any, 1=log responses, 2=log all available information (this also requires setting --debug to 7). This does not affect logging of error conditions.

-n, --priority <prio>

Run with specified priority.

-p, --pid-file <file>

Create pid file with specified name.

-P, --port <port>

Bind to this (UDP) port.

-u, --user <user>

Run as specified user.

-s, --secret <0xN>

Secret for simple authentication (32-bit hex).

-h, --help

Show this help.

-V, --version

Print version and settings.

SIGNALS

USR1

Log statistics

TERM

QUIT

Terminate process.

REQUIREMENTS

proxy-helper uses netfilter netlink interface for conntrack lookups. Support depends on kernel version:

2.6.x since 2.6.14

nfnetlink_conntrack is natively supported by kernel. All you need is libnfnetlink and libnetfilter_conntrack libraries installed (from your distribution or netfilter.org subversion). You must enable IP_NF_CONNTRACK_NETLINK ("Connection tracking netlink interface") in kernel configuration to produce ip_conntrack_netlink module.

2.6.x before 2.6.14

I have no idea if this is supported

2.4.x

There were apropriate patches in patch-o-matic, that worked for at least 2.4.27 and 2.4.29. Userspace libraries are included in proxy-helper sources, and are used if necessary.

Kernel support version is printed at the end by ./configure script, and by proxy-helper -V (as "ctnetlink kernel version").

SEE ALSO

smtpgated(8) smtpgated.conf(5)

BUGS

See http://software.klolik.org/proxy-helper/#bugs for details.

HOMEPAGE

http://software.klolik.org

AUTHOR

Bartlomiej Korupczynski