| Current File : //usr/share/doc/dbus/api/dbus-errors_8c_source.html |
<!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"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>D-Bus: dbus-errors.c Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">D-Bus
 <span id="projectnumber">1.8.20</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- Generated by Doxygen 1.7.6.1 -->
<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="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="files.html"><span>File List</span></a></li>
</ul>
</div>
</div>
<div class="header">
<div class="headertitle">
<div class="title">dbus-errors.c</div> </div>
</div><!--header-->
<div class="contents">
<div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */</span>
<a name="l00002"></a>00002 <span class="comment">/* dbus-errors.c Error reporting</span>
<a name="l00003"></a>00003 <span class="comment"> *</span>
<a name="l00004"></a>00004 <span class="comment"> * Copyright (C) 2002, 2004 Red Hat Inc.</span>
<a name="l00005"></a>00005 <span class="comment"> * Copyright (C) 2003 CodeFactory AB</span>
<a name="l00006"></a>00006 <span class="comment"> *</span>
<a name="l00007"></a>00007 <span class="comment"> * Licensed under the Academic Free License version 2.1</span>
<a name="l00008"></a>00008 <span class="comment"> * </span>
<a name="l00009"></a>00009 <span class="comment"> * This program is free software; you can redistribute it and/or modify</span>
<a name="l00010"></a>00010 <span class="comment"> * it under the terms of the GNU General Public License as published by</span>
<a name="l00011"></a>00011 <span class="comment"> * the Free Software Foundation; either version 2 of the License, or</span>
<a name="l00012"></a>00012 <span class="comment"> * (at your option) any later version.</span>
<a name="l00013"></a>00013 <span class="comment"> *</span>
<a name="l00014"></a>00014 <span class="comment"> * This program is distributed in the hope that it will be useful,</span>
<a name="l00015"></a>00015 <span class="comment"> * but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00016"></a>00016 <span class="comment"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the</span>
<a name="l00017"></a>00017 <span class="comment"> * GNU General Public License for more details.</span>
<a name="l00018"></a>00018 <span class="comment"> * </span>
<a name="l00019"></a>00019 <span class="comment"> * You should have received a copy of the GNU General Public License</span>
<a name="l00020"></a>00020 <span class="comment"> * along with this program; if not, write to the Free Software</span>
<a name="l00021"></a>00021 <span class="comment"> * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA</span>
<a name="l00022"></a>00022 <span class="comment"> *</span>
<a name="l00023"></a>00023 <span class="comment"> */</span>
<a name="l00024"></a>00024
<a name="l00025"></a>00025 <span class="preprocessor">#include <config.h></span>
<a name="l00026"></a>00026 <span class="preprocessor">#include "dbus-errors.h"</span>
<a name="l00027"></a>00027 <span class="preprocessor">#include "dbus-internals.h"</span>
<a name="l00028"></a>00028 <span class="preprocessor">#include "dbus-string.h"</span>
<a name="l00029"></a>00029 <span class="preprocessor">#include "dbus-protocol.h"</span>
<a name="l00030"></a>00030 <span class="preprocessor">#include <stdarg.h></span>
<a name="l00031"></a>00031 <span class="preprocessor">#include <string.h></span>
<a name="l00032"></a>00032
<a name="l00065"></a><a class="code" href="structDBusRealError.html">00065</a> <span class="keyword">typedef</span> <span class="keyword">struct</span>
<a name="l00066"></a>00066 {
<a name="l00067"></a><a class="code" href="structDBusRealError.html#a269069d5d2fc0f33deced317cb435de9">00067</a> <span class="keywordtype">char</span> *<a class="code" href="structDBusRealError.html#a269069d5d2fc0f33deced317cb435de9" title="error name">name</a>;
<a name="l00068"></a><a class="code" href="structDBusRealError.html#afd09fc7ff565b5f3b410ee1ce985172b">00068</a> <span class="keywordtype">char</span> *<a class="code" href="structDBusRealError.html#afd09fc7ff565b5f3b410ee1ce985172b" title="error message">message</a>;
<a name="l00070"></a><a class="code" href="structDBusRealError.html#a3e95ec02e0320fe0bfccf24fb4b8db8a">00070</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> const_message : 1;
<a name="l00072"></a><a class="code" href="structDBusRealError.html#a1b4f15b6d9a85a37f3ab9e95fff179e1">00072</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> dummy2 : 1;
<a name="l00073"></a><a class="code" href="structDBusRealError.html#a72b752e63b30144ece9dc9a072d58995">00073</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> dummy3 : 1;
<a name="l00074"></a><a class="code" href="structDBusRealError.html#a67d03b32ec168e2676a886dc260a08fa">00074</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> dummy4 : 1;
<a name="l00075"></a><a class="code" href="structDBusRealError.html#a5beec0e4c6f956795eebe49593878f31">00075</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> dummy5 : 1;
<a name="l00077"></a><a class="code" href="structDBusRealError.html#aa0aaa5baa7ae43bb669e9b36ffd4a246">00077</a> <span class="keywordtype">void</span> *<a class="code" href="structDBusRealError.html#aa0aaa5baa7ae43bb669e9b36ffd4a246" title="placeholder">padding1</a>;
<a name="l00079"></a>00079 } <a class="code" href="structDBusRealError.html" title="Internals of DBusError.">DBusRealError</a>;
<a name="l00080"></a>00080
<a name="l00081"></a>00081 _DBUS_STATIC_ASSERT (<span class="keyword">sizeof</span> (<a class="code" href="structDBusRealError.html" title="Internals of DBusError.">DBusRealError</a>) == <span class="keyword">sizeof</span> (<a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a>));
<a name="l00082"></a>00082
<a name="l00091"></a>00091 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span>*
<a name="l00092"></a>00092 message_from_error (<span class="keyword">const</span> <span class="keywordtype">char</span> *error)
<a name="l00093"></a>00093 {
<a name="l00094"></a>00094 <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#gabb62fd6340d0787fbd56ff8dd2f326c7" title="A generic error; "something went wrong" - see the error message for more.">DBUS_ERROR_FAILED</a>) == 0)
<a name="l00095"></a>00095 <span class="keywordflow">return</span> <span class="stringliteral">"Unknown error"</span>;
<a name="l00096"></a>00096 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>) == 0)
<a name="l00097"></a>00097 <span class="keywordflow">return</span> <span class="stringliteral">"Not enough memory available"</span>;
<a name="l00098"></a>00098 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#ga445d7ad73da94c796ef441df2dcc3cc8" title="Something went wrong reading or writing to a socket, for example.">DBUS_ERROR_IO_ERROR</a>) == 0)
<a name="l00099"></a>00099 <span class="keywordflow">return</span> <span class="stringliteral">"Error reading or writing data"</span>;
<a name="l00100"></a>00100 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#ga3fa04eb600edda4afc2dd9fe2e0f8b02" title="A D-Bus bus address was malformed.">DBUS_ERROR_BAD_ADDRESS</a>) == 0)
<a name="l00101"></a>00101 <span class="keywordflow">return</span> <span class="stringliteral">"Could not parse address"</span>;
<a name="l00102"></a>00102 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#ga33122bcaf8f5896ec222c755b6effb40" title="Requested operation isn't supported (like ENOSYS on UNIX).">DBUS_ERROR_NOT_SUPPORTED</a>) == 0)
<a name="l00103"></a>00103 <span class="keywordflow">return</span> <span class="stringliteral">"Feature not supported"</span>;
<a name="l00104"></a>00104 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#ga7c96d165c4ebee51e939969934d18027" title="Some limited resource is exhausted.">DBUS_ERROR_LIMITS_EXCEEDED</a>) == 0)
<a name="l00105"></a>00105 <span class="keywordflow">return</span> <span class="stringliteral">"Resource limits exceeded"</span>;
<a name="l00106"></a>00106 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#ga6d3940075c1fbd1bfe06626b59723a16" title="Security restrictions don't allow doing what you're trying to do.">DBUS_ERROR_ACCESS_DENIED</a>) == 0)
<a name="l00107"></a>00107 <span class="keywordflow">return</span> <span class="stringliteral">"Permission denied"</span>;
<a name="l00108"></a>00108 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#ga5a03c8e0e98131ee2a03d46d72c6ab49" title="Authentication didn't work.">DBUS_ERROR_AUTH_FAILED</a>) == 0)
<a name="l00109"></a>00109 <span class="keywordflow">return</span> <span class="stringliteral">"Could not authenticate to server"</span>;
<a name="l00110"></a>00110 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#ga72b375fab2486ee165e1cca2bd145695" title="Unable to connect to server (probably caused by ECONNREFUSED on a socket).">DBUS_ERROR_NO_SERVER</a>) == 0)
<a name="l00111"></a>00111 <span class="keywordflow">return</span> <span class="stringliteral">"No server available at address"</span>;
<a name="l00112"></a>00112 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#ga0e4674c42373ee449ddf08aab8bce9ce" title="Certain timeout errors, possibly ETIMEDOUT on a socket.">DBUS_ERROR_TIMEOUT</a>) == 0)
<a name="l00113"></a>00113 <span class="keywordflow">return</span> <span class="stringliteral">"Connection timed out"</span>;
<a name="l00114"></a>00114 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#gab18c0e4eee0936dc042319803730b62e" title="No network access (probably ENETUNREACH on a socket).">DBUS_ERROR_NO_NETWORK</a>) == 0)
<a name="l00115"></a>00115 <span class="keywordflow">return</span> <span class="stringliteral">"Network unavailable"</span>;
<a name="l00116"></a>00116 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#ga3d13424a19bb774cf3481216bf4ba366" title="Can't bind a socket since its address is in use (i.e.">DBUS_ERROR_ADDRESS_IN_USE</a>) == 0)
<a name="l00117"></a>00117 <span class="keywordflow">return</span> <span class="stringliteral">"Address already in use"</span>;
<a name="l00118"></a>00118 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#gaef6443e0bd8cdcc1606d985a775d07a7" title="The connection is disconnected and you're trying to use it.">DBUS_ERROR_DISCONNECTED</a>) == 0)
<a name="l00119"></a>00119 <span class="keywordflow">return</span> <span class="stringliteral">"Disconnected."</span>;
<a name="l00120"></a>00120 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#gacf5321b161193ad66d5bdf5c910a9792" title="Invalid arguments passed to a method call.">DBUS_ERROR_INVALID_ARGS</a>) == 0)
<a name="l00121"></a>00121 <span class="keywordflow">return</span> <span class="stringliteral">"Invalid arguments."</span>;
<a name="l00122"></a>00122 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#gade2cb1c5a6adf47af18672865f233b6d" title="No reply to a message expecting one, usually means a timeout occurred.">DBUS_ERROR_NO_REPLY</a>) == 0)
<a name="l00123"></a>00123 <span class="keywordflow">return</span> <span class="stringliteral">"Did not get a reply message."</span>;
<a name="l00124"></a>00124 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#gaf5ad9572cc5935d4655635003073c21a" title="Missing file.">DBUS_ERROR_FILE_NOT_FOUND</a>) == 0)
<a name="l00125"></a>00125 <span class="keywordflow">return</span> <span class="stringliteral">"File doesn't exist."</span>;
<a name="l00126"></a>00126 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcmp (error, <a class="code" href="group__DBusProtocol.html#ga6a4358a62f0cd68d637532772475e576" title="There's already an object with the requested object path.">DBUS_ERROR_OBJECT_PATH_IN_USE</a>) == 0)
<a name="l00127"></a>00127 <span class="keywordflow">return</span> <span class="stringliteral">"Object path already in use"</span>;
<a name="l00128"></a>00128 <span class="keywordflow">else</span>
<a name="l00129"></a>00129 <span class="keywordflow">return</span> error;
<a name="l00130"></a>00130 }
<a name="l00131"></a>00131 <span class="comment">/* End of internals */</span>
<a name="l00133"></a>00133
<a name="l00187"></a>00187 <span class="keywordtype">void</span>
<a name="l00188"></a><a class="code" href="group__DBusErrors.html#ga8937f0b7cdf8554fa6305158ce453fbe">00188</a> <a class="code" href="group__DBusErrors.html#ga8937f0b7cdf8554fa6305158ce453fbe" title="Initializes a DBusError structure.">dbus_error_init</a> (<a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a> *error)
<a name="l00189"></a>00189 {
<a name="l00190"></a>00190 <a class="code" href="structDBusRealError.html" title="Internals of DBusError.">DBusRealError</a> *real;
<a name="l00191"></a>00191
<a name="l00192"></a>00192 _dbus_return_if_fail (error != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00193"></a>00193
<a name="l00194"></a>00194 _dbus_assert (<span class="keyword">sizeof</span> (<a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a>) == <span class="keyword">sizeof</span> (<a class="code" href="structDBusRealError.html" title="Internals of DBusError.">DBusRealError</a>));
<a name="l00195"></a>00195
<a name="l00196"></a>00196 real = (<a class="code" href="structDBusRealError.html" title="Internals of DBusError.">DBusRealError</a> *)error;
<a name="l00197"></a>00197
<a name="l00198"></a>00198 real-><a class="code" href="structDBusRealError.html#a269069d5d2fc0f33deced317cb435de9" title="error name">name</a> = <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00199"></a>00199 real-><a class="code" href="structDBusRealError.html#afd09fc7ff565b5f3b410ee1ce985172b" title="error message">message</a> = <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00200"></a>00200
<a name="l00201"></a>00201 real-><a class="code" href="structDBusRealError.html#a3e95ec02e0320fe0bfccf24fb4b8db8a" title="Message is not owned by DBusError.">const_message</a> = <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to "1".">TRUE</a>;
<a name="l00202"></a>00202 }
<a name="l00203"></a>00203
<a name="l00210"></a>00210 <span class="keywordtype">void</span>
<a name="l00211"></a><a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568">00211</a> <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that's been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (<a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a> *error)
<a name="l00212"></a>00212 {
<a name="l00213"></a>00213 <a class="code" href="structDBusRealError.html" title="Internals of DBusError.">DBusRealError</a> *real;
<a name="l00214"></a>00214
<a name="l00215"></a>00215 _dbus_return_if_fail (error != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00216"></a>00216
<a name="l00217"></a>00217 real = (<a class="code" href="structDBusRealError.html" title="Internals of DBusError.">DBusRealError</a> *)error;
<a name="l00218"></a>00218
<a name="l00219"></a>00219 <span class="keywordflow">if</span> (!real-><a class="code" href="structDBusRealError.html#a3e95ec02e0320fe0bfccf24fb4b8db8a" title="Message is not owned by DBusError.">const_message</a>)
<a name="l00220"></a>00220 {
<a name="l00221"></a>00221 <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (real-><a class="code" href="structDBusRealError.html#a269069d5d2fc0f33deced317cb435de9" title="error name">name</a>);
<a name="l00222"></a>00222 <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (real-><a class="code" href="structDBusRealError.html#afd09fc7ff565b5f3b410ee1ce985172b" title="error message">message</a>);
<a name="l00223"></a>00223 }
<a name="l00224"></a>00224
<a name="l00225"></a>00225 <a class="code" href="group__DBusErrors.html#ga8937f0b7cdf8554fa6305158ce453fbe" title="Initializes a DBusError structure.">dbus_error_init</a> (error);
<a name="l00226"></a>00226 }
<a name="l00227"></a>00227
<a name="l00242"></a>00242 <span class="keywordtype">void</span>
<a name="l00243"></a><a class="code" href="group__DBusErrors.html#ga3cc15cc37bcd3aaca87aa4d791c124f5">00243</a> <a class="code" href="group__DBusErrors.html#ga3cc15cc37bcd3aaca87aa4d791c124f5" title="Assigns an error name and message to a DBusError.">dbus_set_error_const</a> (<a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a> *error,
<a name="l00244"></a>00244 <span class="keyword">const</span> <span class="keywordtype">char</span> *name,
<a name="l00245"></a>00245 <span class="keyword">const</span> <span class="keywordtype">char</span> *message)
<a name="l00246"></a>00246 {
<a name="l00247"></a>00247 <a class="code" href="structDBusRealError.html" title="Internals of DBusError.">DBusRealError</a> *real;
<a name="l00248"></a>00248
<a name="l00249"></a>00249 _dbus_return_if_error_is_set (error);
<a name="l00250"></a>00250 _dbus_return_if_fail (name != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00251"></a>00251
<a name="l00252"></a>00252 <span class="keywordflow">if</span> (error == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00253"></a>00253 <span class="keywordflow">return</span>;
<a name="l00254"></a>00254
<a name="l00255"></a>00255 _dbus_assert (error-><a class="code" href="structDBusError.html#a09a9614ff07fdf3ef163b232ff934581" title="public error name field">name</a> == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00256"></a>00256 _dbus_assert (error-><a class="code" href="structDBusError.html#afb559175326de5b6b340e26204e92d72" title="public error message field">message</a> == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00257"></a>00257
<a name="l00258"></a>00258 <span class="keywordflow">if</span> (message == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00259"></a>00259 message = message_from_error (name);
<a name="l00260"></a>00260
<a name="l00261"></a>00261 real = (<a class="code" href="structDBusRealError.html" title="Internals of DBusError.">DBusRealError</a> *)error;
<a name="l00262"></a>00262
<a name="l00263"></a>00263 real-><a class="code" href="structDBusRealError.html#a269069d5d2fc0f33deced317cb435de9" title="error name">name</a> = (<span class="keywordtype">char</span>*) name;
<a name="l00264"></a>00264 real-><a class="code" href="structDBusRealError.html#afd09fc7ff565b5f3b410ee1ce985172b" title="error message">message</a> = (<span class="keywordtype">char</span> *)message;
<a name="l00265"></a>00265 real-><a class="code" href="structDBusRealError.html#a3e95ec02e0320fe0bfccf24fb4b8db8a" title="Message is not owned by DBusError.">const_message</a> = <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to "1".">TRUE</a>;
<a name="l00266"></a>00266 }
<a name="l00267"></a>00267
<a name="l00278"></a>00278 <span class="keywordtype">void</span>
<a name="l00279"></a><a class="code" href="group__DBusErrors.html#ga0a27fb9f1af0c2bfd105d7e8622b93f4">00279</a> <a class="code" href="group__DBusErrors.html#ga0a27fb9f1af0c2bfd105d7e8622b93f4" title="Moves an error src into dest, freeing src and overwriting dest.">dbus_move_error</a> (<a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a> *src,
<a name="l00280"></a>00280 <a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a> *dest)
<a name="l00281"></a>00281 {
<a name="l00282"></a>00282 _dbus_return_if_error_is_set (dest);
<a name="l00283"></a>00283
<a name="l00284"></a>00284 <span class="keywordflow">if</span> (dest)
<a name="l00285"></a>00285 {
<a name="l00286"></a>00286 <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that's been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (dest);
<a name="l00287"></a>00287 *dest = *src;
<a name="l00288"></a>00288 <a class="code" href="group__DBusErrors.html#ga8937f0b7cdf8554fa6305158ce453fbe" title="Initializes a DBusError structure.">dbus_error_init</a> (src);
<a name="l00289"></a>00289 }
<a name="l00290"></a>00290 <span class="keywordflow">else</span>
<a name="l00291"></a>00291 <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that's been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (src);
<a name="l00292"></a>00292 }
<a name="l00293"></a>00293
<a name="l00301"></a>00301 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00302"></a><a class="code" href="group__DBusErrors.html#ga48515c580199514026542fe053ef1887">00302</a> <a class="code" href="group__DBusErrors.html#ga48515c580199514026542fe053ef1887" title="Checks whether the error is set and has the given name.">dbus_error_has_name</a> (<span class="keyword">const</span> <a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a> *error,
<a name="l00303"></a>00303 <span class="keyword">const</span> <span class="keywordtype">char</span> *name)
<a name="l00304"></a>00304 {
<a name="l00305"></a>00305 _dbus_return_val_if_fail (error != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>, <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to "0".">FALSE</a>);
<a name="l00306"></a>00306 _dbus_return_val_if_fail (name != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>, <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to "0".">FALSE</a>);
<a name="l00307"></a>00307
<a name="l00308"></a>00308 _dbus_assert ((error-><a class="code" href="structDBusError.html#a09a9614ff07fdf3ef163b232ff934581" title="public error name field">name</a> != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a> && error-><a class="code" href="structDBusError.html#afb559175326de5b6b340e26204e92d72" title="public error message field">message</a> != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>) ||
<a name="l00309"></a>00309 (error-><a class="code" href="structDBusError.html#a09a9614ff07fdf3ef163b232ff934581" title="public error name field">name</a> == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a> && error-><a class="code" href="structDBusError.html#afb559175326de5b6b340e26204e92d72" title="public error message field">message</a> == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>));
<a name="l00310"></a>00310
<a name="l00311"></a>00311 <span class="keywordflow">if</span> (error-><a class="code" href="structDBusError.html#a09a9614ff07fdf3ef163b232ff934581" title="public error name field">name</a> != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00312"></a>00312 {
<a name="l00313"></a>00313 <a class="code" href="structDBusString.html">DBusString</a> str1, str2;
<a name="l00314"></a>00314 <a class="code" href="group__DBusString.html#ga374640ddfa2f0b27a8356e2379ba8043" title="Initializes a constant string.">_dbus_string_init_const</a> (&str1, error-><a class="code" href="structDBusError.html#a09a9614ff07fdf3ef163b232ff934581" title="public error name field">name</a>);
<a name="l00315"></a>00315 <a class="code" href="group__DBusString.html#ga374640ddfa2f0b27a8356e2379ba8043" title="Initializes a constant string.">_dbus_string_init_const</a> (&str2, name);
<a name="l00316"></a>00316 <span class="keywordflow">return</span> <a class="code" href="group__DBusString.html#gad79c34af55b58f0e8b81ecf11b8694bb" title="Tests two DBusString for equality.">_dbus_string_equal</a> (&str1, &str2);
<a name="l00317"></a>00317 }
<a name="l00318"></a>00318 <span class="keywordflow">else</span>
<a name="l00319"></a>00319 <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to "0".">FALSE</a>;
<a name="l00320"></a>00320 }
<a name="l00321"></a>00321
<a name="l00328"></a>00328 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00329"></a><a class="code" href="group__DBusErrors.html#gab0ed62e9fc2685897eb2d41467c89405">00329</a> <a class="code" href="group__DBusErrors.html#gab0ed62e9fc2685897eb2d41467c89405" title="Checks whether an error occurred (the error is set).">dbus_error_is_set</a> (<span class="keyword">const</span> <a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a> *error)
<a name="l00330"></a>00330 {
<a name="l00331"></a>00331 _dbus_return_val_if_fail (error != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>, <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to "0".">FALSE</a>);
<a name="l00332"></a>00332 _dbus_assert ((error-><a class="code" href="structDBusError.html#a09a9614ff07fdf3ef163b232ff934581" title="public error name field">name</a> != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a> && error-><a class="code" href="structDBusError.html#afb559175326de5b6b340e26204e92d72" title="public error message field">message</a> != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>) ||
<a name="l00333"></a>00333 (error-><a class="code" href="structDBusError.html#a09a9614ff07fdf3ef163b232ff934581" title="public error name field">name</a> == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a> && error-><a class="code" href="structDBusError.html#afb559175326de5b6b340e26204e92d72" title="public error message field">message</a> == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>));
<a name="l00334"></a>00334 <span class="keywordflow">return</span> error-><a class="code" href="structDBusError.html#a09a9614ff07fdf3ef163b232ff934581" title="public error name field">name</a> != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00335"></a>00335 }
<a name="l00336"></a>00336
<a name="l00353"></a>00353 <span class="keywordtype">void</span>
<a name="l00354"></a><a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3">00354</a> <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (<a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a> *error,
<a name="l00355"></a>00355 <span class="keyword">const</span> <span class="keywordtype">char</span> *name,
<a name="l00356"></a>00356 <span class="keyword">const</span> <span class="keywordtype">char</span> *format,
<a name="l00357"></a>00357 ...)
<a name="l00358"></a>00358 {
<a name="l00359"></a>00359 <a class="code" href="structDBusRealError.html" title="Internals of DBusError.">DBusRealError</a> *real;
<a name="l00360"></a>00360 <a class="code" href="structDBusString.html">DBusString</a> str;
<a name="l00361"></a>00361 va_list args;
<a name="l00362"></a>00362
<a name="l00363"></a>00363 <span class="keywordflow">if</span> (error == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00364"></a>00364 <span class="keywordflow">return</span>;
<a name="l00365"></a>00365
<a name="l00366"></a>00366 <span class="comment">/* it's a bug to pile up errors */</span>
<a name="l00367"></a>00367 _dbus_return_if_error_is_set (error);
<a name="l00368"></a>00368 _dbus_return_if_fail (name != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00369"></a>00369
<a name="l00370"></a>00370 _dbus_assert (error-><a class="code" href="structDBusError.html#a09a9614ff07fdf3ef163b232ff934581" title="public error name field">name</a> == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00371"></a>00371 _dbus_assert (error-><a class="code" href="structDBusError.html#afb559175326de5b6b340e26204e92d72" title="public error message field">message</a> == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00372"></a>00372
<a name="l00373"></a>00373 <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#ga348252317f7bb8ac43529972945830ae" title="Initializes a string.">_dbus_string_init</a> (&str))
<a name="l00374"></a>00374 <span class="keywordflow">goto</span> nomem;
<a name="l00375"></a>00375
<a name="l00376"></a>00376 <span class="keywordflow">if</span> (format == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00377"></a>00377 {
<a name="l00378"></a>00378 <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#ga100c5ce0696822c5a4cfbdfaba674d96" title="Appends a nul-terminated C-style string to a DBusString.">_dbus_string_append</a> (&str,
<a name="l00379"></a>00379 message_from_error (name)))
<a name="l00380"></a>00380 {
<a name="l00381"></a>00381 <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (&str);
<a name="l00382"></a>00382 <span class="keywordflow">goto</span> nomem;
<a name="l00383"></a>00383 }
<a name="l00384"></a>00384 }
<a name="l00385"></a>00385 <span class="keywordflow">else</span>
<a name="l00386"></a>00386 {
<a name="l00387"></a>00387 va_start (args, format);
<a name="l00388"></a>00388 <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#ga8d794f292831d1a7edeb971b13a2c641" title="Appends a printf-style formatted string to the DBusString.">_dbus_string_append_printf_valist</a> (&str, format, args))
<a name="l00389"></a>00389 {
<a name="l00390"></a>00390 <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (&str);
<a name="l00391"></a>00391 va_end (args);
<a name="l00392"></a>00392 <span class="keywordflow">goto</span> nomem;
<a name="l00393"></a>00393 }
<a name="l00394"></a>00394 va_end (args);
<a name="l00395"></a>00395 }
<a name="l00396"></a>00396
<a name="l00397"></a>00397 real = (<a class="code" href="structDBusRealError.html" title="Internals of DBusError.">DBusRealError</a> *)error;
<a name="l00398"></a>00398
<a name="l00399"></a>00399 <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#ga556cc30c3ab032dbc63e217119f0d1f5" title="Like _dbus_string_get_data(), but removes the gotten data from the original string.">_dbus_string_steal_data</a> (&str, &real-><a class="code" href="structDBusRealError.html#afd09fc7ff565b5f3b410ee1ce985172b" title="error message">message</a>))
<a name="l00400"></a>00400 {
<a name="l00401"></a>00401 <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (&str);
<a name="l00402"></a>00402 <span class="keywordflow">goto</span> nomem;
<a name="l00403"></a>00403 }
<a name="l00404"></a>00404 <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (&str);
<a name="l00405"></a>00405
<a name="l00406"></a>00406 real-><a class="code" href="structDBusRealError.html#a269069d5d2fc0f33deced317cb435de9" title="error name">name</a> = <a class="code" href="group__DBusInternalsUtils.html#ga9d00d77f6595b9d7ac1baf59d44bf58c" title="Duplicates a string.">_dbus_strdup</a> (name);
<a name="l00407"></a>00407 <span class="keywordflow">if</span> (real-><a class="code" href="structDBusRealError.html#a269069d5d2fc0f33deced317cb435de9" title="error name">name</a> == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00408"></a>00408 {
<a name="l00409"></a>00409 <a class="code" href="group__DBusMemory.html#ga34e666b19b015035a9a31e53da84b39a" title="Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().">dbus_free</a> (real-><a class="code" href="structDBusRealError.html#afd09fc7ff565b5f3b410ee1ce985172b" title="error message">message</a>);
<a name="l00410"></a>00410 real-><a class="code" href="structDBusRealError.html#afd09fc7ff565b5f3b410ee1ce985172b" title="error message">message</a> = <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00411"></a>00411 <span class="keywordflow">goto</span> nomem;
<a name="l00412"></a>00412 }
<a name="l00413"></a>00413 real-><a class="code" href="structDBusRealError.html#a3e95ec02e0320fe0bfccf24fb4b8db8a" title="Message is not owned by DBusError.">const_message</a> = <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to "0".">FALSE</a>;
<a name="l00414"></a>00414
<a name="l00415"></a>00415 <span class="keywordflow">return</span>;
<a name="l00416"></a>00416
<a name="l00417"></a>00417 nomem:
<a name="l00418"></a>00418 _DBUS_SET_OOM (error);
<a name="l00419"></a>00419 }
<a name="l00420"></a>00420 <span class="comment">/* End public API */</span>
</pre></div></div><!-- contents -->
<hr class="footer"/><address class="footer"><small>
Generated on Thu Mar 3 2016 17:50:30 for D-Bus by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.7.6.1
</small></address>
</body>
</html>