Command Line Arguments

To use bfort, you need only to give it the name of the files to process. For example, to process every .c and .h file in the current directory, use

 
bfort *.[ch] 

A complete list of the command line options follows. Some of these will be used often (e.g., -anyname); others are needed only in special cases (e.g., -ferr).

The following option controls the location of the output file:

-dir name

Directory for output file

The following options control the kind of messages that bfort produces about the generated interfaces.

-nomsgs

Do not generate messages for routines that cannot be converted to Fortran.

-nofort

Generate messages for all routines/macros without a Fortran counterpart.

-anyname

Generate a single wrapper that can handle the three most common cases: trailing underscore, no underscore, and all caps. The choice is based on whether one of the following macro names is defined.

FORTRANCAPS

Names are upper case with no trailing underscore.

FORTRANUNDERSCORE

Names are lower case with trailing underscore.

FORTRANDOUBLEUNDERSCORE

Names are lower case, with two trailing underscores. This is needed when some versions of f2c are used to generate C for Fortran routines. Note that f2c uses two underscores only when the name already contains an underscore (on at least one FreeBSD system that uses f2c). To handle this case, the generated code contains the second underscore only when the name already contains one.

In addition, if -mpi is used, the MPI profiling names are also generated, surrounded by MPI_BUILD_PROFILING.

-ferr

Fortran versions return the value of the routine as the last argument (an integer). This is used in MPI and is a common approach for handling error returns.

-I name

Give the name of a file that contains #include statements that are necessary to compile the wrapper.

-mapptr

Generate special code to convert Fortran integers to and from pointers used by the C routines. The special code is used only if the macro POINTER_64_BITS is defined. It is also used to determine whether pointers are too long to fit in a 32-bit Fortran integer. (You have to insert a call to __RmPointer( pointer ) into the routines that destroy the pointer.) The routines for managing the pointers are in ptrcvt.c.

-mnative

Multiple indirects (int *** are native datatypes; that is, there is no coercion to the basic type).

-mpi

Recognize special MPI [(ref mpi-final)] datatypes (some MPI datatypes are pointers by definition).

-ptrprefix name

Change the prefix for names of functions to convert to/from pointers. The default value of name is __.

-voidisptr

Consider void * as a pointer to a structure.

-ansiheader

Generate ANSI-C style headers instead of Fortran interfaces. This is useful in creating ANSI prototypes without converting the code to ANSI prototype form. These use a trick to provide both ANSI and non-ANSI prototypes. The declarations are wrapped in ANSI_ARGS, the definition of which should be

#ifdef ANSI_ARG 
#undef ANSI_ARG 
#endif 
#ifdef __STDC__ 
#define ANSI_ARGS(a) a 
#else 
#define ANSI_ARGS(a) () 
#endif