0000: 20 20 43 6f 70 79 72 69 67 68 74 20 31 39 39 33 Copyright 1993
0010: 20 42 69 6c 6c 20 54 72 69 67 67 73 2c 20 3c 42 Bill Triggs, <B
0020: 69 6c 6c 2e 54 72 69 67 67 73 40 69 6e 72 69 61 ill.Triggs@inria
0030: 6c 70 65 73 2e 66 72 3e 0a 0a 20 20 43 6f 70 79 lpes.fr>.. Copy
0040: 72 69 67 68 74 20 31 39 39 35 20 42 72 75 6e 6f right 1995 Bruno
0050: 20 48 61 69 62 6c 65 2c 20 3c 62 72 75 6e 6f 40 Haible, <bruno@
0060: 63 6c 69 73 70 2e 6f 72 67 3e 0a 0a 20 20 54 68 clisp.org>.. Th
0070: 69 73 20 69 73 20 66 72 65 65 20 73 6f 66 74 77 is is free softw
0080: 61 72 65 20 64 69 73 74 72 69 62 75 74 65 64 20 are distributed
0090: 75 6e 64 65 72 20 74 68 65 20 47 4e 55 20 47 65 under the GNU Ge
00a0: 6e 65 72 61 6c 20 50 75 62 6c 69 63 0a 20 20 4c neral Public. L
00b0: 69 63 65 6e 63 65 20 64 65 73 63 72 69 62 65 64 icence described
00c0: 20 69 6e 20 74 68 65 20 66 69 6c 65 20 43 4f 50 in the file COP
00d0: 59 49 4e 47 2e 20 43 6f 6e 74 61 63 74 20 74 68 YING. Contact th
00e0: 65 20 61 75 74 68 6f 72 20 69 66 20 0a 20 20 79 e author if . y
00f0: 6f 75 20 64 6f 6e 27 74 20 68 61 76 65 20 74 68 ou don't have th
0100: 69 73 20 6f 72 20 63 61 6e 27 74 20 6c 69 76 65 is or can't live
0110: 20 77 69 74 68 20 69 74 2e 20 54 68 65 72 65 20 with it. There
0120: 69 73 20 41 42 53 4f 4c 55 54 45 4c 59 20 0a 20 is ABSOLUTELY .
0130: 20 4e 4f 20 57 41 52 52 41 4e 54 59 2c 20 65 78 NO WARRANTY, ex
0140: 70 6c 69 63 69 74 20 6f 72 20 69 6d 70 6c 69 65 plicit or implie
0150: 64 2c 20 6f 6e 20 74 68 69 73 20 73 6f 66 74 77 d, on this softw
0160: 61 72 65 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d are...----------
0170: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0180: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0190: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
01a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 09 41 56 ------------..AV
01b0: 43 41 4c 4c 20 2d 2d 2d 20 61 20 66 6f 72 65 69 CALL --- a forei
01c0: 67 6e 20 66 75 6e 63 74 69 6f 6e 20 69 6e 74 65 gn function inte
01d0: 72 66 61 63 65 20 74 6f 20 41 4e 53 49 2d 43 0a rface to ANSI-C.
01e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
01f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0200: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0210: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0220: 2d 2d 2d 2d 2d 2d 0a 0a 54 68 69 73 20 6c 69 62 ------..This lib
0230: 72 61 72 79 20 61 6c 6c 6f 77 73 20 61 72 62 69 rary allows arbi
0240: 74 72 61 72 79 20 43 20 66 75 6e 63 74 69 6f 6e trary C function
0250: 73 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 20 66 s to be called f
0260: 72 6f 6d 20 65 6d 62 65 64 64 65 64 0a 69 6e 74 rom embedded.int
0270: 65 72 70 72 65 74 65 72 73 2c 20 64 65 62 75 67 erpreters, debug
0280: 67 65 72 73 2c 20 52 50 43 20 63 61 6c 6c 73 2c gers, RPC calls,
0290: 20 65 74 63 2c 20 62 79 20 62 75 69 6c 64 69 6e etc, by buildin
02a0: 67 20 75 70 20 61 20 43 20 61 72 67 75 6d 65 6e g up a C argumen
02b0: 74 0a 6c 69 73 74 20 69 6e 63 72 65 6d 65 6e 74 t.list increment
02c0: 61 6c 6c 79 20 66 72 6f 6d 20 65 78 70 6c 69 63 ally from explic
02d0: 69 74 6c 79 20 74 79 70 65 64 20 61 72 67 75 6d itly typed argum
02e0: 65 6e 74 73 2e 20 54 68 69 73 20 63 6f 6e 73 69 ents. This consi
02f0: 64 65 72 61 62 6c 79 0a 72 65 64 75 63 65 73 20 derably.reduces
0300: 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 62 6f the amount of bo
0310: 69 6c 65 72 70 6c 61 74 65 20 67 6c 75 65 20 63 ilerplate glue c
0320: 6f 64 65 20 72 65 71 75 69 72 65 64 20 66 6f 72 ode required for
0330: 20 73 75 63 68 0a 61 70 70 6c 69 63 61 74 69 6f such.applicatio
0340: 6e 73 2e 0a 0a 54 68 65 20 69 6e 74 65 72 66 61 ns...The interfa
0350: 63 65 20 69 73 20 6c 69 6b 65 20 73 74 64 61 72 ce is like stdar
0360: 67 73 2f 76 61 72 61 72 67 73 20 69 6e 20 72 65 gs/varargs in re
0370: 76 65 72 73 65 20 61 6e 64 20 69 73 20 69 6e 74 verse and is int
0380: 65 6e 64 65 64 20 74 6f 20 62 65 20 61 73 0a 70 ended to be as.p
0390: 6f 72 74 61 62 6c 65 20 61 73 20 70 6f 73 73 69 ortable as possi
03a0: 62 6c 65 2c 20 68 6f 77 65 76 65 72 20 74 68 65 ble, however the
03b0: 20 64 65 74 61 69 6c 73 20 6f 66 20 66 75 6e 63 details of func
03c0: 74 69 6f 6e 20 63 61 6c 6c 69 6e 67 20 61 72 65 tion calling are
03d0: 20 68 69 67 68 6c 79 0a 6d 61 63 68 69 6e 65 2d highly.machine-
03e0: 64 65 70 65 6e 64 65 6e 74 20 73 6f 20 79 6f 75 dependent so you
03f0: 72 20 6d 69 6c 65 61 67 65 20 6d 61 79 20 76 61 r mileage may va
0400: 72 79 2e 20 41 74 20 74 68 65 20 76 65 72 79 20 ry. At the very
0410: 6c 65 61 73 74 20 74 68 65 72 65 20 61 72 65 0a least there are.
0420: 74 79 70 69 63 61 6c 6c 79 20 62 75 69 6c 74 2d typically built-
0430: 69 6e 20 6c 69 6d 69 74 73 20 6f 6e 20 74 68 65 in limits on the
0440: 20 73 69 7a 65 20 6f 66 20 74 68 65 20 61 72 67 size of the arg
0450: 75 6d 65 6e 74 2d 6c 69 73 74 2e 20 54 68 65 0a ument-list. The.
0460: 61 72 67 75 6d 65 6e 74 2d 70 75 73 68 69 6e 67 argument-pushing
0470: 20 6d 61 63 72 6f 73 20 61 6c 6c 20 72 65 74 75 macros all retu
0480: 72 6e 20 30 20 66 6f 72 20 73 75 63 63 65 73 73 rn 0 for success
0490: 2c 20 3c 20 30 20 66 6f 72 20 65 72 72 6f 72 20 , < 0 for error
04a0: 28 65 67 2c 0a 61 72 67 2d 6c 69 73 74 20 6f 76 (eg,.arg-list ov
04b0: 65 72 66 6c 6f 77 29 2e 0a 0a 49 6e 73 74 61 6c erflow)...Instal
04c0: 6c 61 74 69 6f 6e 20 69 6e 73 74 72 75 63 74 69 lation instructi
04d0: 6f 6e 73 20 61 72 65 20 69 6e 20 74 68 65 20 4d ons are in the M
04e0: 61 6b 65 66 69 6c 65 2e 0a 0a 2d 2d 2d 2d 2d 2d akefile...------
04f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0500: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0510: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0520: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0530: 0a 44 45 43 4c 41 52 45 20 41 4c 49 53 54 20 2d .DECLARE ALIST -
0540: 3e 20 4f 50 45 4e 20 41 4c 49 53 54 20 2d 3e 20 > OPEN ALIST ->
0550: 53 45 54 20 46 4c 41 47 53 20 2d 3e 20 50 55 53 SET FLAGS -> PUS
0560: 48 20 41 52 47 53 20 2d 3e 20 43 41 4c 4c 20 46 H ARGS -> CALL F
0570: 55 4e 43 54 49 4f 4e 0a 2d 2d 2d 2d 2d 2d 2d 2d UNCTION.--------
0580: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0590: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
05a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
05b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
05c0: 31 29 20 44 65 63 6c 61 72 65 20 74 68 65 20 61 1) Declare the a
05d0: 72 67 75 6d 65 6e 74 20 6c 69 73 74 20 73 74 72 rgument list str
05e0: 75 63 74 75 72 65 3a 0a 0a 09 23 69 6e 63 6c 75 ucture:...#inclu
05f0: 64 65 20 22 61 76 63 61 6c 6c 2e 68 22 0a 09 7b de "avcall.h"..{
0600: 0a 09 20 20 61 76 5f 61 6c 69 73 74 20 61 6c 69 .. av_alist ali
0610: 73 74 3b 0a 0a 32 29 20 53 65 74 20 61 6e 79 20 st;..2) Set any
0620: 73 70 65 63 69 61 6c 20 66 6c 61 67 73 2e 20 54 special flags. T
0630: 68 69 73 20 69 73 20 61 72 63 68 69 74 65 63 74 his is architect
0640: 75 72 65 20 61 6e 64 20 63 6f 6d 70 69 6c 65 72 ure and compiler
0650: 20 64 65 70 65 6e 64 65 6e 74 2e 0a 53 6f 6d 65 dependent..Some
0660: 74 69 6d 65 73 2c 20 63 6f 6d 70 69 6c 65 72 20 times, compiler
0670: 6f 70 74 69 6f 6e 73 20 6d 75 73 74 20 62 65 20 options must be
0680: 66 6c 61 67 67 65 64 20 62 79 20 23 64 65 66 69 flagged by #defi
0690: 6e 65 73 20 62 65 66 6f 72 65 20 74 68 65 0a 23 nes before the.#
06a0: 69 6e 63 6c 75 64 65 20 3c 61 76 63 61 6c 6c 2e include <avcall.
06b0: 68 3e 2e 20 55 73 75 61 6c 6c 79 2c 20 68 6f 77 h>. Usually, how
06c0: 65 76 65 72 2c 20 74 68 65 20 60 63 6f 6e 66 69 ever, the `confi
06d0: 67 75 72 65 27 20 73 63 72 69 70 74 20 73 68 6f gure' script sho
06e0: 75 6c 64 0a 68 61 76 65 20 64 65 74 65 72 6d 69 uld.have determi
06f0: 6e 65 64 20 77 68 69 63 68 20 23 64 65 66 69 6e ned which #defin
0700: 65 73 20 61 72 65 20 6e 65 65 64 65 64 20 61 6e es are needed an
0710: 64 20 70 75 74 20 74 68 65 6d 20 61 74 20 74 68 d put them at th
0720: 65 20 68 65 61 64 20 6f 66 0a 61 76 63 61 6c 6c e head of.avcall
0730: 2e 68 2e 0a 0a 33 29 20 49 6e 69 74 69 61 6c 69 .h...3) Initiali
0740: 73 65 20 74 68 65 20 61 6c 69 73 74 20 77 69 74 se the alist wit
0750: 68 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 61 h the function a
0760: 64 64 72 65 73 73 20 61 6e 64 20 72 65 74 75 72 ddress and retur
0770: 6e 20 74 79 70 65 2e 20 0a 54 68 65 72 65 20 69 n type. .There i
0780: 73 20 61 20 73 65 70 61 72 61 74 65 20 6d 61 63 s a separate mac
0790: 72 6f 20 66 6f 72 20 65 61 63 68 20 62 75 69 6c ro for each buil
07a0: 74 2d 69 6e 20 43 20 74 79 70 65 20 28 63 68 61 t-in C type (cha
07b0: 72 2c 20 69 6e 74 2c 20 66 6c 6f 61 74 2c 20 65 r, int, float, e
07c0: 74 63 29 2e 0a 45 67 2c 0a 09 61 76 5f 73 74 61 tc)..Eg,..av_sta
07d0: 72 74 5f 69 6e 74 28 61 6c 69 73 74 2c 26 66 75 rt_int(alist,&fu
07e0: 6e 63 2c 26 72 65 74 75 72 6e 5f 61 64 64 72 29 nc,&return_addr)
07f0: 3b 0a 6f 72 0a 09 61 76 5f 73 74 61 72 74 5f 64 ;.or..av_start_d
0800: 6f 75 62 6c 65 28 61 6c 69 73 74 2c 26 66 75 6e ouble(alist,&fun
0810: 63 2c 26 72 65 74 75 72 6e 5f 61 64 64 72 29 3b c,&return_addr);
0820: 0a 65 74 63 2e 0a 46 75 6e 63 74 69 6f 6e 73 20 .etc..Functions
0830: 72 65 74 75 72 6e 69 6e 67 20 61 20 73 74 72 75 returning a stru
0840: 63 74 75 72 65 20 6f 72 20 70 6f 69 6e 74 65 72 cture or pointer
0850: 20 74 61 6b 65 20 61 6e 20 65 78 74 72 61 20 74 take an extra t
0860: 79 70 65 20 61 72 67 75 6d 65 6e 74 3a 0a 45 67 ype argument:.Eg
0870: 2c 0a 09 61 76 5f 73 74 61 72 74 5f 73 74 72 75 ,..av_start_stru
0880: 63 74 28 61 6c 69 73 74 2c 26 66 75 6e 63 2c 53 ct(alist,&func,S
0890: 54 52 55 43 54 5f 4f 52 5f 55 4e 49 4f 4e 5f 54 TRUCT_OR_UNION_T
08a0: 59 50 45 2c 53 50 4c 49 54 54 41 42 4c 45 2c 26 YPE,SPLITTABLE,&
08b0: 72 65 74 75 72 6e 5f 61 64 64 72 29 3b 0a 6f 72 return_addr);.or
08c0: 0a 09 61 76 5f 73 74 61 72 74 5f 70 74 72 28 61 ..av_start_ptr(a
08d0: 6c 69 73 74 2c 26 66 75 6e 63 2c 50 4f 49 4e 54 list,&func,POINT
08e0: 45 52 5f 54 59 50 45 2c 26 72 65 74 75 72 6e 5f ER_TYPE,&return_
08f0: 61 64 64 72 29 3b 0a 0a 0a 34 29 20 50 75 73 68 addr);...4) Push
0900: 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73 20 6f the arguments o
0910: 6e 65 20 62 79 20 6f 6e 65 20 69 6e 20 6f 72 64 ne by one in ord
0920: 65 72 2e 20 54 68 65 72 65 20 69 73 20 61 20 6d er. There is a m
0930: 61 63 72 6f 20 66 6f 72 20 65 61 63 68 0a 62 75 acro for each.bu
0940: 69 6c 74 2d 69 6e 20 43 20 74 79 70 65 2c 20 65 ilt-in C type, e
0950: 67 3a 0a 09 61 76 5f 69 6e 74 28 61 6c 69 73 74 g:..av_int(alist
0960: 2c 76 61 6c 75 65 29 3b 0a 6f 72 0a 09 61 76 5f ,value);.or..av_
0970: 64 6f 75 62 6c 65 28 61 6c 69 73 74 2c 76 61 6c double(alist,val
0980: 75 65 29 3b 0a 0a 53 74 72 75 63 74 75 72 65 20 ue);..Structure
0990: 61 6e 64 20 70 6f 69 6e 74 65 72 20 61 72 67 75 and pointer argu
09a0: 6d 65 6e 74 73 20 72 65 71 75 69 72 65 20 61 6e ments require an
09b0: 20 65 78 74 72 61 20 74 79 70 65 20 61 72 67 75 extra type argu
09c0: 6d 65 6e 74 3a 0a 0a 09 61 76 5f 73 74 72 75 63 ment:...av_struc
09d0: 74 28 61 6c 69 73 74 2c 53 54 52 55 43 54 5f 54 t(alist,STRUCT_T
09e0: 59 50 45 2c 76 61 6c 75 65 29 3b 0a 6f 72 0a 09 YPE,value);.or..
09f0: 61 76 5f 70 74 72 28 61 6c 69 73 74 2c 50 4f 49 av_ptr(alist,POI
0a00: 4e 54 45 52 5f 54 59 50 45 2c 76 61 6c 75 65 29 NTER_TYPE,value)
0a10: 3b 0a 0a 35 29 20 43 61 6c 6c 20 74 68 65 20 66 ;..5) Call the f
0a20: 75 6e 63 74 69 6f 6e 2c 20 73 65 74 20 74 68 65 unction, set the
0a30: 20 72 65 74 75 72 6e 20 76 61 6c 75 65 2c 20 61 return value, a
0a40: 6e 64 20 74 69 64 79 20 75 70 3a 0a 0a 09 61 76 nd tidy up:...av
0a50: 5f 63 61 6c 6c 28 61 6c 69 73 74 29 3b 0a 0a 2d _call(alist);..-
0a60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0a70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0a80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0a90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0aa0: 2d 2d 2d 2d 2d 0a 09 09 09 4e 4f 54 45 53 0a 0a -----....NOTES..
0ab0: 31 29 20 46 75 6e 63 74 69 6f 6e 73 20 64 65 63 1) Functions dec
0ac0: 6c 61 72 65 64 20 69 6e 20 4b 26 52 20 73 74 79 lared in K&R sty
0ad0: 6c 65 20 28 69 65 2c 20 77 69 74 68 6f 75 74 20 le (ie, without
0ae0: 61 20 74 79 70 65 64 20 61 72 67 6c 69 73 74 29 a typed arglist)
0af0: 20 6d 75 73 74 0a 75 73 65 20 64 65 66 61 75 6c must.use defaul
0b00: 74 20 4b 26 52 20 65 78 70 72 65 73 73 69 6f 6e t K&R expression
0b10: 20 70 72 6f 6d 6f 74 69 6f 6e 73 20 28 63 68 61 promotions (cha
0b20: 72 2c 73 68 6f 72 74 2d 2d 3e 69 6e 74 3b 20 66 r,short-->int; f
0b30: 6c 6f 61 74 2d 2d 3e 64 6f 75 62 6c 65 29 0a 77 loat-->double).w
0b40: 68 65 74 68 65 72 20 74 68 65 79 20 61 72 65 20 hether they are
0b50: 63 6f 6d 70 69 6c 65 64 20 62 79 20 61 20 4b 26 compiled by a K&
0b60: 52 20 6f 72 20 61 6e 20 41 4e 53 49 20 63 6f 6d R or an ANSI com
0b70: 70 69 6c 65 72 2c 20 62 65 63 61 75 73 65 20 74 piler, because t
0b80: 68 65 20 0a 74 72 75 65 20 61 72 67 20 74 79 70 he .true arg typ
0b90: 65 73 20 6d 61 79 20 6e 6f 74 20 62 65 20 6b 6e es may not be kn
0ba0: 6f 77 6e 20 61 74 20 74 68 65 20 63 61 6c 6c 20 own at the call
0bb0: 70 6f 69 6e 74 2e 20 53 75 63 68 20 66 75 6e 63 point. Such func
0bc0: 74 69 6f 6e 73 0a 62 61 63 6b 2d 63 6f 6e 76 65 tions.back-conve
0bd0: 72 74 20 74 68 65 69 72 20 61 72 67 75 6d 65 6e rt their argumen
0be0: 74 73 20 74 6f 20 74 68 65 20 64 65 63 6c 61 72 ts to the declar
0bf0: 65 64 20 74 79 70 65 73 20 6f 6e 20 66 75 6e 63 ed types on func
0c00: 74 69 6f 6e 20 65 6e 74 72 79 2e 0a 54 68 65 20 tion entry..The
0c10: 6f 6e 6c 79 20 77 61 79 20 74 6f 20 70 61 73 73 only way to pass
0c20: 20 61 20 74 72 75 65 20 63 68 61 72 2c 20 73 68 a true char, sh
0c30: 6f 72 74 20 6f 72 20 66 6c 6f 61 74 20 28 65 67 ort or float (eg
0c40: 2c 20 66 72 6f 6d 20 4b 26 52 20 43 20 74 6f 20 , from K&R C to
0c50: 61 6e 20 0a 41 4e 53 49 20 6f 72 20 76 61 72 61 an .ANSI or vara
0c60: 72 67 73 20 66 75 6e 63 74 69 6f 6e 29 20 69 73 rgs function) is
0c70: 20 62 79 20 61 6e 20 65 78 70 6c 69 63 69 74 20 by an explicit
0c80: 63 61 73 74 3a 20 66 6f 6f 28 28 63 68 61 72 29 cast: foo((char)
0c90: 63 2c 28 66 6c 6f 61 74 29 66 29 2e 0a 0a 20 21 c,(float)f)... !
0ca0: 21 20 48 65 6e 63 65 2c 20 66 6f 72 20 61 72 67 ! Hence, for arg
0cb0: 73 20 6f 66 20 66 75 6e 63 74 69 6f 6e 73 20 64 s of functions d
0cc0: 65 63 6c 61 72 65 64 20 69 6e 20 4b 26 52 20 73 eclared in K&R s
0cd0: 74 79 6c 65 20 79 6f 75 20 73 68 6f 75 6c 64 20 tyle you should
0ce0: 75 73 65 0a 20 21 21 20 61 76 5f 69 6e 74 28 29 use. !! av_int()
0cf0: 20 61 6e 64 20 61 76 5f 64 6f 75 62 6c 65 28 29 and av_double()
0d00: 20 69 6e 73 74 65 61 64 20 6f 66 20 61 76 5f 7b instead of av_{
0d10: 63 68 61 72 2c 73 68 6f 72 74 7d 28 29 20 61 6e char,short}() an
0d20: 64 20 61 76 5f 66 6c 6f 61 74 28 29 2e 0a 0a 49 d av_float()...I
0d30: 66 20 79 6f 75 20 75 73 65 20 61 20 4b 26 52 20 f you use a K&R
0d40: 63 6f 6d 70 69 6c 65 72 2c 20 74 68 65 20 61 76 compiler, the av
0d50: 63 61 6c 6c 20 68 65 61 64 65 72 20 66 69 6c 65 call header file
0d60: 73 20 6d 61 79 20 64 65 74 65 63 74 20 74 68 69 s may detect thi
0d70: 73 20 61 6e 64 20 0a 64 65 66 69 6e 65 20 61 76 s and .define av
0d80: 5f 66 6c 6f 61 74 2c 20 65 74 63 2c 20 61 70 70 _float, etc, app
0d90: 72 6f 70 72 69 61 74 65 6c 79 2c 20 62 75 74 20 ropriately, but
0da0: 77 69 74 68 20 61 6e 20 41 4e 53 49 20 63 6f 6d with an ANSI com
0db0: 70 69 6c 65 72 20 74 68 65 72 65 27 73 20 0a 6e piler there's .n
0dc0: 6f 20 77 61 79 20 61 76 63 61 6c 6c 20 63 61 6e o way avcall can
0dd0: 20 6b 6e 6f 77 20 68 6f 77 20 61 20 66 75 6e 63 know how a func
0de0: 74 69 6f 6e 20 77 61 73 20 64 65 63 6c 61 72 65 tion was declare
0df0: 64 2c 20 73 6f 20 79 6f 75 20 68 61 76 65 20 74 d, so you have t
0e00: 6f 20 0a 63 6f 72 72 65 63 74 20 74 68 65 20 61 o .correct the a
0e10: 72 67 75 6d 65 6e 74 20 74 79 70 65 73 20 79 6f rgument types yo
0e20: 75 72 73 65 6c 66 2e 20 53 69 6d 69 6c 61 72 6c urself. Similarl
0e30: 79 2c 20 73 6f 6d 65 20 4b 26 52 20 63 6f 6d 70 y, some K&R comp
0e40: 69 6c 65 72 73 20 28 73 75 63 68 20 0a 61 73 20 ilers (such .as
0e50: 53 75 6e 20 63 63 20 6f 6e 20 74 68 65 20 73 70 Sun cc on the sp
0e60: 61 72 63 29 20 61 63 74 75 61 6c 6c 79 20 72 65 arc) actually re
0e70: 74 75 72 6e 20 61 20 66 6c 6f 61 74 20 61 73 20 turn a float as
0e80: 61 20 64 6f 75 62 6c 65 2e 0a 0a 32 29 20 54 68 a double...2) Th
0e90: 65 72 65 20 61 72 65 20 74 6f 6f 20 6d 61 6e 79 ere are too many
0ea0: 20 70 6f 73 73 69 62 6c 65 20 73 74 72 75 63 74 possible struct
0eb0: 75 72 65 20 61 6e 64 20 70 6f 69 6e 74 65 72 20 ure and pointer
0ec0: 74 79 70 65 73 20 74 6f 20 68 61 76 65 20 61 0a types to have a.
0ed0: 73 65 70 61 72 61 74 65 20 6d 61 63 72 6f 20 66 separate macro f
0ee0: 6f 72 20 65 61 63 68 2c 20 73 6f 20 74 68 65 20 or each, so the
0ef0: 70 6f 69 6e 74 65 72 20 61 6e 64 20 73 74 72 75 pointer and stru
0f00: 63 74 75 72 65 20 6d 61 63 72 6f 73 20 74 61 6b cture macros tak
0f10: 65 20 61 6e 0a 65 78 70 6c 69 63 69 74 20 74 79 e an.explicit ty
0f20: 70 65 20 61 72 67 75 6d 65 6e 74 20 77 68 69 63 pe argument whic
0f30: 68 20 6d 61 79 20 62 65 20 75 73 65 64 20 28 65 h may be used (e
0f40: 67 29 20 74 6f 20 63 61 6c 63 75 6c 61 74 65 20 g) to calculate
0f50: 74 68 65 20 73 69 7a 65 20 6f 66 0a 74 68 65 20 the size of.the
0f60: 73 74 72 75 63 74 75 72 65 2e 20 4f 6e 20 6d 6f structure. On mo
0f70: 73 74 20 61 72 63 68 69 74 65 63 74 75 72 65 73 st architectures
0f80: 20 74 68 69 73 20 70 72 6f 76 69 64 65 73 20 65 this provides e
0f90: 6e 6f 75 67 68 20 69 6e 66 6f 72 6d 61 74 69 6f nough informatio
0fa0: 6e 0a 66 6f 72 20 74 68 65 20 63 6f 6d 70 69 6c n.for the compil
0fb0: 65 72 20 74 6f 20 6d 61 6b 65 20 74 68 65 20 70 er to make the p
0fc0: 72 6f 70 65 72 20 63 61 6c 6c 2c 20 62 75 74 20 roper call, but
0fd0: 74 68 65 72 65 20 77 69 6c 6c 20 61 6c 77 61 79 there will alway
0fe0: 73 20 62 65 0a 6d 61 63 68 69 6e 65 73 20 77 69 s be.machines wi
0ff0: 74 68 20 6f 64 64 20 61 6c 69 67 6e 6d 65 6e 74 th odd alignment
1000: 20 72 65 71 75 69 72 65 6d 65 6e 74 73 20 6f 72 requirements or
1010: 20 61 72 67 75 6d 65 6e 74 20 70 61 73 73 69 6e argument passin
1020: 67 0a 63 6f 6e 76 65 6e 74 69 6f 6e 73 2c 20 75 g.conventions, u
1030: 6e 75 73 75 61 6c 20 72 65 70 72 65 6e 74 61 74 nusual reprentat
1040: 69 6f 6e 73 20 66 6f 72 20 66 75 6e 63 74 69 6f ions for functio
1050: 6e 2c 20 63 68 61 72 2c 20 6f 72 20 76 6f 69 64 n, char, or void
1060: 20 70 6f 69 6e 74 65 72 73 2c 0a 65 74 63 2c 20 pointers,.etc,
1070: 66 6f 72 20 77 68 69 63 68 20 74 68 69 73 20 73 for which this s
1080: 63 68 65 6d 65 20 77 69 6c 6c 20 6e 6f 74 20 73 cheme will not s
1090: 75 66 66 69 63 65 2e 20 20 54 68 65 73 65 20 6d uffice. These m
10a0: 61 63 68 69 6e 65 73 20 6d 61 79 20 64 65 66 69 achines may defi
10b0: 6e 65 0a 61 64 64 69 74 69 6f 6e 61 6c 20 61 76 ne.additional av
10c0: 5f 73 74 61 72 74 5f 54 59 50 45 20 61 6e 64 20 _start_TYPE and
10d0: 61 76 5f 54 59 50 45 20 6d 61 63 72 6f 73 2e 0a av_TYPE macros..
10e0: 0a 33 29 20 54 68 65 20 63 75 72 72 65 6e 74 20 .3) The current
10f0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 implementations
1100: 61 72 65 20 70 72 65 74 74 79 20 66 6c 61 6b 65 are pretty flake
1110: 79 20 69 6e 20 70 6c 61 63 65 73 2e 20 49 27 6d y in places. I'm
1120: 20 68 61 70 70 79 20 74 6f 20 0a 61 63 63 65 70 happy to .accep
1130: 74 20 6e 65 77 20 70 6f 72 74 73 20 61 6e 64 20 t new ports and
1140: 28 70 72 6f 70 65 72 6c 79 20 74 65 73 74 65 64 (properly tested
1150: 29 20 66 69 78 65 73 20 61 6e 64 20 65 6e 68 61 ) fixes and enha
1160: 6e 63 65 6d 65 6e 74 73 2e 20 49 6e 0a 70 61 72 ncements. In.par
1170: 74 69 63 75 6c 61 72 2c 20 6d 61 6e 79 20 6f 66 ticular, many of
1180: 20 74 68 65 20 72 6f 75 74 69 6e 65 73 20 77 61 the routines wa
1190: 73 74 65 20 61 20 6c 6f 74 20 6f 66 20 73 74 61 ste a lot of sta
11a0: 63 6b 20 73 70 61 63 65 20 61 6e 64 20 67 65 6e ck space and gen
11b0: 65 72 61 6c 6c 79 0a 64 6f 20 68 61 69 72 79 20 erally.do hairy
11c0: 74 68 69 6e 67 73 20 77 69 74 68 20 73 74 61 63 things with stac
11d0: 6b 20 66 72 61 6d 65 73 20 2d 20 61 20 62 69 74 k frames - a bit
11e0: 20 6d 6f 72 65 20 61 73 73 65 6d 62 6c 79 20 63 more assembly c
11f0: 6f 64 65 20 77 6f 75 6c 64 20 70 72 6f 62 61 62 ode would probab
1200: 6c 79 20 0a 68 65 6c 70 20 74 68 69 6e 67 73 20 ly .help things
1210: 61 6c 6f 6e 67 20 71 75 69 74 65 20 61 20 62 69 along quite a bi
1220: 74 2c 20 62 75 74 20 49 20 64 6f 6e 27 74 20 73 t, but I don't s
1230: 70 65 61 6b 20 61 73 73 65 6d 62 6c 65 72 20 61 peak assembler a
1240: 74 20 61 6c 6c 20 77 65 6c 6c 2e 0a 0a 34 29 20 t all well...4)
1250: 54 68 65 20 6d 61 63 72 6f 73 20 72 65 71 75 69 The macros requi
1260: 72 65 64 20 66 6f 72 20 61 6c 6c 20 74 68 69 73 red for all this
1270: 20 61 72 65 20 70 72 65 74 74 79 20 67 72 75 6e are pretty grun
1280: 67 79 2c 20 62 75 74 20 69 74 20 64 6f 65 73 20 gy, but it does
1290: 73 65 65 6d 0a 74 6f 20 62 65 20 70 6f 73 73 69 seem.to be possi
12a0: 62 6c 65 20 74 6f 20 70 6f 72 74 20 61 76 63 61 ble to port avca
12b0: 6c 6c 20 74 6f 20 6d 61 6e 79 20 6d 61 63 68 69 ll to many machi
12c0: 6e 65 73 2e 20 53 6f 6d 65 20 6f 66 20 74 68 65 nes. Some of the
12d0: 20 67 72 75 6e 67 65 20 69 73 0a 75 73 75 61 6c grunge is.usual
12e0: 6c 79 20 68 61 6e 64 6c 65 64 20 62 79 20 61 20 ly handled by a
12f0: 43 20 6f 72 20 61 73 73 65 6d 62 6c 79 20 6c 65 C or assembly le
1300: 76 65 6c 20 67 6c 75 65 20 72 6f 75 74 69 6e 65 vel glue routine
1310: 20 74 68 61 74 20 61 63 74 75 61 6c 6c 79 0a 70 that actually.p
1320: 75 73 68 65 73 20 74 68 65 20 61 72 67 75 6d 65 ushes the argume
1330: 6e 74 73 2c 20 63 61 6c 6c 73 20 74 68 65 20 66 nts, calls the f
1340: 75 6e 63 74 69 6f 6e 20 61 6e 64 20 75 6e 70 61 unction and unpa
1350: 63 6b 73 20 61 6e 79 20 72 65 74 75 72 6e 20 76 cks any return v
1360: 61 6c 75 65 2e 0a 54 68 69 73 20 69 73 20 63 61 alue..This is ca
1370: 6c 6c 65 64 20 5f 5f 62 75 69 6c 74 69 6e 5f 61 lled __builtin_a
1380: 76 63 61 6c 6c 28 29 2e 20 41 20 70 72 65 63 6f vcall(). A preco
1390: 6d 70 69 6c 65 64 20 61 73 73 65 6d 62 6c 65 72 mpiled assembler
13a0: 20 76 65 72 73 69 6f 6e 20 66 6f 72 0a 70 65 6f version for.peo
13b0: 70 6c 65 20 77 69 74 68 6f 75 74 20 67 63 63 20 ple without gcc
13c0: 69 73 20 61 6c 73 6f 20 6d 61 64 65 20 61 76 61 is also made ava
13d0: 69 6c 61 62 6c 65 2e 20 54 68 65 20 72 6f 75 74 ilable. The rout
13e0: 69 6e 65 20 73 68 6f 75 6c 64 20 69 64 65 61 6c ine should ideal
13f0: 6c 79 0a 68 61 76 65 20 66 6c 61 67 73 20 66 6f ly.have flags fo
1400: 72 20 74 68 65 20 70 61 73 73 69 6e 67 20 63 6f r the passing co
1410: 6e 76 65 6e 74 69 6f 6e 73 20 6f 66 20 6f 74 68 nventions of oth
1420: 65 72 20 63 6f 6d 70 69 6c 65 72 73 2e 0a 2d 2d er compilers..--
1430: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1440: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1450: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1460: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1470: 2d 2d 2d 2d 0a 09 09 41 43 4b 4e 4f 57 4c 45 44 ----...ACKNOWLED
1480: 47 45 4d 45 4e 54 53 0a 0a 49 20 77 61 73 20 61 GEMENTS..I was a
1490: 77 61 72 65 20 6f 66 20 74 77 6f 20 73 69 6d 69 ware of two simi
14a0: 6c 61 72 20 62 75 74 20 72 61 74 68 65 72 20 6d lar but rather m
14b0: 6f 72 65 20 72 65 73 74 72 69 63 74 65 64 20 66 ore restricted f
14c0: 6f 72 65 69 67 6e 20 66 75 6e 63 74 69 6f 6e 20 oreign function
14d0: 0a 69 6e 74 65 72 66 61 63 65 73 20 77 68 65 6e .interfaces when
14e0: 20 74 68 65 20 69 6e 69 74 69 61 6c 20 76 65 72 the initial ver
14f0: 73 69 6f 6e 20 6f 66 20 74 68 69 73 20 6c 69 62 sion of this lib
1500: 72 61 72 79 20 77 61 73 20 77 72 69 74 74 65 6e rary was written
1510: 2c 20 61 6c 74 68 6f 75 67 68 0a 28 49 20 62 65 , although.(I be
1520: 6c 69 65 76 65 29 20 61 6c 6c 20 6f 66 20 74 68 lieve) all of th
1530: 65 20 70 72 65 73 65 6e 74 20 63 6f 64 65 20 69 e present code i
1540: 73 20 6d 79 20 6f 77 6e 3a 20 74 68 65 20 43 20 s my own: the C
1550: 69 6e 74 65 72 66 61 63 65 20 69 6e 20 74 68 65 interface in the
1560: 20 7a 65 6c 6b 0a 65 78 74 65 6e 73 69 6f 6e 73 zelk.extensions
1570: 20 74 6f 20 4f 6c 69 76 65 72 20 4c 61 75 6d 61 to Oliver Lauma
1580: 6e 6e 27 73 20 3c 6e 65 74 40 63 73 2e 74 75 2d nn's <net@cs.tu-
1590: 62 65 72 6c 69 6e 2e 64 65 3e 20 45 6c 6b 20 73 berlin.de> Elk s
15a0: 63 68 65 6d 65 20 69 6e 74 65 72 70 72 65 74 65 cheme interprete
15b0: 72 0a 62 79 20 4a 2e 50 2e 4c 65 77 69 73 2c 20 r.by J.P.Lewis,
15c0: 4e 45 43 20 43 26 43 20 52 65 73 65 61 72 63 68 NEC C&C Research
15d0: 2c 20 3c 7a 69 6c 6c 61 40 63 63 72 6c 2e 6e 6a , <zilla@ccrl.nj
15e0: 2e 6e 65 63 2e 63 6f 6d 3e 20 28 66 6f 72 20 53 .nec.com> (for S
15f0: 75 6e 34 20 61 6e 64 20 53 47 49 29 3b 20 0a 61 un4 and SGI); .a
1600: 6e 64 20 52 6f 79 20 46 65 61 74 68 65 72 73 74 nd Roy Featherst
1610: 6f 6e 65 27 73 20 3c 72 6f 79 40 72 6f 62 6f 74 one's <roy@robot
1620: 73 2e 6f 78 66 6f 72 64 2e 61 63 2e 75 6b 3e 20 s.oxford.ac.uk>
1630: 70 65 72 73 6f 6e 61 6c 20 43 20 69 6e 74 65 72 personal C inter
1640: 66 61 63 65 20 0a 6c 69 62 72 61 72 79 20 66 6f face .library fo
1650: 72 20 53 75 6e 33 2c 34 20 61 6e 64 20 53 47 49 r Sun3,4 and SGI
1660: 2e 20 49 20 61 6c 73 6f 20 6c 6f 6f 6b 65 64 20 . I also looked
1670: 61 74 20 74 68 65 20 63 6f 6d 6d 65 6e 74 73 20 at the comments
1680: 61 6e 64 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 and some of the
1690: 0a 63 6f 64 65 20 69 6e 20 74 68 65 20 6d 61 63 .code in the mac
16a0: 68 69 6e 65 2d 64 65 70 65 6e 64 65 6e 74 20 70 hine-dependent p
16b0: 61 72 74 73 20 6f 66 20 74 68 65 20 47 43 43 20 arts of the GCC
16c0: 61 6e 64 20 47 44 42 20 64 69 73 74 72 69 62 75 and GDB distribu
16d0: 74 69 6f 6e 73 2c 20 61 6e 64 20 0a 70 75 74 20 tions, and .put
16e0: 74 68 65 20 47 43 43 20 5f 5f 61 73 6d 5f 5f 20 the GCC __asm__
16f0: 65 78 74 65 6e 73 69 6f 6e 73 20 74 6f 20 67 6f extensions to go
1700: 6f 64 20 75 73 65 2e 20 54 68 61 6e 6b 73 20 67 od use. Thanks g
1710: 75 79 73 21 0a 0a 54 68 69 73 20 77 6f 72 6b 20 uys!..This work
1720: 77 61 73 20 70 61 72 74 6c 79 20 73 75 70 70 6f was partly suppo
1730: 72 74 65 64 20 62 79 20 45 43 2d 45 53 50 52 49 rted by EC-ESPRI
1740: 54 20 42 61 73 69 63 20 52 65 73 65 61 72 63 68 T Basic Research
1750: 20 41 63 74 69 6f 6e 20 53 45 43 4f 4e 44 2e 0a Action SECOND..
1760: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1770: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1780: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1790: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
17a0: 2d 2d 2d 2d 2d 2d 0a ------.