SWIG(1)

💖 SWIG(1) — bestie edition 💖

General Commands Manual · the swig page, but make it a group chat

---

✨ NAME ✨

swig — Simplified Wrapper and Interface Generator 🦋

---

🌸 SYNOPSIS 🌸

swig [options] file

---

👑 DESCRIPTION 👑

okay so. the swig command is literally the whole point of this page: it makes wrapper code that glues your C and C++ code to scripting languages like Perl, Python, etc. — and it does that from the definition of the interface. that's the whole vibe 💅

if you want the deep lore on how to actually write those interface definitions, bestie, go read /usr/share/doc/swig-doc/Manual/index.html from the swig-doc package. this manpage? it's focused on one thing only: explaining how you invoke the swig command. periodt.

---

🎀 OPTIONS 🎀

🌈 Target Language Options:

pick your language, pick your destiny ✨

• -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

the main character options, fr fr 🌟

• -c++ — turn on 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 info about authors and contributors, bestie, go check http://www.swig.org/guilty.html. 👑

this manual page was written by Torsten Landschoff <torsten@debian.org> for the Debian project (but may be used by others). iconic of them honestly 🫶

---

and that's the tea, bestie — this page is from 2004-05-22, part of the SWIG(1) manual set. go write some wrappers, you absolute legend 💅✨