From 0156b1645a201e44d5285c96d32cbfa5a9eb6814 Mon Sep 17 00:00:00 2001 From: José Bollo Date: Mon, 30 May 2016 13:22:34 +0200 Subject: Improves the documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Change-Id: Iac5ee5c2ca014ced5fe836601e9afc362a9d4fda Signed-off-by: José Bollo --- doc/afb-overview.html | 147 +++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 146 insertions(+), 1 deletion(-) (limited to 'doc/afb-overview.html') diff --git a/doc/afb-overview.html b/doc/afb-overview.html index 15331282..cfb5de75 100644 --- a/doc/afb-overview.html +++ b/doc/afb-overview.html @@ -8,7 +8,7 @@

Overview of AFB-DAEMON

version: 1
-Date:    29 mai 2016
+Date:    30 mai 2016
 Author:  José Bollo
 
@@ -16,6 +16,14 @@ Author: José Bollo
  • Overview of AFB-DAEMON
  • @@ -33,6 +41,8 @@ an application to the AGL framework and AGL system.

    On the following figure, you can use a typical use of afb-daemon:

    +

    Figure: binder afb-daemon, basis

    +
    . . . . . . . . . . . . . . . . . . . . . . . . . .
     .        Isolated security context                .
     .                                                 .
    @@ -45,6 +55,7 @@ of afb-daemon:

    . | . . +-------------------+----------------------+ . . | : | . +. | b i n d e r : | . . | A F B - D A E M O N : PLUGINS | . . | : | . . +-------------------+----------------------+ . @@ -68,5 +79,139 @@ system through the binder.

    to security enforcement for accessing hardware ressources or for speeding parts of algorithm.

    + + + +

    Use cases of the binder afb-daemon

    + +

    This section tries to give a better understanding of the binder +usage through several use cases.

    + + +

    Remotely running application

    + +

    One of the most interresting aspect of using the binder afb-daemon +is the ability to run applications remotely. This feature is +possible because the binder afb-daemon implements native web +protocols.

    + +

    So the figure binder, basis would become +when the application is run remotely:

    + +

    Figure: binder afb-daemon and remotely running application

    + +
                 +------------------------------+
    +             |                              |
    +             |    A P P L I C A T I O N     |
    +             |                              |
    +             +--------------+---------------+
    +                            |
    +                       ~ ~ ~ ~ ~ ~
    +                      :  NETWORK  :
    +                       ~ ~ ~ ~ ~ ~
    +                            |
    +. . . . . . . . . . . . . . | . . . . . . . . . . . . . .
    +. Isolated security         |                           .
    +.   context                 |                           .
    +.                           |                           .
    +.     . . . . . . . . . . . . . . . . . . . . . . . .   .
    +.     .                                             .   .
    +.     .               F I R E W A L L               .   .
    +.     .                                             .   .
    +.     . . . . . . . . . . . . . . . . . . . . . . . .   .
    +.                           |                           .
    +.       +-------------------+----------------------+    .
    +.       |                            :             |    .
    +.       |    A F B - D A E M O N     :   PLUGINS   |    .
    +.       |                            :             |    .
    +.       +-------------------+----------------------+    .
    +.                           |                           .
    +. . . . . . . . . . . . . . | . . . . . . . . . . . . . .
    +                            |
    +                            v
    +                       AGL SYSTEM
    +
    + + +

    Adding native features to HTML5/QML applications

    + +

    Applications can provide with their packaged delivery a plugin. +That plugin will be instanciated for each application instance. +The methods of the plugin will be accessible by applications and +will be excuted within the security context.

    + + +

    Offering services to the system

    + +

    It is possible to run the binder afb-daemon as a daemon that provides the +API of its plugins.

    + +

    This will be used for:

    + +
      +
    1. offering common APIs

    2. +
    3. provide application’s services (services provided as application)

    4. +
    + + +

    In that case, the figure showing the whole aspects is

    + +

    Figure: binder afb-daemon for services

    + +
    . . . . . . . . . . . . . . . . . . . . . . 
    +.  Isolated security context application  . 
    +.                                         . 
    +.    +------------------------------+     . 
    +.    |                              |     . 
    +.    |    A P P L I C A T I O N     |     . 
    +.    |                              |     . 
    +.    +--------------+---------------+     .     . . . . . . . . . . . . . . . . . . . . . .
    +.                   |                     .     .        Isolated security context A      .
    +.                   |                     .     .                                         .
    +. +-----------------+------------------+  .     . +------------------------------------+  .
    +. |                        :           |  .     . |                        :           |  .
    +. |      b i n d e r       :           |  .     . |      b i n d e r       :  service  |  .
    +. |  A F B - D A E M O N   :  PLUGINS  |  .     . |  A F B - D A E M O N   :  PLUGINS  |  .
    +. |                        :           |  .     . |                        :     A     |  .
    +. +-----------------+------------------+  .     . +-----------------+------------------+  .
    +.                   |                     .     .                   |                     .
    +. . . . . . . . . . | . . . . . . . . . . .     . . . . . . . . . . | . . . . . . . . . . .
    +                    |                                               |
    +                    v                                               v
    +         ================================================================================
    +                                     D - B U S   &   C Y N A R A
    +         ================================================================================
    +                    ^                                               ^
    +                    |                                               |
    +. . . . . . . . . . | . . . . . . . . . . .     . . . . . . . . . . | . . . . . . . . . . .
    +.                   |                     .     .                   |                     .
    +. +-----------------+------------------+  .     . +-----------------+------------------+  .
    +. |                        :           |  .     . |                        :           |  .
    +. |      b i n d e r       :  service  |  .     . |      b i n d e r       :  service  |  .
    +. |  A F B - D A E M O N   :  PLUGINS  |  .     . |  A F B - D A E M O N   :  PLUGINS  |  .
    +. |                        :     B     |  .     . |                        :     C     |  .
    +. +------------------------------------+  .     . +------------------------------------+  .
    +.                                         .     .                                         .
    +.        Isolated security context B      .     .        Isolated security context C      .
    +. . . . . . . . . . . . . . . . . . . . . .     . . . . . . . . . . . . . . . . . . . . . .
    +
    + + +

    The plugins of the binder afb-daemon

    + +

    The binder can instanciate plugins. The primary use of plugins +is to add native methods that can be accessed by applications +written with any language through web technologies ala JSON RPC.

    + +

    This simple idea is declined to serves multiple purposes:

    + +
      +
    1. add native feature to applications

    2. +
    3. add common API available by any applications

    4. +
    5. provide customers services

    6. +
    + + +

    A specific document shows

    -- cgit 1.2.3-korg