c3-lang/libffi/man/ffi_prep_cif_var.3

• Show log

  Commit

• Hash : ff9454da
  Author :
  Date : 2011-11-12T17:18:51
  

  Add David Gilbert's variadic function call support

Download

• man/ffi_prep_cif_var.3

• .Dd January 25, 2011
  .Dt ffi_prep_cif_var 3
  .Sh NAME
  .Nm ffi_prep_cif_var
  .Nd Prepare a
  .Nm ffi_cif
  structure for use with
  .Nm ffi_call
  for variadic functions.
  .Sh SYNOPSIS
  .In ffi.h
  .Ft ffi_status
  .Fo ffi_prep_cif_var
  .Fa "ffi_cif *cif"
  .Fa "ffi_abi abi"
  .Fa "unsigned int nfixedargs"
  .Fa "unsigned int ntotalargs"
  .Fa "ffi_type *rtype"
  .Fa "ffi_type **atypes"
  .Fc
  .Sh DESCRIPTION
  The
  .Nm ffi_prep_cif_var
  function prepares a
  .Nm ffi_cif
  structure for use with
  .Nm ffi_call
  for variadic functions.
  .Fa abi
  specifies a set of calling conventions to use.
  .Fa atypes
  is an array of
  .Fa ntotalargs
  pointers to
  .Nm ffi_type
  structs that describe the data type, size and alignment of each argument.
  .Fa rtype
  points to an
  .Nm ffi_type
  that describes the data type, size and alignment of the
  return value.
  .Fa nfixedargs
  must contain the number of fixed (non-variadic) arguments.
  Note that to call a non-variadic function
  .Nm ffi_prep_cif
  must be used.
  .Sh RETURN VALUES
  Upon successful completion,
  .Nm ffi_prep_cif_var
  returns
  .Nm FFI_OK .
  It will return
  .Nm FFI_BAD_TYPEDEF
  if
  .Fa cif
  is
  .Nm NULL
  or
  .Fa atypes
  or
  .Fa rtype
  is malformed. If
  .Fa abi
  does not refer to a valid ABI,
  .Nm FFI_BAD_ABI
  will be returned. Available ABIs are
  defined in
  .Nm <ffitarget.h>
  .
  .Sh SEE ALSO
  .Xr ffi 3 ,
  .Xr ffi_call 3 ,
  .Xr ffi_prep_cif 3
  

Download