RSTART(1)						      General Commands Manual							 RSTART(1)

NAME

       rstart - a sample implementation of a Remote Start client

SYNOPSIS

       rstart [-c context] [-g] [-l username] [-v] hostname command args ...

DESCRIPTION

       Rstart  is a simple implementation of a Remote Start client as defined in "A Flexible Remote Execution Protocol Based on rsh".  It uses rsh
       as its underlying remote execution mechanism.

OPTIONS

       -c context
	       This option specifies the context in which the command is to be run.  A context specifies a general environment the program  is	to
	       be run in.  The details of this environment are host-specific; the intent is that the client need not know how the environment must
	       be configured.  If omitted, the context defaults to X.  This should be suitable for running X programs from the	host's	"usual"  X
	       installation.

       -g      Interprets  command  as a generic command, as discussed in the protocol document.  This is intended to allow common applications to
	       be invoked without knowing what they are called on the remote system.  Currently, the only generic commands defined  are  Terminal,
	       LoadMonitor, ListContexts, and ListGenericCommands.

       -l username
	       This option is passed to the underlying rsh; it requests that the command be run as the specified user.

       -v      This option requests that rstart be verbose in its operation.  Without this option, rstart discards output from the remote's rstart
	       helper, and directs the rstart helper to detach the program from the rsh connection used to start it.  With this option,  responses
	       from the helper are displayed and the resulting program is not detached from the connection.

NOTES

       This is a trivial implementation.  Far more sophisticated implementations are possible and should be developed.

       Error handling is nonexistent.  Without -v, error reports from the remote are discarded silently.  With -v, error reports are displayed.

       The  $DISPLAY environment variable is passed.  If it starts with a colon, the local hostname is prepended.  The local domain name should be
       appended to unqualified host names, but isn't.

       The $SESSION_MANAGER environment variable should be passed, but isn't.

       X11 authority information is passed for the current display.

       ICE authority information should be passed, but isn't.  It isn't completely clear how rstart should select what ICE  authority  information
       to pass.

       Even  without  -v,  the sample rstart helper will leave a shell waiting for the program to complete.  This causes no real harm and consumes
       relatively few resources, but if it is undesirable it can be avoided by explicitly specifying the "exec" command to the shell, eg
       rstart somehost exec xterm
       This is obviously dependent on the command interpreter being used on the remote system; the example given will work for the  Bourne  and  C
       shells.

SEE ALSO

       rstartd(1), rsh(1), A Flexible Remote Execution Protocol Based on rsh

AUTHOR

       Jordan Brown, Quarterdeck Office Systems

XFree86 							   Version 4.7.0							 RSTART(1)