void vortex_tunnel_settings_add_hop ( VortexTunnelSettings settings,
  ... 
)

Allows to configure a new hop to be added to the current proxy configuration.

The hop added, will be appended to the current configuration:

1 [new hop] -> [next hop] -> [next hop]

You can configure one proxy to act as the first (and the only one) hop for all you connections, or you can configure a serie of hops.

The hop configuration provided will be a combination of the following items:

  • TUNNEL_FQDN + TUNNEL_PORT : a full qualified domain name followed by a tcp port.
  • TUNNEL_FQDN + TUNNEL_SRV : a full qualified domain name followed by a DNS service record.
  • TUNNEL_FQDN + TUNNEL_SRV + TUNNEL_PORT : a full qualified domain name followed by a DNS service record plus a tcp port.
  • TUNNEL_IP4 + TUNNEL_PORT : an IPv4 address followed by a tcp port configuration.
  • TUNNEL_IP6 + TUNNEL_PORT : an IPv6 address followed by a tcp port configuration.
  • TUNNEL_URI : the uri for the set of channels to be created, that is, a remote end point BEEP peer that supports this profile. This is only allowed at the but only on the innermost element, that is, the last hop to be traversed.
  • TUNNEL_ENDPOINT : a user defined string, provisioned at the last proxy to be traversed, configuring a particular service to be reached. Again, this is only allowed in the last hop used for a proxy setting.

The function must receive a set of VortexTunnelItem followed by its associated value, terminated with a TUNNEL_END_CONF.

For example:

1 VortexTunnelSettings * settings;
2 
3 // create the settings (using an initialized VortexCtx)
4 settings = vortex_tunnel_settings_new (ctx);
5 
6 // configure the default proxy
7 vortex_tunnel_settings_add_hop (settings,
8  TUNNEL_IP4, "192.168.1.100",
9  TUNNEL_PORT, "604",
10  TUNNEL_END_CONF);
Parameters
settingsThe setting that will be configured with a new hop.

References TUNNEL_END_CONF, TUNNEL_ENDPOINT, TUNNEL_FQDN, TUNNEL_IP4, TUNNEL_IP6, TUNNEL_PORT, TUNNEL_SRV, and TUNNEL_URI.