unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



rstart(1X)							   rstart(1X)
X11R6									X11R6



NAME

  rstart - a sample implementation of a	Remote Start client

SYNOPSIS

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

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 installa-
	  tion.

  -g	  Interprets command as	a generic command, as discussed	in the proto-
	  col 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, LoadMon-
	  itor,	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.

DESCRIPTION

  The rstart command 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.

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 is not.

  The $SESSION_MANAGER environment variable should be passed, but is not.

  X11 authority	information is passed for the current display.

  ICE authority	information should be passed, but is not.  It is not com-
  pletely 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, for example,

       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(1X), rsh(1), A Flexible Remote Execution Protocol Based on rsh

AUTHOR

  Jordan Brown,	Quarterdeck Office Systems