← Back to branch summary

~ubuntu-branches/debian/squeeze/ffcall/squeeze

« back to all changes in this revision

Viewing changes to ffcall/avcall/README

  • Committer: Bazaar Package Importer
  • Author(s): Christoph Egger
  • Date: 2010-06-26 15:29:30 UTC
  • mfrom: (5.1.1 experimental)
  • Revision ID: james.westby@ubuntu.com-20100626152930-c09y01gk3szcnykn
Tags: 1.10+cvs20100619-2
Ship to unstable

Show diffs side-by-side

added added

removed removed

Lines of Context:
ffcall/avcall/README
1
 
avcall - calling C functions with variable arguments
2
 
 
3
 
This library allows arbitrary C functions to be called from embedded
4
 
interpreters, debuggers, RPC calls, etc, by building up a C
5
 
argument-list incrementally from explicitly typed arguments. This 
6
 
considerably reduces the amount of boilerplate glue code required
7
 
for such applications.
8
 
 
9
 
The interface is like stdargs/varargs in reverse and is intended to be as
10
 
portable as possible, however the details of function calling are highly
11
 
machine-dependent so your mileage may vary. At the very least there are
12
 
typically built-in limits on the size of the argument-list. The
13
 
argument-pushing macros all return 0 for success, < 0 for error (eg,
14
 
arg-list overflow).
15
 
 
16
 
 
17
 
Installation instructions:
18
 
        ./configure
19
 
        make
20
 
        make check
21
 
        make install
22
 
 
23
 
 
24
 
Files in this package:
25
 
 
26
 
    Documentation:
27
 
 
28
 
        README          this text
29
 
        COPYING         free software license
30
 
        PLATFORMS       list of supported platforms
31
 
        avcall.3        manual page in Unix man format
32
 
        avcall.man      manual page
33
 
        avcall.html     manual page in HTML format
34
 
        DOC             documentation
35
 
 
36
 
    Source:
37
 
 
38
 
        avcall.h.in     master for main include file avcall.h
39
 
        avcall-*.c      source for the interface function
40
 
        avcall-*.[sS]   its translation to assembly language
41
 
        structcpy.c     auxiliary function
42
 
        tests.c         test program
43
 
 
44
 
    Installation:
45
 
 
46
 
        configure       configuration script
47
 
        configure.in    autoconf-2.12 source for the configuration script
48
 
        ../build-aux/*  auxiliary build scripts
49
 
        Makefile.in     Makefile master
50
 
        config.h.in     config.h master
51
 
 
52
 
    Porting:
53
 
 
54
 
        Makefile.devel  developer's Makefile
55
 
        underscore.h    used to build the *.S files
56
 
 
57
 
 
58
 
The current code is under the GNU licence, but the interface (macro
59
 
names, arguments & functionality but not the actual macro or function
60
 
code in avcall.[ch]) is absolutely free and any port conforming to it is
61
 
welcome.
62
 
 
63
 
------------------------------------------------------
64
 
Bill Triggs                       | Bill.Triggs@inrialpes.fr
65
 
Oxford University Robotics Group  | Bill.Triggs@imag.fr
66
 
19 Parks Rd, Oxford OX1 3PJ, G.B. | fax +44-865-273908
67
 
------------------------------------------------------
68
 
Bruno Haible
69
 
<bruno@clisp.org>