startbonjour
startbonjour
SERVICE

The startbonjour statement starts monitoring the local network for available hosts.

Parameters

This statement has one parameter:

service – specifies the type of service to monitor, for example `_printer._tcp` for a LPR printer over TCP.

Description

This statement sets up monitoring of the local network for available hosts of a specified type. The monitoring will continue until Panorama quits, or until you use the stopbonjour statement. This example starts monitoring the local network for TCP printers.

    startbonjour "_printer._tcp"

After monitoring has started, you can use the bonjour( function to find out what hosts are available. This function returns a carriage return delimited text array, with one host per line. Each line is a tab delimited text array, with the first element being the host name. The second element (after the tab) is the URL for the host (including the port). Note that this URL is normally a local machine identifier, for example `Bobs-MacBook-Pro.local.:8080`, rather than an IP address. You can use this identifier in functions like url( and urltask(. By using an identifier instead of an actual IP address, the address will continue to work even if the underlying host IP address changes (for example due to DHCP).

See Also

- bonjour( -- returns a list of available hosts.
- bonjourserversenabled( -- returns true if client access to bounjour servers (on local network) is enabled.
- panoramaxservercgiurl( -- returns the URL associated with a Panorama X server cgi.
- panoramaxservers( -- returns an array of available Panorama servers.
- panoramaxserverurl( -- returns the URL associated with a Panorama X server.
- serverupdate -- temporarily disables record locking and server updates when using a shared database.
- stopbonjour -- cancels monitoring of the local network for available hosts.

History

Version | Status | Notes
10.0 | New | New in this version.