<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libgdamm: Gnome::Gda::Config Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.3 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">libgdamm <span id="projectnumber">4.1.3</span></div>
</td>
</tr>
</tbody>
</table>
</div>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="namespaceGnome.html">Gnome</a> </li>
<li class="navelem"><a class="el" href="namespaceGnome_1_1Gda.html">Gda</a> </li>
<li class="navelem"><a class="el" href="classGnome_1_1Gda_1_1Config.html">Config</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pub-static-methods">Static Public Member Functions</a> |
<a href="#pro-methods">Protected Member Functions</a> |
<a href="#related">Related Functions</a> </div>
<div class="headertitle">
<h1>Gnome::Gda::Config Class Reference</h1> </div>
</div>
<div class="contents">
<!-- doxytag: class="Gnome::Gda::Config" --><!-- doxytag: inherits="Glib::Object" -->
<p>Configuration — Access/Management of libgda configuration. <a href="#_details">More...</a></p>
<div class="dynheader">
Inheritance diagram for Gnome::Gda::Config:</div>
<div class="dyncontent">
<div class="center"><img src="classGnome_1_1Gda_1_1Config__inherit__graph.png" border="0" usemap="#Gnome_1_1Gda_1_1Config_inherit__map" alt="Inheritance graph"/></div>
<map name="Gnome_1_1Gda_1_1Config_inherit__map" id="Gnome_1_1Gda_1_1Config_inherit__map">
<area shape="rect" id="node2" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="31,166,121,197"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="16,86,136,117"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="23,6,129,37"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<div class="dynheader">
Collaboration diagram for Gnome::Gda::Config:</div>
<div class="dyncontent">
<div class="center"><img src="classGnome_1_1Gda_1_1Config__coll__graph.png" border="0" usemap="#Gnome_1_1Gda_1_1Config_coll__map" alt="Collaboration graph"/></div>
<map name="Gnome_1_1Gda_1_1Config_coll__map" id="Gnome_1_1Gda_1_1Config_coll__map">
<area shape="rect" id="node2" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="31,166,121,197"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="16,86,136,117"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="23,6,129,37"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classGnome_1_1Gda_1_1Config-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#aec7e5d21bf67b8cf4ee8bfd7e6d6f4b0">~Config</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GdaConfig* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#a8682ae1b8d6a33a6c89e04b893b191f4">gobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a8682ae1b8d6a33a6c89e04b893b191f4"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const GdaConfig* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#ad241d321edb90054bb6dfbe74574db10">gobj</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#ad241d321edb90054bb6dfbe74574db10"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GdaConfig* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#a14746d8d642a927b61ccdbe5293f72e9">gobj_copy</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. <a href="#a14746d8d642a927b61ccdbe5293f72e9"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>< void, <br class="typebreak"/>
GdaDsnInfo* > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#a29ebaa10aef1604551ffcf5d9790b414">signal_dsn_added</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>< void, <br class="typebreak"/>
GdaDsnInfo* > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#a55a690e6540928812c8b63fa03855a52">signal_dsn_changed</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>< void, <br class="typebreak"/>
GdaDsnInfo* > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#acc9b066345330c7010deec48ac7204e5">signal_dsn_removed</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>< void, <br class="typebreak"/>
GdaDsnInfo* > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#a356d69a8355f0ba7403ee9b6c7c1e56e">signal_dsn_to_be_removed</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><br class="typebreak"/>
< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#a7c40cda850d423eba6a048baf42a8fae">property_system_filename</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">File to use for system-wide DSN list. <a href="#a7c40cda850d423eba6a048baf42a8fae"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#ababc8dafafa0ee9a87de96d3623c386e">property_system_filename</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">File to use for system-wide DSN list. <a href="#ababc8dafafa0ee9a87de96d3623c386e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><br class="typebreak"/>
< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#a494c38331b22ce7ad264b5156e5451dd">property_user_filename</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">File to use for per-user DSN list. <a href="#a494c38331b22ce7ad264b5156e5451dd"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#ad7f3eff5c7a2c20abc221f4562772759">property_user_filename</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">File to use for per-user DSN list. <a href="#ad7f3eff5c7a2c20abc221f4562772759"></a><br/></td></tr>
<tr><td colspan="2"><h2><a name="pub-static-methods"></a>
Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1Config.html">Config</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#af56c2db8ac6e2b0505c93609c98da0cc">get</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get a pointer to the global GdaConfig object. <a href="#af56c2db8ac6e2b0505c93609c98da0cc"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static GdaDsnInfo* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#a739788847a2c0359653d02738902eac4">get_dsn_info</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& dsn_name)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get information about the DSN named <em>dsn_name</em>. <a href="#a739788847a2c0359653d02738902eac4"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#ac1961dc97c4ee0e623f84958b3ab6c9d">dsn_needs_authentication</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& dsn_name)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Tells if the data source identified as <em>dsn_name</em> needs any authentication. <a href="#ac1961dc97c4ee0e623f84958b3ab6c9d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#a2c9fed1bfcab0aab3402790b963bc169">list_dsn</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get a <a class="el" href="classGnome_1_1Gda_1_1DataModel.html" title="Abstract DataModel (Base class for all DataModels).">Gda::DataModel</a> representing all the configured DSN, and keeping itself up to date with the changes in the declared DSN. <a href="#a2c9fed1bfcab0aab3402790b963bc169"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/>
< <a class="el" href="classGnome_1_1Gda_1_1ServerProvider.html">ServerProvider</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#a22f64d4c99627cd52c5e2754efc0ba78">get_provider</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& provider_name)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get a pointer to the session-wide <a class="el" href="classGnome_1_1Gda_1_1ServerProvider.html" title="Base class for all the DBMS providers.">Gda::ServerProvider</a> for the provider named <em>provider_name</em>. <a href="#a22f64d4c99627cd52c5e2754efc0ba78"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#a51c09ed94f02042e338ebed0f0aeeacf">list_providers</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get a <a class="el" href="classGnome_1_1Gda_1_1DataModel.html" title="Abstract DataModel (Base class for all DataModels).">Gda::DataModel</a> representing all the installed database providers. <a href="#a51c09ed94f02042e338ebed0f0aeeacf"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#af9fc60671d82d812dd019d89fa807998">get_nb_dsn</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the number of defined DSN. <a href="#af9fc60671d82d812dd019d89fa807998"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#a6163f71eb9c906e3eee4bd11e06d2256">can_modify_system_config</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Tells if the global (system) configuration can be modified (considering system permissions and settings) <a href="#a6163f71eb9c906e3eee4bd11e06d2256"></a><br/></td></tr>
<tr><td colspan="2"><h2><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#ab630f9d613a7c246d7c22f9b7d9418cf">Config</a> ()</td></tr>
<tr><td colspan="2"><h2><a name="related"></a>
Related Functions</h2></td></tr>
<tr><td colspan="2">(Note that these are not member functions.) <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1Config.html">Gnome::Gda::Config</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Config.html#a9cc59aee36fd6f4f7e2e8a2fb2661993">wrap</a> (GdaConfig* object, bool take_copy=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a9cc59aee36fd6f4f7e2e8a2fb2661993"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>Configuration — Access/Management of libgda configuration. </p>
</div><hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="aec7e5d21bf67b8cf4ee8bfd7e6d6f4b0"></a><!-- doxytag: member="Gnome::Gda::Config::~Config" ref="aec7e5d21bf67b8cf4ee8bfd7e6d6f4b0" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual Gnome::Gda::Config::~Config </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="ab630f9d613a7c246d7c22f9b7d9418cf"></a><!-- doxytag: member="Gnome::Gda::Config::Config" ref="ab630f9d613a7c246d7c22f9b7d9418cf" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gnome::Gda::Config::Config </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a6163f71eb9c906e3eee4bd11e06d2256"></a><!-- doxytag: member="Gnome::Gda::Config::can_modify_system_config" ref="a6163f71eb9c906e3eee4bd11e06d2256" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool Gnome::Gda::Config::can_modify_system_config </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tells if the global (system) configuration can be modified (considering system permissions and settings) </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if system-wide configuration can be modified. </dd></dl>
</div>
</div>
<a class="anchor" id="ac1961dc97c4ee0e623f84958b3ab6c9d"></a><!-- doxytag: member="Gnome::Gda::Config::dsn_needs_authentication" ref="ac1961dc97c4ee0e623f84958b3ab6c9d" args="(const Glib::ustring &dsn_name)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool Gnome::Gda::Config::dsn_needs_authentication </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>dsn_name</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tells if the data source identified as <em>dsn_name</em> needs any authentication. </p>
<p>If a <username> and optionally a <password> are specified, they are ignored. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">dsn_name</td><td>The name of a DSN, in the "[<username>[:<password>]@]<DSN>" format. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if an authentication is needed. </dd></dl>
</div>
</div>
<a class="anchor" id="af56c2db8ac6e2b0505c93609c98da0cc"></a><!-- doxytag: member="Gnome::Gda::Config::get" ref="af56c2db8ac6e2b0505c93609c98da0cc" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGnome_1_1Gda_1_1Config.html">Config</a>> Gnome::Gda::Config::get </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get a pointer to the global GdaConfig object. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A non <code>0</code> pointer to a <a class="el" href="classGnome_1_1Gda_1_1Config.html" title="Configuration — Access/Management of libgda configuration.">Gda::Config</a>. </dd></dl>
</div>
</div>
<a class="anchor" id="a739788847a2c0359653d02738902eac4"></a><!-- doxytag: member="Gnome::Gda::Config::get_dsn_info" ref="a739788847a2c0359653d02738902eac4" args="(const Glib::ustring &dsn_name)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static GdaDsnInfo* Gnome::Gda::Config::get_dsn_info </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>dsn_name</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get information about the DSN named <em>dsn_name</em>. </p>
<p><em>dsn_name's</em> format is "[<username>[:<password>]@]<DSN>" (if <username> and optionally <password> are provided, they are ignored). Also see the gda_dsn_split() utility function. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">dsn_name</td><td>The name of the DSN to look for. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A pointer to read-only Gda::DsnInfo structure, or <code>0</code> if not found. </dd></dl>
</div>
</div>
<a class="anchor" id="af9fc60671d82d812dd019d89fa807998"></a><!-- doxytag: member="Gnome::Gda::Config::get_nb_dsn" ref="af9fc60671d82d812dd019d89fa807998" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static int Gnome::Gda::Config::get_nb_dsn </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the number of defined DSN. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The number of defined DSN. </dd></dl>
</div>
</div>
<a class="anchor" id="a22f64d4c99627cd52c5e2754efc0ba78"></a><!-- doxytag: member="Gnome::Gda::Config::get_provider" ref="a22f64d4c99627cd52c5e2754efc0ba78" args="(const Glib::ustring &provider_name)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGnome_1_1Gda_1_1ServerProvider.html">ServerProvider</a>> Gnome::Gda::Config::get_provider </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>provider_name</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get a pointer to the session-wide <a class="el" href="classGnome_1_1Gda_1_1ServerProvider.html" title="Base class for all the DBMS providers.">Gda::ServerProvider</a> for the provider named <em>provider_name</em>. </p>
<p>The caller must not call Glib::object_unref() on the returned object.</p>
<p>This method may fail with a Gda::CONFIG_ERROR domain error (see the <a class="el" href="classGnome_1_1Gda_1_1ConfigError.html">Gda::ConfigError</a> error codes). </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">provider_name</td><td>A database provider. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A pointer to the <a class="el" href="classGnome_1_1Gda_1_1ServerProvider.html" title="Base class for all the DBMS providers.">Gda::ServerProvider</a>, or <code>0</code> if an error occurred. </dd></dl>
</div>
</div>
<a class="anchor" id="ad241d321edb90054bb6dfbe74574db10"></a><!-- doxytag: member="Gnome::Gda::Config::gobj" ref="ad241d321edb90054bb6dfbe74574db10" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const GdaConfig* Gnome::Gda::Config::gobj </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C GObject. </p>
<p>Reimplemented from <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a778a94181132976bbfb0519793f3b32e">Glib::ObjectBase</a>.</p>
</div>
</div>
<a class="anchor" id="a8682ae1b8d6a33a6c89e04b893b191f4"></a><!-- doxytag: member="Gnome::Gda::Config::gobj" ref="a8682ae1b8d6a33a6c89e04b893b191f4" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GdaConfig* Gnome::Gda::Config::gobj </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C GObject. </p>
<p>Reimplemented from <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a4c6efc18be8cb9c56e58fc0bd20fafbe">Glib::ObjectBase</a>.</p>
</div>
</div>
<a class="anchor" id="a14746d8d642a927b61ccdbe5293f72e9"></a><!-- doxytag: member="Gnome::Gda::Config::gobj_copy" ref="a14746d8d642a927b61ccdbe5293f72e9" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GdaConfig* Gnome::Gda::Config::gobj_copy </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. </p>
</div>
</div>
<a class="anchor" id="a2c9fed1bfcab0aab3402790b963bc169"></a><!-- doxytag: member="Gnome::Gda::Config::list_dsn" ref="a2c9fed1bfcab0aab3402790b963bc169" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a>> Gnome::Gda::Config::list_dsn </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get a <a class="el" href="classGnome_1_1Gda_1_1DataModel.html" title="Abstract DataModel (Base class for all DataModels).">Gda::DataModel</a> representing all the configured DSN, and keeping itself up to date with the changes in the declared DSN. </p>
<p>The returned data model is composed of the following columns: <itemizedlist> <listitem>DSN name</listitem> <listitem>Provider name</listitem> <listitem>Description</listitem> <listitem><a class="el" href="classGnome_1_1Gda_1_1Connection.html" title="Manages a connection to a data source.">Connection</a> string</listitem> <listitem>Username if it exists</listitem> </itemizedlist> </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classGnome_1_1Gda_1_1DataModel.html" title="Abstract DataModel (Base class for all DataModels).">Gda::DataModel</a>. </dd></dl>
</div>
</div>
<a class="anchor" id="a51c09ed94f02042e338ebed0f0aeeacf"></a><!-- doxytag: member="Gnome::Gda::Config::list_providers" ref="a51c09ed94f02042e338ebed0f0aeeacf" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a>> Gnome::Gda::Config::list_providers </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get a <a class="el" href="classGnome_1_1Gda_1_1DataModel.html" title="Abstract DataModel (Base class for all DataModels).">Gda::DataModel</a> representing all the installed database providers. </p>
<p>The returned data model is composed of the following columns: <itemizedlist> <listitem>Provider name</listitem> <listitem>Description</listitem> <listitem>DSN parameters</listitem> <listitem>Authentication parameters</listitem> <listitem>File name of the plugin</listitem> </itemizedlist> </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classGnome_1_1Gda_1_1DataModel.html" title="Abstract DataModel (Base class for all DataModels).">Gda::DataModel</a>. </dd></dl>
</div>
</div>
<a class="anchor" id="a7c40cda850d423eba6a048baf42a8fae"></a><!-- doxytag: member="Gnome::Gda::Config::property_system_filename" ref="a7c40cda850d423eba6a048baf42a8fae" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>> Gnome::Gda::Config::property_system_filename </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>File to use for system-wide DSN list. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="ababc8dafafa0ee9a87de96d3623c386e"></a><!-- doxytag: member="Gnome::Gda::Config::property_system_filename" ref="ababc8dafafa0ee9a87de96d3623c386e" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>> Gnome::Gda::Config::property_system_filename </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>File to use for system-wide DSN list. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="ad7f3eff5c7a2c20abc221f4562772759"></a><!-- doxytag: member="Gnome::Gda::Config::property_user_filename" ref="ad7f3eff5c7a2c20abc221f4562772759" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>> Gnome::Gda::Config::property_user_filename </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>File to use for per-user DSN list. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a494c38331b22ce7ad264b5156e5451dd"></a><!-- doxytag: member="Gnome::Gda::Config::property_user_filename" ref="a494c38331b22ce7ad264b5156e5451dd" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>> Gnome::Gda::Config::property_user_filename </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>File to use for per-user DSN list. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a29ebaa10aef1604551ffcf5d9790b414"></a><!-- doxytag: member="Gnome::Gda::Config::signal_dsn_added" ref="a29ebaa10aef1604551ffcf5d9790b414" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>< void,GdaDsnInfo* > Gnome::Gda::Config::signal_dsn_added </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_dsn_added(GdaDsnInfo* info)</code> </dd></dl>
</div>
</div>
<a class="anchor" id="a55a690e6540928812c8b63fa03855a52"></a><!-- doxytag: member="Gnome::Gda::Config::signal_dsn_changed" ref="a55a690e6540928812c8b63fa03855a52" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>< void,GdaDsnInfo* > Gnome::Gda::Config::signal_dsn_changed </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_dsn_changed(GdaDsnInfo* info)</code> </dd></dl>
</div>
</div>
<a class="anchor" id="acc9b066345330c7010deec48ac7204e5"></a><!-- doxytag: member="Gnome::Gda::Config::signal_dsn_removed" ref="acc9b066345330c7010deec48ac7204e5" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>< void,GdaDsnInfo* > Gnome::Gda::Config::signal_dsn_removed </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_dsn_removed(GdaDsnInfo* info)</code> </dd></dl>
</div>
</div>
<a class="anchor" id="a356d69a8355f0ba7403ee9b6c7c1e56e"></a><!-- doxytag: member="Gnome::Gda::Config::signal_dsn_to_be_removed" ref="a356d69a8355f0ba7403ee9b6c7c1e56e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>< void,GdaDsnInfo* > Gnome::Gda::Config::signal_dsn_to_be_removed </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_dsn_to_be_removed(GdaDsnInfo* info)</code> </dd></dl>
</div>
</div>
<hr/><h2>Friends And Related Function Documentation</h2>
<a class="anchor" id="a9cc59aee36fd6f4f7e2e8a2fb2661993"></a><!-- doxytag: member="Gnome::Gda::Config::wrap" ref="a9cc59aee36fd6f4f7e2e8a2fb2661993" args="(GdaConfig *object, bool take_copy=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1Config.html">Gnome::Gda::Config</a> > wrap </td>
<td>(</td>
<td class="paramtype">GdaConfig * </td>
<td class="paramname"><em>object</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>take_copy</em> = <code>false</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [related]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">object</td><td>The C instance. </td></tr>
<tr><td class="paramname">take_copy</td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li>libgdamm/config.h</li>
</ul>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Thu Sep 22 2011 11:20:02 for libgdamm by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address>
</body>
</html>
