<?xml version="1.0" encoding="UTF-8"?>
<!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" lang="en_US" xml:lang="en_US">
<head>
<title>knewstuff: KNewStuffSecure Class Reference (knewstuff)</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org" r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org" r (n 0 s 0 v 0 l 0))' />
<meta name="trademark" content="KDE e.V." />
<meta name="description" content="K Desktop Environment Homepage, KDE.org" />
<meta name="MSSmartTagsPreventParsing" content="true" />
<meta name="robots" content="all" />
<link rel="shortcut icon" href="../../favicon.ico" />
<link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" />
</head>
<body>
<div id="nav_header_top" align="right">
<a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a>
<a href="../.."><img id="nav_header_logo" alt="Home" align="left" src="../../kde_gear_64.png" border="0" /></a>
<span class="doNotDisplay">::</span>
<div id="nav_header_title" align="left">KDE API Reference</div>
</div>
<div id="nav_header_bottom" align="right">
<span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span>
<div id="nav_header_bottom_right" style="text-align: left;">
/ <a href="../..">API Reference</a>
/ <a href=".">knewstuff</a>
</div>
</div>
<table id="main" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td valign="top" class="menuheader" height="0"></td>
<td id="contentcolumn" valign="top" rowspan="2" >
<div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;">
<a name="content"></a>
<!-- Generated by Doxygen 1.7.4 -->
</div>
<div class="header">
<div class="summary">
<a href="#signals">Signals</a> |
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pro-methods">Protected Member Functions</a> |
<a href="#pro-attribs">Protected Attributes</a> </div>
<div class="headertitle">
<div class="title">KNewStuffSecure Class Reference</div> </div>
</div>
<div class="contents">
<!-- doxytag: class="KNewStuffSecure" --><!-- doxytag: inherits="QObject,KNewStuff" -->
<p>Makes possible downloading and installing signed resource files from a server.
<a href="classKNewStuffSecure.html#details">More...</a></p>
<p><code>#include <<a class="el" href="knewstuffsecure_8h_source.html">knewstuffsecure.h</a>></code></p>
<div class="dynheader">
Inheritance diagram for KNewStuffSecure:</div>
<div class="dyncontent">
<div class="center">
<img src="classKNewStuffSecure.png" usemap="#KNewStuffSecure_map" alt=""/>
<map id="KNewStuffSecure_map" name="KNewStuffSecure_map">
<area href="qobject.html" alt="QObject" shape="rect" coords="0,0,112,24"/>
<area href="classKNewStuff.html" title="This class provides the functionality to download and upload "new stuff"." alt="KNewStuff" shape="rect" coords="122,0,234,24"/>
</map>
</div></div>
<p><a href="classKNewStuffSecure-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="signals"></a>
Signals</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="af9f8698d68ed24e34f6daebf24400eff"></a><!-- doxytag: member="KNewStuffSecure::installFinished" ref="af9f8698d68ed24e34f6daebf24400eff" args="()" -->
void </td><td class="memItemRight" valign="bottom"><b>installFinished</b> ()</td></tr>
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKNewStuffSecure.html#ad63fbb3caf9d2cdc8dcf68c0c83d7022">KNewStuffSecure</a> (const <a class="elRef" href="qstring.html">QString</a> &type, <a class="elRef" href="qwidget.html">QWidget</a> *parentWidget=0)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKNewStuffSecure.html#acec831e4f9f30f0dd2950d231be8a78c">install</a> (const <a class="elRef" href="qstring.html">QString</a> &fileName)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKNewStuffSecure.html#a616b08bee29bdf396e91494c75fa270c">createUploadFile</a> (const <a class="elRef" href="qstring.html">QString</a> &fileName)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKNewStuffSecure.html#ad7ff78f3fdeb94c626c5f5cff521534f">downloadResource</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKNewStuffSecure.html#a93be94654c561b20f877e0db11a29968">uploadResource</a> (const <a class="elRef" href="qstring.html">QString</a> &fileName)</td></tr>
<tr><td colspan="2"><h2><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKNewStuffSecure.html#af4a5398cb5c650406dfff084d885ea89">installResource</a> ()=0</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKNewStuffSecure.html#ae8bb9fa319db33930faf6894dfd314fc">removeTempDirectory</a> ()</td></tr>
<tr><td colspan="2"><h2><a name="pro-attribs"></a>
Protected Attributes</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ae3cc1b458f752274d0a024644c31dba7"></a><!-- doxytag: member="KNewStuffSecure::m_tempDir" ref="ae3cc1b458f752274d0a024644c31dba7" args="" -->
KTempDir * </td><td class="memItemRight" valign="bottom"><b>m_tempDir</b></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a41b9883493f7c7b91e0d91fc12894836"></a><!-- doxytag: member="KNewStuffSecure::m_tarName" ref="a41b9883493f7c7b91e0d91fc12894836" args="" -->
<a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><b>m_tarName</b></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a845adea46ad465815e8ab7f10c8ea454"></a><!-- doxytag: member="KNewStuffSecure::m_signedFileName" ref="a845adea46ad465815e8ab7f10c8ea454" args="" -->
<a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><b>m_signedFileName</b></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="af1b4430d2fd74abe75359d5735b1698d"></a><!-- doxytag: member="KNewStuffSecure::m_installedResources" ref="af1b4430d2fd74abe75359d5735b1698d" args="" -->
<a class="elRef" href="qmap.html">QMap</a>< <a class="elRef" href="qstring.html">QString</a>, <a class="elRef" href="qstring.html">QString</a> > </td><td class="memItemRight" valign="bottom"><b>m_installedResources</b></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>Makes possible downloading and installing signed resource files from a server. </p>
<p>You must subclass it and implement the <a class="el" href="classKNewStuffSecure.html#af4a5398cb5c650406dfff084d885ea89">installResource()</a> pure virtual method to install a resource. For uploading you must create a resource tarball (which is installabale by <a class="el" href="classKNewStuffSecure.html#af4a5398cb5c650406dfff084d885ea89">installResource()</a>) and call the <a class="el" href="classKNewStuffSecure.html#a93be94654c561b20f877e0db11a29968">uploadResource()</a> method with this tarball as the argument. Signing and verification is done by the gpg application, so the user must have it installed, otherwise this class does not give any extra security compared to the standard <a class="el" href="classKNewStuff.html" title="This class provides the functionality to download and upload "new stuff".">KNewStuff</a> class.</p>
<dl class="since"><dt><b>Since:</b></dt><dd>3.4</dd></dl>
<dl class="author"><dt><b>Author:</b></dt><dd>Andras Mantia <<a href="mailto:amantia@kde.org">amantia@kde.org</a>> </dd></dl>
<p>Definition at line <a class="el" href="knewstuffsecure_8h_source.html#l00040">40</a> of file <a class="el" href="knewstuffsecure_8h_source.html">knewstuffsecure.h</a>.</p>
</div><hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="ad63fbb3caf9d2cdc8dcf68c0c83d7022"></a><!-- doxytag: member="KNewStuffSecure::KNewStuffSecure" ref="ad63fbb3caf9d2cdc8dcf68c0c83d7022" args="(const QString &type, QWidget *parentWidget=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KNewStuffSecure::KNewStuffSecure </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" href="qwidget.html">QWidget</a> * </td>
<td class="paramname"><em>parentWidget</em> = <code>0</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Constructor. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>type of data to be handled, should be something like korganizer/calendar, kword/template, kdesktop/wallpaper </td></tr>
<tr><td class="paramname">parentWidget</td><td>parent widget of dialogs opened by the <a class="el" href="classKNewStuff.html" title="This class provides the functionality to download and upload "new stuff".">KNewStuff</a> engine </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="knewstuffsecure_8cpp_source.html#l00036">36</a> of file <a class="el" href="knewstuffsecure_8cpp_source.html">knewstuffsecure.cpp</a>.</p>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a616b08bee29bdf396e91494c75fa270c"></a><!-- doxytag: member="KNewStuffSecure::createUploadFile" ref="a616b08bee29bdf396e91494c75fa270c" args="(const QString &fileName)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KNewStuffSecure::createUploadFile </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>fileName</em></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Reimplemented for internal reasons. </p>
<p>Implements <a class="el" href="classKNewStuff.html#aeac94e85cc88eaef3ff5fca121434406">KNewStuff</a>.</p>
<p>Definition at line <a class="el" href="knewstuffsecure_8cpp_source.html#l00168">168</a> of file <a class="el" href="knewstuffsecure_8cpp_source.html">knewstuffsecure.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ad7ff78f3fdeb94c626c5f5cff521534f"></a><!-- doxytag: member="KNewStuffSecure::downloadResource" ref="ad7ff78f3fdeb94c626c5f5cff521534f" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KNewStuffSecure::downloadResource </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Initiates a download. </p>
<p>This is the method that must be called in order to download a signed resource. </p>
<p>Definition at line <a class="el" href="knewstuffsecure_8cpp_source.html#l00160">160</a> of file <a class="el" href="knewstuffsecure_8cpp_source.html">knewstuffsecure.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="acec831e4f9f30f0dd2950d231be8a78c"></a><!-- doxytag: member="KNewStuffSecure::install" ref="acec831e4f9f30f0dd2950d231be8a78c" args="(const QString &fileName)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KNewStuffSecure::install </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>fileName</em></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Installs the downloaded resource. </p>
<p>Do not call or reimplement directly. It's reimplemented from <a class="el" href="classKNewStuff.html" title="This class provides the functionality to download and upload "new stuff".">KNewStuff</a> for internal reasons. </p>
<p>Implements <a class="el" href="classKNewStuff.html#ada381f1cf3abd3985b45cfa9c4091592">KNewStuff</a>.</p>
<p>Definition at line <a class="el" href="knewstuffsecure_8cpp_source.html#l00049">49</a> of file <a class="el" href="knewstuffsecure_8cpp_source.html">knewstuffsecure.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="af4a5398cb5c650406dfff084d885ea89"></a><!-- doxytag: member="KNewStuffSecure::installResource" ref="af4a5398cb5c650406dfff084d885ea89" args="()=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void KNewStuffSecure::installResource </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [protected, pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Installs the resource specified by m_tarName. </p>
<p>Implement it in the subclass. </p>
</div>
</div>
<a class="anchor" id="ae8bb9fa319db33930faf6894dfd314fc"></a><!-- doxytag: member="KNewStuffSecure::removeTempDirectory" ref="ae8bb9fa319db33930faf6894dfd314fc" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KNewStuffSecure::removeTempDirectory </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Removes the temporary directory m_tempDir. </p>
<p>Definition at line <a class="el" href="knewstuffsecure_8cpp_source.html#l00230">230</a> of file <a class="el" href="knewstuffsecure_8cpp_source.html">knewstuffsecure.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a93be94654c561b20f877e0db11a29968"></a><!-- doxytag: member="KNewStuffSecure::uploadResource" ref="a93be94654c561b20f877e0db11a29968" args="(const QString &fileName)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KNewStuffSecure::uploadResource </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>fileName</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Signs the file and uploads to the central server. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">fileName</td><td>The file to be signed and uploaded </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="knewstuffsecure_8cpp_source.html#l00174">174</a> of file <a class="el" href="knewstuffsecure_8cpp_source.html">knewstuffsecure.cpp</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="knewstuffsecure_8h_source.html">knewstuffsecure.h</a></li>
<li><a class="el" href="knewstuffsecure_8cpp_source.html">knewstuffsecure.cpp</a></li>
</ul>
</div>
</div></div>
</td>
</tr>
<tr>
<td valign="top" id="leftmenu" width="25%">
<a name="navigation"></a>
<div class="menu_box"><h2>knewstuff</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="functions.html">Class Members</a></li><li><a href="pages.html">Related Pages</a></li></ul>
<!--
<h2>Class Picker</h2>
<div style="text-align: center;">
<form name="guideform">
<select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value">
<option value="annotated.html">-- Choose --</option>
<option value="classKNewStuff.html">knewstuff</option>, <option value="classKNewStuffGeneric.html">knewstuffgeneric</option>, <option value="classKNewStuffSecure.html">knewstuffsecure</option>, <option value="classKNS_1_1Button.html">kns::button</option>, <option value="classKNS_1_1DownloadDialog.html">kns::downloaddialog</option>, <option value="classKNS_1_1Engine.html">kns::engine</option>, <option value="classKNS_1_1Entry.html">kns::entry</option>, <option value="classKNS_1_1Provider.html">kns::provider</option>, <option value="classKNS_1_1ProviderDialog.html">kns::providerdialog</option>, <option value="classKNS_1_1ProviderLoader.html">kns::providerloader</option>, <option value="classKNS_1_1UploadDialog.html">kns::uploaddialog</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../arts/html/index.html">arts</a></li><li><a href="../../dcop/html/index.html">dcop</a></li><li><a href="../../dnssd/html/index.html">dnssd</a></li><li><a href="../../interfaces/html/index.html">interfaces</a></li><li> <a href="../../interfaces/kimproxy/interface/html/index.html">interface</a></li><li> <a href="../../interfaces/kimproxy/library/html/index.html">library</a></li><li> <a href="../../interfaces/kspeech/html/index.html">kspeech</a></li><li> <a href="../../interfaces/ktexteditor/html/index.html">ktexteditor</a></li><li><a href="../../kabc/html/index.html">kabc</a></li><li><a href="../../kate/html/index.html">kate</a></li><li><a href="../../kcmshell/html/index.html">kcmshell</a></li><li><a href="../../kdecore/html/index.html">kdecore</a></li><li><a href="../../kded/html/index.html">kded</a></li><li><a href="../../kdefx/html/index.html">kdefx</a></li><li><a href="../../kdeprint/html/index.html">kdeprint</a></li><li><a href="../../kdesu/html/index.html">kdesu</a></li><li><a href="../../kdeui/html/index.html">kdeui</a></li><li><a href="../../kdoctools/html/index.html">kdoctools</a></li><li><a href="../../khtml/html/index.html">khtml</a></li><li><a href="../../kimgio/html/index.html">kimgio</a></li><li><a href="../../kinit/html/index.html">kinit</a></li><li><a href="../../kio/html/index.html">kio</a></li><li> <a href="../../kio/bookmarks/html/index.html">bookmarks</a></li><li> <a href="../../kio/httpfilter/html/index.html">httpfilter</a></li><li> <a href="../../kio/kfile/html/index.html">kfile</a></li><li> <a href="../../kio/kio/html/index.html">kio</a></li><li> <a href="../../kio/kioexec/html/index.html">kioexec</a></li><li> <a href="../../kio/kpasswdserver/html/index.html">kpasswdserver</a></li><li> <a href="../../kio/kssl/html/index.html">kssl</a></li><li><a href="../../kioslave/html/index.html">kioslave</a></li><li> <a href="../../kioslave/http/html/index.html">http</a></li><li><a href="../../kjs/html/index.html">kjs</a></li><li><a href="../../kmdi/html/index.html">kmdi</a></li><li> <a href="../../kmdi/kmdi/html/index.html">kmdi</a></li><li><a href="../../knewstuff/html/index.html">knewstuff</a></li><li><a href="../../kparts/html/index.html">kparts</a></li><li><a href="../../kresources/html/index.html">kresources</a></li><li><a href="../../kspell2/html/index.html">kspell2</a></li><li><a href="../../kunittest/html/index.html">kunittest</a></li><li><a href="../../kutils/html/index.html">kutils</a></li><li><a href="../../kwallet/html/index.html">kwallet</a></li><li><a href="../../libkmid/html/index.html">libkmid</a></li><li><a href="../../libkscreensaver/html/index.html">libkscreensaver</a></li>
</ul></div></div>
</td>
</tr>
</table>
<span class="doNotDisplay">
<a href="http://www.kde.org/" accesskey="8">KDE Home</a> |
<a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> |
<a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a>
</span>
<div style="height: 8px"></div>
<div id="footer">
<div id="footer_left">
Maintained by <a href="mailto:groot@kde.org">Adriaan de Groot</a>
and
<a href="mailto:winter@kde.org">Allen Winter</a>.
<br/>
KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
<a href="http://www.kde.org/contact/impressum.php">Legal</a>
</div>
<div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div>
</div>
<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a>
WARNING END
-->
</body>
</html>
