|
2474
|
1 RMA Library
|
|
|
2
|
|
|
3 by
|
|
|
4
|
|
|
5 Bob van der Poel
|
|
|
6
|
|
|
7
|
|
|
8 WARNING: The entire contents of this file including the documentation and
|
|
|
9 the actual binary library code are protected by copyright and is the sole
|
|
|
10 property of Bob van der Poel. You are given permission to use this
|
|
|
11 software and to post it on other information systems, etc. However, you
|
|
|
12 may not sell it, or claim it as your own. Any commercial expoltation will
|
|
|
13 be prosectuted to the full extent of the law.
|
|
|
14
|
|
|
15 Bob van der Poel Software
|
|
|
16
|
|
|
17 P.O. Box 57 P.O. Box 355
|
|
|
18 Wynndel, B.C. Porthill, ID
|
|
|
19 Canada V0B 2N0 USA 83853
|
|
|
20
|
|
|
21
|
|
|
22 To use the routines in this library, just include calls to them in your
|
|
|
23 programs with a "lbsr". For example, the following code segment calls a
|
|
|
24 library routine to print a number via standard out:
|
|
|
25
|
|
|
26 ldd number
|
|
|
27 lbsr PRINT_DEC
|
|
|
28
|
|
|
29 To use a routine make sure you have set up all the registers properly.
|
|
|
30 None of the routines use any memory other than stated. Since the hardware
|
|
|
31 stack is used for all temporary variables all the routines are re-entrant
|
|
|
32 and shareable. It is up to the user to ensure an adequate stack area.
|
|
|
33 Note that most of the routines have all uppercase names. It is hoped that
|
|
|
34 this will make your code more readable since you can tell at a glance
|
|
|
35 which routines are external.
|
|
|
36
|
|
|
37 To compile an assembler program using the library first use RMA to
|
|
|
38 generate a ".r" file, then use RLINK to compile. A sample command line
|
|
|
39 would be:
|
|
|
40
|
|
|
41 rlink yourprog.a -o=yourprog -l=/d0/lib/alib.l
|
|
|
42
|
|
|
43 The file alib.doc is a formatted listing of all the commands available in
|
|
|
44 the library. Just list it to your printer.
|
|
|
45
|
|
|
46 Included in the SRC directory is the file "makefile" which can be used
|
|
|
47 with MAKE to create a new library file. List "makefile" first to see
|
|
|
48 which directories, etc. you'll need.
|
|
|
49
|
|
|
50 Also included on the disk is the file "LIB/alib.l". This is the complied
|
|
|
51 version of the library, ready for you to link with.
|
|
|
52
|
|
|
53 If you have any comments or suggestions for future improvement--or even
|
|
|
54 if you want to send money (yes, I take contributions!)--please write me
|
|
|
55 at the above address or email bvdp@uniserve.com.
|
|
|
56
|
