APCComm 2.1.0
^^^^^^^^^^^^^

This is APCComm, a program for transfering files between Amiga and PC running
Linux using a LapLink-Cable.
It's distributed under GNU General Public License and comes with full source-
code for the PC and amiga. Please read COPYING for details.
For installing read the file INSTALL.
It's fast (up to 38 KByte/s, see Speed below), easy to use (no configuration
needed) and the amiga part has a GUI.
Starting with version 2 you can also transfer whole directories.

The Amiga GUI was created with GadToolsBox V2 and also uses the
reqtools.library (ReqTools is Copyright © Nico François and Magnus Holmgren).

Requirements:
^^^^^^^^^^^^^
 Hardware:
  Amiga (ClassicAmiga with 68k processor and standard parallel port
         !!!NOTE: the Amiga1000 has a different parallel port and needs
                  an adapter!)
  PC (with standard parallel port)
  LapLink-Cable
  
 Software:
  PC:
   Linux
   C-Compiler (gcc recommend (because I only tested it with this))

  Amiga:
   AmigaOS >=2.0
     but there is a binary (apccomm-nogui) for AmigaOS >1.0
     read INSTALL for more information
   reqtools.library V38 (for the normal gui version)
   NOTE: no compiler needed

APCComm uses the Parapin-Library which is included (unmodified) in the
  directory src/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

Usage:
^^^^^^
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.

PC:
---
If you want to receive files, start apccomm without any non-option arguments.
If there is atleast one non-option argument to apccomm, it will send all
given files and directories to the amiga.

Amiga:
------
Start apccomm by entering apccomm in a cli or doubleclick on the icon at the
Workbench.
If you want to receive files, the top box is of interest for you. Select, if
you want to ignore the protection bits send by the PC.
Choose the directory where the incoming files and directories should be stored
by changed the value or click on "G" to select the dir with a requester.
Then click "Receive" and the transfer starts.

If you want to send files, add all files and directories by clicking at "Add"
and select them in the requester. You can do multi-select by holding the shift
key while selecting. With Remove you can remove the selected entry from the
list.
Finally click on "Send" and the transfer starts.

If you start the GUI version from a cli and give some files as arguments, they
will be added the list so you can still add more files or remove some from
the list before sending them.

APCComm understands 3 ToolTypes:
 - PUBSCREEN=<Public screen to use>
   Enter the name of the public screen on which APCComm should open it's
   window
 - VERBOSE_LEVEL=0-2
   Select one of three verbose levels. 1 and 2 are almost the same at the
   moment, but level 0 means quiet and there will be no requester after transfer
   start when everything runs okay
 - IGNORE_PROT=true or false
   Set it to the value you prefer but you can still change it in the main-
   window

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

The amiga version without gui (apccomm-nogui) works just like the linux version,
try "apccomm-nogui --help" to show all options.

Options:
^^^^^^^^
 -v, --version     prints the program version
 -h, --help        shows a little help
 -V, --verbose     make apccomm print more information
 -q, --quiet       no output except error messages
 -i                ignore protection bits (file permissions) while receiving

special linux options:
 --port=<port>     set the parallel port to <port>
                   <port> can be lpt1 or lpt2

special amiga options:
 -s, --send        immediately start sending
 -r, --receive     immediately start receiving
 --pubscreen PUBSCREENNAME    use given pubscreen for the gui

 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:
^^^^^^
Here is a list for my system:

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

           | RAM<->HD   | HD<->HD    |
-----------+------------+------------+
Amiga ->PC | 38 KByte/s | 32 KByte/s |
Amiga<- PC | 18 Kbyte/s | 15 KByte/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!

########
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>