*** WARNING: These docs are largely incomplete. Sorry but I had to release
*** this in a hurry. Future releases will be much more documented.



		    ===================================

			         HiJack v0.2

			  © 1996 by Rudi Chiarito

		    ===================================



Contents
^^^^^^^^

1. Introduction

2. Usage

3. Odds and ends

4. Program history



	   * · * · * · * · * · * · * · * · * · * · * · * · * · *


/* *\
* 1 *   Introduction
\* */  ^^^^^^^^^^^^^^


 1.1. Preface
^^^^^^^^^^^^^^

  The programs and files in this distribution are FREEWARE. That is: they
are copyright © Rudi Chiarito, but they may be freely distributed as long as
no more than a nominal fee is charged to cover distribution costs. Moreover
they can't be distributed separately or in a commercial package without
written permission from the author. That's all.
  

 1.2. Welcome to HiJack!
^^^^^^^^^^^^^^^^^^^^^^^^^

  Do you have two or more computers and just one modem? Do you want to
share an IP address among them? Well, then HiJack is a partial (still)
2.5kb large answer to your needs.


/* *\
* 2 *   Usage
\* */  ^^^^^^^


 2.1. Requirements
^^^^^^^^^^^^^^^^^^^

  HiJack hasn't been tested with AS225, but as far as I know it should work
fine. If you manage to install and run successfully my 'beast' with the
above-mentioned protocol stack, PLEASE contact me so that I'll be able to
give users information about HiJack and AS225.

 2.2. Installation
^^^^^^^^^^^^^^^^^^^

  It shouldn't be that difficult, if you've already installed any other
3rd-party inetd daemons. You just basically need to bind as many ports as you
want to HiJack by editing the AmiTCP:db/inetd.conf file on the computer
which establishes the SLIP/PPP/WHATEVER connection and should work as some
sort of gateway.
  Before doing that, you'll also have to add each of the ports to the
AmiTCP:db/services database. Here are some (NON-WORKING!) examples... they
must be appended to the files (lines with a leading # are just comments).
  Well.. of course the HiJack executable needs to be copied in AmiTCP:serv :)

------------------------------------------------------------------------------
AmiTCP:db/Inetd.conf
------------------------------------------------------------------------------

# Allows remote host to access my.host and foo.bar.com through telnet protocol
HJteln      stream tcp nowait root amitcp:Serv/hijack (HJ) my.host 23
HJfoo       stream tcp nowait root amitcp:Serv/hijack (HJ) foo.bar.com 23

# Finger service on pippo.baudo.it
PippoBaudo  stream tcp nowait root amitcp:Serv/hijack (HJ) pippo.baudo.it 79

# an IRC server
HJirc       stream tcp nowait root amitcp:Serv/hijack (HJ) my.irc.server 6667

------------------------------------------------------------------------------
AmiTCP:db/services
------------------------------------------------------------------------------

# Dont use already assigned port numbers!

HJteln      2900/tcp
HJfoo       2901/tcp

PippoBaudo  2902/tcp

HJirc       2903/tcp

------------------------------------------------------------------------------


 2.3. Getting started
^^^^^^^^^^^^^^^^^^^^^^

  Provided that AmiTCP and inetd are running on the 'gateway', you should
simply use your software from the other local hosts by accessing the ports you
have configured. For example, by issuing on one of your computers the command

telnet <gatewayhost> 2901

the login prompt of foo.bar.com should appear.

  PLEASE notice that not all of the services will work with the current
release, ftp being probably the most notable. When using IRC, DCC GET/CHAT
connections WON'T BE ESTABILISHED. The http protocol works just fine but it
would be nearly impossible to follow links to other hosts since

1) you'd need to add such hosts to the configuration files
2) you'd also have to change the port numbers 'on the fly'

  A better 'trick' would be installing a http-proxy on your gateway. Such a
solution provides a 'global cache' for all the local machines as well, shared
also indipendently of the browser(s) used.

/* *\
* 3 *   Odds and ends
\* */  ^^^^^^^^^^^^^^^


 3.1. HiJack: the making
^^^^^^^^^^^^^^^^^^^^^^^^^^

  HiJack is a little C program, my third 'socket-based' program, compiled
using SAS/C v6.56. Please dont blame me if it isnt 100% working!

 3.2. Acknowledgements
^^^^^^^^^^^^^^^^^^^^^^^

I would like to thank...

 · Commodore-Amiga...
 · Luca Viola... my housemate, for testing HiJack using his A4000 (and also 
   for porting ncurses, ytalk, ncftp 2.3.0 and midnight commander)
 · Sting, D. Fagen, Queen, D. Bowie, G. & P. Conte, Yes, Bangles, INXS, Elio
   e le storie tese, Dire Straits, Cure, D. Byrne, W.A. Mozart, B52's, Toto,
   L. Dalla, The Who, J.M. Jarre, Fleetwood Mac, L. van Beethoven...
 · D. Adams, M. Serra, K. Vonnegut, A. Rice, E. Queen, H. Hesse...
 · Michelle

  Their contribution has been invaluable to the development of this program!

 3.3. Future improvements
^^^^^^^^^^^^^^^^^^^^^^^^^^

"If it's a future world we fear
 We have tomorrow's seeds right here
 For you can hold them in your hand
 Or let them fall into the sand"
			     - Sting

  Here's what I'd like to add in future releases
  · An Installer script
  · Better documentation
  · Support for ftp etc
  · Who knows what else

  Any suggestions, as usual, would be very appreciated. Meanwhile *please*
also check its stability and let me know about it... I've been testing
HiJack a lot during the last weeks and it has never crashed on me (well, my
housemate and I suspect that magplip.device should be responsible for the
many reboots we have experienced lately). If you are almost 100% sure that
you've found some bug, send me enough details to me and I'll try to track
down the nasty creature.


 3.4. The author
^^^^^^^^^^^^^^^^^

  This program is FREEWARE. I don't ask anything, but if you like, you can
send me PD programs, sources, money (why not?) or anything you can think of
(I'd like to receive sweetmeats, anyway). Oh, yes, you can send me nice
postcards, too.
  Here's my address... of course you can also send me suggestions, comments,
questions, bug reports (Aaaaargh! God Forbid()!) and gossips! Email is far
better: I study in Pisa (550kms from home) and most of the time I'm there.
As if it weren't enough, mail delivery in Italy is sooooo sloooooooooooow...

SnailMail:	Rudi Chiarito
		Via Malpighi, 8
		I-80014 Giugliano (NA)

E-Mail:		chiarito@cli.di.unipi.it

WorldWideWeb:	http://www.cli.di.unipi.it/~chiarito/

IRC:		Nutello


(Ooops, I almost forgot: excuse me for my English!!!)


/* *\
* 4 *   Program history
\* */  ^^^^^^^^^^^^^^^^^

****************************************************************************
*  v. 0.10  [0.023] - 08/06/96 - First public release!!!		   *
*  · There's still a lot to be done.					   *
* == - == - == - == - == - == - == - == - == - == - == - == - == - == - == *
*  v. 0.20  [0.025] - 07/09/96 						   *
*  · Improved (hopefully) buffering.					   *
*  · Removed nasty typo which made UDP redirecting impossible		   *
****************************************************************************
* akes it possible! Only Amiga makes it possible! Only Amiga makes it poss *
****************************************************************************
