Term Modem Multiplexer

This simple document provides specific information for using term between kurango running SunOS and a user home PC running Linux. It is not a complete guide user for term. For a complete guide please refer to Term HOWTO which is also included in the term sources.

Requirement for running `term'

On kurango/gucis, you should have a normal UNIX account.
Term has been installed on these machines for you (version 2.3.5)
On your home side, you should have
1. a PC running Linux, BSD or other unix PC clones (with TCP/IP enable for high version (>2) of term)
2. one modem -- must be high speed for opening X clients

Installing `term' on your home PC

Grab the latest sources for term from this brisbane site or the maintainers ftp site.
Transfer the gzip'ed tar file to your home machine, via floppy or Zmodem file transfer (and remove the source on the UNIX machine).
On your Home Machine: Uncompress, untar, and CD into the source directory.
Read the following documents carefully and make one hard-copy for further reference -- "README", "README.security", "Term.HOWTO", "FAQ".

Run the configure program and build the UNIX/LINUX version

       ./configure --user
       make install installman

Install your own "termrc" file (on your home pc)
```
       mkdir ~/.term
       cp TERMRC ~/.term/termrc
```
and edit it to suit. For more information look at the termrc manpage.
Cleanup and remove sources as required.
For Gucis Users:
A "termrc" file for gucis has been modified ofr your use which will work through the ITC modem. On Gucis...
```
       mkdir ~/.term
       cp /usr/local/info/termrc-gucis ~/.term/termrc
```
you can then edit this as required to suit your modem setup.

For Kurango Users:

       mkdir ~/.term
       cp /usr/local/info/termrc-kurango ~/.term/termrc

you can then edit this as required to suit your modem setup.

Using `term' -- Examples

My own setup is Linux (kernel version 1.1.52) running on my poor 486DX50 and a 14.4k modem. I name my PC dragon, and I will use this name in the following document.

While the examples use kurango, term and these examples will also work on gucis.

Starting `term'

Start Linux on your home PC, and login.
Use a normal communication program like kermit, minicom (I am using) to login to kurango as usual.
On gucis type,
```
       term
```
Escape back to your local machine and suspend your comm program --
^Z under kermit,
^Aj under minicom.

On your local linux machine,

       term -r </dev/modem >/dev/modem &

Logging to gucis via `term'

Type ``trsh'' in your local Linux session. As Linux normally supports more than five session on the console, you can open five login sessions to kurango at the same time.

Starting X via `term'

Start X server on your PC
```
	  startx &
```
Note: This is assuming you have set up your xsession.
Login to gucis
```
	 trsh
```
On gucis,
```
	 txconn
```
After run txconn, you should get a number, say 10, then
```
	 setenv gucis:10
```
Start any X client as you want, and all windows will come up on your local linux machine.

Note that, using txconn has the same effect as xhost+, so please use xauth to security your X connection, and turn off xhost authorization otherwise your PC (running linux) at home is open to attack.

Simple X Protocol Compressor

For more efficient and fast X connection use xspc which is available from X11 R5 contrib area.

Start X server on your PC
```
       startx &
```
On your local linux machine,
```
      sxpc local dragon:0
```
Login to gucis
```
      trsh
```

On gucis,

      tredir 4000 4000
      setenv DISPLAY `sxpc remote kurango:0`
                     ^---Note the back-quotes

Terminating `term'

Either:

type ``tshutdown''
kill term on both sides.
kill `term' on your local PC, and
```
	echo 'NO CARRIER' > /dev/modem
```
Note that, 'NO CARRIER' is defined in your termrc file and can be changed to other string, such as '00000'.

Created: 6 December 1994, by Stephen Chen
Updated: 12 April 1995
Modified for Local Usage: Anthony Thyssen