dynmhs(1)

NAME
dynmhs - Dynamic Multi-Homing Setup (DynMHS)

SYNOPSIS
dynmhs [-C config_file | - -config config_file]
[-O log_file | - -logfile log_file]
[-Z on|off | - -logcolor on|off]
[-N interface:table_id | - -network interface:table_id]
[-q | - -quiet] [! | - -verbose]
dynmhs [-h | - -help]
dynmhs [-v | - -version]

DESCRIPTION
dynmhs dynamically sets up IP routing rules, to allow using multiple network connections simultaneously. That is, for each relevant network interface, a separate routing table is created and maintained. For each source address of a network interface managed by DynMHS, routing rules are maintained to point to the corresponding routing table. Software binding to a specific interface address can then use a specific network. In addition, multi-homing-capable network protocols like the Multi-Path TCP (MPTCP) or the Stream Control Transmission Protocol (SCTP) can take advantage of multi-homing for redundancy and load balancing.

ARGUMENTS
The following argument may be provided:

-C config_file | - -config config_file
    Read the configuration from the given configuration file.

-L level | - -loglevel level
    Sets the minimum logging level to the provided value: 0=trace, 1=debug, 2=info, 3=warning, 4=error, 5=fatal.

-Z on|off | - -logcolor on|off
    Enables (on) or disables (off) the usage of ANSI color escape sequences to colorise the log output according to its level.

-O log_file | - -logfile log_file
    Sets a file name for appending the log output to. If a file is set, no log output is made to the console. Otherwise, all log output will be written to the console.

-q | - -quiet
    Sets the minimum logging level to 3 (warning).

-v | - -verbose
    Sets the minimum logging level to 0 (trace).

-N interface:table_id | - -network interface:table_id
    Sets an interface and the corresponding routing table ID. All routing entries referring to this interface will be cloned from the main routing table. All IP addresses of the interface will get an IP rule pointing to the corresponding routing table. The parameter can be repeated to provide multiple interfaces.

-I interface:table_id | - -interface interface:table_id
    Deprecated alias for --network.

-h | - -help
    Prints command help.

- -version
    Prints program version.

EXAMPLES

sudo dynmhs -C /etc/dynmhs/dynmhs.conf

sudo dynmhs --network eno1:1000 --network eno2:1002 --loglevel 0

sudo dynmhs --network eno1:1000 --network eno2:1002 --loglevel 3 --logfile /var/log/dynmhs.log

sudo dynmhs -N ethernet:1000 -N telia:2000 -N telenor:3000 --loglevel 2

sudo dynmhs -N ethernet:1000 -N telia:2000 -N telenor:3000 --logcolor off

dynmhs --version

AUTHORS
Thomas Dreibholz
https://www.nntb.no/~dreibh/dynmhs
mailto://dreibh@simula.no