example.library V1.1 (26.09.2002)
An Amiga shared library in 100 % C language - coming with sources.

Supported and tested compilers:
SAS/C 6.5x, MaxonC (HiSoftC) 3.x, MaxonCPP 4.x, StormC 3.x, GCC 2.7.2.1,
vbcc 0.8

This example library code is partly based on CLib37x by Andreas R. Kleinert.
The main stuff comes from my own library startup code developed for
xpkmaster.library and xadmaster.library.

I decided to release my own code to show a somewhat different method.
Some of the texts are taken from Andreas release. Best is to check both
ways and choose the one you like most (or mix them :-).

Thanks must go to: Andreas R. Kleinert for the initial idea in 1996.
Gunter Nikl for developing the main SDI_compiler.h stuff and for telling
me lots of improvements and bug fixes. All the others contributing to
Andreas release.

This sample library intends to make Amiga shared library sources compileable
with any available Amiga C compiler - without any changes to the source code.

This seams to be easily done: nearly any noticeable compiler for the Amiga
does support generation of libraries by special linker commands and pre-
generated object files.

But when looking into the details, one will find out, that these linker
functionality just reduces the influence of the programmer on how his sources
are handled, that the pre-generated object files just originally were done
in Assembler, and that each compiler does define its own interface definitions
and usage rules.

But as a programmer, it is important to have control over the _complete_
source code and to be able to compile it _anywhere_ with only minor changes,
even better without any changes.

Since most Amiga system modules - noticeable Libraries, Devices and Resources -
do have startup-modules and other larger parts completely written in Assembler
language, the most important task for getting inter-compiler and operating
system independant sources in my opinion is, to completely migrate the
interfaces to C language.

If you can submit adjustments for the other compilers as mentioned above: feel
free to send these. Feel free to use this source for own projects.

History:
  1.0  first version, Made with help of CLib by Andreas Kleinert and my
       library code used in xadmaster.library.
  1.1  Updated the library to compile with MorphOS and allow tests of callback
       hooks.

Please contact me:

*********************************************************************
* snail-mail:                  * e-mail:                            *
*   Dirk Stoecker              *   stoeckerepost.de                *
*   Geschwister-Scholl-Str. 10 *   dirkdstoecker.de                *
*   01877 Bischofswerda        * world wide web:                    *
*   GERMANY                    *   http://www.dstoecker.de/         *
* phone:                       * pgp key:                           *
*   GERMANY +49 (0)3594/706666 *   get from WWW pages or keyservers *
*********************************************************************

Following is my PGP signature for the corresponding LhA-File.
Use ' pgpv CLib-SDI.readme -o CLib-SDI.lha ' to check it.
Key fingerprint: B9 F2 3A 1A 29 02 75 16  6A C6 5B 7D 5E F6 16 CF.
All my releases after April 2001 have a PGP signature with this key.
Be alarmed if signature is missing or wrong.

-----BEGIN PGP SIGNATURE-----
Version: PGPfreeware 5.0i for non-commercial use
MessageID: BzKAVfcorfaBL5gDkpff0VVmdF7gnkOK

iQCVAwUAPbwBjLOTsAT/iOY9AQFr2gP/ZZE1iStrUx/Hj1ufPjUiBP5dhQRpVstD
5uHt6AD0QHCkz3BzJHWU9YjgPND+UEu0R+Dq5+Q+6F+06u7UNfA50hxd5SS2faP5
J501I2ll4dpMl3zIQAIwyxjQV5rkTekeUPJeVFOtEsll3EZpQL+0yBn7NSVDT+6Z
idaLctHaaGU=
=WPKc
-----END PGP SIGNATURE-----

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 1523    2146  71.0% -lh5- 8bc7 Oct 27  2002 CLib-SDI.info
[generic]                 1194    1800  66.3% -lh5- a893 Oct 27  2002 CLib-SDI/C/EasyTest_SAS
[generic]                 3392    7836  43.3% -lh5- 68db Oct 27  2002 CLib-SDI/C/EasyTest_vbccMOS
[generic]                 1339    1936  69.2% -lh5- c3ee Oct 27  2002 CLib-SDI/C/HookTest_SAS
[generic]                 3781    8852  42.7% -lh5- 3141 Oct 27  2002 CLib-SDI/C/HookTest_vbccMOS
[generic]                 1190    1692  70.3% -lh5- 4429 Oct 27  2002 CLib-SDI/C/Test_SAS
[generic]                 3469    8020  43.3% -lh5- 6972 Oct 27  2002 CLib-SDI/C/Test_vbccMOS
[generic]                 1453    3173  45.8% -lh5- 28bd Oct 27  2002 CLib-SDI/CLib-SDI.readme
[generic]                   61      84  72.6% -lh5- 64dd Oct 27  2002 CLib-SDI/include/AmigaE/example.m
[generic]                  273     447  61.1% -lh5- bbaf Oct 27  2002 CLib-SDI/include/ASM/libraries/example.i
[generic]                   99     182  54.4% -lh5- 0c2c Oct 27  2002 CLib-SDI/include/ASM/lvo/example_lib.i
[generic]                  339     645  52.6% -lh5- 7318 Oct 27  2002 CLib-SDI/include/C/clib/example_protos.h
[generic]                  344     867  39.7% -lh5- c82c Oct 27  2002 CLib-SDI/include/C/inline/example.h
[generic]                  426    1287  33.1% -lh5- 1a0e Oct 27  2002 CLib-SDI/include/C/inline/example_protos.h
[generic]                  304     583  52.1% -lh5- a69b Oct 27  2002 CLib-SDI/include/C/libraries/example.h
[generic]                  312     850  36.7% -lh5- cf62 Oct 27  2002 CLib-SDI/include/C/pragma/example_lib.h
[generic]                  237     478  49.6% -lh5- 5fad Oct 27  2002 CLib-SDI/include/C/proto/example.h
[generic]                 1536    4065  37.8% -lh5- 15f3 Oct 27  2002 CLib-SDI/include/C/SDI_compiler.h
[generic]                 2170    7968  27.2% -lh5- 1472 Oct 27  2002 CLib-SDI/include/C/SDI_hook.h
[generic]                  113     171  66.1% -lh5- 2620 Oct 27  2002 CLib-SDI/include/FD/example_lib.fd
[generic]                  441    1473  29.9% -lh5- bba8 Oct 27  2002 CLib-SDI/include/makefile
[generic]                  666    1539  43.3% -lh5- decc Oct 27  2002 CLib-SDI/include/ReadMe.TXT
[generic]                  266     533  49.9% -lh5- 0ce8 Oct 27  2002 CLib-SDI/include/SFD/example_lib.sfd
[generic]                 4412   21907  20.1% -lh5- 527a Oct 27  2002 CLib-SDI/include2/inline/dos.h
[generic]                 5789   34462  16.8% -lh5- c465 Oct 27  2002 CLib-SDI/include2/inline/dos_protos.h
[generic]                 3134   16130  19.4% -lh5- f76d Oct 27  2002 CLib-SDI/include2/inline/exec.h
[generic]                 3998   24382  16.4% -lh5- 7fa8 Oct 27  2002 CLib-SDI/include2/inline/exec_protos.h
[generic]                 4137   21888  18.9% -lh5- bb70 Oct 27  2002 CLib-SDI/include2/inline/intuition.h
[generic]                 5424   34696  15.6% -lh5- dd2b Oct 27  2002 CLib-SDI/include2/inline/intuition_protos.h
[generic]                 1344    6049  22.2% -lh5- cabf Oct 27  2002 CLib-SDI/include2/inline/utility.h
[generic]                 1695    9137  18.6% -lh5- 26b6 Oct 27  2002 CLib-SDI/include2/inline/utility_protos.h
[generic]                 3237   18291  17.7% -lh5- f50a Oct 27  2002 CLib-SDI/include2/pragma/dos_lib.h
[generic]                 2381   13386  17.8% -lh5- 8957 Oct 27  2002 CLib-SDI/include2/pragma/exec_lib.h
[generic]                 2772   16595  16.7% -lh5- 5052 Oct 27  2002 CLib-SDI/include2/pragma/intuition_lib.h
[generic]                  979    4873  20.1% -lh5- bed6 Oct 27  2002 CLib-SDI/include2/pragma/utility_lib.h
[generic]                  232     441  52.6% -lh5- 05d3 Oct 27  2002 CLib-SDI/include2/proto/dos.h
[generic]                  230     447  51.5% -lh5- cf84 Oct 27  2002 CLib-SDI/include2/proto/exec.h
[generic]                  241     498  48.4% -lh5- b7e9 Oct 27  2002 CLib-SDI/include2/proto/intuition.h
[generic]                  237     478  49.6% -lh5- 96b0 Oct 27  2002 CLib-SDI/include2/proto/utility.h
[generic]                 6063   46791  13.0% -lh5- e4da Oct 27  2002 CLib-SDI/include2mos/inline/dos_protos.h
[generic]                  472    1636  28.9% -lh5- 1518 Oct 27  2002 CLib-SDI/include2mos/inline/example_protos.h
[generic]                 4270   33104  12.9% -lh5- aa0e Oct 27  2002 CLib-SDI/include2mos/inline/exec_protos.h
[generic]                 5950   45218  13.2% -lh5- 233b Oct 27  2002 CLib-SDI/include2mos/inline/intuition_protos.h
[generic]                 1821   12034  15.1% -lh5- aca8 Oct 27  2002 CLib-SDI/include2mos/inline/utility_protos.h
[generic]                  232     441  52.6% -lh5- 05d3 Oct 27  2002 CLib-SDI/include2mos/proto/dos.h
[generic]                  237     478  49.6% -lh5- 5fad Oct 27  2002 CLib-SDI/include2mos/proto/example.h
[generic]                  230     447  51.5% -lh5- cf84 Oct 27  2002 CLib-SDI/include2mos/proto/exec.h
[generic]                  241     498  48.4% -lh5- b7e9 Oct 27  2002 CLib-SDI/include2mos/proto/intuition.h
[generic]                  237     478  49.6% -lh5- 96b0 Oct 27  2002 CLib-SDI/include2mos/proto/utility.h
[generic]                  551     796  69.2% -lh5- 9741 Oct 27  2002 CLib-SDI/libs/example.library_gcc
[generic]                  822    1376  59.7% -lh5- 03f1 Oct 27  2002 CLib-SDI/libs/example.library_MaxonV3
[generic]                  834    1376  60.6% -lh5- 6a72 Oct 27  2002 CLib-SDI/libs/example.library_MaxonV4
[generic]                  528     740  71.4% -lh5- 936b Oct 27  2002 CLib-SDI/libs/example.library_SAS
[generic]                  672    1092  61.5% -lh5- 3e9b Oct 27  2002 CLib-SDI/libs/example.library_StormV3
[generic]                  636     840  75.7% -lh5- b70b Oct 27  2002 CLib-SDI/libs/example.library_vbcc
[generic]                 1118    2376  47.1% -lh5- a54e Oct 27  2002 CLib-SDI/libs/example.library_vbccMOS
[generic]                  734    1586  46.3% -lh5- 3bdf Oct 27  2002 CLib-SDI/libsource/examplefuncs.c
[generic]                 1006    3123  32.2% -lh5- 9642 Oct 27  2002 CLib-SDI/libsource/libinfo.h
[generic]                 2449    8076  30.3% -lh5- f5bf Oct 27  2002 CLib-SDI/libsource/libinit.c
[generic]                  227     458  49.6% -lh5- 0080 Oct 27  2002 CLib-SDI/libsource/makefile.gcc
[generic]                  129     295  43.7% -lh5- 6798 Oct 27  2002 CLib-SDI/libsource/makefile.Maxon
[generic]                  258     548  47.1% -lh5- a46d Oct 27  2002 CLib-SDI/libsource/makefile.Storm
[generic]                  215     453  47.5% -lh5- 9f17 Oct 27  2002 CLib-SDI/libsource/makefile.vbcc
[generic]                  241     518  46.5% -lh5- 5328 Oct 27  2002 CLib-SDI/libsource/makefile.vbccMOS
[generic]                  344     630  54.6% -lh5- 2566 Oct 27  2002 CLib-SDI/libsource/project.MaxonCPP4
[generic]                  564    1568  36.0% -lh5- 55f6 Oct 27  2002 CLib-SDI/libsource/project.StormC.¶
[generic]                  664    2456  27.0% -lh5- 03c1 Oct 27  2002 CLib-SDI/libsource/SMakeFile
[generic]                 1519    3489  43.5% -lh5- 16a4 Oct 27  2002 CLib-SDI/ReadMe
[generic]                  429     926  46.3% -lh5- eeb1 Oct 27  2002 CLib-SDI/testsource/EasyTest.c
[generic]                  883    2010  43.9% -lh5- ef21 Oct 27  2002 CLib-SDI/testsource/HookTest.c
[generic]                  145     287  50.5% -lh5- 14dd Oct 27  2002 CLib-SDI/testsource/makefile.vbccMOS
[generic]                  700    1465  47.8% -lh5- d003 Oct 27  2002 CLib-SDI/testsource/Test.c
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        72 files  100591  457896  22.0%            Nov  6  2002