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 man-
       ager.  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 net-
       work 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

X Version 11                   xfindproxy 1.0.1                  XFINDPROXY(1)