Fix last patch

This commit is contained in:
Anthony Green
2011-11-12 17:22:24 -05:00
parent ff9454da44
commit 4f17e1f142
3 changed files with 54 additions and 34 deletions

View File

@@ -1,10 +1,10 @@
This is /home/green/libffi/doc/libffi.info, produced by makeinfo This is ../libffi/doc/libffi.info, produced by makeinfo version 4.13
version 4.13 from /home/green/libffi/doc/libffi.texi. from ../libffi/doc/libffi.texi.
This manual is for Libffi, a portable foreign-function interface This manual is for Libffi, a portable foreign-function interface
library. library.
Copyright (C) 2008, 2010 Red Hat, Inc. Copyright (C) 2008, 2010, 2011 Red Hat, Inc.
Permission is granted to copy, distribute and/or modify this Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU General Public License as document under the terms of the GNU General Public License as
@@ -27,7 +27,7 @@ libffi
This manual is for Libffi, a portable foreign-function interface This manual is for Libffi, a portable foreign-function interface
library. library.
Copyright (C) 2008, 2010 Red Hat, Inc. Copyright (C) 2008, 2010, 2011 Red Hat, Inc.
Permission is granted to copy, distribute and/or modify this Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU General Public License as document under the terms of the GNU General Public License as
@@ -115,8 +115,6 @@ To prepare a call interface object, use the function `ffi_prep_cif'.
want. *note Multiple ABIs:: for more information. want. *note Multiple ABIs:: for more information.
NARGS is the number of arguments that this function accepts. NARGS is the number of arguments that this function accepts.
`libffi' does not yet handle varargs functions; see *note Missing
Features:: for more information.
RTYPE is a pointer to an `ffi_type' structure that describes the RTYPE is a pointer to an `ffi_type' structure that describes the
return type of the function. *Note Types::. return type of the function. *Note Types::.
@@ -129,6 +127,30 @@ To prepare a call interface object, use the function `ffi_prep_cif'.
properly; `FFI_BAD_TYPEDEF' if one of the `ffi_type' objects is properly; `FFI_BAD_TYPEDEF' if one of the `ffi_type' objects is
incorrect; or `FFI_BAD_ABI' if the ABI parameter is invalid. incorrect; or `FFI_BAD_ABI' if the ABI parameter is invalid.
If the function being called is variadic (varargs) then
`ffi_prep_cif_var' must be used instead of `ffi_prep_cif'.
-- Function: ffi_status ffi_prep_cif_var (ffi_cif *CIF, ffi_abi
varabi, unsigned int NFIXEDARGS, unsigned int varntotalargs,
ffi_type *RTYPE, ffi_type **ARGTYPES)
This initializes CIF according to the given parameters for a call
to a variadic function. In general it's operation is the same as
for `ffi_prep_cif' except that:
NFIXEDARGS is the number of fixed arguments, prior to any variadic
arguments. It must be greater than zero.
NTOTALARGS the total number of arguments, including variadic and
fixed arguments.
Note that, different cif's must be prepped for calls to the same
function when different numbers of arguments are passed.
Also note that a call to `ffi_prep_cif_var' with
NFIXEDARGS=NOTOTALARGS is NOT equivalent to a call to
`ffi_prep_cif'.
To call a function using an initialized `ffi_cif', use the To call a function using an initialized `ffi_cif', use the
`ffi_call' function: `ffi_call' function:
@@ -511,9 +533,7 @@ File: libffi.info, Node: Missing Features, Next: Index, Prev: Using libffi,
`libffi' is missing a few features. We welcome patches to add support `libffi' is missing a few features. We welcome patches to add support
for these. for these.
* There is no support for calling varargs functions. This may work * Variadic closures.
on some platforms, depending on how the ABI is defined, but it is
not reliable.
* There is no support for bit fields in structures. * There is no support for bit fields in structures.
@@ -521,6 +541,9 @@ for these.
* The "raw" API is undocumented. * The "raw" API is undocumented.
Note that variadic support is very new and tested on a relatively
small number of platforms.
 
File: libffi.info, Node: Index, Prev: Missing Features, Up: Top File: libffi.info, Node: Index, Prev: Missing Features, Up: Top
@@ -538,11 +561,12 @@ Index
* closure API: The Closure API. (line 13) * closure API: The Closure API. (line 13)
* closures: The Closure API. (line 13) * closures: The Closure API. (line 13)
* FFI: Introduction. (line 31) * FFI: Introduction. (line 31)
* ffi_call: The Basics. (line 41) * ffi_call: The Basics. (line 63)
* ffi_closure_alloc: The Closure API. (line 19) * ffi_closure_alloc: The Closure API. (line 19)
* ffi_closure_free: The Closure API. (line 26) * ffi_closure_free: The Closure API. (line 26)
* FFI_CLOSURES: The Closure API. (line 13) * FFI_CLOSURES: The Closure API. (line 13)
* ffi_prep_cif: The Basics. (line 16) * ffi_prep_cif: The Basics. (line 16)
* ffi_prep_cif_var: The Basics. (line 39)
* ffi_prep_closure_loc: The Closure API. (line 34) * ffi_prep_closure_loc: The Closure API. (line 34)
* ffi_status <1>: The Closure API. (line 37) * ffi_status <1>: The Closure API. (line 37)
* ffi_status: The Basics. (line 18) * ffi_status: The Basics. (line 18)
@@ -570,24 +594,24 @@ Index
* ffi_type_void: Primitive Types. (line 10) * ffi_type_void: Primitive Types. (line 10)
* Foreign Function Interface: Introduction. (line 31) * Foreign Function Interface: Introduction. (line 31)
* void <1>: The Closure API. (line 20) * void <1>: The Closure API. (line 20)
* void: The Basics. (line 43) * void: The Basics. (line 65)
 
Tag Table: Tag Table:
Node: Top724 Node: Top712
Node: Introduction1466 Node: Introduction1460
Node: Using libffi3102 Node: Using libffi3096
Node: The Basics3588 Node: The Basics3582
Node: Simple Example6374 Node: Simple Example7224
Node: Types7401 Node: Types8251
Node: Primitive Types7684 Node: Primitive Types8534
Node: Structures9504 Node: Structures10354
Node: Type Example10364 Node: Type Example11214
Node: Multiple ABIs11587 Node: Multiple ABIs12437
Node: The Closure API11958 Node: The Closure API12808
Node: Closure Example14902 Node: Closure Example15752
Node: Missing Features16461 Node: Missing Features17311
Node: Index16954 Node: Index17764
 
End Tag Table End Tag Table

View File

@@ -152,9 +152,7 @@ If the function being called is variadic (varargs) then
@code{ffi_prep_cif_var} must be used instead of @code{ffi_prep_cif}. @code{ffi_prep_cif_var} must be used instead of @code{ffi_prep_cif}.
@findex ffi_prep_cif_var @findex ffi_prep_cif_var
@defun ffi_status ffi_prep_cif_var (ffi_cif *@var{cif}, ffi_abi @defun ffi_status ffi_prep_cif_var (ffi_cif *@var{cif}, ffi_abi var{abi}, unsigned int @var{nfixedargs}, unsigned int var{ntotalargs}, ffi_type *@var{rtype}, ffi_type **@var{argtypes})
var{abi}, unsigned int @var{nfixedargs}, unsigned int
var{ntotalargs}, ffi_type *@var{rtype}, ffi_type **@var{argtypes})
This initializes @var{cif} according to the given parameters for This initializes @var{cif} according to the given parameters for
a call to a variadic function. In general it's operation is the a call to a variadic function. In general it's operation is the
same as for @code{ffi_prep_cif} except that: same as for @code{ffi_prep_cif} except that:

View File

@@ -507,7 +507,7 @@ Index: libffi/doc/libffi.texi
@var{rtype} is a pointer to an @code{ffi_type} structure that @var{rtype} is a pointer to an @code{ffi_type} structure that
describes the return type of the function. @xref{Types}. describes the return type of the function. @xref{Types}.
@@ -150,6 +148,32 @@ objects is incorrect; or @code{FFI_BAD_A @@ -150,6 +148,30 @@ objects is incorrect; or @code{FFI_BAD_A
is invalid. is invalid.
@end defun @end defun
@@ -515,9 +515,7 @@ Index: libffi/doc/libffi.texi
+@code{ffi_prep_cif_var} must be used instead of @code{ffi_prep_cif}. +@code{ffi_prep_cif_var} must be used instead of @code{ffi_prep_cif}.
+ +
+@findex ffi_prep_cif_var +@findex ffi_prep_cif_var
+@defun ffi_status ffi_prep_cif_var (ffi_cif *@var{cif}, ffi_abi +@defun ffi_status ffi_prep_cif_var (ffi_cif *@var{cif}, ffi_abi var{abi}, unsigned int @var{nfixedargs}, unsigned int var{ntotalargs}, ffi_type *@var{rtype}, ffi_type **@var{argtypes})
+var{abi}, unsigned int @var{nfixedargs}, unsigned int
+var{ntotalargs}, ffi_type *@var{rtype}, ffi_type **@var{argtypes})
+This initializes @var{cif} according to the given parameters for +This initializes @var{cif} according to the given parameters for
+a call to a variadic function. In general it's operation is the +a call to a variadic function. In general it's operation is the
+same as for @code{ffi_prep_cif} except that: +same as for @code{ffi_prep_cif} except that:
@@ -540,7 +538,7 @@ Index: libffi/doc/libffi.texi
To call a function using an initialized @code{ffi_cif}, use the To call a function using an initialized @code{ffi_cif}, use the
@code{ffi_call} function: @code{ffi_call} function:
@@ -572,9 +596,7 @@ support for these. @@ -572,9 +594,7 @@ support for these.
@itemize @bullet @itemize @bullet
@item @item
@@ -551,7 +549,7 @@ Index: libffi/doc/libffi.texi
@item @item
There is no support for bit fields in structures. There is no support for bit fields in structures.
@@ -591,6 +613,8 @@ The ``raw'' API is undocumented. @@ -591,6 +611,8 @@ The ``raw'' API is undocumented.
@c anything else? @c anything else?
@end itemize @end itemize