XFINDPROXY(1)      X Version 11 (Release 6.6)       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 services, 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 insensitive.

          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/authentication 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 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 -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


     Page 2                                          (printed 7/20/06)