APCComm 2.0.1
^^^^^^^^^^^^^

This is APCComm, a program for transfering files between Amiga and PC running
under Linux using a LapLink-Cable.
It's distributed under GNU General Public License and comes with full source-
code for the PC and amiga.
For installing read the file INSTALL.
It's now (since version 1.1.0) fast (up to 33 KByte/s, see Speed below) and also
faster then the floppy-transfer :-)
Starting with version 2 you can also transfer whole directories.

Requirements:
^^^^^^^^^^^^^
 Hardware:
  Amiga
  PC
  LapLink-Cable
  
 Software:
  PC:
   Linux
   C-Compiler (gcc recommend (because I only tested it with this))

  Amiga:
   AmigaOS >1.0
     the binary will NOT run on AmigaOS 1.0!
   NOTE: no compiler needed

APCComm uses the Parapin-Library which is included (unmodified) in the
  directory parapin-0.90 and used automatically. But if you have an installed
  version and want to use it instead uncomment the line "USE_SP=1" in the
  Makefile
  You can also install the included version by entering the directory and
  do a "make install" (please read the README for detailed information)
  
  Parapin-Library >= 0.90 can be found at:
    http://www.circlemud.org/~jelson/software/parapin

Using:
^^^^^^
For Linux you need (at the moment) root-privileges to get access to the parallel
port!
You can make apccomm suid-root, apccomm will drop root-privileges after
initialization but be warned that this can open security holes!
I'm not responsible for any error or damage that occurs by using this program.

The default port is LPT1 but can be changed, see Options below.

For transfering files to PC:
----------------------------
Start "apccomm" at the amiga with the filename(s) as arg:

Amiga:
apccomm <filename>

Then (or before) start "apccomm" at the PC.
If the filename already exists, you will be asked for overwrite or rename it.
So type "o" or "c" to do so.

PC:
apccomm

For transfering files to Amiga:
-------------------------------
Same as above, only give the file to the pc-prog

PC:
apccomm <filename>

Amiga:
apccomm

For transfering files to Amiga and to PC same time:
---------------------------------------------------
Since version 2.0.0 this is no longer supported, if you need this feature,
use the version 1.2.2 which you can get from the homepage but you can't transfer
directories with it!

Examples:
^^^^^^^^^
1) PC: apccomm
   Amiga: apccomm SYS:
   
   Will send the whole sys partition to the pc

2) PC: apccomm *
   Amiga: apccomm
   
   Will send all files and subdirectories in the current dir to the amiga

Options:
^^^^^^^^
 -v, --version     prints the program version
 -h, --help        shows a little help
 --port=<port>     set the parallel port to <port>
                   <port> can be lpt1 or lpt2
 -V, --verbose     make apccomm print more information
 -q, --quiet       no output except error messages
 -ip               ignore protection bits (file permissions) while receiving

 Any other option is taken as filename.
 Filenames can be normal files or directories or even patterns like *.c at linux
 or #?.c at the amiga (NOTE: at linux patterns are resolved using the shell so
 don't use single quotes ('))
 You can give as much filenames you need.

Speed:
^^^^^^
This depends very on the slowest system.
Here are some rates for my system:

Amiga: A600 with 68030 @ 25 Mhz, 10 MB RAM, OS 2.1, HD
PC: Linux 2.4.7 with Intel PIII 800, 512 MB RAM

           | RAM<->HD   | HD<->HD    |
-----------+------------+------------+
Amiga ->PC | 33 KByte/s | 27 KByte/s |
Amiga<- PC | 16 Kbyte/s | 12 KByte/s |
Amiga<->PC | 15/28 KB/s | 10/24 Kb/s |
-----------+------------+------------+

The rates doesn't depend on what you transfering because there is no crunching
code. But of course you can get lower or ever higher values.
And of course you don't need also a powerful PC.
Speed reports are very welcome!

At the moment I use the 5 pins from Amiga to PC for transfer, but only 3 pins
for PC to Amiga (because I doesn't know the whole connection table)
If you know something about this, please contact me.

########
FINALLY:
########

Use this at your own risk. I have some checksum for correct transmitting (and
I never get an error at my machine) but there is no warranty for correct trans-
mitting. You have been warned!
I'm not responsible for any error or damage that occurs by using this program.

Author:
^^^^^^^
Ralf Hoffmann
Homepage: http://www.boomerangsworld.de/apccomm
E-Mail: Ralf Hoffmann <ralf.hoffmann@epost.de>