XFINDPROXY(1)							XFINDPROXY(1)



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	 ser-
       vices,  starts new proxies when necessary, and makes sure that proxies
       are shared whenever possible.

       The -manager argument  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/blah.x.org:6500").

       The -name argument is required, and  it	specifies  the	name  of  the
       desired proxy service (for example, "LBX").  The name is case insensi-
       tive.

       The -server argument 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 -name argument.  For example, for  a	proxy
       service	of  "LBX",  the	 address  would be an X display address (e.g,
       "blah.x.org:0").

       The -auth argument is optional.	If specified, xfindproxy will read  2
       lines from standard input.  The first line is an authorization/authen-
       tication name.  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 -host argument is optional.	If xfindproxy starts a new proxy ser-
       vice, 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  -options  argument 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.

       If xfindproxy is successful in obtaining	 a  proxy  address,  it	 will
       print  it  to  stdout.  The format of the proxy address is specific to
       the proxy service being used.  For example, for	a  proxy  service  of
       "LBX",  the  proxy address would be the X display address of the proxy
       (e.g, "blah.x.org:63").

       If xfindproxy is unsuccessful in obtaining a proxy  address,  it	 will
       print an error to stderr.

SEE ALSO
       proxymngr (1), Proxy Management Protocol spec V1.0

AUTHOR
       Ralph Mor, X Consortium



								XFINDPROXY(1)

UNIX/Linux commands referenced on this page:

1. locate
2. id
3. display
4. host
5. proxymngr