home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat1 / rstart.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  4.0 KB  |  133 lines

  1.  
  2.  
  3.  
  4. RSTART(1)                        RSTART(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        rstart - a sample implementation of a Remote Start client
  9.  
  10. SSYYNNOOPPSSIISS
  11.        rrssttaarrtt  [-c  _c_o_n_t_e_x_t]  [-g]  [-l     _u_s_e_r_n_a_m_e]  [-v] _h_o_s_t_n_a_m_e
  12.        _c_o_m_m_a_n_d _a_r_g_s _._._.
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        _R_s_t_a_r_t is a simple implementation of a Remote Start client
  16.        as  defined in "A Flexible Remote Execution Protocol Based
  17.        on rrsshh".     It uses _r_s_h as its underlying    remote    execution
  18.        mechanism.
  19.  
  20. OOPPTTIIOONNSS
  21.        --cc _c_o_n_t_e_x_t
  22.            This  option  specifies    the  _c_o_n_t_e_x_t in which the
  23.            command is to  be  run.     A  _c_o_n_t_e_x_t  specifies    a
  24.            general    environment  the program is to be run in.
  25.            The details of this environment are host-specific;
  26.            the  intent  is    that the client need not know how
  27.            the environment must be configured.   If     omitted,
  28.            the   context  defaults    to  XX.     This  should  be
  29.            suitable for running X programs    from  the  host's
  30.            "usual" X installation.
  31.  
  32.        --gg      Interprets   _c_o_m_m_a_n_d  as     a  _g_e_n_e_r_i_c  _c_o_m_m_a_n_d,  as
  33.            discussed  in  the  protocol  document.     This  is
  34.            intended      to  allow  common  applications  to  be
  35.            invoked without knowing what they  are  called  on
  36.            the  remote  system.   Currently, the only generic
  37.            commands     defined   are     TTeerrmmiinnaall,   LLooaaddMMoonniittoorr,
  38.            LLiissttCCoonntteexxttss, and LLiissttGGeenneerriiccCCoommmmaannddss.
  39.  
  40.        --ll _u_s_e_r_n_a_m_e
  41.            This  option  is     passed to the underlying _r_s_h; it
  42.            requests that the command be run as the    specified
  43.            user.
  44.  
  45.        --vv      This option requests that _r_s_t_a_r_t be verbose in its
  46.            operation.  Without this option,     _r_s_t_a_r_t     discards
  47.            output    from  the  remote's  _r_s_t_a_r_t  helper,  and
  48.            directs the _r_s_t_a_r_t helper to  detach  the  program
  49.            from  the  _r_s_h  connection used to start it.  With
  50.            this  option,  responses     from  the   helper   are
  51.            displayed   and     the  resulting     program  is  not
  52.            detached from the connection.
  53.  
  54. NNOOTTEESS
  55.        This is a trivial implementation.  Far more  sophisticated
  56.        implementations are possible and should be developed.
  57.  
  58.        Error  handling is nonexistant.    Without --vv, error reports
  59.        from the remote are discarded silently.     With  --vv,  error
  60.        reports are displayed.
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RSTART(1)                        RSTART(1)
  71.  
  72.  
  73.        The $DISPLAY environment variable is passed.  If it starts
  74.        with a colon, the local hostname is prepended.  The  local
  75.        domain  name should be appended to unqualified host names,
  76.        but isn't.
  77.  
  78.        The  $SESSION_MANAGER  environment  variable   should   be
  79.        passed, but isn't.
  80.  
  81.        X11  authority  information  is    passed    for  the  current
  82.        display.
  83.  
  84.        ICE authority information should be passed, but isn't.  It
  85.        isn't  completely  clear how _r_s_t_a_r_t should select what ICE
  86.        authority information to pass.
  87.  
  88.        Even without --vv, the sample _r_s_t_a_r_t  helper  will     leave    a
  89.        shell waiting for the program to complete.  This causes no
  90.        real harm and consumes relatively few resources, but if it
  91.        is  undesirable it can be avoided by explicitly specifying
  92.        the "exec" command to the shell, eg
  93.  
  94.         rstart somehost exec xterm
  95.  
  96.        This is obviously dependent  on    the  command  interpreter
  97.        being  used  on    the remote system; the example given will
  98.        work for the Bourne and C shells.
  99.  
  100. SSEEEE AALLSSOO
  101.        rstartd(1), rsh(1), A Flexible Remote  Execution     Protocol
  102.        Based on rrsshh
  103.  
  104. AAUUTTHHOORR
  105.        Jordan Brown, Quarterdeck Office Systems
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.