|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /usr/share/devhelp/books/dbus/api/ |
Upload File : |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>D-Bus: Miscellaneous</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.4.7 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</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><a href="files.html"><span>Files</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
</ul></div>
<h1>Miscellaneous<br>
<small>
[<a class="el" href="group__DBus.html">D-Bus low-level public API</a>]</small>
</h1>Miscellaneous API that doesn't cleanly fit anywhere else.
<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBusMisc.html#g67af2ecc0bacf9a35818d2f881233088">dbus_get_local_machine_id</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Obtains the machine UUID of the machine this process is running on. <a href="#g67af2ecc0bacf9a35818d2f881233088"></a><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
Miscellaneous API that doesn't cleanly fit anywhere else.
<p>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="g67af2ecc0bacf9a35818d2f881233088"></a><!-- doxytag: member="dbus-misc.c::dbus_get_local_machine_id" ref="g67af2ecc0bacf9a35818d2f881233088" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char * dbus_get_local_machine_id </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Obtains the machine UUID of the machine this process is running on.
<p>
The returned string must be freed with <a class="el" href="group__DBusMemory.html#g488c6b08cc8c1ddf0203243c4b27a13c">dbus_free()</a>.<p>
This UUID is guaranteed to remain the same until the next reboot (unless the sysadmin foolishly changes it and screws themselves). It will usually remain the same across reboots also, but hardware configuration changes or rebuilding the machine could break that.<p>
The idea is that two processes with the same machine ID should be able to use shared memory, UNIX domain sockets, process IDs, and other features of the OS that require both processes to be running on the same OS kernel instance.<p>
The machine ID can also be used to create unique per-machine instances. For example, you could use it in bus names or X selection names.<p>
The machine ID is preferred over the machine hostname, because the hostname is frequently set to "localhost.localdomain" and may also change at runtime.<p>
You can get the machine ID of a remote application by invoking the method GetMachineId from interface org.freedesktop.DBus.Peer.<p>
If the remote application has the same machine ID as the one returned by this function, then the remote application is on the same machine as your application.<p>
The UUID is not a UUID in the sense of RFC4122; the details are explained in the D-Bus specification.<p>
<dl compact><dt><b>Returns:</b></dt><dd>a 32-byte-long hex-encoded UUID string, or <a class="el" href="group__DBusMacros.html#g070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> if insufficient memory </dd></dl>
<p>
Definition at line <a class="el" href="dbus-misc_8c-source.html#l00073">73</a> of file <a class="el" href="dbus-misc_8c-source.html">dbus-misc.c</a>.
<p>
References <a class="el" href="dbus-internals_8c-source.html#l00715">_dbus_get_local_machine_uuid_encoded()</a>, <a class="el" href="dbus-string_8c-source.html#l00262">_dbus_string_free()</a>, <a class="el" href="dbus-string_8c-source.html#l00175">_dbus_string_init()</a>, <a class="el" href="dbus-string_8c-source.html#l00608">_dbus_string_steal_data()</a>, <a class="el" href="group__DBusMacros.html#ga93f0eb578d23995850d61f7d61c55c1">FALSE</a>, and <a class="el" href="group__DBusMacros.html#g070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>.
</div>
</div><p>
<hr size="1"><address style="align: right;"><small>Generated on Mon Dec 14 22:26:14 2009 for D-Bus by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.7 </small></address>
</body>
</html>