fix svg path for gen html
[src/app-framework-main.git] / docs / overview.md
index d39e66e..c3627bc 100644 (file)
@@ -1,6 +1,5 @@
-
-AGL framework, overview of the proposal of IoT.bzh
-==================================================
+AGL framework, IoT.bzh proposal overview
+========================================
 
 Foreword
 --------
 
 Foreword
 --------
@@ -30,7 +29,7 @@ Here is a minimal list of what was needed:
  - platform/core/appfw/pkgmgr-info
  - platform/core/appfw/slp-pkgmgr
 
  - platform/core/appfw/pkgmgr-info
  - platform/core/appfw/slp-pkgmgr
 
-But this list is complete because many dependencies are hidden.
+But this list isn't complete because many dependencies are hidden.
 Those hidden dependencies are including some common libraries but also many
 tizen specific sub-components (iniparser, bundle, dlog, libtzplatform-config,
 db-util, vconf-buxton, ...).
 Those hidden dependencies are including some common libraries but also many
 tizen specific sub-components (iniparser, bundle, dlog, libtzplatform-config,
 db-util, vconf-buxton, ...).
@@ -56,15 +55,7 @@ The 3 layers are providing components for:
 
 The figure below shows the history of these layers.
 
 
 The figure below shows the history of these layers.
 
-
-                      2014         2015
-    Tizen OBS ----------+--------------------------->
-                         \
-                          \
-         Tizen Yocto       +---------+-------------->
-                                      \
-                                       \
-           meta-intel-iot-security      +----------->
+![Security_model_history][Security_model_history]
 
 We took the decision to use these security layers that provides the
 basis of the Tizen security, the security framework.
 
 We took the decision to use these security layers that provides the
 basis of the Tizen security, the security framework.
@@ -77,7 +68,7 @@ the dependencies and with minor architectural improvements for AGL.
 
 These components are **afm-system-daemon** and **afm-user-daemon**.
 They provides infrastructure for installing, uninstalling,
 
 These components are **afm-system-daemon** and **afm-user-daemon**.
 They provides infrastructure for installing, uninstalling,
-launching, terminating, stopping and resuming applications in
+launching, terminating, pausing and resuming applications in
 a multi user secure environment.
 
 A third component exists in the framework, the binder **afb-daemon**.
 a multi user secure environment.
 
 A third component exists in the framework, the binder **afb-daemon**.
@@ -96,50 +87,7 @@ The figure below shows the major components of the framework
 and their interactions going through the following scenario:
 APPLICATION installs an other application and then launch it.
 
 and their interactions going through the following scenario:
 APPLICATION installs an other application and then launch it.
 
-    +-----------------------------------------------------------------------+
-    |                                 User                                  |
-    |  ................................                                     |
-    |  :   Smack isolation context    :                                     |
-    |  :                              :      ...........................    |
-    |  :  +-----------------------+   :      : Smack isolation context :    |
-    |  :  |                       |   :      :                         :    |
-    |  :  |      APPLICATION      |   :      :     OTHER application   :    |
-    |  :  |                       |   :      :.........................:    |
-    |  :  +-----------+-----------+   :                ^                    |
-    |  :              |               :                |                    |
-    |  :              |(1),(7)        :                |(13)                |
-    |  :              |               :                |                    |
-    |  :  +-----------v-----------+   :      +---------+---------------+    |
-    |  :  |   binder afb-daemon   |   :      |                         |    |
-    |  :  +-----------------------+   :      |      afm-user-daemon    |    |
-    |  :  |    afm-main-binding   |   :      |                         |    |
-    |  :  +-----+--------------+--+   :      +------^-------+------+---+    |
-    |  :........|..............|......:             |       |      :        |
-    |           |(2)           |(8)                 |(10)   |      :        |
-    |           |              |                    |       |      :        |
-    |           |         +----v--------------------+---+   |      :        |
-    |           |         |        D-Bus   session      |   |(11)  :(12)    |
-    |           |         +-------------------------+---+   |      :        |
-    |           |                                   |       |      :        |
-    |           |                                   |(9)    |      :        |
-    |           |                                   |       |      :        |
-    :===========|===================================|=======|======:========:
-    |           |                                   |       |      :        |
-    |           |                               +---v-------v--+   :        |
-    |    +------v-------------+     (3)         |              |   :        |
-    |    |  D-Bus   system    +----------------->    CYNARA    |   :        |
-    |    +------+-------------+                 |              |   :        |
-    |           |                               +------^-------+   :        |
-    |           |(4)                                   |           :        |
-    |           |                                      |(6)        v        |
-    |    +------v--------------+             +---------+---------------+    |
-    |    |                     |    (5)      |                         |    |
-    |    |  afm-system-daemon  +------------->     SECURITY-MANAGER    |    |
-    |    |                     |             |                         |    |
-    |    +---------------------+             +-------------------------+    |
-    |                                                                       |
-    |                              System                                   |
-    +-----------------------------------------------------------------------+
+![AppFW-APP_install_sequences][AppFW-APP_install_sequences]
 
 Let follow the sequence of calls:
 
 
 Let follow the sequence of calls:
 
@@ -197,7 +145,7 @@ the components are:
 * ***afm-system-daemon***: in charge of installing and uninstalling applications.
 
 * ***afm-user-daemon***: in charge of listing applications, querying application details,
 * ***afm-system-daemon***: in charge of installing and uninstalling applications.
 
 * ***afm-user-daemon***: in charge of listing applications, querying application details,
-  starting, terminating, stopping, resuming applications and their instances
+  starting, terminating, pausing, resuming applications and their instances
   for a given user context.
 
 * ***afb-binder***: in charge of serving resources and features through an
   for a given user context.
 
 * ***afb-binder***: in charge of serving resources and features through an
@@ -219,7 +167,7 @@ to ensure security and privacy. It also includes features of reporting
 using audit features and by managing logs and alerts.
 
 The application framework manages the applications:
 using audit features and by managing logs and alerts.
 
 The application framework manages the applications:
-installing, uninstalling, starting, stopping, listing ...
+installing, uninstalling, starting, pausing, listing ...
 
 The application framework uses the security model/framework
 to ensure the security and the privacy of the applications that
 
 The application framework uses the security model/framework
 to ensure the security and the privacy of the applications that
@@ -267,11 +215,11 @@ application framework of Tizen as is but used an adaptation of it.
 The basis is kept identical: the applications are distributed
 in a digitally signed container that must match the specifications
 of widgets (web applications). This is described by the technical
 The basis is kept identical: the applications are distributed
 in a digitally signed container that must match the specifications
 of widgets (web applications). This is described by the technical
-recomendations [widgets] and [widgets-digsig] of the W3 consortium.
+recommendations [widgets] and [widgets-digsig] of the W3 consortium.
 
 This model allows the distribution of HTML, QML and binary applications.
 
 
 This model allows the distribution of HTML, QML and binary applications.
 
-The management of signatures of the widget packages 
+The management of signatures of the widget packages.
 This basis is not meant as being rigid and it can be extended in the
 futur to include for example incremental delivery.
 
 This basis is not meant as being rigid and it can be extended in the
 futur to include for example incremental delivery.
 
@@ -293,4 +241,5 @@ futur to include for example incremental delivery.
 [tizen-security]:   https://wiki.tizen.org/wiki/Security                            "Tizen security home page"
 [tizen-secu-3]:     https://wiki.tizen.org/wiki/Security/Tizen_3.X_Overview         "Tizen 3 security overview"
 
 [tizen-security]:   https://wiki.tizen.org/wiki/Security                            "Tizen security home page"
 [tizen-secu-3]:     https://wiki.tizen.org/wiki/Security/Tizen_3.X_Overview         "Tizen 3 security overview"
 
-
+[AppFW-APP_install_sequences]: pictures/AppFW-APP_install_sequences.svg
+[Security_model_history]: pictures/Security_model_history.svg