collapseos/doc/rsh.txt
Virgil Dupras a0775c5dcf Add a new "Remote Shell" application
This allows a COS shell to remotely control another shell from a
serial line. It's very crude now, but the plan is to add tools much
like the POSIX tools, but for COS.
2021-01-03 14:25:25 -05:00

23 lines
769 B
Plaintext

# Remote Shell
You can control a remote system from Collapse OS using the
Remote Shell application at B150. All you need are words that
follow the EMIT and KEY? signatures. Serial lines drivers
provide those words.
To use the remote shell, first plug your words into RSH aliases:
' FOO> ' rsh> *! ' FOO<? ' rsh<? *!
FOO> being the "EMIT" word and "FOO<?" being the KEY? word.
Then, it's only a matter of running "rsh". This will repeatedly
poll rsh<? and emit whatever is coming from there and at the
same time, poll KEY? and push whatever key you type to rsh>.
You can stop the remote shell by typing any character over 0x7f.
For example, on a TRS-80 4P, the BREAK key yields 0x80 and will
break the loop.
See hw/acia.txt for tips on configuring a serial line.