NAME

       tayga - stateless NAT64 daemon

SYNOPSIS

       tayga [OPTION]...

       tayga --mktun [OPTION]...

       tayga --rmtun [OPTION]...

DESCRIPTION

       TAYGA  is  a  stateless  NAT64  daemon for Linux.  Using the in-kernel TUN network driver,
       TAYGA receives IPv4 and IPv6 packets from the host's network stack, translates them to the
       other  protocol, and then sends the translated packets back to the host using the same TUN
       interface.

       Translation is compliant with  IETF  Internet-Draft  draft-ietf-behave-v6v4-xlate-23,  and
       address  mapping  is  performed  in  accordance  with  RFC 6052.  Optionally, TAYGA may be
       configured to dynamically map IPv6 hosts to addresses drawn from a configured IPv4 address
       pool.

       As  a  stateless  NAT, TAYGA requires a one-to-one mapping between IPv4 addresses and IPv6
       addresses.  Mapping multiple IPv6 addresses onto a single IPv4 address can be achieved  by
       mapping  IPv6  addresses  to  private  IPv4 addresses with TAYGA and then using a stateful
       NAT44 (such as the iptables(8) MASQUERADE target) to map the private IPv4  addresses  onto
       the desired single IPv4 address.

       TAYGA's  configuration  is  stored  in  the  tayga.conf(5) file, which is usually found in
       /etc/tayga.conf or /usr/local/etc/tayga.conf.

INVOCATION

       Without the --mktun  or  --rmtun  options,  the  `tayga`  executable  runs  as  a  daemon,
       translating packets as described above.

       The  --mktun  and  --rmtun  options instruct TAYGA to create or destroy, respectively, its
       configured TUN device as a "persistent" interface and then immediately exit.

       Persistent TUN devices remain present on the host system even when TAYGA is  not  running.
       This  allows  host-side  network  parameters  and firewall rules to be configured prior to
       commencement of packet translation.  This may simplify network configuration on the  host;
       for  example,  systems which use a Debian-style /etc/network/interfaces file may configure
       TAYGA's TUN device at boot by running `tayga --mktun`  as  a  "pre-up"  command  and  then
       configuring the TUN device as any other network interface.

OPTIONS

       -c configfile | --config configfile
              Read configuration options from configfile

       -d     Enable debug messages (enables --nodetach as well)

       -n | --nodetach
              Do not detach from terminal

       -u userid | --user userid
              Set uid to userid after initialization

       -g groupid | --group groupid
              Set gid to groupid after initialization

       -r | --chroot
              chroot() to data-dir (specified in config file)

       -p pidfile | --pidfile pidfile
              Write process ID of daemon to pidfile

AUTHOR

       Written by Nathan Lutchansky <lutchann@litech.org>

COPYRIGHT

       Copyright © 2010 Nathan Lutchansky
       License GPLv2+: GNU GPL version 2 or later
       This  is free software: you are free to change and redistribute it.  There is NO WARRANTY,
       to the extent permitted by law.

SEE ALSO

       tayga.conf(5)
       <http://www.litech.org/tayga/>