.TH TERM_CLIENTS 1
.SH NAME
trsh, tupload, tredir, txconn \- clients to term
.SH SYNOPSIS
.IR tredir 
local_port remote_port [options] &

.IR trsh 
[options]

.IR txconn 
[options]

.IR tupload 
[options] local_file [local_file2] [remote_directory] [&]
.SH DESCRIPTION
These clients connect to a running term daemon and initiate the communication
process appropriate for each.  
.IR Trsh 
runs a shell on the remote system, 
.IR tupload 
transfers a file from the system where it was run to the other,
.IR tredir 
redirects connections from a port on one system to a port on the other, and
.IR txconn 
redirects X-server connections over the serial link to a user's remote system.

.SH USAGE
.TP
.IR trsh
.IR Trsh 
accepts only the global options below.  A shell is executed on the remote 
system, and it's std i/o/e are sent to 
.IR trsh's
terminal.
.TP
.IR tredir
.IR Tredir
accepts two port numbers, the first for the port to redirect, and the second
for which port on the other system to redirect to.  Tredir should be run in
the background. 
.IR Tredir
will also accept a hostname in front of the second port number. i.e. commands
of the form 'tredir 119 my.nntp.host:119' run on your non-internet machine
will mean that any program (like an NNTP newsreader) run on your non-inet
machine that connects to port 119 , will get redirected to port 119 on
my.nntp.host.
.TP 
.IR tupload
.IR Tupload
takes a list of local file names to upload. If there is more than one name, 
then the last name is checked to see if it matches a remote directory.
If it does match a remote directory, the remaining files are uploaded
to this directory.  If there remote file exists, and is smaller than
the local file, tupload will assume that it was a previous upload that
got aborted, and will attempt to resume the upload.
.IR
 Tupload
specific options are.
.RS
.TP
.BR \-f
Tells 
.IR upload 
to not do any possible resumptions. Always overwrite the
remote file.
.TP
.BR \-u
Unlink the local file after a succesful upload.
.TP
.BR \-v
Verbose mode. Will write out the number of bytes transfered, the name
of the remote file, and the CPS rate. More 'v's will produce more
output.
.TP
.BR \-q
Quiet mode. Tupload will not write out any messages.
.RE
.TP
.IR txconn
.IR Txconn
accepts only the global options below. You need to explicitly set your
DISPLAY variable after running
.IR txconn.
The recommended method of setting you DISPLAY variable
is to do
.Ds
setenv DISPLAY `hostname``txconn`
.De
or for ksh, or bash shell users
.Ds
export DISPLAY=`hostname``txconn`
.De
This will obviously run 
.SH OPTIONS
The following options are accepted by all 
.IR term 
clients
.TP
.BR \-t \ <server>
Specifies which term daemon socket to connect to (~/.term/socket<server>).
Useless unless you have multiple terms on multiple serial connections.
.TP
.BR \-r
Specifies no compression for this link.
.TP
.BR \-c
Specifies 
.B yes, 
compression for this link.
.TP
.BR \-p \ <number>
Specifies priority for this link.  A client with higher priority will be able
to send all its data before lower priority clients.  This may be changed in 
future releases.  
.IR tshell 
defaults to 2. 
.IR tupload
defaults to -2.  All other clients default to zero.


.SH EXAMPLES
.B
.CW
tupload -vv -r linux-0.99.3.tar.Z -as linux993.tar.Z /new
.PP
This will upload the local file 'linux-0.99.3.tar.Z' to the remote end
with the name '/new/linux993.tar.Z'. It will resume an upload if
there is an existing /new/linux993.tar.Z, and will writeout the CPS
and bytes transfered every 2K. It will not do compression on the way. 

.B
.CW
tredir 6667 munagin.ee.mu.oz.au:6667
.PP
This will map any connections to port 6667 on your local host to port
6667 on munagin.ee.mu.oz.au. So if you do 'telnet 0 6667', you will be
connected to munagin.

.SH SEE ALSO
.IR term (1),
.IR term_setup (1).