X10CLIENT(1X11)         COMMAND REFERENCE         X10CLIENT(1X11)



NAME
     x10client - execute an X10 client from an X11 environment.

     This is a user-contributed client.

SYNOPSIS
     x10client <X10_client_filename> <X10_client_arguments>

DESCRIPTION
     Although x10tox11 provides X10 to X11 protocol conversion,
     unwanted side-effects can occur when an X10 client or
     subprocesses of an X10 client attempts to execute other X10
     clients.  For example, executing an X10 xterm through
     x10tox11 or across the network (e.g., xterm fizzle:0) may
     result in unexpected side effects when another xterm is
     executed through that X10 xterm window.  If the paths for
     X10 executables does not does not precede those for X11
     executables in the PATH environment variable, then an X11
     xterm will be executed instead of an X10 xterm. If the X10
     xterm was executed to display across the network and the
     DISPLAY environment variable was not changed, then executing
     another xterm in the X10 xterm window on the remote host
     will result in an xterm displayed on the local host instead
     of the remote host.

     Therefore, X10client attempts to resolve these problems by
     modifying the PATH and DISPLAY environment variables, and
     attempting to run x10tox11 when necessary before finally
     running the specified X10 client.

     To execute an X10 client from an X11 environment, x10client
     first checks if it can make an X10 connection to the X
     Server associated with the target host:display specified on
     the command line in the X10_client_arguments (defaults to
     DISPLAY environment variable).  If unable, it will attempt
     to run the x10tox11 protocol converter on the host; remotely
     if a remote host (i.e., "rsh host x10tox11 [ -display
     host:display ]" where -display option is used if display >
     0).  X10client will again attempt to make an X10 connection.
     If x10client can make the X10 connection, it prepends the
     process's PATH environment variable with pathnames found in
     an X10PATH environment variable and known X10 executable
     directory pathnames (/usr/lib/X11/bin and
     /usr/lib/X11/usr/unsupportedXbin).  The DISPLAY environment
     variable is modified as well, set to the target
     host:display. X10client then executes the X10 client with
     the specified arguments (via execvp).  Therefore, should the
     X10 client or subprocesses execute any other X clients the
     X10 paths will be searched first and the client displayed on
     the target host:display.





Printed 4/6/89                                                  1

X10CLIENT(1X11)         COMMAND REFERENCE         X10CLIENT(1X11)



EXAMPLE
          x10client xclock -analog fizzle:0

CAVEATS
     As a general rule, you should not set the PATH or DISPLAY
     environment variables in your .cshrc or .profile. If you do,
     DISPLAY environment variables set by x10client will be
     overwritten by those in .cshrc or .profile should the X10
     client (e.g., xterm, tterm) start up a shell.

     Environment strings (e.g., "DISPLAY=hostname:0") are limited
     to a length of 2048 characters.

     When x10client attempts to run x10tox11 on a remote host,
     x10client will assume its pathname on the remote host is
     /usr/lib/X11/bin/x10tox11R.

     Specifying a host:display on workstations with multiple
     displays (e.g., "fizzle:2") has yet to be tested.

SEE ALSO
     x10tox11(1x11)

COPYRIGHT
     Portions copyrighted by the Massachusetts Institute of
     Technology.

     (c) Copyright 1989, Tektronix, Inc.

     Permission to use, copy, modify, and distribute this
     software and its documentation for any purpose and without
     fee is hereby granted, provided that the above copyright
     notice appear in all copies and that both that copyright
     notice and this permission notice appear in supporting
     documentation.

     Copyright 1985, 1986, 1987, 1988 by the Massachusetts
     Institute of Technology

     Permission to use, copy, modify, and distribute this
     software and its documentation for any purpose and without
     fee is hereby granted, provided that the above copyright
     notice appear in all copies and that both that copyright
     notice and this permission notice appear in supporting
     documentation, and that the name of M.I.T. not be used in
     advertising or publicity pertaining to distribution of the
     software without specific, written prior permission.  M.I.T.
     makes no representations about the suitability of this
     software for any purpose.  It is provided "as is" without
     express or implied warranty.





Printed 4/6/89                                                  2

X10CLIENT(1X11)         COMMAND REFERENCE         X10CLIENT(1X11)



AUTHOR
     Al Tabayoyon; Interactive Technologies Division; Tektronix,
     Inc.




















































Printed 4/6/89                                                  3

%%index%%
na:432,151;
sy:583,310;
de:893,2944;4341,123;
ca:4464,944;
se:5408,1418;7330,191;
%%index%%000000000115