/usr/share/doc/content-hub/cpp/html/Mainpage_8md_source.html is in libcontent-hub-doc 0.1+16.04.20160309-0ubuntu1.
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 | <!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"/>
<meta name="generator" content="Doxygen 1.8.11"/>
<title>Content Hub: /build/content-hub-yZSh3W/content-hub-0.1+16.04.20160309/doc/Mainpage.md Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
$(window).load(resizeHeight);
</script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
$(document).ready(function() { init_search(); });
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="extra.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">Content Hub
 <span id="projectnumber">0.0.1</span>
</div>
<div id="projectbrief">A session-wide content-exchange service</div>
</td>
<td> <div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.11 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('Mainpage_8md.html','');});
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div class="header">
<div class="headertitle">
<div class="title">/build/content-hub-yZSh3W/content-hub-0.1+16.04.20160309/doc/Mainpage.md</div> </div>
</div><!--header-->
<div class="contents">
<a href="Mainpage_8md.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> Content Management & Exchange {#mainpage}</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> =============================</div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> </div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> Unity and the overall Ubuntu experience put heavy emphasis on the</div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> notion of content, with Unity's dash offering streamlined access to</div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> arbitrary content, both local to the device or online. More to this,</div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> Unity's dash is the primary way of surfacing content on mobile form</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> factors without the need to access individual applications and their</div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> respective content silos. The content-hub deals with</div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> application-specific content management and implements an architecture</div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> that allows an app to define its own content silo, exchange content</div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> with other applications/the system, and a way to provide the user with</div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> content picking functionality.</div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> </div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> To ease conversations, we start over with a set of definitions:</div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span> </div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span>  - Content item: A content item is an entity that consists of meta-data</div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> and data. E.g., an image is a content item, where the actual pixels</div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span> are the data, and information like size, image format, bit depth,</div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> location etc. is considered meta data. \sa com::ubuntu::content::Item.</div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> </div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span>  - Content types: A set of well-known content types. E.g., images or</div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span>  music files. \sa com::ubuntu::content::Type.</div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> </div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span>  - Content set: A set of unique content items. Can be considered a</div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span>  content item itself, e.g., in the case of playlists.</div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> </div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span>  - Content owner: The unique owner of a content item. A content item</div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span>  has to be owned by exactly one app. \sa com::ubuntu::content::Peer</div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> </div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span>  - Content store: A container (think of it as a top-level folder in</div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span>  the filesystem) that contains content items of a certain</div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span>  type. Different stores exist for different scopes, where scope</div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span>  refers to either system-wide, user-wide or app-specific storage</div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span>  locations. \sa com::ubuntu::content::Store, com::ubuntu::content::Scope</div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> </div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span>  - Content transfer: Transferring content item/s to and from a source</div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span>  or destination. A transfer is uniquely defined by:</div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span>  * The content source</div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span>  * The content destination</div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span>  * The transfer direction, either import or export</div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span>  * The set of items that should be exchanged</div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  \sa com::ubuntu::content::Transfer, com::ubuntu::content::Hub::create_import_for_type_from_peer</div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span> </div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  - Content picking: Operation that allows a user to select content for</div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span>  subsequent import from a content source (e.g., an application). The</div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span>  content source is responsible for providing a UI to the user.</div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> </div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span> Architectural Overview</div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> ----------------------</div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span> </div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span> The architecture enforces complete application isolation, both in</div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span> terms of content separation, sandboxing/confinement and in terms of</div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span> the application lifecycle. As we cannot assume that two apps that want</div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span> to exchange content are running at the same time, a system-level</div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span> component needs to mediate and control the content exchange operation,</div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span> making sure that neither app instance assumes the existence of the</div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span> other one. We refer to this component as the content hub. \sa com::ubuntu::content::Hub</div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span> </div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span> Example usage - Importing Pictures</div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span> ----------------------------------</div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span> </div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span> \snippet acceptance-tests/app_hub_communication_transfer.cpp Importing pictures</div></div><!-- fragment --></div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="navelem"><a class="el" href="Mainpage_8md.html">Mainpage.md</a></li>
<li class="footer">Generated on Wed Mar 9 2016 14:03:08 for Content Hub by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.11 </li>
</ul>
</div>
</body>
</html>
|