Name

aftr — Address Family Transition Router

Synopsis

aftr [-g] [-t] [-c config-file] [-d device-name] [-p port-number] [-s script-file] [-u socket-name]

OPTIONS

-g

By default the aftr process becomes a daemon, -g keeps it in foreground with logging to stderr.

-t

-t can be used to check a configuration file.

-c config-file

The aftr daemon requires a configuration file. By default it is named aftr.conf, and is located in $src_path. The AFTRCONFIG environment variable and the -c argument give an alternate path. A sample configuration file is provided in $src_path/confs/aftr.conf (OS independent).

-d device-name

Linux: The aftr process opens /dev/net/tun and set the name of the interface to the AFTRDEVICE environment variable or the -d command line argument value or by default 'tun0'.

FreeBSD: The aftr process opens /dev/tunXXX from the AFTRDEVICE environment variable or the -d command or by default /dev/tun0. The 'auto' value uses the first free /dev/tunXXX device.

The tunnel interface/device specification can be a full path (/dev/...), a relative name or a number.

-p port-number

Use the port-number for TCP control channels. Default is 1015.

-s script-file

The aftr daemon executes a shell script file with start on invocation. This is named by default aftr-script and located in $src_path. The AFTRSCRIPT environment variable and the -s argument give an alternate path. This file could be even empty, but must exist.

The aftr daemon will eventually execute the shell script file with the stop argument before it exits.

The confs directory provides examples (in fact the scripts used in our testbeds). aftr-script.freebsd variant is for a FreeBSD based AFTR.

-u socket-name

As an alternative to TCP over IPv4 and IPv6 with localhost control channels, the aftr process can accept PF_UNIX stream socket control channel on the socket-name.

SEE ALSO

aftr.conf(5), aftr.commands(5)

AUTHOR

Internet Systems Consortium