|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /usr/share/gtk-doc/html/gtk/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Running GTK+ Applications</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="GTK+ Reference Manual">
<link rel="up" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="prev" href="gtk-compiling.html" title="Compiling GTK+ Applications">
<link rel="next" href="gtk-x11.html" title="Using GTK+ on the X Window System">
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="ch02.html" title="Widget Gallery">
<link rel="chapter" href="WindowWidgets.html" title="Windows">
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
<link rel="chapter" href="Ornaments.html" title="Ornaments">
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
<link rel="chapter" href="Printing.html" title="Printing">
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and
GtkComboBoxEntry">
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
<link rel="glossary" href="glossary.html" title="Glossary">
<link rel="index" href="ix01.html" title="Index">
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<td><a accesskey="p" href="gtk-compiling.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="gtk.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ Reference Manual</th>
<td><a accesskey="n" href="gtk-x11.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry" lang="en">
<a name="gtk-running"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle">Running GTK+ Applications</span></h2>
<p>Running GTK+ Applications —
How to run and debug your GTK+ application
</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1" lang="en">
<a name="id2554473"></a><h2>Running and debugging GTK+ Applications</h2>
<div class="refsect2" lang="en">
<a name="id2554479"></a><h3>Common commandline options</h3>
<p>
All GTK+ applications support a number of standard commandline
options. These are removed from <code class="literal">argv</code> by <a href="gtk-General.html#gtk-init">gtk_init()</a>. Modules may parse and remove
further options. The <a href="gtk-x11.html#x11-cmdline" title="X11-specific commandline options">X11</a> and
<a href="gtk-windows.html#win32-cmdline" title="Windows-specific commandline options">Windows</a> GDK backends parse
some additional commandline options.
</p>
<p><b><code class="systemitem">--gtk-module <em class="replaceable"><code>module</code></em></code>. </b>
A list of modules to load in addition to those specified in the
<code class="envar">GTK_MODULES</code> environment variable and the
<code class="literal">gtk-modules</code> setting.
</p>
<p><b><code class="systemitem">--g-fatal-warnings</code>. </b>
Make GTK+ abort on all warnings. This is useful to stop on the first
warning in a debugger, if your application is printing multiple
warnings. It's almost always best to start debugging with the first
warning that occurs.
</p>
<p><b><code class="systemitem">--gtk-debug <em class="replaceable"><code>options</code></em></code>. </b>
A list of <a href="gtk-running.html#GTK-Debug-Options">debug options</a>
to turn on in addition to those specified in the <code class="envar">GTK_DEBUG</code>
environment variable.
This option is only available if GTK+ has been configured with
<code class="option">--enable-debug=yes</code>.
</p>
<p><b><code class="systemitem">--gtk-no-debug <em class="replaceable"><code>options</code></em></code>. </b>
A list of <a href="gtk-running.html#GTK-Debug-Options">debug options</a>
to turn off.
This option is only available if GTK+ has been configured with
<code class="option">--enable-debug=yes</code>.
</p>
<p>
The following options are really used by GDK, not by GTK+, but we
list them here for completeness nevertheless.
</p>
<p><b><code class="systemitem">--class <em class="replaceable"><code>class</code></em></code>. </b>
Sets the program class; see <a
href="../gdk/gdk-General.html#gdk-set-program-class"
><code class="function">gdk_set_program_class</code>()</a>.
</p>
<p><b><code class="systemitem">--name <em class="replaceable"><code>name</code></em></code>. </b>
Sets the program name.
</p>
<p><b><code class="systemitem">--gdk-debug <em class="replaceable"><code>options</code></em></code>. </b>
A list of <a href="gtk-running.html#GDK-Debug-Options">debug options</a>
to turn on in addition to those
specified in the <code class="envar">GDK_DEBUG</code> environment variable.
This option is only available if GTK+ has been configured with
<code class="option">--enable-debug=yes</code>.
</p>
<p><b><code class="systemitem">--gdk-no-debug <em class="replaceable"><code>options</code></em></code>. </b>
A list of <a href="gtk-running.html#GDK-Debug-Options">debug options</a>
to turn off.
This option is only available if GTK+ has been configured with
<code class="option">--enable-debug=yes</code>.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2555452"></a><h3>Environment variables</h3>
<p>
GTK+ inspects a number of environment variables in addition to standard
variables like <code class="envar">LANG</code>, <code class="envar">PATH</code>, <code class="envar">HOME</code>
or <code class="envar">DISPLAY</code>; mostly to determine paths to look for certain
files. The <a href="gtk-x11.html#x11-envar" title="X11-specific environment variables">X11</a>,
<a href="gtk-windows.html#win32-envar" title="Windows-specific environment variables">Windows</a> and
<a href="gtk-framebuffer.html#fb-envar">Framebuffer</a> GDK backends use some
additional environment variables.
</p>
<p><a name="GTK-Debug-Options"></a><b><code class="envar">GTK_DEBUG</code>. </b>
If GTK+ has been configured with <code class="option">--enable-debug=yes</code>,
this variable can be set to a list of debug options, which cause GTK+
to print out different types of debugging information.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term">misc</span></td>
<td><p>Miscellaneous information</p></td>
</tr>
<tr>
<td>
<span class="term">plugsocket</span></td>
<td><p>Cross-process embedding</p></td>
</tr>
<tr>
<td>
<span class="term">text</span></td>
<td><p>Text widget internals</p></td>
</tr>
<tr>
<td>
<span class="term">tree</span></td>
<td><p>Tree widget internals</p></td>
</tr>
<tr>
<td>
<span class="term">updates</span></td>
<td><p>Visual feedback about window updates</p></td>
</tr>
<tr>
<td>
<span class="term">keybindings</span></td>
<td><p>Keybindings</p></td>
</tr>
<tr>
<td>
<span class="term">multihead</span></td>
<td><p>Working on multiple displays</p></td>
</tr>
<tr>
<td>
<span class="term">modules</span></td>
<td><p>Loading of modules</p></td>
</tr>
<tr>
<td>
<span class="term">geometry</span></td>
<td><p>Size allocation</p></td>
</tr>
<tr>
<td>
<span class="term">icontheme</span></td>
<td><p>Icon themes</p></td>
</tr>
<tr>
<td>
<span class="term">printing</span></td>
<td><p>Printing support</p></td>
</tr>
</tbody>
</table></div>
<p>
The special value <code class="literal">all</code> can be used to turn on all debug options.
</p>
<p><b><code class="envar">GTK_MODULES</code>. </b>
A list of modules to load.
</p>
<p><b><code class="envar">GTK_PATH</code>. </b>
Specifies a list of directories to search when GTK+ is looking for
dynamically loaded objects such as the modules specified by
<code class="envar">GTK_MODULES</code>, theme engines, and input method
modules. If the path to the dynamically loaded object is given
as an absolute path name, then GTK+ loads it directly. Otherwise,
GTK+ goes in turn through the directories in GTK_PATH, followed
by the directory <code class="filename">.gtk-2.0</code> in the user's home
directory, followed by the system default directory,
which is <code class="filename"><em class="replaceable"><code>libdir</code></em>/gtk-2.0/modules</code>.
(If <code class="envar">GTK_EXE_PREFIX</code> is defined, <em class="replaceable"><code>libdir</code></em> is
<code class="filename">$GTK_EXE_PREFIX/lib</code>. Otherwise it is the libdir
specified when GTK+ was configured, usually
<code class="filename">/usr/lib</code>, or
<code class="filename">/usr/local/lib</code>.)
For each directory in this list, GTK+ actually looks in a
subdirectory
<code class="filename"><em class="replaceable"><code>directory</code></em>/<em class="replaceable"><code>version</code></em>/<em class="replaceable"><code>host</code></em>/<em class="replaceable"><code>type</code></em></code>
Where <em class="replaceable"><code>version</code></em> is derived from the
version of GTK+ (use <code class="literal">pkg-config
--variable=gtk_binary_version gtk+-2.0</code> to determine this from a
script), <em class="replaceable"><code>host</code></em> is the architecture on
which GTK+ was built. (use <code class="literal">pkg-config
--variable=gtk_host gtk+-2.0</code> to determine this from a
script), and <em class="replaceable"><code>type</code></em> is a directory
specific to the type of modules; currently it can be
<code class="literal">modules</code>, <code class="literal">engines</code> or
<code class="literal">immodules</code> corresponding to the three types of
modules above. Either <em class="replaceable"><code>version</code></em>,
<em class="replaceable"><code>host</code></em>, or both may be omitted. GTK+ looks
first in the most specific directory, then in directories with
fewer components.
The components of GTK_PATH are separated by the ':' character on
Linux and Unix, and the ';' character on Windows.
</p>
<p><b><code class="envar">GTK_IM_MODULE</code>. </b>
Specifies an IM module to use in preference to the one determined
from the locale.
</p>
<p><a name="im-module-file"></a><b><code class="envar">GTK_IM_MODULE_FILE</code>. </b>
Specifies the file listing the IM modules to load. This environment
variable overrides the <code class="literal">im_module_file</code> specified in
the RC files, which in turn overrides the default value
<code class="filename"><em class="replaceable"><code>sysconfdir</code></em>/gtk-2.0/gtk.immodules</code>
(<em class="replaceable"><code>sysconfdir</code></em> is the sysconfdir specified when GTK+ was configured,
usually <code class="filename">/usr/local/etc</code>.)
</p>
<p><b><code class="envar">GTK2_RC_FILES</code>. </b>
Specifies a list of RC files to parse instead of the default ones;
see <a href="gtk-Resource-Files.html" title="Resource Files">Resource Files</a>.
</p>
<p><b><code class="envar">GTK_EXE_PREFIX</code>. </b>
If set, GTK+ uses <code class="filename">$GTK_EXE_PREFIX/lib</code> instead of
the libdir configured when GTK+ was compiled.
</p>
<p><b><code class="envar">GTK_DATA_PREFIX</code>. </b>
If set, makes GTK+ use <code class="filename">$GTK_DATA_PREFIX</code>
instead of the prefix configured when GTK+ was compiled.
</p>
<p>
The following environment variables are used by GdkPixbuf, GDK or
Pango, not by GTK+ itself, but we list them here for completeness
nevertheless.
</p>
<p><b><code class="envar">GDK_PIXBUF_MODULE_FILE</code>. </b>
Specifies the file listing the GdkPixbuf loader modules to load.
This environment variable overrides the default value
<code class="filename"><em class="replaceable"><code>sysconfdir</code></em>/gtk-2.0/gdk-pixbuf.loaders</code>
(<em class="replaceable"><code>sysconfdir</code></em> is the sysconfdir specified when
GTK+ was configured, usually <code class="filename">/usr/local/etc</code>.)
</p>
<p><a name="GDK-Debug-Options"></a><b><code class="envar">GDK_DEBUG</code>. </b>
If GTK+ has been configured with <code class="option">--enable-debug=yes</code>,
this variable can be set to a list of debug options, which cause GDK
to print out different types of debugging information.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term">misc</span></td>
<td><p>Miscellaneous information</p></td>
</tr>
<tr>
<td>
<span class="term">events</span></td>
<td><p>Show all events received by GDK</p></td>
</tr>
<tr>
<td>
<span class="term">dnd</span></td>
<td><p>Information about drag-and-drop</p></td>
</tr>
<tr>
<td>
<span class="term">xim</span></td>
<td><p>Information about XIM support</p></td>
</tr>
</tbody>
</table></div>
<p>
The special value <code class="literal">all</code> can be used to turn on all debug options.
</p>
<p><b><code class="envar">XDG_DATA_HOME</code>, <code class="envar">XDG_DATA_DIRS</code>. </b>
GTK+ uses these environment variables to locate icon themes
and MIME information. For more information, see
<a href="http://freedesktop.org/Standards/icon-theme-spec" target="_top">Icon Theme Specification</a>,
the <a href="http://freedesktop.org/Standards/shared-mime-info-spec" target="_top">Shared MIME-info Database</a>
and the <a href="http://freedesktop.org/Standards/basedir-spec" target="_top">Base Directory Specification</a>.
</p>
</div>
</div>
</div>
</body>
</html>