NAME
isatapd - ISATAP client for Linux
SYNOPSIS
isatapd --help
isatapd [ --daemon ] [ --link device ] [ options ] [ router ] [ ... ]
DESCRIPTION
isatapd is a userspace program or daemon that sets up and maintains an
ISATAP client tunnel by using the kernels ISATAP capabilities, first
introduced with 2.6.25.
The program will create the tunnel, periodically query the specified
routers, add them to the potential router list , send periodic router
solicitations and parse router advertisements. isatapd will try to
keep the tunnel up and running, even if the network topology changes.
See NOTES below for more information
OPTIONS
-n --name name
Name of the tunnel interface. Default is is0.
-l --link device
Tunnel link device. If specified, tunnel will be restricted to
that device, allowing multiple instances of isatapd with
different tunnels. The tunnel can only exist as long as the link
device is up and has a IPv4 address configured.
If unspecified, the outgoing IPv4 address will be guessed for
the first router and the tunnel created accordingly. The tunnel
device will only created, if there is a possible IPv4 source
address to reach the first router.
-m --mtu bytes
Sets the MTU to value for the tunnel device, minimum is 1280. If
unspecified, the kernel will choose the MTU automatically,
usually 1480.
-t --ttl hoplimit
Set the tunnel hoplimit, default is 64. Specifying ’auto’ or
’inherit’ will make the tunnel inherit the ttl from the linked
device.
-N --nopmtudisc
Disable (IPv4) Path MTU Discovery on this tunnel. For this to
work --ttl has to be set to inherit. Default: do Path MTU
Discovery to reduce redundant fragmentation.
-r --router router
Set a potential router. isatapd will resolv the hostname, add
the IPv4 address to the PRL and send periodic router
solicitation messages. Up to 10 potential routers can be
specified, the default is the unqualified domainname "isatap".
-i --interval seconds
Default interval to send router solicitations. If the router
lifetime is lower, the interval will be 80 of the router´s
lifetime. Can be used to force solicitations at a shorter
interval.
Default: auto
-D --check-dns seconds
Interval to perform DNS resolution of configured routers and to
recreate the PRL, if necessary. Set to 0 to disable.
Default: 3600 sec = 1 hour
-d --daemon
fork to background. No logging is available yet.
-p --pid file
Store the pid as plaintext to file. The pid file will be write-
locked to prevent multiple running instances. Useful for scripts
and when running isatapd as a daemon.
--user username
Drop privileges to this user when running the solicitation loop.
Default: nobody
-v --verbose
increase verbosity
-q --quiet
decrease verbosity
-h --help
print usage
--version
print version
EXIT STATUS
On success zero is returned, otherwise a non-zero value is returned.
SIGNALS
SIGHUP Force sending router solicitations and recreate the tunnel, if
neccessary.
SIGINT SIGTERM
Gracefully shut down tunnel device and terminate.
SYSLOG
isatapd logs to stderr when run in foreground and to syslog(3), using
the facility LOG_DAEMON. Verbosity can be controlled with the -v and -q
switches.
NOTES
Network data will be processed by isatapd with privileges of an
unprivileged user to minimize impact of bugs in the networking code. To
create and maintain the tunnel device, root privileges are necessary.
Whenever the tunnel link interface goes down or the source address for
the local tunnel endpoint changes, the tunnel device will be destroyed
and recreated, if possible. Note that till then your tunnel might be in
a unusable state.
AUTHORS
Sascha Hlusiak <mail@saschahlusiak.de>
Kwong-Sang Yin <kwong-sang.yin@boeing.com>
Fred Templin <fred.l.templin@boeing.com>
SEE ALSO
ip(8) syslog-ng(8)
http://www.ietf.org/rfc/rfc5214.txt