|
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 : /proc/21573/root/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: SHA implementation</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>SHA implementation<br>
<small>
[<a class="el" href="group__DBusInternals.html">D-Bus secret internal implementation details</a>]</small>
</h1>SHA-1 hash.
<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">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBusSHA.html#ge7c1a8ad734655b70e67e9a1498465f7">_dbus_sha_init</a> (<a class="el" href="structDBusSHAContext.html">DBusSHAContext</a> *context)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Initializes the SHA context. <a href="#ge7c1a8ad734655b70e67e9a1498465f7"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBusSHA.html#ge9c5e5cd39e2dc151ef1c54819aef3b6">_dbus_sha_update</a> (<a class="el" href="structDBusSHAContext.html">DBusSHAContext</a> *context, const <a class="el" href="structDBusString.html">DBusString</a> *data)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Feeds more data into an existing shasum computation. <a href="#ge9c5e5cd39e2dc151ef1c54819aef3b6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__DBusTypes.html#g39c9cb0f3a2a8ad6f55cc4855d035349">dbus_bool_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBusSHA.html#gf685311db11cc2e6b38fc62d171311e4">_dbus_sha_final</a> (<a class="el" href="structDBusSHAContext.html">DBusSHAContext</a> *context, <a class="el" href="structDBusString.html">DBusString</a> *results)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">SHA finalization. <a href="#gf685311db11cc2e6b38fc62d171311e4"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__DBusTypes.html#g39c9cb0f3a2a8ad6f55cc4855d035349">dbus_bool_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBusSHA.html#g4278fb9df967943834c4ad6332f2c28b">_dbus_sha_compute</a> (const <a class="el" href="structDBusString.html">DBusString</a> *data, <a class="el" href="structDBusString.html">DBusString</a> *ascii_output)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Computes the ASCII hex-encoded shasum of the given data and appends it to the output string. <a href="#g4278fb9df967943834c4ad6332f2c28b"></a><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
SHA-1 hash.
<p>
Types and functions related to computing SHA-1 hash. <hr><h2>Function Documentation</h2>
<a class="anchor" name="g4278fb9df967943834c4ad6332f2c28b"></a><!-- doxytag: member="dbus-sha.c::_dbus_sha_compute" ref="g4278fb9df967943834c4ad6332f2c28b" args="(const DBusString *data, DBusString *ascii_output)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__DBusTypes.html#g39c9cb0f3a2a8ad6f55cc4855d035349">dbus_bool_t</a> _dbus_sha_compute </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="structDBusString.html">DBusString</a> * </td>
<td class="paramname"> <em>data</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structDBusString.html">DBusString</a> * </td>
<td class="paramname"> <em>ascii_output</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Computes the ASCII hex-encoded shasum of the given data and appends it to the output string.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>data</em> </td><td>input data to be hashed </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ascii_output</em> </td><td>string to append ASCII shasum to </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd><a class="el" href="group__DBusMacros.html#ga93f0eb578d23995850d61f7d61c55c1">FALSE</a> if not enough memory </dd></dl>
<p>
Definition at line <a class="el" href="dbus-sha_8c-source.html#l00482">482</a> of file <a class="el" href="dbus-sha_8c-source.html">dbus-sha.c</a>.
<p>
References <a class="el" href="dbus-sha_8c-source.html#l00455">_dbus_sha_final()</a>, <a class="el" href="dbus-sha_8c-source.html#l00419">_dbus_sha_init()</a>, <a class="el" href="dbus-sha_8c-source.html#l00431">_dbus_sha_update()</a>, <a class="el" href="dbus-string_8c-source.html#l00262">_dbus_string_free()</a>, <a class="el" href="dbus-string_8c-source.html#l02442">_dbus_string_hex_encode()</a>, <a class="el" href="dbus-string_8c-source.html#l00175">_dbus_string_init()</a>, <a class="el" href="group__DBusMacros.html#ga93f0eb578d23995850d61f7d61c55c1">FALSE</a>, and <a class="el" href="group__DBusMacros.html#ga8cecfc5c5c054d2875c03e77b7be15d">TRUE</a>.
</div>
</div><p>
<a class="anchor" name="gf685311db11cc2e6b38fc62d171311e4"></a><!-- doxytag: member="dbus-sha.c::_dbus_sha_final" ref="gf685311db11cc2e6b38fc62d171311e4" args="(DBusSHAContext *context, DBusString *results)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__DBusTypes.html#g39c9cb0f3a2a8ad6f55cc4855d035349">dbus_bool_t</a> _dbus_sha_final </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structDBusSHAContext.html">DBusSHAContext</a> * </td>
<td class="paramname"> <em>context</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structDBusString.html">DBusString</a> * </td>
<td class="paramname"> <em>results</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
SHA finalization.
<p>
Ends an SHA message-digest operation, writing the the message digest and zeroing the context. The results are returned as a raw 20-byte digest, not as the ascii-hex-digits string form of the digest.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>the SHA context </td></tr>
<tr><td valign="top"></td><td valign="top"><em>results</em> </td><td>string to append the 20-byte SHA digest to </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd><a class="el" href="group__DBusMacros.html#ga93f0eb578d23995850d61f7d61c55c1">FALSE</a> if not enough memory to append the digest </dd></dl>
<p>
Definition at line <a class="el" href="dbus-sha_8c-source.html#l00455">455</a> of file <a class="el" href="dbus-sha_8c-source.html">dbus-sha.c</a>.
<p>
References <a class="el" href="dbus-string_8c-source.html#l01253">_dbus_string_append_len()</a>, <a class="el" href="group__DBusMacros.html#ga93f0eb578d23995850d61f7d61c55c1">FALSE</a>, and <a class="el" href="group__DBusMacros.html#ga8cecfc5c5c054d2875c03e77b7be15d">TRUE</a>.
<p>
Referenced by <a class="el" href="dbus-sha_8c-source.html#l00482">_dbus_sha_compute()</a>.
</div>
</div><p>
<a class="anchor" name="ge7c1a8ad734655b70e67e9a1498465f7"></a><!-- doxytag: member="dbus-sha.c::_dbus_sha_init" ref="ge7c1a8ad734655b70e67e9a1498465f7" args="(DBusSHAContext *context)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void _dbus_sha_init </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structDBusSHAContext.html">DBusSHAContext</a> * </td>
<td class="paramname"> <em>context</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Initializes the SHA context.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>an uninitialized context, typically on the stack. </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-sha_8c-source.html#l00419">419</a> of file <a class="el" href="dbus-sha_8c-source.html">dbus-sha.c</a>.
<p>
Referenced by <a class="el" href="dbus-sha_8c-source.html#l00482">_dbus_sha_compute()</a>.
</div>
</div><p>
<a class="anchor" name="ge9c5e5cd39e2dc151ef1c54819aef3b6"></a><!-- doxytag: member="dbus-sha.c::_dbus_sha_update" ref="ge9c5e5cd39e2dc151ef1c54819aef3b6" args="(DBusSHAContext *context, const DBusString *data)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void _dbus_sha_update </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structDBusSHAContext.html">DBusSHAContext</a> * </td>
<td class="paramname"> <em>context</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="structDBusString.html">DBusString</a> * </td>
<td class="paramname"> <em>data</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Feeds more data into an existing shasum computation.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>the SHA context </td></tr>
<tr><td valign="top"></td><td valign="top"><em>data</em> </td><td>the additional data to hash </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-sha_8c-source.html#l00431">431</a> of file <a class="el" href="dbus-sha_8c-source.html">dbus-sha.c</a>.
<p>
Referenced by <a class="el" href="dbus-sha_8c-source.html#l00482">_dbus_sha_compute()</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>