Garth Telnet Command Processor
User's Manual





Copyright (c) 1999 McKenzie Corp Pty Ltd
All Rights Reserved
Version 1.09 August 1999



McKenzie Corp Pty Ltd
GPO Box 1739
HOBART, TAS 7001
AUSTRALIA
All enquiries: +61 3 6231 9387
Fax: +61 3 6231 9478






Technical Support
Email: support@mckenziecorp.com.au
Downloads: ftp://ftp.mckenziecorp.com.au/pub/garth
World Wide Web:  http://www.mckenziecorp.com.au/support.htm
Fax:  +61 3 6231 9478


SOFTWARE LICENCE AGREEMENT WARNING

a)  Please read carefully the following terms and conditions before continuing with the setup or installation.  You will be asked if you understand and accept and agree to be bound by these terms and conditions.  The installation or setup will not be complete until you have confirmed this.

RECITALS

Throughout this document, including the immediately preceding SOFTWARE LICENCE AGREEMENT WARNING the following have effect:

a)  The software supplied, together with any updates, enhancements, modifications, additions or new releases thereto and related documentation, including instruction manuals, is known as "Garth".
b)  McKenzie Corp Pty Ltd is the author and owner of Garth and is referred to in this document as "McKenzie Corp".
c)  Garth is not and never has been public domain software, nor is it free software. McKenzie Corp grants users a "Shareware Licence" to use Garth on a thirty (30) day trial basis (the "Shareware trial period") for the purpose of determining whether it is suitable for their needs.  The use of Garth, except for the initial Shareware trial period, requires the purchase of a "Registered Licence".  The use of a Shareware Licence beyond the Shareware trial period by any person, business, corporation, government agency or any other entity is strictly prohibited.
d)  Upon purchase of a Registered Licence, McKenzie Corp grants the licensee a non-exclusive non-transferable right to use Garth and the right to install Garth subject to the terms and conditions in this document.
e)  "Shareware Licencee" refers to an owner of a Shareware Licence.
f)  "Registered Licencee" refers to an owner of a Registered Licence.
g)  "Licencee" refers to both an owner of a Shareware Licence and the owner of a Registered Licence.

OPERATIVE PROVISIONS

1.  OWNERSHIP

1.1  This Agreement does not grant the Licencee any title or rights of ownership in Garth.

2.  CONDITIONS OF USE - SHAREWARE LICENCE

2.1  A Shareware Licence includes limited rights to copy Shareware Licenced versions of Garth only for the trial use of others subject to any limitations outlined in this Agreement.
2.2  Garth must be copied in unmodified form.
2.3  No fee, charge or other compensation may be requested or accepted, except as authorised below:

a)  Operators of electronic bulletin board systems (SYSOP's) may make Garth available for downloading only as long as the above conditions are met.  An overall or time-dependent charge for the use of the bulletin board system is permitted as long as there is not a specific charge for the download of Garth.
b)  Vendors of user supported or shareware software may distribute Garth, subject to the above conditions, without specific permission. Non-approved vendors may distribute Garth only after obtaining written permission from McKenzie Corp via our Internet e-mail address, postal address or fax.  Details of these contacts can be found in the Registration Details of this manual and in the file vendor.txt.  Such permission will normally be granted.  Vendors may charge a disk duplication and handling fee but may not charge any fee specifically designed to increase the price of Garth above that charged by McKenzie Corp when sold directly.
c)  Non-profit users groups may distribute Garth, subject to the above conditions, without specific permission.  Non-profit users group may also charge a disk duplication fee, but may not charge any fee specifically designed to increase the price of Garth above that charged by McKenzie Corp when sold directly.

2.4  A Shareware Licence carries no rights to copy and distribute Registered Licenced versions of Garth.

3.  CONDITIONS OF USE - REGISTERED LICENCE

3.1  A Registered Licence carries no rights to copy and distribute Registered Licenced versions of Garth.
3.2 A Registered Licencee of Garth may obtain Shareware Licenced copies of Garth and copy and distribute them subject to the limitations in this Agreement.

4.  LICENSEE'S OBLIGATIONS

4.1  The Licencee undertakes and agrees with McKenzie Corp that the Licencee must:
a)  not copy, reproduce, translate, adapt, vary or modify Garth other than in accordance with the terms and conditions of the Agreement without the prior written consent of McKenzie Corp; and
b)  supervise and shall indemnify McKenzie Corp fully against all actions, claims, liabilities, costs and expenses howsoeverlasting which McKenzie Corp may incur as a result of the Licencee's breach  of McKenzie Corp copyright and other intellectual property rights in Garth.

5.  WARRANTY

5.1  The Licencee acknowledges that Garth cannot be guaranteed free of errors and further acknowledges that the existence of any such errors shall not constitute a breach of this Agreement.

6.  LIMITATION OF LIABILITY

6.1  To the fullest extent allowed under law, McKenzie Corp excludes all other terms, warranties and conditions, whether express or implied, relating to the performance, quality, or fitness for use of Garth or any floppy disks or CD-ROMs on which Garth is recorded, including any warranty or condition that Garth will meet the Licencee's requirements or operate without interruption or error.  To the fullest extent allowed under law, the liability of McKenzie Corp for any breach of any term, condition or warranty, or duty of care, shall be limited, at the discretion of McKenzie Corp, to any one or more of the following:
a)  the replacement of Garth;
b)  the repair of Garth;
c)  the payment of the cost of replacing Garth;
d)  the payment of the cost of having Garth repaired.
6.2  The Licencee agrees that in no event will McKenzie Corp be liable for damages, including but not limited to, indirect, special, incidental or consequential damages (including loss of profits or anticipated revenue) in connection with or arising out of performance of Garth, even if McKenzie Corp has been advised of the possibility of such damages.

7.  WAIVER

7.1  No right under this Agreement shall be deemed to be waived except by notice in writing signed by each party.  No waiver by a party pursuant to this clause will prejudice its rights in respect of any subsequent breach of this Agreement by another party.

8.  ASSIGNMENT

8.1  This Agreement will enure to the benefit of McKenzie Corp, their successors and assigns.  The Licencee may not assign or otherwise deal with its rights or obligations under this Agreement or any part thereof without the prior written consent of McKenzie Corp.

9.  GOVERNING LAW

9.1  This Agreement will be governed by and interpreted in accordance with the laws of Tasmania (Australia) and the parties agree to submit to the non-exclusive jurisdiction of the courts of Tasmania.

10.  INVALIDITY

10.1  Any provision of this Agreement which is or becomes prohibited or unenforceable in any jurisdiction will, as to such jurisdiction, be ineffective to the extent thereof without invalidating any other provision of this Agreement, and any such prohibition or unenforceability will not invalidate such provision in any other jurisdiction.

11.  ENTIRE AGREEMENT

11.1  This Agreement comprises the entire agreement between the parties with respect to the subject matter of this Agreement and supersedes all prior agreements, representations and correspondence between the parties with respect to that subject matter.

Introduction

Garth Telnet Command Processor is a simple to use application.  Its sole purpose is to run as a server on Windows95/98 computers listening for connections on a TCP/IP port (usually the Telnet port - 23).  When a client connects, Garth spawns a command processor by running "command.com".  The output of that command processor is re-directed to the client connection.  Therefore, you can perform operations on Garth's machine - get directories, run command line programs etc.

There are other programs that perform this sort of operation but most seem to run as a service on Windows NT.  Garth will not run on Windows NT.  It only runs on Windows 95/98 to provide a niche service in this area.

Garth is easy to set up and configure as detailed below.  Ensure that you read the Hints, Tips and Other Information section.

System Requirements

a) Windows 95 or 98;
b) 500KB HD space;
c) no memory limit is specified but a modern 32MB machine is recommended; and
d) necessary networking equipment and TCP/IP software properly installed and operating.

Installation

Simply run setup.exe and follows the few prompts.  Garth pre-configures itself to listen on port 23 - the standard Telnet port.

Configuration

a) Run Garth in any of the usual ways;
b) Choose Preferences from the File menu;
c) Choose the port on which Garth will listen.  The default is the standard Telnet port (23);
d) Type in the path to the command shell you wish to run.  The default is command.com;
e) Garth is now configured.

Operation

a) Run Garth in any of the usual ways;
b) Choose Listen from the File Menu;
c) Garth will tell you that it is listening;
d) From the same computer or any other computer that can see Garth's machine, run the Windows Telnet client or any other Telnet client of your choice;
e) Connect to Garth's computer on the port you specified.  You can use the Domain Name System (DNS) or a raw IP address depending on your network setup;
f) Upon connection you will see a greeting as if you had run a command processor on Garth's machine;
g) Perform operations as necessary;
h) When ready, choose disconnect from the Telnet client's menus.  Garth will close the command processor.  You can type "exit" if you wish but you still have to choose Disconnect anyway.

Hints, Tips and Other Information

a) Command line applications can be run remotely but only if they return you straight back to a command prompt with no user input in between (i.e. ping).  Any application that requests information (i.e. ftp) will usually lead to a loss of control from the remote client and you will have to disconnect and reconnect to establish a new session.  This will leave the command processor running on Garth's machine.  This will have to be shut down locally;
b) You don't have to use the Windows Telnet client (obviously you can't if you are not connecting from a Windows machine) but it is readily available and easy to use.
c) Garth takes a few seconds to run the command processor on connection.  Sometimes the delay is significant enough that you won't receive any feedback on your client.  If you see nothing after about 5 seconds, press "return".  You should now receive all output.
d) Sometimes you will only receive partial output in your Telnet client.  Again press "return" to fix this.
e) Garth does accept multiple connections, it is a true server.  Naturally, if two or more of you are connecting and working remotely on a machine, it is up to you to make sure that your actions are compatible.
f) For every connection Garth actually creates a child window stating a few details about the client.  Copies of the conversation between it and the client appear in the window.  There is no logging facility but you could cut and paste the data assuming the client did not disconnect, thus closing the child window.
g) There is a disconnect menu option within Garth so you can close connections from the server end.
h) Garth has NO built in security, that is simply beyond its scope and purpose.  It is designed for Intranets and other private networks or properly secured networks within the Internet.  If you put Garth on a computer that is open to the Internet, anybody can connect and start doing nasty things.
i) Garth is not a full Telnet server.  It uses Telnet's common port number as Telnet clients are the easiest way to connect and do things.  Garth does not implement RFC 854 ("Telnet Protocol Specification") nor does McKenzie Corp pretend that it does.  It won't recognise requests for any option negotiation or related procedures.
j) Finally, why the name "Garth".  This was the nickname of the program during development.  Rather than try and think of another snazzy title, we just continued to use it.

Registration Details

If, after 30 days, you wish to continue using Garth, you must register it and can do so using the form below.  At the time of writing this costs $US29.  Note that you get 30 discrete days on which to try the program.  These are days on which you actually use it.

			Garth Registration

Name:
Company Name:
Serial Number:

Postal Address:


Town/Suburb:		State:			Postcode/Zip:
Country:

your Phone Number:			Your email address:
your Fax Number:

How many copies of Garth ...... @ $US29 a copy.

Mastercard/Visa/Bankcard/American express/Diner's club	(cross out options not applicable)
Card number:

Card is in name of:

Expiry date:

Signature:

When paying by credit card, McKenzie Corp will charge it in Australian dollars after doing the necessary conversion.  If you are paying by cheque or telegraphic transfer and you wish to pay in your own currency, check with McKenzie Corp for an exchange rate before ordering.  DO NOT SEND A CHEQUE IN US DOLLARS DRAWN ON A NON-US BANK.

Send your registration form to us at:

	sales@mckenziecorp.com.au
or

	McKenzie Corp Pty Ltd
	GPO Box 1739T
	HOBART       7001
	Tasmania
	Australia

or

Telephone us: +61 3 62319387  (outside Australia) or (03) 62319387 or 0411 835 632 (within Australia).

or

Fax us: +61 3 6231 9478 (outside Australia) or (03) 6231 9478 (within Australia)

or

you can fill out the order form at www.mckenziecorp.com.au/orders.htm
