


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

			        NetClip v0.5

			  © 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. I'm Clip, NetClip
^^^^^^^^^^^^^^^^^^^^^^^^

  NetClip lets you write the current clipboard contents to a remote Amiga's
clipboard. It can be handy to quickly send some graphics over a local network
for test purposes or some text to a remote user without actually writing to a
file and sending it by email-ftp-dcc(irc). It's perfect for *lazy* people
like *me* }:)

  A clipboard monitor such as ClipBook or ClipHistory, even if not necessary,
is a perfect companion for NetClip.


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


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

  You need a TCP/IP stack like AmiTCP, AS225, Inet225 or Miami and the
ability to run the inetd daemon. Nothing else is required.

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

  Copy the netclip executable to (preferably) a directory in your path
and the netclipd executable to the directory where you keep your daemons.
AmiTCP users, for example, should place netclipd in AmiTCP:serv/.

  Append the following line to your services file/list:

NetClip         2971/tcp


  Then append the following line to your inetd configuration:

NetClip         stream tcp nowait   root AmiTCP:serv/NetClipd (netclipd)


  Of course AmiTCP:serv/NetClipd has to be replaced with the complete
file path of the NetClipd executable.

  If inetd is running, there could be the need to force it to re-read its
configuration by sending a CTRL-F signal to it (Miami users don't have to
care about this).

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

  Using NetClip is extremely easy: it can be run both from the Shell and the
Workbench. If run from the Shell prompt, you can specify which host you want
your clipboard contents to be sent to. Otherwise, if no host is present in
the command line or if NetClip is run from WB, the program will search for
the environment variable 'cliphost'. If it isn't defined, the hostname that
NetClip will try to reach is 'cliphost' (you might need to edit your
resolv.conf file to use this feature). OF COURSE the remote host MUST be an
Amiga running NetClipd (people seem to forget about this).

  I suggest you to use a clipboard monitor/snooper like ClipHistory. It lets
you always know what your current clipboard contents are. It could be a bit
appalling if you paste on your AmIRC window the nasty text someone sent to
your netclipd daemon (I suggest you, if your TCP/IP stack lets you do it, to
let ONLY some 'well-known' hosts send data to your clipboard), for example!

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


 3.1. NetClip: the making
^^^^^^^^^^^^^^^^^^^^^^^^^^

  This is, after HiJack, yet another dummy net utility I wrote for my needs.
It was written using SAS/C v6.56 in my spare time. Please don't blame me if
everything isn't already working fine.

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

I would like to thank...

 · Commodore-Amiga, Amiga Technologies, VisCorp...
 · Luca Viola for his Amiga (and also his patience!)
 · Guido Popoli, Paul Sadlik
 · 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
^^^^^^^^^^^^^^^^^^^^^^^^^^

  Note that this is just v0.5 and thus it should just be considered as a BETA
RELEASE. Please don't complain about any bugs/missing features. Just email me
and I'll do anything to improve it. Anyway *AT THE MOMENT* it seems to work
just fine on my Amigas.

  Release 1 should be a commodity and feature configurable options such as a
host hotlist, hotkeys, variable buffer size/policy, detection of any new data
being written to the clipboard, etc. Plus it should have a minimum GUI
(PLEASE contact me if you're interested in coding this, actually: I'm a busy
man). And an installer script, of course.

  Any suggestions, as usual, would be very appreciated. Meanwhile *please*
also check its stability and let me know about it...


 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. They would be REALLY appreciated.
  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.50  [0.142] - 19/09/96 - First public release!!!		   *
****************************************************************************
* akes it possible! Only Amiga makes it possible! Only Amiga makes it poss *
****************************************************************************