tayga(8) - f29

1TAYGA(8)                                                              TAYGA(8)
2
3
4

NAME

6       tayga - stateless NAT64 daemon
7
8

SYNOPSIS

10       tayga [OPTION]...
11
12       tayga --mktun [OPTION]...
13
14       tayga --rmtun [OPTION]...
15
16

DESCRIPTION

18       TAYGA  is  a stateless NAT64 daemon for Linux.  Using the in-kernel TUN
19       network driver, TAYGA receives IPv4 and IPv6 packets  from  the  host's
20       network  stack,  translates  them to the other protocol, and then sends
21       the translated packets back to the host using the same TUN interface.
22
23       Translation is compliant with  IETF  Internet-Draft  draft-ietf-behave-
24       v6v4-xlate-23,  and address mapping is performed in accordance with RFC
25       6052.  Optionally, TAYGA may be  configured  to  dynamically  map  IPv6
26       hosts to addresses drawn from a configured IPv4 address pool.
27
28       As  a  stateless  NAT, TAYGA requires a one-to-one mapping between IPv4
29       addresses and IPv6 addresses.  Mapping multiple IPv6 addresses  onto  a
30       single  IPv4  address can be achieved by mapping IPv6 addresses to pri‐
31       vate IPv4 addresses with TAYGA and then using a stateful NAT44 (such as
32       the  iptables(8)  MASQUERADE  target) to map the private IPv4 addresses
33       onto the desired single IPv4 address.
34
35       TAYGA's configuration is stored in the  tayga.conf(5)  file,  which  is
36       usually found in /etc/tayga.conf or /usr/local/etc/tayga.conf.
37
38

INVOCATION

40       Without  the --mktun or --rmtun options, the `tayga` executable runs as
41       a daemon, translating packets as described above.
42
43       The --mktun and --rmtun options instruct TAYGA to  create  or  destroy,
44       respectively, its configured TUN device as a "persistent" interface and
45       then immediately exit.
46
47       Persistent TUN devices remain present on  the  host  system  even  when
48       TAYGA  is  not  running.   This allows host-side network parameters and
49       firewall rules to be configured prior to commencement of packet  trans‐
50       lation.  This may simplify network configuration on the host; for exam‐
51       ple, systems which use a Debian-style /etc/network/interfaces file  may
52       configure  TAYGA's  TUN  device at boot by running `tayga --mktun` as a
53       "pre-up" command and then configuring the TUN device as any other  net‐
54       work interface.
55
56

OPTIONS

58       -c configfile | --config configfile
59              Read configuration options from configfile
60
61       -d     Enable debug messages (enables --nodetach as well)
62
63       -n | --nodetach
64              Do not detach from terminal
65
66       -u userid | --user userid
67              Set uid to userid after initialization
68
69       -g groupid | --group groupid
70              Set gid to groupid after initialization
71
72       -r | --chroot
73              chroot() to data-dir (specified in config file)
74
75       -p pidfile | --pidfile pidfile
76              Write process ID of daemon to pidfile
77

AUTHOR

79       Written by Nathan Lutchansky <lutchann@litech.org>
80

COPYRIGHT

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