1GEN-CTL-IO(1) libctl GEN-CTL-IO(1)
2
3
4
6 gen-ctl-io - generate C interface code for libctl control files
7
9 gen-ctl-io [OPTION]... [spec-file]
10
12 gen-ctl-io generates C code to import/export the input/output variables
13 used in a libctl control file. gen-ctl-io generates files like ctl-
14 io.h and ctl-io.c. These files define global variables, data struc‐
15 tures, and functions for the input/output variables, classes, and func‐
16 tion interfaces defined in the spec-file argument, automating the
17 interaction between C and Guile.
18
19 The arguments such as --code and --header are used to control whether
20 ctl-io.c or ctl-io.h, etcetera, are generated. If no argument is spec‐
21 ified then both of these files are generated by default, for backwards
22 compatibility.
23
24 libctl is a free library to aid in interfacing scientific software with
25 the GNU Guile scripting and extension language. Documentation for it
26 may be found online at the libctl home page: http://ab-ini‐
27 tio.mit.edu/libctl
28
30 --code Generate C (or C++) source code to implement the Guile interface
31 functions. The default output file name is ctl-io.c (in C) or
32 ctl-io.cpp (in C++).
33
34 --header
35 Generate the header file declaring the interface data types and
36 functions. The default output file name is ctl-io.h (in C) or
37 ctl-io.hpp (in C++).
38
39 --swig Generate a SWIG interface definition file declaring automatic
40 conversions for the various libctl data types. The default out‐
41 put file name is ctl-io.i.
42
43 --cxx Generate C++ code instead of C code.
44
45 -o file
46 Use file as the output file name instead of the defaults
47 (above).
48
50 Send bug reports to S. G. Johnson, stevenj@alum.mit.edu.
51
53 Written by Steven G. Johnson.
54
55
56
57libctl March 27, 2006 GEN-CTL-IO(1)