NAME
	Amied - two rudimentary scripts that allows you to edit
	remote Amiga text files from a Unix machine.

SYNOPSIS
	Amiga side:
	run execute ed.service [CLIENT IP]
	
	Unix side:
	amied [SERVER IP] [FILE]

DESCRIPTION
	This couple of scripts allows you to edit text files
	residing on an Amiga from a Unix machine. The two machines
	must reside on the same LAN and must have port 1124/TCP open.

PREREQUISITES
	Amiga side:
	- any TCP/IP stack
	- "TCP device" provided by inet-handler

	Unix side:
	- nc ("OpenBSD netcat")

USAGE
	In this example we assume that Amiga is at 192.168.0.7
	and Unix at 192.168.0.8
	
	Amiga side:
	run execute ed.service 192.168.0.8
	
	Unix side:
	amied 192.168.0.7 s:startup-sequence
	
	Remote file "startup-sequence" will appear in "nano"
	or any other user's editor of choice.
	After closing the editor, the remote file will be updated.
	If the remote file doesn't exist, it will be created.
	
	Please note that if the FULL PATH is not specified,
	the file will be created in SYS:!

INSTALLATION
	Copy "ed.service" to s:
	and put the lines...
	
	; BEGIN AMIED
	run execute ed.service [CLIENT IP]
	; END AMIED
	
	...right after the "startnet" command from AmiTCP
	(usually located in s:user-startup).
	
	Under Unix one can retrieve the client script like this:
	curl https://raw.githubusercontent.com/Telefonorosso/amied/master/amied >amied
	chmod +x amied

ADVANTAGES
	- Runs on a plain Amiga 600
	- Little-to-no RAM usage
	- Entirely script-based (20 lines total)
	- Not relying on inetd
	- Useful with headless Amigas

LIMITATIONS	
	- Client is for Unix only, not Windows
	- Accepts connections from a single IP (maybe that's a feature?)
	- NO ERROR HANDLING BESIDE A "FAILAT 21"
	- NO SECURITY AT ALL
	- It just allows to edit some friggin text files!
	  (what do you expect from 20 lines of code?)
	- You can't remotely edit the server script itself
	  (it's locked for writing)

THEORY OF OPERATION
	- These are the command pairs that are connected via TCP/IP (the arrows).
	  Variables are expanded for clarity.

	echo "s:user-startup" | nc -N 192.168.0.7 1124 ---> set localfile `type TCP:1124`
	copy "s:user-startup" TO TCP:192.168.0.8/1124 ----> nc -l 1124 >/tmp/amied.tmp
	cat /tmp/amied.tmp | nc -N 192.168.0.7 1124 ------> copy TCP:1124 TO "s:user-startup"
	
AUTHOR
	Francesco Talarico (AvantGarden)

LICENSE
	Public domain

DISCLAIMER
	The author is not responsible for any damage, hacking, system lockups,
	lost files or bushfires caused by the use of these scripts.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                   98     152  64.5% -lh5- bc27 Apr 15  1980 amied
[generic]                 3916   18432  21.2% -lh5- ce13 Apr 16  1980 Amied.doc
[generic]                  140     230  60.9% -lh5- 2198 Apr 15  1980 ed.service
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         3 files    4154   18814  22.1%            Apr 21 17:04