= NAME =
target_setup_route_to_host

= SYNOPSIS =
target_setup_route_to_host

= DESCRIPTION =
This function is used to set up the route from the target (board) back to the host machine.  Even though the host machine may be able to communicate with
the target over the selected transport, the target might not have network
communication with the host.

This function checks that the host has communication with the target, and
then tries to set up routing on the target to the host, using /sbin/route on the target board.

''NOTE: I can find no callers of this function in Fuego as of January 2023''

= EXAMPLES =
Here are some sample invocations:
{{{#!YellowBox
target_setup_route_to_host $LINK_NET $LINK_NETMASK $LINK_GATEWAY $LINK_TARGET_IFACE
}}}

= ENVIRONMENT and ARGUMENTS =
This function takes the following positional arguments:
 * $1 - link network
 * $2 - link netmask
 * $3 - link gateway
 * $4 - link target interface (e.g. eth0)

These parameters are from the perspective of the target.

= RETURN =
Returns non-zero on error.

= SOURCE =
Located in ''scripts/functions.sh''

= SEE ALSO =
 * [[function_default_target_route_setup|default_target_route_setup]]