NAME

SYNOPSIS

DESCRIPTION

The short argument form uses whatever implementation defined default detection mechanism that is available, with the TRUST_KNOWN level of trust. For more refined control, the mode argument can be set to one of the following: DISCOVER_PASSIVE , DISCOVER_SWEEP , DISCOVER_BROADCAST , DISCOVER_DIRECTORY .

DISCOVER_PASSIVE silently listens on available network interfaces (or ones specified through the description argument) for broadcasting clients.

DISCOVER_BROADCAST periodically announces its presence in a privacy preserving way, assuming that the trust model is set to TRUST_KNOWN .

DISCOVER_SWEEP cycles through the set of trusted keys, looking for the first possible host for each keyset. The description arguments accepts a delay=n:period=m form where the delay is a number in seconds between each attempted keyset, and period delay in seconds between sweeps.

DISCOVER_DIRECTORY uses a directory service to discover which ones are currently available. This mode can punch through NAT ed networks and is suitable for wide-area network use where you have access to a remote trusted server.

the trust argment changes how the discover modes based on a specified trust model, which can be one of the following: TRUST_KNOWN , TRUST_PERMIT_UNKNOWN , TRUST_TRANSITIVE .

TRUST_KNOWN will only forward and reply to messages that comes from previously known and trusted sources. Known sources are managed through an external keystore, see the arcan-net tool.

TRUST_PERMIT_UNKNOWN (for broadcast, passive and directory) allows interactive verification whether a certain connection should be trusted or not.

TRUST_TRANSITIVE (for directory) allows viewing and temporary or permanentily trusting connections that comes from an intermediary dictionary server.

The callback handler provides the source vid as well as a status table. This behaves similar to other launch_target style callbacks. The set of useful events is reduced to kind=terminated, and kind=state as the ones of relevance.

NOTES

1

specifying an invalid value for trust or mode is a terminal state transition.

EXAMPLE

function net_discover0()
      net_discover(
      function(source, status)
            if status.kind == "terminated" then
                  delete_image(source)
            elseif status.kind == "found" then
                  print("discovered", status.trusted, status.tag, status.host)
                  if not status.trusted then
                        return false
                  end
            elseif status.kind == "lost" then
                  print("lost", status.tag)
            end
      end
      )
end

SEE ALSO: