home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / programming / osclid / !OscliD / Documents / roscli < prev    next >
Encoding:
Text File  |  1998-01-25  |  2.8 KB  |  66 lines
  1. roscli
  2. v1.01 (27 March 1997)
  3. -----------------------------------------------------------------------------
  4.  
  5. Having setup all your computers to run OscliD, you'll want to send *commands
  6. to them.  To do this, you use the "roscli" utility.  The "roscli" utility
  7. should be put in your library directory (e.g. !Boot.Library), and used in
  8. applications or from the command-line.  Its command syntax is quite simple:
  9.  
  10.     *roscli <host> <command>
  11.  
  12. where <host> must be resolvable on the computer (i.e. an IP address or a
  13. name in the hosts file or available via a name resolver).
  14.  
  15.  If you prefix <command> with a "*" character, the output will pop up
  16. in a text window when the command has finished executing.  For example,
  17. entering
  18.  
  19.     *roscli carmel *Modules
  20.  
  21. would execute a "*Modules" command on the computer called "carmel", and
  22. then pop-up the result on your screen, whereas
  23.  
  24.     *roscli carmel Modules
  25.  
  26. would popup the result as though it were output by whatever application
  27. is currently in use on "carmel".  (Note: this is dangerous and can lead to
  28. spurious crashes, so I don't advise running any remote commands that can
  29. cause output without the "*" parameter.)
  30.  
  31.  (Note: in order to enable spooling of the result back to you, you must
  32. define a system variable OscliD$Spool which is the name of a file whose
  33. path is identical both from the remote and host computers. For example,
  34. you might share your harddisc as `HardDisc4' under Access+, which would
  35. make the path Share::HardDisc4.$.!Boot.Resources.!Scrap.ScrapDirs.Spool
  36. refer to the same file from both computers.)
  37.  
  38. Spawning new applications
  39. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  40. However, while this works fine for `simple' commands (such as *Modules
  41. or *ifconfig), commands which spawn new programs can have disastrous
  42. effects.  (Remember, OscliD actually interrupts the current application
  43. in order to execute the *command, so if it runs a new application it will
  44. confuse the interrupted program.)  So, we have to adopt a new scheme.
  45. OscliD has a special `queue', where it retains *commands sent to it until
  46. such time as it can execute them safely, without interrupting any other
  47. applications.  To make use of this queue, you must prefix the parameters
  48. to roscli with "-wimp" (i.e. before the name of the computer).  For
  49. example,
  50.  
  51.     *roscli carmel "Filer_Run $.!Impression"
  52.  
  53. would most likely crash the computer called "carmel", but
  54.  
  55.     *roscli -wimp carmel "Filer_Run $.!Impression"
  56.  
  57. would safely run Impression on the target computer. However, this feature
  58. *does* depend on the Wimp being polled. (If an application had crashed with
  59. an error box, Impression would never start up.)
  60.  
  61. Unix roscli
  62. ¨¨¨¨¨¨¨¨¨¨¨
  63. Clive Jones <clive@nsict.org> has provided a version of the roscli utility
  64. that should compile under any 4.3/4.4-BSD-compatible-ish Unix (Linux/NetBSD
  65. both work fine).
  66.