Current File : //usr/share/doc/dbus/api/dbus-userdb_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-userdb.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
   &#160;<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&#160;Page</span></a></li>
      <li><a href="pages.html"><span>Related&#160;Pages</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&#160;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&#160;List</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="headertitle">
<div class="title">dbus-userdb.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: &quot;gnu&quot;; indent-tabs-mode: nil; -*- */</span>
<a name="l00002"></a>00002 <span class="comment">/* dbus-userdb.c User database abstraction</span>
<a name="l00003"></a>00003 <span class="comment"> * </span>
<a name="l00004"></a>00004 <span class="comment"> * Copyright (C) 2003, 2004  Red Hat, Inc.</span>
<a name="l00005"></a>00005 <span class="comment"> *</span>
<a name="l00006"></a>00006 <span class="comment"> * Licensed under the Academic Free License version 2.1</span>
<a name="l00007"></a>00007 <span class="comment"> * </span>
<a name="l00008"></a>00008 <span class="comment"> * This program is free software; you can redistribute it and/or modify</span>
<a name="l00009"></a>00009 <span class="comment"> * it under the terms of the GNU General Public License as published by</span>
<a name="l00010"></a>00010 <span class="comment"> * the Free Software Foundation; either version 2 of the License, or</span>
<a name="l00011"></a>00011 <span class="comment"> * (at your option) any later version.</span>
<a name="l00012"></a>00012 <span class="comment"> *</span>
<a name="l00013"></a>00013 <span class="comment"> * This program is distributed in the hope that it will be useful,</span>
<a name="l00014"></a>00014 <span class="comment"> * but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00015"></a>00015 <span class="comment"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the</span>
<a name="l00016"></a>00016 <span class="comment"> * GNU General Public License for more details.</span>
<a name="l00017"></a>00017 <span class="comment"> * </span>
<a name="l00018"></a>00018 <span class="comment"> * You should have received a copy of the GNU General Public License</span>
<a name="l00019"></a>00019 <span class="comment"> * along with this program; if not, write to the Free Software</span>
<a name="l00020"></a>00020 <span class="comment"> * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA</span>
<a name="l00021"></a>00021 <span class="comment"> *</span>
<a name="l00022"></a>00022 <span class="comment"> */</span>
<a name="l00023"></a>00023 <span class="preprocessor">#include &lt;config.h&gt;</span>
<a name="l00024"></a>00024 <span class="preprocessor">#define DBUS_USERDB_INCLUDES_PRIVATE 1</span>
<a name="l00025"></a>00025 <span class="preprocessor"></span><span class="preprocessor">#include &quot;dbus-userdb.h&quot;</span>
<a name="l00026"></a>00026 <span class="preprocessor">#include &quot;dbus-hash.h&quot;</span>
<a name="l00027"></a>00027 <span class="preprocessor">#include &quot;dbus-test.h&quot;</span>
<a name="l00028"></a>00028 <span class="preprocessor">#include &quot;dbus-internals.h&quot;</span>
<a name="l00029"></a>00029 <span class="preprocessor">#include &quot;dbus-protocol.h&quot;</span>
<a name="l00030"></a>00030 <span class="preprocessor">#include &quot;dbus-credentials.h&quot;</span>
<a name="l00031"></a>00031 <span class="preprocessor">#include &lt;string.h&gt;</span>
<a name="l00032"></a>00032 
<a name="l00044"></a>00044 <span class="keywordtype">void</span>
<a name="l00045"></a><a class="code" href="group__DBusInternalsUtils.html#gaf725ba6f380a3b926650626eef714b67">00045</a> <a class="code" href="group__DBusInternalsUtils.html#gaf725ba6f380a3b926650626eef714b67" title="Frees the given DBusUserInfo&#39;s members with _dbus_user_info_free() and also calls dbus_free() on the ...">_dbus_user_info_free_allocated</a> (<a class="code" href="structDBusUserInfo.html" title="Information about a UNIX user.">DBusUserInfo</a> *info)
<a name="l00046"></a>00046 {
<a name="l00047"></a>00047   <span class="keywordflow">if</span> (info == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>) <span class="comment">/* hash table will pass NULL */</span>
<a name="l00048"></a>00048     <span class="keywordflow">return</span>;
<a name="l00049"></a>00049 
<a name="l00050"></a>00050   <a class="code" href="group__DBusSysdepsUnix.html#gaa40334f7b4f185a437a8bc6d6e0994a1" title="Frees the members of info (but not info itself)">_dbus_user_info_free</a> (info);
<a name="l00051"></a>00051   <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> (info);
<a name="l00052"></a>00052 }
<a name="l00053"></a>00053 
<a name="l00060"></a>00060 <span class="keywordtype">void</span>
<a name="l00061"></a><a class="code" href="group__DBusInternalsUtils.html#gab9420d7a4a31329a00fd5709f8cf08ba">00061</a> <a class="code" href="group__DBusInternalsUtils.html#gab9420d7a4a31329a00fd5709f8cf08ba" title="Frees the given DBusGroupInfo&#39;s members with _dbus_group_info_free() and also calls dbus_free() on th...">_dbus_group_info_free_allocated</a> (<a class="code" href="structDBusGroupInfo.html" title="Information about a UNIX group.">DBusGroupInfo</a> *info)
<a name="l00062"></a>00062 {
<a name="l00063"></a>00063   <span class="keywordflow">if</span> (info == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>) <span class="comment">/* hash table will pass NULL */</span>
<a name="l00064"></a>00064     <span class="keywordflow">return</span>;
<a name="l00065"></a>00065 
<a name="l00066"></a>00066   <a class="code" href="group__DBusSysdepsUnix.html#gac2d226476e6fff50bdfaace18b897fe9" title="Frees the members of info (but not info itself).">_dbus_group_info_free</a> (info);
<a name="l00067"></a>00067   <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> (info);
<a name="l00068"></a>00068 }
<a name="l00069"></a>00069 
<a name="l00075"></a>00075 <span class="keywordtype">void</span>
<a name="l00076"></a><a class="code" href="group__DBusInternalsUtils.html#gaa40334f7b4f185a437a8bc6d6e0994a1">00076</a> <a class="code" href="group__DBusSysdepsUnix.html#gaa40334f7b4f185a437a8bc6d6e0994a1" title="Frees the members of info (but not info itself)">_dbus_user_info_free</a> (<a class="code" href="structDBusUserInfo.html" title="Information about a UNIX user.">DBusUserInfo</a> *info)
<a name="l00077"></a>00077 {
<a name="l00078"></a>00078   <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> (info-&gt;<a class="code" href="structDBusUserInfo.html#a902af9e0fb7d37c14eefb7d2b016ab11" title="Groups IDs, *including* above primary group.">group_ids</a>);
<a name="l00079"></a>00079   <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> (info-&gt;<a class="code" href="structDBusUserInfo.html#ac6b57db1dc8315eee3f532f4e77912d1" title="Username.">username</a>);
<a name="l00080"></a>00080   <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> (info-&gt;<a class="code" href="structDBusUserInfo.html#a5235d4d021cd134e1130e1e8e912bc0c" title="Home directory.">homedir</a>);
<a name="l00081"></a>00081 }
<a name="l00082"></a>00082 
<a name="l00088"></a>00088 <span class="keywordtype">void</span>
<a name="l00089"></a><a class="code" href="group__DBusInternalsUtils.html#gac2d226476e6fff50bdfaace18b897fe9">00089</a> <a class="code" href="group__DBusSysdepsUnix.html#gac2d226476e6fff50bdfaace18b897fe9" title="Frees the members of info (but not info itself).">_dbus_group_info_free</a> (<a class="code" href="structDBusGroupInfo.html" title="Information about a UNIX group.">DBusGroupInfo</a>    *info)
<a name="l00090"></a>00090 {
<a name="l00091"></a>00091   <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> (info-&gt;<a class="code" href="structDBusGroupInfo.html#af1a4b925663336f64c62cfcab40571c6" title="Group name.">groupname</a>);
<a name="l00092"></a>00092 }
<a name="l00093"></a>00093 
<a name="l00102"></a>00102 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00103"></a><a class="code" href="group__DBusInternalsUtils.html#gad1c3538c544df91f438a13c9fb4d3a1b">00103</a> <a class="code" href="group__DBusInternalsUtils.html#gad1c3538c544df91f438a13c9fb4d3a1b" title="Checks if a given string is actually a number and converts it if it is.">_dbus_is_a_number</a> (<span class="keyword">const</span> <a class="code" href="structDBusString.html">DBusString</a> *str,
<a name="l00104"></a>00104                    <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span>    *num)
<a name="l00105"></a>00105 {
<a name="l00106"></a>00106   <span class="keywordtype">int</span> end;
<a name="l00107"></a>00107 
<a name="l00108"></a>00108   <span class="keywordflow">if</span> (<a class="code" href="group__DBusString.html#ga84cc8d08bb48b7915d673f7cc7886f97" title="Parses an unsigned integer contained in a DBusString.">_dbus_string_parse_uint</a> (str, 0, num, &amp;end) &amp;&amp;
<a name="l00109"></a>00109       end == <a class="code" href="group__DBusString.html#gaa5136e6fd2c5188f4b88de7863369c6d" title="Gets the length of a string (not including nul termination).">_dbus_string_get_length</a> (str))
<a name="l00110"></a>00110     <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00111"></a>00111   <span class="keywordflow">else</span>
<a name="l00112"></a>00112     <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00113"></a>00113 }
<a name="l00114"></a>00114 
<a name="l00127"></a>00127 <a class="code" href="structDBusUserInfo.html" title="Information about a UNIX user.">DBusUserInfo</a>*
<a name="l00128"></a><a class="code" href="group__DBusInternalsUtils.html#ga959372f7d7cdea35ffbac3b78e29a1b0">00128</a> <a class="code" href="group__DBusInternalsUtils.html#ga959372f7d7cdea35ffbac3b78e29a1b0" title="Looks up a uid or username in the user database.">_dbus_user_database_lookup</a> (DBusUserDatabase *db,
<a name="l00129"></a>00129                             <a class="code" href="group__DBusSysdeps.html#ga186e987b700f9ddc6cea8aa0db82b151" title="A user ID.">dbus_uid_t</a>        uid,
<a name="l00130"></a>00130                             <span class="keyword">const</span> <a class="code" href="structDBusString.html">DBusString</a> *username,
<a name="l00131"></a>00131                             <a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a>        *error)
<a name="l00132"></a>00132 {
<a name="l00133"></a>00133   <a class="code" href="structDBusUserInfo.html" title="Information about a UNIX user.">DBusUserInfo</a> *info;
<a name="l00134"></a>00134 
<a name="l00135"></a>00135   _DBUS_ASSERT_ERROR_IS_CLEAR (error);
<a name="l00136"></a>00136   _dbus_assert (uid != <a class="code" href="group__DBusSysdeps.html#ga3d2f3fb32bb759cabe362ca2de383f7d" title="an invalid UID used to represent an uninitialized dbus_uid_t field">DBUS_UID_UNSET</a> || username != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00137"></a>00137 
<a name="l00138"></a>00138   <span class="comment">/* See if the username is really a number */</span>
<a name="l00139"></a>00139   <span class="keywordflow">if</span> (uid == <a class="code" href="group__DBusSysdeps.html#ga3d2f3fb32bb759cabe362ca2de383f7d" title="an invalid UID used to represent an uninitialized dbus_uid_t field">DBUS_UID_UNSET</a>)
<a name="l00140"></a>00140     {
<a name="l00141"></a>00141       <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> n;
<a name="l00142"></a>00142 
<a name="l00143"></a>00143       <span class="keywordflow">if</span> (<a class="code" href="group__DBusInternalsUtils.html#gad1c3538c544df91f438a13c9fb4d3a1b" title="Checks if a given string is actually a number and converts it if it is.">_dbus_is_a_number</a> (username, &amp;n))
<a name="l00144"></a>00144         uid = n;
<a name="l00145"></a>00145     }
<a name="l00146"></a>00146 
<a name="l00147"></a>00147   <span class="keywordflow">if</span> (uid != <a class="code" href="group__DBusSysdeps.html#ga3d2f3fb32bb759cabe362ca2de383f7d" title="an invalid UID used to represent an uninitialized dbus_uid_t field">DBUS_UID_UNSET</a>)
<a name="l00148"></a>00148     info = <a class="code" href="group__DBusHashTable.html#gae0ac411f87a797767f36c6e64fd807b3" title="Looks up the value for a given integer in a hash table of type DBUS_HASH_UINTPTR.">_dbus_hash_table_lookup_uintptr</a> (db-&gt;users, uid);
<a name="l00149"></a>00149   <span class="keywordflow">else</span>
<a name="l00150"></a>00150     info = <a class="code" href="group__DBusHashTable.html#gad51eb3fe682721dd4f6a920ca87cb730" title="Looks up the value for a given string in a hash table of type DBUS_HASH_STRING.">_dbus_hash_table_lookup_string</a> (db-&gt;users_by_name, <a class="code" href="group__DBusString.html#ga33e20241ae7d784624f97d89b1a0539e" title="Gets the raw character buffer from a const string.">_dbus_string_get_const_data</a> (username));
<a name="l00151"></a>00151 
<a name="l00152"></a>00152   <span class="keywordflow">if</span> (info)
<a name="l00153"></a>00153     {
<a name="l00154"></a>00154       _dbus_verbose (<span class="stringliteral">&quot;Using cache for UID &quot;</span><a class="code" href="group__DBusSysdeps.html#gab657f0434f01b463891942f373f7b4a1" title="an appropriate printf format for dbus_uid_t">DBUS_UID_FORMAT</a><span class="stringliteral">&quot; information\n&quot;</span>,
<a name="l00155"></a>00155                      info-&gt;<a class="code" href="structDBusUserInfo.html#a2d9c74d29f371e391a79b81162050b2e" title="UID.">uid</a>);
<a name="l00156"></a>00156       <span class="keywordflow">return</span> info;
<a name="l00157"></a>00157     }
<a name="l00158"></a>00158   <span class="keywordflow">else</span>
<a name="l00159"></a>00159     {
<a name="l00160"></a>00160       <span class="keywordflow">if</span> (uid != <a class="code" href="group__DBusSysdeps.html#ga3d2f3fb32bb759cabe362ca2de383f7d" title="an invalid UID used to represent an uninitialized dbus_uid_t field">DBUS_UID_UNSET</a>)
<a name="l00161"></a>00161         _dbus_verbose (<span class="stringliteral">&quot;No cache for UID &quot;</span><a class="code" href="group__DBusSysdeps.html#gab657f0434f01b463891942f373f7b4a1" title="an appropriate printf format for dbus_uid_t">DBUS_UID_FORMAT</a><span class="stringliteral">&quot;\n&quot;</span>,
<a name="l00162"></a>00162                        uid);
<a name="l00163"></a>00163       <span class="keywordflow">else</span>
<a name="l00164"></a>00164         _dbus_verbose (<span class="stringliteral">&quot;No cache for user \&quot;%s\&quot;\n&quot;</span>,
<a name="l00165"></a>00165                        <a class="code" href="group__DBusString.html#ga33e20241ae7d784624f97d89b1a0539e" title="Gets the raw character buffer from a const string.">_dbus_string_get_const_data</a> (username));
<a name="l00166"></a>00166       
<a name="l00167"></a>00167       info = <a class="code" href="group__DBusMemory.html#gaba9d823abda7f4cadbaf5177d3b8b793" title="Safe macro for using dbus_malloc0().">dbus_new0</a> (<a class="code" href="structDBusUserInfo.html" title="Information about a UNIX user.">DBusUserInfo</a>, 1);
<a name="l00168"></a>00168       <span class="keywordflow">if</span> (info == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00169"></a>00169         {
<a name="l00170"></a>00170           <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00171"></a>00171           <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00172"></a>00172         }
<a name="l00173"></a>00173 
<a name="l00174"></a>00174       <span class="keywordflow">if</span> (uid != <a class="code" href="group__DBusSysdeps.html#ga3d2f3fb32bb759cabe362ca2de383f7d" title="an invalid UID used to represent an uninitialized dbus_uid_t field">DBUS_UID_UNSET</a>)
<a name="l00175"></a>00175         {
<a name="l00176"></a>00176           <span class="keywordflow">if</span> (!<a class="code" href="group__DBusSysdepsUnix.html#gafcc2fbcde2c72f499f04fa43d97dfcec" title="Gets user info for the given user ID.">_dbus_user_info_fill_uid</a> (info, uid, error))
<a name="l00177"></a>00177             {
<a name="l00178"></a>00178               _DBUS_ASSERT_ERROR_IS_SET (error);
<a name="l00179"></a>00179               <a class="code" href="group__DBusInternalsUtils.html#gaf725ba6f380a3b926650626eef714b67" title="Frees the given DBusUserInfo&#39;s members with _dbus_user_info_free() and also calls dbus_free() on the ...">_dbus_user_info_free_allocated</a> (info);
<a name="l00180"></a>00180               <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00181"></a>00181             }
<a name="l00182"></a>00182         }
<a name="l00183"></a>00183       <span class="keywordflow">else</span>
<a name="l00184"></a>00184         {
<a name="l00185"></a>00185           <span class="keywordflow">if</span> (!<a class="code" href="group__DBusSysdepsUnix.html#ga95e9deb9dd2d76aa3a64fdac555d956d" title="Gets user info for the given username.">_dbus_user_info_fill</a> (info, username, error))
<a name="l00186"></a>00186             {
<a name="l00187"></a>00187               _DBUS_ASSERT_ERROR_IS_SET (error);
<a name="l00188"></a>00188               <a class="code" href="group__DBusInternalsUtils.html#gaf725ba6f380a3b926650626eef714b67" title="Frees the given DBusUserInfo&#39;s members with _dbus_user_info_free() and also calls dbus_free() on the ...">_dbus_user_info_free_allocated</a> (info);
<a name="l00189"></a>00189               <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00190"></a>00190             }
<a name="l00191"></a>00191         }
<a name="l00192"></a>00192 
<a name="l00193"></a>00193       <span class="comment">/* be sure we don&#39;t use these after here */</span>
<a name="l00194"></a>00194       uid = <a class="code" href="group__DBusSysdeps.html#ga3d2f3fb32bb759cabe362ca2de383f7d" title="an invalid UID used to represent an uninitialized dbus_uid_t field">DBUS_UID_UNSET</a>;
<a name="l00195"></a>00195       username = <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00196"></a>00196 
<a name="l00197"></a>00197       <span class="comment">/* insert into hash */</span>
<a name="l00198"></a>00198       <span class="keywordflow">if</span> (!<a class="code" href="group__DBusHashTable.html#ga811d833032ca919a9063ca835482d01a" title="Creates a hash entry with the given key and value.">_dbus_hash_table_insert_uintptr</a> (db-&gt;users, info-&gt;<a class="code" href="structDBusUserInfo.html#a2d9c74d29f371e391a79b81162050b2e" title="UID.">uid</a>, info))
<a name="l00199"></a>00199         {
<a name="l00200"></a>00200           <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00201"></a>00201           <a class="code" href="group__DBusInternalsUtils.html#gaf725ba6f380a3b926650626eef714b67" title="Frees the given DBusUserInfo&#39;s members with _dbus_user_info_free() and also calls dbus_free() on the ...">_dbus_user_info_free_allocated</a> (info);
<a name="l00202"></a>00202           <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00203"></a>00203         }
<a name="l00204"></a>00204 
<a name="l00205"></a>00205       <span class="keywordflow">if</span> (!<a class="code" href="group__DBusHashTable.html#ga43e98a91a11952824c544330e19f6c22" title="Creates a hash entry with the given key and value.">_dbus_hash_table_insert_string</a> (db-&gt;users_by_name,
<a name="l00206"></a>00206                                            info-&gt;<a class="code" href="structDBusUserInfo.html#ac6b57db1dc8315eee3f532f4e77912d1" title="Username.">username</a>,
<a name="l00207"></a>00207                                            info))
<a name="l00208"></a>00208         {
<a name="l00209"></a>00209           <a class="code" href="group__DBusHashTable.html#ga0ad8fa1108bad2b4bd5b4ce539d32d64" title="Removes the hash entry for the given key.">_dbus_hash_table_remove_uintptr</a> (db-&gt;users, info-&gt;<a class="code" href="structDBusUserInfo.html#a2d9c74d29f371e391a79b81162050b2e" title="UID.">uid</a>);
<a name="l00210"></a>00210           <a class="code" href="group__DBusErrors.html#ga89d2ad4bde21f9e0057fac07a79885e3" title="Assigns an error name and message to a DBusError.">dbus_set_error</a> (error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00211"></a>00211           <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00212"></a>00212         }
<a name="l00213"></a>00213       
<a name="l00214"></a>00214       <span class="keywordflow">return</span> info;
<a name="l00215"></a>00215     }
<a name="l00216"></a>00216 }
<a name="l00217"></a>00217 
<a name="l00218"></a>00218 <span class="keyword">static</span> <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a> database_locked = <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00219"></a>00219 <span class="keyword">static</span> DBusUserDatabase *system_db = <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00220"></a>00220 <span class="keyword">static</span> <a class="code" href="structDBusString.html">DBusString</a> process_username;
<a name="l00221"></a>00221 <span class="keyword">static</span> <a class="code" href="structDBusString.html">DBusString</a> process_homedir;
<a name="l00222"></a>00222       
<a name="l00223"></a>00223 <span class="keyword">static</span> <span class="keywordtype">void</span>
<a name="l00224"></a>00224 shutdown_system_db (<span class="keywordtype">void</span> *data)
<a name="l00225"></a>00225 {
<a name="l00226"></a>00226   <span class="keywordflow">if</span> (system_db != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00227"></a>00227     <a class="code" href="group__DBusInternalsUtils.html#ga55dbb78c415da040037442eca4c4e80e" title="Decrements refcount of user database.">_dbus_user_database_unref</a> (system_db);
<a name="l00228"></a>00228   system_db = <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00229"></a>00229   <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (&amp;process_username);
<a name="l00230"></a>00230   <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (&amp;process_homedir);
<a name="l00231"></a>00231 }
<a name="l00232"></a>00232 
<a name="l00233"></a>00233 <span class="keyword">static</span> <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00234"></a>00234 init_system_db (<span class="keywordtype">void</span>)
<a name="l00235"></a>00235 {
<a name="l00236"></a>00236   _dbus_assert (database_locked);
<a name="l00237"></a>00237     
<a name="l00238"></a>00238   <span class="keywordflow">if</span> (system_db == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00239"></a>00239     {
<a name="l00240"></a>00240       <a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a> error = <a class="code" href="group__DBusErrorInternals.html#ga961cc70e3891282a65205c4c8418d88e" title="Expands to a suitable initializer for a DBusError on the stack.">DBUS_ERROR_INIT</a>;
<a name="l00241"></a>00241       <span class="keyword">const</span> <a class="code" href="structDBusUserInfo.html" title="Information about a UNIX user.">DBusUserInfo</a> *info;
<a name="l00242"></a>00242       
<a name="l00243"></a>00243       system_db = <a class="code" href="group__DBusInternalsUtils.html#ga1dbf2c80952d17707c544f5d86dd8545" title="Creates a new user database object used to look up and cache user information.">_dbus_user_database_new</a> ();
<a name="l00244"></a>00244       <span class="keywordflow">if</span> (system_db == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00245"></a>00245         <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00246"></a>00246 
<a name="l00247"></a>00247       <span class="keywordflow">if</span> (!<a class="code" href="group__DBusInternalsUtils.html#ga6a7e8b8cf3a6968972e9a49726022638" title="Gets the user information for the given UID, returned user info should not be freed.">_dbus_user_database_get_uid</a> (system_db,
<a name="l00248"></a>00248                                         <a class="code" href="group__DBusSysdepsUnix.html#gae7701063932951bdd8a7df0dcacb3bab" title="Gets our UID.">_dbus_getuid</a> (),
<a name="l00249"></a>00249                                         &amp;info,
<a name="l00250"></a>00250                                         &amp;error))
<a name="l00251"></a>00251         {
<a name="l00252"></a>00252           <a class="code" href="group__DBusInternalsUtils.html#ga55dbb78c415da040037442eca4c4e80e" title="Decrements refcount of user database.">_dbus_user_database_unref</a> (system_db);
<a name="l00253"></a>00253           system_db = <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00254"></a>00254           
<a name="l00255"></a>00255           <span class="keywordflow">if</span> (<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> (&amp;error, <a class="code" href="group__DBusProtocol.html#gac32eaf0b92f798307853cd4fe0cf11c2" title="There was not enough memory to complete an operation.">DBUS_ERROR_NO_MEMORY</a>))
<a name="l00256"></a>00256             {
<a name="l00257"></a>00257               <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that&#39;s been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (&amp;error);
<a name="l00258"></a>00258               <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00259"></a>00259             }
<a name="l00260"></a>00260           <span class="keywordflow">else</span>
<a name="l00261"></a>00261             {
<a name="l00262"></a>00262               <span class="comment">/* This really should not happen. */</span>
<a name="l00263"></a>00263               <a class="code" href="group__DBusInternalsUtils.html#gabea2c16d6d3fe7c4eb5b9496fc877f84" title="Prints a warning message to stderr.">_dbus_warn</a> (<span class="stringliteral">&quot;Could not get password database information for UID of current process: %s\n&quot;</span>,
<a name="l00264"></a>00264                           error.<a class="code" href="structDBusError.html#afb559175326de5b6b340e26204e92d72" title="public error message field">message</a>);
<a name="l00265"></a>00265               <a class="code" href="group__DBusErrors.html#gaac6c14ead14829ee4e090f39de6a7568" title="Frees an error that&#39;s been set (or just initialized), then reinitializes the error as in dbus_error_i...">dbus_error_free</a> (&amp;error);
<a name="l00266"></a>00266               <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00267"></a>00267             }
<a name="l00268"></a>00268         }
<a name="l00269"></a>00269 
<a name="l00270"></a>00270       <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#ga348252317f7bb8ac43529972945830ae" title="Initializes a string.">_dbus_string_init</a> (&amp;process_username))
<a name="l00271"></a>00271         {
<a name="l00272"></a>00272           <a class="code" href="group__DBusInternalsUtils.html#ga55dbb78c415da040037442eca4c4e80e" title="Decrements refcount of user database.">_dbus_user_database_unref</a> (system_db);
<a name="l00273"></a>00273           system_db = <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00274"></a>00274           <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00275"></a>00275         }
<a name="l00276"></a>00276 
<a name="l00277"></a>00277       <span class="keywordflow">if</span> (!<a class="code" href="group__DBusString.html#ga348252317f7bb8ac43529972945830ae" title="Initializes a string.">_dbus_string_init</a> (&amp;process_homedir))
<a name="l00278"></a>00278         {
<a name="l00279"></a>00279           <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (&amp;process_username);
<a name="l00280"></a>00280           <a class="code" href="group__DBusInternalsUtils.html#ga55dbb78c415da040037442eca4c4e80e" title="Decrements refcount of user database.">_dbus_user_database_unref</a> (system_db);
<a name="l00281"></a>00281           system_db = <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00282"></a>00282           <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00283"></a>00283         }
<a name="l00284"></a>00284 
<a name="l00285"></a>00285       <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> (&amp;process_username,
<a name="l00286"></a>00286                                 info-&gt;<a class="code" href="structDBusUserInfo.html#ac6b57db1dc8315eee3f532f4e77912d1" title="Username.">username</a>) ||
<a name="l00287"></a>00287           !<a class="code" href="group__DBusString.html#ga100c5ce0696822c5a4cfbdfaba674d96" title="Appends a nul-terminated C-style string to a DBusString.">_dbus_string_append</a> (&amp;process_homedir,
<a name="l00288"></a>00288                                 info-&gt;<a class="code" href="structDBusUserInfo.html#a5235d4d021cd134e1130e1e8e912bc0c" title="Home directory.">homedir</a>) ||
<a name="l00289"></a>00289           !<a class="code" href="group__DBusMemoryInternals.html#ga8dc6d5dd0a0e7901ab793da7403ee734" title="Register a cleanup function to be called exactly once the next time dbus_shutdown() is called...">_dbus_register_shutdown_func</a> (shutdown_system_db, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>))
<a name="l00290"></a>00290         {
<a name="l00291"></a>00291           <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (&amp;process_username);
<a name="l00292"></a>00292           <a class="code" href="group__DBusString.html#ga781ca91acda49a834dce7d0ed0eef212" title="Frees a string created by _dbus_string_init().">_dbus_string_free</a> (&amp;process_homedir);
<a name="l00293"></a>00293           <a class="code" href="group__DBusInternalsUtils.html#ga55dbb78c415da040037442eca4c4e80e" title="Decrements refcount of user database.">_dbus_user_database_unref</a> (system_db);
<a name="l00294"></a>00294           system_db = <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00295"></a>00295           <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00296"></a>00296         }
<a name="l00297"></a>00297     }
<a name="l00298"></a>00298 
<a name="l00299"></a>00299   <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00300"></a>00300 }
<a name="l00301"></a>00301 
<a name="l00305"></a>00305 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00306"></a><a class="code" href="group__DBusInternalsUtils.html#ga15df3b3fdaa4946f69ff87f3a9a03fe7">00306</a> <a class="code" href="group__DBusInternalsUtils.html#ga15df3b3fdaa4946f69ff87f3a9a03fe7" title="Locks global system user database.">_dbus_user_database_lock_system</a> (<span class="keywordtype">void</span>)
<a name="l00307"></a>00307 {
<a name="l00308"></a>00308   <span class="keywordflow">if</span> (_DBUS_LOCK (system_users))
<a name="l00309"></a>00309     {
<a name="l00310"></a>00310       database_locked = <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00311"></a>00311       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00312"></a>00312     }
<a name="l00313"></a>00313   <span class="keywordflow">else</span>
<a name="l00314"></a>00314     {
<a name="l00315"></a>00315       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00316"></a>00316     }
<a name="l00317"></a>00317 }
<a name="l00318"></a>00318 
<a name="l00322"></a>00322 <span class="keywordtype">void</span>
<a name="l00323"></a><a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c">00323</a> <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> (<span class="keywordtype">void</span>)
<a name="l00324"></a>00324 {
<a name="l00325"></a>00325   database_locked = <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00326"></a>00326   _DBUS_UNLOCK (system_users);
<a name="l00327"></a>00327 }
<a name="l00328"></a>00328 
<a name="l00335"></a>00335 DBusUserDatabase*
<a name="l00336"></a><a class="code" href="group__DBusInternalsUtils.html#ga79b6c3cf0d735622b6af2795840f9d21">00336</a> <a class="code" href="group__DBusInternalsUtils.html#ga79b6c3cf0d735622b6af2795840f9d21" title="Gets the system global user database; must be called with lock held (_dbus_user_database_lock_system(...">_dbus_user_database_get_system</a> (<span class="keywordtype">void</span>)
<a name="l00337"></a>00337 {
<a name="l00338"></a>00338   _dbus_assert (database_locked);
<a name="l00339"></a>00339 
<a name="l00340"></a>00340   init_system_db ();
<a name="l00341"></a>00341   
<a name="l00342"></a>00342   <span class="keywordflow">return</span> system_db;
<a name="l00343"></a>00343 }
<a name="l00344"></a>00344 
<a name="l00348"></a>00348 <span class="keywordtype">void</span>
<a name="l00349"></a><a class="code" href="group__DBusInternalsUtils.html#ga788ce7775d7f812d28d931e8b87ddfde">00349</a> <a class="code" href="group__DBusInternalsUtils.html#ga788ce7775d7f812d28d931e8b87ddfde" title="Flushes the system global user database;.">_dbus_user_database_flush_system</a> (<span class="keywordtype">void</span>)
<a name="l00350"></a>00350 {
<a name="l00351"></a>00351   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusInternalsUtils.html#ga15df3b3fdaa4946f69ff87f3a9a03fe7" title="Locks global system user database.">_dbus_user_database_lock_system</a> ())
<a name="l00352"></a>00352     {
<a name="l00353"></a>00353       <span class="comment">/* nothing to flush */</span>
<a name="l00354"></a>00354       <span class="keywordflow">return</span>;
<a name="l00355"></a>00355     }
<a name="l00356"></a>00356 
<a name="l00357"></a>00357    <span class="keywordflow">if</span> (system_db != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00358"></a>00358     <a class="code" href="group__DBusInternalsUtils.html#gab553751e96f8506d10349fb5fb1eaa82" title="Flush all information out of the user database.">_dbus_user_database_flush</a> (system_db);
<a name="l00359"></a>00359 
<a name="l00360"></a>00360   <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00361"></a>00361 }
<a name="l00362"></a>00362 
<a name="l00370"></a>00370 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00371"></a><a class="code" href="group__DBusInternalsUtils.html#ga9c4c1850787bfd457107b95fa1878869">00371</a> <a class="code" href="group__DBusInternalsUtils.html#ga9c4c1850787bfd457107b95fa1878869" title="Gets username of user owning current process.">_dbus_username_from_current_process</a> (<span class="keyword">const</span> <a class="code" href="structDBusString.html">DBusString</a> **username)
<a name="l00372"></a>00372 {
<a name="l00373"></a>00373   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusInternalsUtils.html#ga15df3b3fdaa4946f69ff87f3a9a03fe7" title="Locks global system user database.">_dbus_user_database_lock_system</a> ())
<a name="l00374"></a>00374     <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00375"></a>00375 
<a name="l00376"></a>00376   <span class="keywordflow">if</span> (!init_system_db ())
<a name="l00377"></a>00377     {
<a name="l00378"></a>00378       <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00379"></a>00379       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00380"></a>00380     }
<a name="l00381"></a>00381   *username = &amp;process_username;
<a name="l00382"></a>00382   <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();  
<a name="l00383"></a>00383 
<a name="l00384"></a>00384   <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00385"></a>00385 }
<a name="l00386"></a>00386 
<a name="l00394"></a>00394 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00395"></a><a class="code" href="group__DBusInternalsUtils.html#ga17ce3ab061a3ae2441cd33ece34f5e7a">00395</a> <a class="code" href="group__DBusInternalsUtils.html#ga17ce3ab061a3ae2441cd33ece34f5e7a" title="Gets homedir of user owning current process.">_dbus_homedir_from_current_process</a> (<span class="keyword">const</span> <a class="code" href="structDBusString.html">DBusString</a>  **homedir)
<a name="l00396"></a>00396 {
<a name="l00397"></a>00397   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusInternalsUtils.html#ga15df3b3fdaa4946f69ff87f3a9a03fe7" title="Locks global system user database.">_dbus_user_database_lock_system</a> ())
<a name="l00398"></a>00398     <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00399"></a>00399 
<a name="l00400"></a>00400   <span class="keywordflow">if</span> (!init_system_db ())
<a name="l00401"></a>00401     {
<a name="l00402"></a>00402       <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00403"></a>00403       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00404"></a>00404     }
<a name="l00405"></a>00405   *homedir = &amp;process_homedir;
<a name="l00406"></a>00406   <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00407"></a>00407 
<a name="l00408"></a>00408   <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00409"></a>00409 }
<a name="l00410"></a>00410 
<a name="l00418"></a>00418 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00419"></a><a class="code" href="group__DBusInternalsUtils.html#ga91c63dcb68d38347578edf39eda1712a">00419</a> <a class="code" href="group__DBusInternalsUtils.html#ga91c63dcb68d38347578edf39eda1712a" title="Gets the home directory for the given user.">_dbus_homedir_from_username</a> (<span class="keyword">const</span> <a class="code" href="structDBusString.html">DBusString</a> *username,
<a name="l00420"></a>00420                              <a class="code" href="structDBusString.html">DBusString</a>       *homedir)
<a name="l00421"></a>00421 {
<a name="l00422"></a>00422   DBusUserDatabase *db;
<a name="l00423"></a>00423   <span class="keyword">const</span> <a class="code" href="structDBusUserInfo.html" title="Information about a UNIX user.">DBusUserInfo</a> *info;
<a name="l00424"></a>00424 
<a name="l00425"></a>00425   <span class="comment">/* FIXME: this can&#39;t distinguish ENOMEM from other errors */</span>
<a name="l00426"></a>00426   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusInternalsUtils.html#ga15df3b3fdaa4946f69ff87f3a9a03fe7" title="Locks global system user database.">_dbus_user_database_lock_system</a> ())
<a name="l00427"></a>00427     <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00428"></a>00428 
<a name="l00429"></a>00429   db = <a class="code" href="group__DBusInternalsUtils.html#ga79b6c3cf0d735622b6af2795840f9d21" title="Gets the system global user database; must be called with lock held (_dbus_user_database_lock_system(...">_dbus_user_database_get_system</a> ();
<a name="l00430"></a>00430   <span class="keywordflow">if</span> (db == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00431"></a>00431     {
<a name="l00432"></a>00432       <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00433"></a>00433       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00434"></a>00434     }
<a name="l00435"></a>00435 
<a name="l00436"></a>00436   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusInternalsUtils.html#gaccf1d5b330707a1835dcf4ce49a29c8c" title="Gets the user information for the given username.">_dbus_user_database_get_username</a> (db, username,
<a name="l00437"></a>00437                                          &amp;info, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>))
<a name="l00438"></a>00438     {
<a name="l00439"></a>00439       <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00440"></a>00440       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00441"></a>00441     }
<a name="l00442"></a>00442 
<a name="l00443"></a>00443   <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> (homedir, info-&gt;<a class="code" href="structDBusUserInfo.html#a5235d4d021cd134e1130e1e8e912bc0c" title="Home directory.">homedir</a>))
<a name="l00444"></a>00444     {
<a name="l00445"></a>00445       <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00446"></a>00446       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00447"></a>00447     }
<a name="l00448"></a>00448   
<a name="l00449"></a>00449   <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00450"></a>00450   <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00451"></a>00451 }
<a name="l00452"></a>00452 
<a name="l00460"></a>00460 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00461"></a><a class="code" href="group__DBusInternalsUtils.html#gabdd1dc47f44e3d6702c86c68da9a0173">00461</a> <a class="code" href="group__DBusInternalsUtils.html#gabdd1dc47f44e3d6702c86c68da9a0173" title="Gets the home directory for the given user.">_dbus_homedir_from_uid</a> (<a class="code" href="group__DBusSysdeps.html#ga186e987b700f9ddc6cea8aa0db82b151" title="A user ID.">dbus_uid_t</a>         uid,
<a name="l00462"></a>00462                         <a class="code" href="structDBusString.html">DBusString</a>        *homedir)
<a name="l00463"></a>00463 {
<a name="l00464"></a>00464   DBusUserDatabase *db;
<a name="l00465"></a>00465   <span class="keyword">const</span> <a class="code" href="structDBusUserInfo.html" title="Information about a UNIX user.">DBusUserInfo</a> *info;
<a name="l00466"></a>00466 
<a name="l00467"></a>00467   <span class="comment">/* FIXME: this can&#39;t distinguish ENOMEM from other errors */</span>
<a name="l00468"></a>00468   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusInternalsUtils.html#ga15df3b3fdaa4946f69ff87f3a9a03fe7" title="Locks global system user database.">_dbus_user_database_lock_system</a> ())
<a name="l00469"></a>00469     <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00470"></a>00470 
<a name="l00471"></a>00471   db = <a class="code" href="group__DBusInternalsUtils.html#ga79b6c3cf0d735622b6af2795840f9d21" title="Gets the system global user database; must be called with lock held (_dbus_user_database_lock_system(...">_dbus_user_database_get_system</a> ();
<a name="l00472"></a>00472   <span class="keywordflow">if</span> (db == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00473"></a>00473     {
<a name="l00474"></a>00474       <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00475"></a>00475       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00476"></a>00476     }
<a name="l00477"></a>00477 
<a name="l00478"></a>00478   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusInternalsUtils.html#ga6a7e8b8cf3a6968972e9a49726022638" title="Gets the user information for the given UID, returned user info should not be freed.">_dbus_user_database_get_uid</a> (db, uid,
<a name="l00479"></a>00479                                     &amp;info, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>))
<a name="l00480"></a>00480     {
<a name="l00481"></a>00481       <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00482"></a>00482       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00483"></a>00483     }
<a name="l00484"></a>00484 
<a name="l00485"></a>00485   <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> (homedir, info-&gt;<a class="code" href="structDBusUserInfo.html#a5235d4d021cd134e1130e1e8e912bc0c" title="Home directory.">homedir</a>))
<a name="l00486"></a>00486     {
<a name="l00487"></a>00487       <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00488"></a>00488       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00489"></a>00489     }
<a name="l00490"></a>00490   
<a name="l00491"></a>00491   <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00492"></a>00492   <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00493"></a>00493 }
<a name="l00494"></a>00494 
<a name="l00509"></a>00509 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00510"></a><a class="code" href="group__DBusInternalsUtils.html#gacecdbb00a3c8b63e821edae537ae3c7b">00510</a> <a class="code" href="group__DBusSysdeps.html#gacecdbb00a3c8b63e821edae537ae3c7b" title="Adds the credentials corresponding to the given username.">_dbus_credentials_add_from_user</a> (<a class="code" href="structDBusCredentials.html">DBusCredentials</a>  *<a class="code" href="structDBusTransport.html#acb3d5fe913d4c281f3495e95cd450c57" title="Credentials of other end read from the socket.">credentials</a>,
<a name="l00511"></a>00511                                  <span class="keyword">const</span> <a class="code" href="structDBusString.html">DBusString</a> *username)
<a name="l00512"></a>00512 {
<a name="l00513"></a>00513   DBusUserDatabase *db;
<a name="l00514"></a>00514   <span class="keyword">const</span> <a class="code" href="structDBusUserInfo.html" title="Information about a UNIX user.">DBusUserInfo</a> *info;
<a name="l00515"></a>00515 
<a name="l00516"></a>00516   <span class="comment">/* FIXME: this can&#39;t distinguish ENOMEM from other errors */</span>
<a name="l00517"></a>00517   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusInternalsUtils.html#ga15df3b3fdaa4946f69ff87f3a9a03fe7" title="Locks global system user database.">_dbus_user_database_lock_system</a> ())
<a name="l00518"></a>00518     <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00519"></a>00519 
<a name="l00520"></a>00520   db = <a class="code" href="group__DBusInternalsUtils.html#ga79b6c3cf0d735622b6af2795840f9d21" title="Gets the system global user database; must be called with lock held (_dbus_user_database_lock_system(...">_dbus_user_database_get_system</a> ();
<a name="l00521"></a>00521   <span class="keywordflow">if</span> (db == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00522"></a>00522     {
<a name="l00523"></a>00523       <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00524"></a>00524       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00525"></a>00525     }
<a name="l00526"></a>00526 
<a name="l00527"></a>00527   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusInternalsUtils.html#gaccf1d5b330707a1835dcf4ce49a29c8c" title="Gets the user information for the given username.">_dbus_user_database_get_username</a> (db, username,
<a name="l00528"></a>00528                                          &amp;info, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>))
<a name="l00529"></a>00529     {
<a name="l00530"></a>00530       <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00531"></a>00531       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00532"></a>00532     }
<a name="l00533"></a>00533 
<a name="l00534"></a>00534   <span class="keywordflow">if</span> (!<a class="code" href="group__DBusCredentials.html#ga9cec6da43e4be233d44f5bd60b071624" title="Add a UNIX user ID to the credentials.">_dbus_credentials_add_unix_uid</a>(credentials, info-&gt;<a class="code" href="structDBusUserInfo.html#a2d9c74d29f371e391a79b81162050b2e" title="UID.">uid</a>))
<a name="l00535"></a>00535     {
<a name="l00536"></a>00536       <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00537"></a>00537       <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa93f0eb578d23995850d61f7d61c55c1" title="Expands to &quot;0&quot;.">FALSE</a>;
<a name="l00538"></a>00538     }
<a name="l00539"></a>00539   
<a name="l00540"></a>00540   <a class="code" href="group__DBusInternalsUtils.html#ga468e1d62e1df24bb699c4a37fdfa274c" title="Unlocks global system user database.">_dbus_user_database_unlock_system</a> ();
<a name="l00541"></a>00541   <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#gaa8cecfc5c5c054d2875c03e77b7be15d" title="Expands to &quot;1&quot;.">TRUE</a>;
<a name="l00542"></a>00542 }
<a name="l00543"></a>00543 
<a name="l00549"></a>00549 DBusUserDatabase*
<a name="l00550"></a><a class="code" href="group__DBusInternalsUtils.html#ga1dbf2c80952d17707c544f5d86dd8545">00550</a> <a class="code" href="group__DBusInternalsUtils.html#ga1dbf2c80952d17707c544f5d86dd8545" title="Creates a new user database object used to look up and cache user information.">_dbus_user_database_new</a> (<span class="keywordtype">void</span>)
<a name="l00551"></a>00551 {
<a name="l00552"></a>00552   DBusUserDatabase *db;
<a name="l00553"></a>00553   
<a name="l00554"></a>00554   db = <a class="code" href="group__DBusMemory.html#gaba9d823abda7f4cadbaf5177d3b8b793" title="Safe macro for using dbus_malloc0().">dbus_new0</a> (DBusUserDatabase, 1);
<a name="l00555"></a>00555   <span class="keywordflow">if</span> (db == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00556"></a>00556     <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00557"></a>00557 
<a name="l00558"></a>00558   db-&gt;refcount = 1;
<a name="l00559"></a>00559 
<a name="l00560"></a>00560   db-&gt;users = <a class="code" href="group__DBusHashTable.html#gac8e434348a354b9606d4c50c127a5eb4" title="Constructs a new hash table.">_dbus_hash_table_new</a> (<a class="code" href="group__DBusHashTable.html#ggab0ab9767ffa5b6720a13b3d741630852a477caf35cc3676d6412c9b57f1d0f6c7" title="Hash keys are integer capable to hold a pointer.">DBUS_HASH_UINTPTR</a>,
<a name="l00561"></a>00561                                     <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__DBusMemory.html#ga061bcded226d76c7d7de35beaa165cb5" title="The type of a function which frees a block of memory.">DBusFreeFunction</a>) <a class="code" href="group__DBusInternalsUtils.html#gaf725ba6f380a3b926650626eef714b67" title="Frees the given DBusUserInfo&#39;s members with _dbus_user_info_free() and also calls dbus_free() on the ...">_dbus_user_info_free_allocated</a>);
<a name="l00562"></a>00562   
<a name="l00563"></a>00563   <span class="keywordflow">if</span> (db-&gt;users == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00564"></a>00564     <span class="keywordflow">goto</span> failed;
<a name="l00565"></a>00565 
<a name="l00566"></a>00566   db-&gt;groups = <a class="code" href="group__DBusHashTable.html#gac8e434348a354b9606d4c50c127a5eb4" title="Constructs a new hash table.">_dbus_hash_table_new</a> (<a class="code" href="group__DBusHashTable.html#ggab0ab9767ffa5b6720a13b3d741630852a477caf35cc3676d6412c9b57f1d0f6c7" title="Hash keys are integer capable to hold a pointer.">DBUS_HASH_UINTPTR</a>,
<a name="l00567"></a>00567                                      <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__DBusMemory.html#ga061bcded226d76c7d7de35beaa165cb5" title="The type of a function which frees a block of memory.">DBusFreeFunction</a>) <a class="code" href="group__DBusInternalsUtils.html#gab9420d7a4a31329a00fd5709f8cf08ba" title="Frees the given DBusGroupInfo&#39;s members with _dbus_group_info_free() and also calls dbus_free() on th...">_dbus_group_info_free_allocated</a>);
<a name="l00568"></a>00568   
<a name="l00569"></a>00569   <span class="keywordflow">if</span> (db-&gt;groups == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00570"></a>00570     <span class="keywordflow">goto</span> failed;
<a name="l00571"></a>00571 
<a name="l00572"></a>00572   db-&gt;users_by_name = <a class="code" href="group__DBusHashTable.html#gac8e434348a354b9606d4c50c127a5eb4" title="Constructs a new hash table.">_dbus_hash_table_new</a> (<a class="code" href="group__DBusHashTable.html#ggab0ab9767ffa5b6720a13b3d741630852a481fd0166d28da725b3e97f15192434e" title="Hash keys are strings.">DBUS_HASH_STRING</a>,
<a name="l00573"></a>00573                                             <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#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00574"></a>00574   <span class="keywordflow">if</span> (db-&gt;users_by_name == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00575"></a>00575     <span class="keywordflow">goto</span> failed;
<a name="l00576"></a>00576   
<a name="l00577"></a>00577   db-&gt;groups_by_name = <a class="code" href="group__DBusHashTable.html#gac8e434348a354b9606d4c50c127a5eb4" title="Constructs a new hash table.">_dbus_hash_table_new</a> (<a class="code" href="group__DBusHashTable.html#ggab0ab9767ffa5b6720a13b3d741630852a481fd0166d28da725b3e97f15192434e" title="Hash keys are strings.">DBUS_HASH_STRING</a>,
<a name="l00578"></a>00578                                              <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#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>);
<a name="l00579"></a>00579   <span class="keywordflow">if</span> (db-&gt;groups_by_name == <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>)
<a name="l00580"></a>00580     <span class="keywordflow">goto</span> failed;
<a name="l00581"></a>00581   
<a name="l00582"></a>00582   <span class="keywordflow">return</span> db;
<a name="l00583"></a>00583   
<a name="l00584"></a>00584  failed:
<a name="l00585"></a>00585   <a class="code" href="group__DBusInternalsUtils.html#ga55dbb78c415da040037442eca4c4e80e" title="Decrements refcount of user database.">_dbus_user_database_unref</a> (db);
<a name="l00586"></a>00586   <span class="keywordflow">return</span> <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00587"></a>00587 }
<a name="l00588"></a>00588 
<a name="l00592"></a>00592 <span class="keywordtype">void</span>
<a name="l00593"></a><a class="code" href="group__DBusInternalsUtils.html#gab553751e96f8506d10349fb5fb1eaa82">00593</a> <a class="code" href="group__DBusInternalsUtils.html#gab553751e96f8506d10349fb5fb1eaa82" title="Flush all information out of the user database.">_dbus_user_database_flush</a> (DBusUserDatabase *db) 
<a name="l00594"></a>00594 {
<a name="l00595"></a>00595   <a class="code" href="group__DBusHashTable.html#gad169f3790ca67f8a0adafcdc88ef7188" title="Removed all entries from a hash table.">_dbus_hash_table_remove_all</a>(db-&gt;users_by_name);
<a name="l00596"></a>00596   <a class="code" href="group__DBusHashTable.html#gad169f3790ca67f8a0adafcdc88ef7188" title="Removed all entries from a hash table.">_dbus_hash_table_remove_all</a>(db-&gt;groups_by_name);
<a name="l00597"></a>00597   <a class="code" href="group__DBusHashTable.html#gad169f3790ca67f8a0adafcdc88ef7188" title="Removed all entries from a hash table.">_dbus_hash_table_remove_all</a>(db-&gt;users);
<a name="l00598"></a>00598   <a class="code" href="group__DBusHashTable.html#gad169f3790ca67f8a0adafcdc88ef7188" title="Removed all entries from a hash table.">_dbus_hash_table_remove_all</a>(db-&gt;groups);
<a name="l00599"></a>00599 }
<a name="l00600"></a>00600 
<a name="l00601"></a>00601 <span class="preprocessor">#ifdef DBUS_ENABLE_EMBEDDED_TESTS</span>
<a name="l00602"></a>00602 <span class="preprocessor"></span>
<a name="l00607"></a>00607 DBusUserDatabase *
<a name="l00608"></a>00608 _dbus_user_database_ref (DBusUserDatabase  *db)
<a name="l00609"></a>00609 {
<a name="l00610"></a>00610   _dbus_assert (db-&gt;refcount &gt; 0);
<a name="l00611"></a>00611 
<a name="l00612"></a>00612   db-&gt;refcount += 1;
<a name="l00613"></a>00613 
<a name="l00614"></a>00614   <span class="keywordflow">return</span> db;
<a name="l00615"></a>00615 }
<a name="l00616"></a>00616 <span class="preprocessor">#endif </span><span class="comment">/* DBUS_ENABLE_EMBEDDED_TESTS */</span>
<a name="l00617"></a>00617 
<a name="l00622"></a>00622 <span class="keywordtype">void</span>
<a name="l00623"></a><a class="code" href="group__DBusInternalsUtils.html#ga55dbb78c415da040037442eca4c4e80e">00623</a> <a class="code" href="group__DBusInternalsUtils.html#ga55dbb78c415da040037442eca4c4e80e" title="Decrements refcount of user database.">_dbus_user_database_unref</a> (DBusUserDatabase  *db)
<a name="l00624"></a>00624 {
<a name="l00625"></a>00625   _dbus_assert (db-&gt;refcount &gt; 0);
<a name="l00626"></a>00626 
<a name="l00627"></a>00627   db-&gt;refcount -= 1;
<a name="l00628"></a>00628   <span class="keywordflow">if</span> (db-&gt;refcount == 0)
<a name="l00629"></a>00629     {
<a name="l00630"></a>00630       <span class="keywordflow">if</span> (db-&gt;users)
<a name="l00631"></a>00631         <a class="code" href="group__DBusHashTable.html#ga96b777e00764b44e0f3216fd8478f5a9" title="Decrements the reference count for a hash table, freeing the hash table if the count reaches zero...">_dbus_hash_table_unref</a> (db-&gt;users);
<a name="l00632"></a>00632 
<a name="l00633"></a>00633       <span class="keywordflow">if</span> (db-&gt;groups)
<a name="l00634"></a>00634         <a class="code" href="group__DBusHashTable.html#ga96b777e00764b44e0f3216fd8478f5a9" title="Decrements the reference count for a hash table, freeing the hash table if the count reaches zero...">_dbus_hash_table_unref</a> (db-&gt;groups);
<a name="l00635"></a>00635 
<a name="l00636"></a>00636       <span class="keywordflow">if</span> (db-&gt;users_by_name)
<a name="l00637"></a>00637         <a class="code" href="group__DBusHashTable.html#ga96b777e00764b44e0f3216fd8478f5a9" title="Decrements the reference count for a hash table, freeing the hash table if the count reaches zero...">_dbus_hash_table_unref</a> (db-&gt;users_by_name);
<a name="l00638"></a>00638 
<a name="l00639"></a>00639       <span class="keywordflow">if</span> (db-&gt;groups_by_name)
<a name="l00640"></a>00640         <a class="code" href="group__DBusHashTable.html#ga96b777e00764b44e0f3216fd8478f5a9" title="Decrements the reference count for a hash table, freeing the hash table if the count reaches zero...">_dbus_hash_table_unref</a> (db-&gt;groups_by_name);
<a name="l00641"></a>00641       
<a name="l00642"></a>00642       <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> (db);
<a name="l00643"></a>00643     }
<a name="l00644"></a>00644 }
<a name="l00645"></a>00645 
<a name="l00656"></a>00656 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00657"></a><a class="code" href="group__DBusInternalsUtils.html#ga6a7e8b8cf3a6968972e9a49726022638">00657</a> <a class="code" href="group__DBusInternalsUtils.html#ga6a7e8b8cf3a6968972e9a49726022638" title="Gets the user information for the given UID, returned user info should not be freed.">_dbus_user_database_get_uid</a> (DBusUserDatabase    *db,
<a name="l00658"></a>00658                              <a class="code" href="group__DBusSysdeps.html#ga186e987b700f9ddc6cea8aa0db82b151" title="A user ID.">dbus_uid_t</a>           uid,
<a name="l00659"></a>00659                              <span class="keyword">const</span> <a class="code" href="structDBusUserInfo.html" title="Information about a UNIX user.">DBusUserInfo</a> **info,
<a name="l00660"></a>00660                              <a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a>           *error)
<a name="l00661"></a>00661 {
<a name="l00662"></a>00662   *info = <a class="code" href="group__DBusInternalsUtils.html#ga959372f7d7cdea35ffbac3b78e29a1b0" title="Looks up a uid or username in the user database.">_dbus_user_database_lookup</a> (db, uid, <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>, error);
<a name="l00663"></a>00663   <span class="keywordflow">return</span> *info != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00664"></a>00664 }
<a name="l00665"></a>00665 
<a name="l00675"></a>00675 <a class="code" href="group__DBusTypes.html#ga39c9cb0f3a2a8ad6f55cc4855d035349" title="A boolean, valid values are TRUE and FALSE.">dbus_bool_t</a>
<a name="l00676"></a><a class="code" href="group__DBusInternalsUtils.html#gaccf1d5b330707a1835dcf4ce49a29c8c">00676</a> <a class="code" href="group__DBusInternalsUtils.html#gaccf1d5b330707a1835dcf4ce49a29c8c" title="Gets the user information for the given username.">_dbus_user_database_get_username</a>  (DBusUserDatabase     *db,
<a name="l00677"></a>00677                                    <span class="keyword">const</span> <a class="code" href="structDBusString.html">DBusString</a>     *username,
<a name="l00678"></a>00678                                    <span class="keyword">const</span> <a class="code" href="structDBusUserInfo.html" title="Information about a UNIX user.">DBusUserInfo</a>  **info,
<a name="l00679"></a>00679                                    <a class="code" href="structDBusError.html" title="Object representing an exception.">DBusError</a>            *error)
<a name="l00680"></a>00680 {
<a name="l00681"></a>00681   *info = <a class="code" href="group__DBusInternalsUtils.html#ga959372f7d7cdea35ffbac3b78e29a1b0" title="Looks up a uid or username in the user database.">_dbus_user_database_lookup</a> (db, <a class="code" href="group__DBusSysdeps.html#ga3d2f3fb32bb759cabe362ca2de383f7d" title="an invalid UID used to represent an uninitialized dbus_uid_t field">DBUS_UID_UNSET</a>, username, error);
<a name="l00682"></a>00682   <span class="keywordflow">return</span> *info != <a class="code" href="group__DBusMacros.html#ga070d2ce7b6bb7e5c05602aa8c308d0c4" title="A null pointer, defined appropriately for C or C++.">NULL</a>;
<a name="l00683"></a>00683 }
<a name="l00684"></a>00684 
<a name="l00687"></a>00687 <span class="comment">/* Tests in dbus-userdb-util.c */</span>
</pre></div></div><!-- contents -->


<hr class="footer"/><address class="footer"><small>
Generated on Thu Mar 3 2016 17:50:32 for D-Bus by &#160;<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>