147 lines
4.3 KiB
HTML
147 lines
4.3 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of RSTART</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>RSTART</H1>
|
|
Section: User Commands (1)<BR>Updated: rstart 1.0.5<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
rstart - a sample implementation of a Remote Start client
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>rstart</B>
|
|
|
|
[-c <I>context</I>]
|
|
[-g]
|
|
[-l <I>username</I>]
|
|
[-v]
|
|
<I>hostname</I>
|
|
<I>command args ...</I>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
|
|
<I>Rstart</I> is a simple implementation of a Remote Start client as
|
|
defined in "A Flexible Remote Execution Protocol Based on <B>rsh</B>".
|
|
It uses <I>rsh</I> as its underlying remote execution mechanism.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-c </B><I>context</I>
|
|
|
|
<DD>
|
|
This option specifies the <I>context</I> in which the command is to be
|
|
run. A <I>context</I> 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 <B>X</B>. This should
|
|
be suitable for running X programs from the host's "usual" X
|
|
installation.
|
|
<DT id="2"><B>-g</B>
|
|
|
|
<DD>
|
|
Interprets <I>command</I> as a <I>generic command</I>, 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 <B>Terminal</B>,
|
|
<B>LoadMonitor</B>, <B>ListContexts</B>, and <B>ListGenericCommands</B>.
|
|
<DT id="3"><B>-l </B><I>username</I>
|
|
|
|
<DD>
|
|
This option is passed to the underlying <I>rsh</I>; it requests that
|
|
the command be run as the specified user.
|
|
<DT id="4"><B>-v</B>
|
|
|
|
<DD>
|
|
This option requests that <I>rstart</I> be verbose in its operation.
|
|
Without this option, <I>rstart</I> discards output from the remote's
|
|
<I>rstart</I> helper, and directs the <I>rstart</I> helper to detach
|
|
the program from the <I>rsh</I> connection used to start it. With
|
|
this option, responses from the helper are displayed and the resulting
|
|
program is not detached from the connection.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>NOTES</H2>
|
|
|
|
This is a trivial implementation. Far more sophisticated implementations
|
|
are possible and should be developed.
|
|
<P>
|
|
|
|
Error handling is nonexistent. Without <B>-v</B>, error reports from
|
|
the remote are discarded silently. With <B>-v</B>, error reports are
|
|
displayed.
|
|
<P>
|
|
|
|
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.
|
|
<P>
|
|
|
|
The $SESSION_MANAGER environment variable should be passed, but isn't.
|
|
<P>
|
|
|
|
X11 authority information is passed for the current display.
|
|
<P>
|
|
|
|
ICE authority information should be passed, but isn't. It isn't
|
|
completely clear how <I>rstart</I> should select what ICE authority
|
|
information to pass.
|
|
<P>
|
|
|
|
Even without <B>-v</B>, the sample <I>rstart</I> 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
|
|
|
|
|
|
<P>
|
|
|
|
|
|
<PRE>
|
|
rstart somehost exec xterm
|
|
|
|
</PRE>
|
|
|
|
|
|
<P>
|
|
|
|
|
|
|
|
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.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?1+rstartd">rstartd</A>(1), <A HREF="/cgi-bin/man/man2html?1+rsh">rsh</A>(1), A Flexible Remote Execution Protocol Based on <B>rsh</B>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Jordan Brown, Quarterdeck Office Systems
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="5"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="6"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="7"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="8"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="9"><A HREF="#lbAF">NOTES</A><DD>
|
|
<DT id="10"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
<DT id="11"><A HREF="#lbAH">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:26 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|