Appendix F: Locate Proxy Services
Name
xfindproxy: Locate Proxy Services
Synopsis
xfindproxy -manager <managerAddr > -name <serviceName> -server <serverAddr> [-auth] [-host <hostAddr>] [-options <opts>]
Description
xfindproxy is a program used to locate available proxy services. It utilizes the Proxy Management Protocol to communicate with a proxy manager. The proxy manager keeps track of all available proxy services, starts new proxies when necessary, and makes sure that proxies are shared whenever possible.
The -managerargument is required, and it specifies the network address of the proxy manager. The format of the address is a standard ICE network ID (for example, "tcp/info.x.org:6500").
The -nameargument is required, and it specifies the name of the desired proxy service (for example, "LBX"). The name is case-insensitive.
The -serverargument is also required, and it specifies the address of the target server. The format of the address is specific to the proxy service specified with the -nameargument. For example, for a proxy service of "LBX", the address would be an X display address (e.g, "info.x.org:0").
The -authargument is optional. If specified, xfindproxy will read two lines from standard input. The first line is an authorization/authentication name, and the second line is the authorization/authentication data in hex format (the same format used by xauth). xfindproxy will pass this auth data to the proxy, and in most cases, will be used by the proxy to authorize/authenticate itself to the target server.
The -hostargument is optional. If xfindproxy starts a new proxy service, it will pass the host specified. The proxy may choose to restrict all connections to this host. In the event that xfindproxy locates an already existing proxy, the host will be passed, but the semantics of how the proxy uses this host are undefined.
The -optionsargument is optional. If xfindproxy starts a new proxy service, it will pass any options specified. The semantics of the options are specific to each proxy server and are not defined here. In the event that xfindproxy locates an already existing proxy, the options will be passed, but the semantics of how the proxy uses these options are undefined.