1avcall - calling C functions with variable arguments
2
3This library allows arbitrary C functions to be called from embedded
4interpreters, debuggers, RPC calls, etc, by building up a C
5argument-list incrementally from explicitly typed arguments. This
6considerably reduces the amount of boilerplate glue code required
7for such applications.
8
9The interface is like stdargs/varargs in reverse and is intended to be as
10portable as possible, however the details of function calling are highly
11machine-dependent so your mileage may vary. At the very least there are
12typically built-in limits on the size of the argument-list. The
13argument-pushing macros all return 0 for success, < 0 for error (eg,
14arg-list overflow).
15
16
17Installation instructions:
18
19    Configure the parent directory. Then:
20        cd avcall
21        make
22        make check
23        make install
24
25
26Files in this package:
27
28    Documentation:
29
30        README          this text
31        COPYING         free software license
32        PLATFORMS       list of supported platforms
33        avcall.3        manual page in Unix man format
34        avcall.man      manual page
35        avcall.html     manual page in HTML format
36        DOC             documentation
37
38    Source:
39
40        avcall.h        main include file
41        avcall-*.c      source for the main interface function
42        avcall-*.[sS]   its translation to assembly language
43        avcall-libapi.c     implementation of other library API
44        avcall-structcpy.c  auxiliary function
45        tests.c         test program
46
47    Building:
48
49        Makefile.in     Makefile master
50
51    Porting:
52
53        Makefile.devel  developer's Makefile
54
55
56Copyright notice:
57
58Copyright 1993-1995 Bill Triggs <Bill.Triggs@imag.fr>
59Copyright 1995-2017 Bruno Haible <bruno@clisp.org>
60
61This program is free software: you can redistribute it and/or modify
62it under the terms of the GNU General Public License as published by
63the Free Software Foundation; either version 2 of the License, or
64(at your option) any later version.
65
66This program is distributed in the hope that it will be useful,
67but WITHOUT ANY WARRANTY; without even the implied warranty of
68MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
69GNU General Public License for more details.
70
71You should have received a copy of the GNU General Public License
72along with this program.  If not, see <https://www.gnu.org/licenses/>.
73
74