rstart(1) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>



RSTART(1)						RSTART(1)



NAME

       rstart - a sample implementation of a Remote Start client


SYNOPSIS

       rstart  [-c context] [-g] [-l username] [-v] hostname com-
       mand 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  gen-
	       eral 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 dis-
	       cussed 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  List-
	       GenericCommands.

       -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  dis-
	       played  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 nonexistant.	Without -v, error reports
       from the remote are discarded silently.	 With  -v,  error
       reports are displayed.



X Version 11		   Release 6.3				1





RSTART(1)						RSTART(1)


       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 dis-
       play.

       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
























X Version 11		   Release 6.3				2