This file is indexed.

/usr/share/qt5/doc/qtnfc/qnearfieldsharemanager.html is in qtconnectivity5-doc-html 5.5.1-2build1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qnearfieldsharemanager.cpp -->
  <title>QNearFieldShareManager Class | Qt NFC 5.5</title>
  <link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
    <div class="main">
    <div class="main-rounded">
        <div class="navigationbar">
        <ul>
<li>Qt 5.5</li>
<li><a href="qtnfc-index.html">Qt NFC</a></li>
<li><a href="qtnfc-module.html">C++ Classes</a></li>
<li>QNearFieldShareManager</li>
<li id="buildversion">Qt 5.5.1 Reference Documentation</li>
    </ul>
    </div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-types">Public Types</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#signals">Signals</a></li>
<li class="level1"><a href="#static-public-members">Static Public Members</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">QNearFieldShareManager Class</h1>
<!-- $$$QNearFieldShareManager-brief -->
<p>The <a href="qnearfieldsharemanager.html">QNearFieldShareManager</a> class manages all interactions related to sharing files and data over NFC. <a href="#details">More...</a></p>
<!-- @@@QNearFieldShareManager -->
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> Header:</td><td class="memItemRight bottomAlign"> <span class="preprocessor">#include &lt;QNearFieldShareManager&gt;</span>
</td></tr><tr><td class="memItemLeft rightAlign topAlign"> qmake:</td><td class="memItemRight bottomAlign"> QT += nfc</td></tr><tr><td class="memItemLeft rightAlign topAlign"> Since:</td><td class="memItemRight bottomAlign">  Qt 5.3</td></tr><tr><td class="memItemLeft rightAlign topAlign"> Inherits:</td><td class="memItemRight bottomAlign"> <a href="../qtcore/qobject.html">QObject</a></td></tr></table></div><ul>
<li><a href="qnearfieldsharemanager-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h2 id="public-types">Public Types</h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#ShareError-enum">ShareError</a></b> { NoError, UnknownError, InvalidShareContentError, ShareCanceledError, ..., SharePermissionDeniedError }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#ShareMode-enum">ShareMode</a></b> { NoShare, NdefShare, FileShare }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> flags </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#ShareMode-enum">ShareModes</a></b></td></tr>
</table></div>
<a name="public-functions"></a>
<h2 id="public-functions">Public Functions</h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#QNearFieldShareManager">QNearFieldShareManager</a></b>(QObject *<i> parent</i> = 0)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#dtor.QNearFieldShareManager">~QNearFieldShareManager</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#setShareModes">setShareModes</a></b>(ShareModes<i> mode</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QNearFieldShareManager::ShareError </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#shareError">shareError</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QNearFieldShareManager::ShareModes </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#shareModes">shareModes</a></b>() const</td></tr>
</table></div>
<ul>
<li class="fn">31 public functions inherited from <a href="../qtcore/qobject.html#public-functions">QObject</a></li>
</ul>
<a name="signals"></a>
<h2 id="signals">Signals</h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#error">error</a></b>(QNearFieldShareManager::ShareError<i> error</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#shareModesChanged">shareModesChanged</a></b>(QNearFieldShareManager::ShareModes<i> modes</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#targetDetected">targetDetected</a></b>(QNearFieldShareTarget *<i> shareTarget</i>)</td></tr>
</table></div>
<ul>
<li class="fn">2 signals inherited from <a href="../qtcore/qobject.html#signals">QObject</a></li>
</ul>
<a name="static-public-members"></a>
<h2 id="static-public-members">Static Public Members</h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> QNearFieldShareManager::ShareModes </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#supportedShareModes">supportedShareModes</a></b>()</td></tr>
</table></div>
<ul>
<li class="fn">10 static public members inherited from <a href="../qtcore/qobject.html#static-public-members">QObject</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">1 property inherited from <a href="../qtcore/qobject.html#properties">QObject</a></li>
<li class="fn">1 public slot inherited from <a href="../qtcore/qobject.html#public-slots">QObject</a></li>
<li class="fn">1 public variable inherited from <a href="../qtcore/qobject.html#public-variables">QObject</a></li>
<li class="fn">9 protected functions inherited from <a href="../qtcore/qobject.html#protected-functions">QObject</a></li>
<li class="fn">2 protected variables inherited from <a href="../qtcore/qobject.html#protected-variables">QObject</a></li>
</ul>
<a name="details"></a>
<!-- $$$QNearFieldShareManager-description -->
<div class="descr">
<h2 id="details">Detailed Description</h2>
<p>The <a href="qnearfieldsharemanager.html">QNearFieldShareManager</a> class manages all interactions related to sharing files and data over NFC.</p>
<p>Applications can share NDEF data or file content using NFC technology by tapping two NFC-enabled devices together. The <a href="qnearfieldsharemanager.html">QNearFieldShareManager</a> provides a high level entry point to access this functionality.</p>
<p>The class allows both NDEF data and/or files to be shared between two devices by calling the <a href="qnearfieldsharemanager.html#setShareModes">setShareModes</a>() method. This method specifies either an NDEF Data and/or a File transfer. The <a href="qnearfieldsharemanager.html#targetDetected">targetDetected</a>() signal is emitted each time a share target is detected. A <a href="qnearfieldsharetarget.html">QNearFieldShareTarget</a> pointer is passed with the signal, which can be used to share either an NDEF message or one or more files.</p>
<p>The process of sharing files via NFC involves other underlying communication transports such as Bluetooth or Wi-Fi Direct. It is implementation specific how and what type of transports are used to perform file transfer. The overall time taken to transfer content depends on the maximum speed of the transport used. Note that the process of sharing NDEF message/data does not require the use of other transports outside NFC.</p>
<p>If an error occurs, <a href="qnearfieldsharemanager.html#shareError">shareError</a>() returns the error type.</p>
<p>Platforms that do not support both NDEF data and file content sharing modes can return the supported subset in the <a href="qnearfieldsharemanager.html#supportedShareModes">supportedShareModes</a>() method. Applications that call <a href="qnearfieldsharemanager.html#setShareModes">setShareModes</a>() with an unsupported mode will receive an error signal with a <a href="qnearfieldsharemanager.html#ShareError-enum">UnsupportedShareModeError</a>.</p>
<p>Since sharing data over NFC is effectively a data pipe between two processes (one on the sender and one of the receiver), the application developer should only create a single instance of <a href="qnearfieldsharemanager.html">QNearFieldShareManager</a> per application. This avoids the possibility that different parts of the same application attempt to all consume data transferred over NFC.</p>
</div>
<!-- @@@QNearFieldShareManager -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$ShareError$$$NoError$$$UnknownError$$$InvalidShareContentError$$$ShareCanceledError$$$ShareInterruptedError$$$ShareRejectedError$$$UnsupportedShareModeError$$$ShareAlreadyInProgressError$$$SharePermissionDeniedError -->
<h3 class="fn" id="ShareError-enum"><a name="ShareError-enum"></a>enum QNearFieldShareManager::<span class="name">ShareError</span></h3>
<p>This enum specifies the share error type.</p>
<div class="table"><table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::NoError</code></td><td class="topAlign"><code>0</code></td><td class="topAlign">No error.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::UnknownError</code></td><td class="topAlign"><code>1</code></td><td class="topAlign">Unknown or internal error occurred.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::InvalidShareContentError</code></td><td class="topAlign"><code>2</code></td><td class="topAlign">Invalid content was provided for sharing.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::ShareCanceledError</code></td><td class="topAlign"><code>3</code></td><td class="topAlign">Data or file sharing is canceled on the local or remote device.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::ShareInterruptedError</code></td><td class="topAlign"><code>4</code></td><td class="topAlign">Data or file sharing is interrupted due to an I/O error.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::ShareRejectedError</code></td><td class="topAlign"><code>5</code></td><td class="topAlign">Data or file sharing is rejected by the remote device.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::UnsupportedShareModeError</code></td><td class="topAlign"><code>6</code></td><td class="topAlign">Data or file sharing is not supported by the share target.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::ShareAlreadyInProgressError</code></td><td class="topAlign"><code>7</code></td><td class="topAlign">Data or file sharing is already in progress.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::SharePermissionDeniedError</code></td><td class="topAlign"><code>8</code></td><td class="topAlign">File sharing is denied due to insufficient permission.</td></tr>
</table></div>
<!-- @@@ShareError -->
<!-- $$$ShareMode$$$NoShare$$$NdefShare$$$FileShare -->
<h3 class="flags" id="ShareMode-enum"><a name="ShareMode-enum"></a>enum QNearFieldShareManager::<span class="name">ShareMode</span><br/>flags QNearFieldShareManager::<span class="name">ShareModes</span></h3>
<p>This enum specifies the content type to be shared.</p>
<div class="table"><table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::NoShare</code></td><td class="topAlign"><code>0x00</code></td><td class="topAlign">No content is currently set to be shared.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::NdefShare</code></td><td class="topAlign"><code>0x01</code></td><td class="topAlign">Share NDEF message with target.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::FileShare</code></td><td class="topAlign"><code>0x02</code></td><td class="topAlign">Share file with target.</td></tr>
</table></div>
<p>The ShareModes type is a typedef for <a href="../qtcore/qflags.html">QFlags</a>&lt;ShareMode&gt;. It stores an OR combination of ShareMode values.</p>
<!-- @@@ShareMode -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QNearFieldShareManager[overload1]$$$QNearFieldShareManagerQObject* -->
<h3 class="fn" id="QNearFieldShareManager"><a name="QNearFieldShareManager"></a>QNearFieldShareManager::<span class="name">QNearFieldShareManager</span>(<span class="type"><a href="../qtcore/qobject.html#QObject">QObject</a></span> *<i> parent</i> = 0)</h3>
<p>Constructs a new near field share manager with <i>parent</i>.</p>
<!-- @@@QNearFieldShareManager -->
<!-- $$$~QNearFieldShareManager[overload1]$$$~QNearFieldShareManager -->
<h3 class="fn" id="dtor.QNearFieldShareManager"><a name="dtor.QNearFieldShareManager"></a>QNearFieldShareManager::<span class="name">~QNearFieldShareManager</span>()</h3>
<p>Destroys the near field share manager.</p>
<!-- @@@~QNearFieldShareManager -->
<!-- $$$error[overload1]$$$errorQNearFieldShareManager::ShareError -->
<h3 class="fn" id="error"><a name="error"></a><code>[signal] </code><span class="type">void</span> QNearFieldShareManager::<span class="name">error</span>(<span class="type"><a href="qnearfieldsharemanager.html#ShareError-enum">QNearFieldShareManager::ShareError</a></span><i> error</i>)</h3>
<p>This signal is emitted whenever an <i>error</i> occurs related to a share request.</p>
<!-- @@@error -->
<!-- $$$setShareModes[overload1]$$$setShareModesShareModes -->
<h3 class="fn" id="setShareModes"><a name="setShareModes"></a><span class="type">void</span> QNearFieldShareManager::<span class="name">setShareModes</span>(<span class="type"><a href="qnearfieldsharemanager.html#ShareMode-enum">ShareModes</a></span><i> mode</i>)</h3>
<p>Initializes the NFC share <i>mode</i> to detect a <a href="qnearfieldsharetarget.html">QNearFieldShareTarget</a> for data and/or file sharing. Calls to this method will overwrite previous share modes.</p>
<p>A <a href="qnearfieldsharemanager.html#shareModesChanged">shareModesChanged</a>() signal will be emitted when share modes are different from previous modes. A <a href="qnearfieldsharemanager.html#targetDetected">targetDetected</a>() signal will be emitted if a share target is detected.</p>
<p><b>See also </b><a href="qnearfieldsharemanager.html#shareModes">shareModes</a>().</p>
<!-- @@@setShareModes -->
<!-- $$$shareError[overload1]$$$shareError -->
<h3 class="fn" id="shareError"><a name="shareError"></a><span class="type"><a href="qnearfieldsharemanager.html#ShareError-enum">QNearFieldShareManager::ShareError</a></span> QNearFieldShareManager::<span class="name">shareError</span>() const</h3>
<p>Returns the error code of the error that occurred.</p>
<!-- @@@shareError -->
<!-- $$$shareModes[overload1]$$$shareModes -->
<h3 class="fn" id="shareModes"><a name="shareModes"></a><span class="type"><a href="qnearfieldsharemanager.html#ShareMode-enum">QNearFieldShareManager::ShareModes</a></span> QNearFieldShareManager::<span class="name">shareModes</span>() const</h3>
<p>Returns which shared modes are set.</p>
<p><b>See also </b><a href="qnearfieldsharemanager.html#setShareModes">setShareModes</a>().</p>
<!-- @@@shareModes -->
<!-- $$$shareModesChanged[overload1]$$$shareModesChangedQNearFieldShareManager::ShareModes -->
<h3 class="fn" id="shareModesChanged"><a name="shareModesChanged"></a><code>[signal] </code><span class="type">void</span> QNearFieldShareManager::<span class="name">shareModesChanged</span>(<span class="type"><a href="qnearfieldsharemanager.html#ShareMode-enum">QNearFieldShareManager::ShareModes</a></span><i> modes</i>)</h3>
<p>This signal is emitted whenever the share <i>modes</i> are changed.</p>
<!-- @@@shareModesChanged -->
<!-- $$$supportedShareModes[overload1]$$$supportedShareModes -->
<h3 class="fn" id="supportedShareModes"><a name="supportedShareModes"></a><code>[static] </code><span class="type"><a href="qnearfieldsharemanager.html#ShareMode-enum">QNearFieldShareManager::ShareModes</a></span> QNearFieldShareManager::<span class="name">supportedShareModes</span>()</h3>
<p>Returns the shared modes supported by NFC.</p>
<!-- @@@supportedShareModes -->
<!-- $$$targetDetected[overload1]$$$targetDetectedQNearFieldShareTarget* -->
<h3 class="fn" id="targetDetected"><a name="targetDetected"></a><code>[signal] </code><span class="type">void</span> QNearFieldShareManager::<span class="name">targetDetected</span>(<span class="type"><a href="qnearfieldsharetarget.html">QNearFieldShareTarget</a></span> *<i> shareTarget</i>)</h3>
<p>This signal is emitted whenever a <i>shareTarget</i> is detected. The <i>shareTarget</i> instance is owned by <a href="qnearfieldsharemanager.html">QNearFieldShareManager</a> and must not be deleted by the application.</p>
<!-- @@@targetDetected -->
</div>
        </div>
       </div>
   </div>
   </div>
</div>
<div class="footer">
   <p>
   <acronym title="Copyright">&copy;</acronym> 2015 The Qt Company Ltd.
   Documentation contributions included herein are the copyrights of
   their respective owners.<br>    The documentation provided herein is licensed under the terms of the    <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation    License version 1.3</a> as published by the Free Software Foundation.<br>    Qt and respective logos are trademarks of The Qt Company Ltd.     in Finland and/or other countries worldwide. All other trademarks are property
   of their respective owners. </p>
</div>
</body>
</html>