Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

swig(1) [osx man page]

SWIG(1) 						      General Commands Manual							   SWIG(1)

swig - Simplified Wrapper and Interface Generator SYNOPSIS
swig [options] file DESCRIPTION
The swig command is used to create wrapper code to connect C and C++ code to scripting languages like Perl, Python, etc. from the defini- tion of the interface. For detailed information on writing those interface definitions please refer to /usr/share/doc/swig-doc/Man- ual/index.html from the swig-doc package. This manpage concentrates on explaining the invocation of the swig command. OPTIONS
Target Language Options: -chicken Generate CHICKEN wrappers -csharp Generate C# wrappers -guile Generate Guile wrappers -java Generate Java wrappers -mzscheme Generate Mzscheme wrappers -ocaml Generate Ocaml wrappers -perl Generate Perl wrappers. -php Generate PHP wrappers -pike Generate Pike wrappers -python Generate Python wrappers -ruby Generate Ruby wrappers -sexp Generate Lisp S-Expressions wrappers -tcl Generate Tcl wrappers -xml Generate XML wrappers. General Options -c++ Enable C++ processing -co Check a file out of the SWIG library -dirprot Turn on wrapping of protected members for director classes -Dsymbol Define a symbol symbol (for conditional compilation) -E Preprocess only, does not generate wrapper code -fcompact Compile in compact mode -fvirtual Compile in virtual elimination mode -Fstandard Display error/warning messages in commonly used format -Fmicrosoft Display error/warning messages in Microsoft format -help Show a summary of supported options and especially of supported options for the selected language. -Idir Look for SWIG files in dir -ignoremissing Ignore missing include files -importall Follow all #include statements as imports -includeall Follow all #include statements -lifile Include SWIG library file ifile -M List all dependencies -MM List dependencies, but omit files in SWIG library -makedefault Create default constructors/destructors (the default) -module name Set module name to name -nocontract Turn off contract checking -nodefault Do not generate constructors/destructors -nodirprot Do not wrap director protected members -noexcept Do not wrap exception specifiers -noextern Do not generate extern declarations -noruntime Do not include SWIG runtime code -o outfile Set name of the output file to outfile -outdir dir Set language specific files output directory -runtime Make the runtime support code globally visible. -small Compile in virtual elimination & compact mode -swiglib Report location of SWIG library and exit -v Run in verbose mode -version Print SWIG version number -Wall Enable all warning messages -Wallkw Enable warning messages for all the languages keywords -Werror Force to treat the warnings as errors -w n Suppress warning number n AUTHOR
SWIG was originally created by David Beazley. For up-to-date information about authors and contributors please check This manual page was written by Torsten Landschoff <> for the Debian project (but may be used by others). 2004-05-22 SWIG(1)

Check Out this Related Man Page

JAVA-WRAPPERS(7)						   Java wrappers						  JAVA-WRAPPERS(7)

java-wrappers - capacities shared by java wrapper scripts DESCRIPTION
Most Java programs are not run directly, but through small shell scripts that take care of various things, such as finding a suitable java environment and looking for libraries. To ease the task of the maintainers, they rely on a library providing runtime detection, library detection and other features. This manual page describes the common features of all those scripts, and to which point you can configure them. This is mainly done via environment variables. ENVIRONMENT VARIABLES
java-wrappers understands some environment variables: JAVA_CMD The java command that will be run. If this variable is set, it disables all lookup for a java runtime. JAVA_BINDIR Specifies a directory that will be looked for a java or a jdb executable (depending on the setting of JAVA_DEBUGGER). It has prece- dence over JAVA_HOME but not over JAVA_CMD. JAVA_HOME A path to a java runtime. If this variable is set, all lookup for a java runtime is disabled, except that if no java executable is found in the path, the command java is used. JAVA_FLAVOR A probably more easy-to-use version of the JAVA_HOME variable: instead of specifying the full path of the java runtime, you name it. List of available flavors can be found in the file /usr/lib/java-wrappers/ See examples below. JAVA_DEBUGGER If this is set, the wrapper will try to pick up a java debugger rather than a java interpreter. This will fail if the jbd of the runtime found is a stub. JAVA_CLASSPATH Additional classpath, will have priority over the one found by the wrapper. JAVA_ARGS Additional arguments to the java command. They will come before all other arguments. FORCE_CLASSPATH If this variable is set, it will be the only classpath. You'd better know what you are doing. DEBUG_WRAPPER This is probably the most important variable; if it set, the wrapper will print out useful information as it goes by its business, such as which runtime it did find, and which command is run eventually. JAVA_JARPATH The path where the wrappers will go looking for jar archives. If not set, the wrapper will look into the default directory, /usr/share/java. Warning : the wrapper will not look anywhere else than in JAVA_JARPATH. Setting it incorrectly will most probably result in early crashes. EXAMPLES
The examples all rely on rasterizer(1), from the package libbatik-java, but they really apply to all scripts that use java-wrappers. Print out debugging information: DEBUG_WRAPPER=1 rasterizer Limit rasterizer's memory to 80 MB: JAVA_ARGS=-Xmx80m rasterizer Force rasterizer to run with kaffe(1): JAVA_HOME=/usr/lib/kaffe rasterizer The same, but using JAVA_BINDIR: JAVA_BINDIR=/usr/lib/kaffe/bin rasterizer Force rasterizer to run with openjdk: JAVA_FLAVOR=openjdk rasterizer Debug rasterizer with Sun's debugger, while printing debugging information from the wrapper: DEBUG_WRAPPER=1 JAVA_CMD=/usr/lib/jvm/java-6-sun/bin/jdb rasterizer BUGS
Care has been taken to make the wrappers bug-free. If that was not the case, please file a bug report against the java-wrappers package. If you wish to submit any problem with a java executable relying on java-wrappers, please also submit the output of the command run with DEBUG_WRAPPER=1. It will save one mail exchange and therefore potentially reduce the time it takes to fix the bug. DEVELOPERS
There is currently no documentation about writing a wrapper script save the comments in /usr/lib/java-wrappers/ If you have to write one, we suggest you base yourself upon, for instance, the rasterizer wrapper script, or any other one (just pick up any direct reverse dependency of java-wrappers and look for scripts). SEE ALSO
java(1), jdb(1) /usr/lib/java-wrappers/ AUTHOR
java-wrappers and its documentation were written by Vincent Fourmond <> Version 0.1.16 2010-05-04 JAVA-WRAPPERS(7)
Man Page