
ZeriLink 2.60 source code release
---------------------------------

I'm releasing the source code for the Windows/Linux side of ZeriLink, to offer
those who want to have a go at the user interface side and/or porting (and
nothing else ! see below), a chance to do so.

There are a few strict rules however. You cannot use this source code in any
way, shape or form if you don't comply with all of them.

The rules are :

- The source code is self-explanatory. I.e. you should make do with that.

- You can change linkt.cpp and linkr.cpp and build on top of that. Knock
  yourself out.

- You can not (ask me to) make any changes to stats.* or guide.txt, or any
  lib_xxx.cpp or .h file. Not any.None.

- You 'publish' your efforts by yourself, on your own website. It will contain
  the binaries, your docs, guide.txt, /no/ source code, /no/ updates.txt (make
  your own, if you want, each time you release). Your docs are the main docs,
  you note at their very start that your release is based on my source code,
  refer to my website's ZeriLink page, and refer to guide.txt for relevant info
  that is already there. You send me the URL, I will point to it from my
  website's ZeriLink page. I have to ok the distribution first. You send me a
  copy of your source code.

A few notes about the source code :

It is ready to be compiled under gcc (I use DJGPP under Windows, makefile.win
makefile, or plain gcc under Linux, makefile.unx makefile). Any recent version
of gcc should do.

Beware of a major pitfall when moving away from gcc : there is (gcc specific)
assembly code in linkr.cpp and linkt.cpp to do the parallel port I/O. You may
want to start using inport/outport etc., I'm not sure of the impact on
performance, it will probably be ok though.

Also, you must arrange access to the parallel port in some way. Under Windows,
I use PortTalk (search for 'PortTalk' on Internet), and especially allowio.exe.
You may need to start using the ioctl calls that interface with porttalk.sys,
as described on the PortTalk website, instead. Under Linux, I take a shortcut
and call iopl(3), which needs root privileges, i.e. this may need to be changed
to something less radical as well.

If you really need to ask something, email me.

Thanks for having a go, and have fun !


John Kortink (kortink@inter.nl.net), 18 June 2006


P.S. if you don't know what on earth you got hold of here, visit :

http://web.inter.nl.net/users/J.Kortink/home/software/zerilink/



