summaryrefslogtreecommitdiffstats
path: root/doc/afm-user-daemon.html
diff options
context:
space:
mode:
authorJosé Bollo <jose.bollo@iot.bzh>2016-10-26 18:24:13 +0200
committerJosé Bollo <jose.bollo@iot.bzh>2016-10-28 15:35:02 +0200
commit4a1409460a7c0a5d26fe10b5f84368b3cb8b8b5a (patch)
tree2ebad5e0b1eca2729c2eda6c1fe029d8e1baef13 /doc/afm-user-daemon.html
parent27bb304eee3485c73e1be677fbc820591bacc2f9 (diff)
doc: switch to mkdocs
Signed-off-by: José Bollo <jose.bollo@iot.bzh>
Diffstat (limited to 'doc/afm-user-daemon.html')
-rw-r--r--doc/afm-user-daemon.html457
1 files changed, 0 insertions, 457 deletions
diff --git a/doc/afm-user-daemon.html b/doc/afm-user-daemon.html
deleted file mode 100644
index 5bf56f7..0000000
--- a/doc/afm-user-daemon.html
+++ /dev/null
@@ -1,457 +0,0 @@
-<!DOCTYPE html>
-<html>
-<head>
- <meta charset="utf-8">
- <meta name="generator" content="pandoc">
- <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
- <meta name="author" content="José Bollo">
- <meta name="author" content="Fulup Ar Foll">
- <title>The afm-user-daemon</title>
- <style type="text/css">code{white-space: pre;}</style>
- <link rel="stylesheet" href="doc.css">
- <!--[if lt IE 9]>
- <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
- <![endif]-->
-</head>
-<body>
-<header>
-<h1 class="title">The afm-user-daemon</h1>
-<h2 class="author">José Bollo</h2>
-<h2 class="author">Fulup Ar Foll</h2>
-<h3 class="date">24 juin 2016</h3>
-</header>
-<nav id="TOC">
-<ul>
-<li><a href="#the-afm-user-daemon">The afm-user-daemon</a><ul>
-<li><a href="#foreword">Foreword</a></li>
-<li><a href="#introduction">Introduction</a></li>
-<li><a href="#tasks-of-afm-user-daemon">Tasks of <strong>afm-user-daemon</strong></a><ul>
-<li><a href="#maintaining-list-of-applications">Maintaining list of applications</a></li>
-<li><a href="#launching-application">Launching application</a></li>
-<li><a href="#managing-instances-of-running-applications">Managing instances of running applications</a></li>
-<li><a href="#installing-and-uninstalling-applications">Installing and uninstalling applications</a></li>
-</ul></li>
-<li><a href="#starting-afm-user-daemon">Starting <strong>afm-user-daemon</strong></a></li>
-<li><a href="#launcher-configuration">Launcher Configuration</a><ul>
-<li><a href="#mode-local">mode local</a></li>
-<li><a href="#mode-remote">mode remote</a></li>
-<li><a href="#substitutions">%substitutions</a></li>
-</ul></li>
-<li><a href="#the-d-bus-interface">The D-Bus interface</a><ul>
-<li><a href="#overview-of-the-dbus-interface">Overview of the dbus interface</a></li>
-<li><a href="#using-afm-util">Using <strong><em>afm-util</em></strong></a></li>
-<li><a href="#the-protocol-over-d-bus">The protocol over D-Bus</a></li>
-</ul></li>
-</ul></li>
-</ul>
-</nav>
-<h1 id="the-afm-user-daemon">The afm-user-daemon</h1>
-<h2 id="foreword">Foreword</h2>
-<p>This document describes application framework user daemon fundamentals. FCF (Fully Conform to Specification) implementation is still under development. It may happen that current implementation somehow diverges with specifications.</p>
-<h2 id="introduction">Introduction</h2>
-<p>The daemon <strong>afm-user-daemon</strong> is in charge of handling applications on behalf of a user. Its main tasks are:</p>
-<ul>
-<li><p>enumerate applications that end user can run and keep this list available on demand</p></li>
-<li><p>start applications on behalf of end user, set user running environment, set user security context</p></li>
-<li><p>list current runnable or running applications</p></li>
-<li><p>stop (aka pause), continue (aka resume), terminate a running instance of a given application</p></li>
-<li><p>transfer requests for installation/uninstallation of applications to the corresponding system daemon <strong>afm-system-daemon</strong></p></li>
-</ul>
-<p>The <strong>afm-user-daemon</strong> takes its orders from the session instance of D-Bus.</p>
-<p>The figure below summarizes the situation of <strong>afm-user-daemon</strong> in the system.</p>
-<pre><code>+------------------------------------------------------------+
-| User |
-| +---------------------+ |
-| +---------------------+ | Smack isolated | |
-| | D-Bus session + | APPLICATIONS | |
-| +----------+----------+ +---------+-----------+ |
-| | | |
-| | | |
-| +----------+--------------------------+-----------+ |
-| | | |
-| | afm-user-daemon | |
-| | | |
-| +----------+----------------------+----------+----+ |
-| | | : |
-| | | : |
-:================|======================|==========:=========:
-| | | : |
-| +----------+----------+ +-----+-----+ : |
-| | D-Bus system +-----+ CYNARA | : |
-| +----------+----------+ +-----+-----+ : |
-| | | : |
-| +----------+---------+ +-------+----------+----+ |
-| | afm-system-daemon +----+ SECURITY-MANAGER | |
-| +--------------------+ +-----------------------+ |
-| |
-| System |
-+------------------------------------------------------------+</code></pre>
-<h2 id="tasks-of-afm-user-daemon">Tasks of <strong>afm-user-daemon</strong></h2>
-<h3 id="maintaining-list-of-applications">Maintaining list of applications</h3>
-<p>At start <strong>afm-user-daemon</strong> scans the directories containing applications and load in memory a list of avaliable applications accessible by current user.</p>
-<p>When <strong>afm-system-daemon</strong> installs or removes an application. On success it sends the signal <em>org.AGL.afm.system.changed</em>. When receiving such a signal, <strong>afm-user-daemon</strong> rebuilds its applications list.</p>
-<p><strong>afm-user-daemon</strong> provides the data it collects about applications to its clients. Clients may either request the full list of avaliable applications or a more specific information about a given application.</p>
-<h3 id="launching-application">Launching application</h3>
-<p><strong>afm-user-daemon</strong> launches application. Its builds a secure environment for the application before starting it within a secured environment.</p>
-<p>Different kind of applications can be launched.</p>
-<p>This is set using a configuration file that describes how to launch an application of a given kind within a given mode.</p>
-<p>There is two launching modes: local or remote.</p>
-<p>Launching an application locally means that the application and its binder are launched together.</p>
-<p>Launching application remotely translates in only launching the application binder. The UI by itself has to be activated remotely by the requested (ie: HTML5 homescreen in a browser)</p>
-<p>Once launched, running instances of application receive a runid that identify them.</p>
-<h3 id="managing-instances-of-running-applications">Managing instances of running applications</h3>
-<p><strong>afm-user-daemon</strong> manages the list of applications that it launched.</p>
-<p>When owning the right permissions, a client can get the list of running instances and details about a specific running instance. It can also terminates, stops or continues a given application.</p>
-<h3 id="installing-and-uninstalling-applications">Installing and uninstalling applications</h3>
-<p>If the client own the right permissions, <strong>afm-user-daemon</strong> delegates that task to <strong>afm-system-daemon</strong>.</p>
-<h2 id="starting-afm-user-daemon">Starting <strong>afm-user-daemon</strong></h2>
-<p><strong>afm-user-daemon</strong> is launched as a <strong>systemd</strong> service attached to user sessions. Normally, the service file is located at /usr/lib/systemd/user/afm-user-daemon.service.</p>
-<p>The options for launching <strong>afm-user-daemon</strong> are:</p>
-<pre><code>-a
---application directory
-
- Includes the given application directory to
- the database base of applications.
-
- Can be repeated.
-
--r
---root directory
-
- Includes root application directory or directories when
- passing multiple rootdir to
- applications database.
-
- Note that default root directory for
- applications is always added. In current version
- /usr/share/afm/applications is used as default.
-
--m
---mode (local|remote)
-
- Set the default launch mode.
- The default value is &#39;local&#39;
-
--d
---daemon
-
- Daemonizes the process. It is not needed by sytemd.
-
--q
---quiet
-
- Reduces the verbosity (can be repeated).
-
--v
---verbose
-
- Increases the verbosity (can be repeated).
-
--h
---help
-
- Prints a short help.</code></pre>
-<h2 id="launcher-configuration">Launcher Configuration</h2>
-<p>It contains rules for launching applications. When <strong>afm-user-daemon</strong> has to launch an application, it looks for launch mode (local or remote), as well as for the type of application describe in <strong><em>config.xml</em></strong> widget configuration file.</p>
-<p>This tuple mode+type allows to select the adequate rule.</p>
-<p>Configuration file is <strong>/etc/afm/afm-launch.conf</strong>.</p>
-<p>It contains sections and rules. It can also contain comments and empty lines to improve readability.</p>
-<p>The separators are space and tabulation, any other character should have a meaning.</p>
-<p>The format is line oriented. The new line character separate the lines.</p>
-<p>Lines having only separators are blank lines and ignored. Line having character #(sharp) at first position are comment lines and ignored.</p>
-<p>Lines not starting with a separator are different from lines starting with a separator character.</p>
-<p>The grammar of the configuration file is defined below:</p>
-<pre><code>CONF: *COMMENT *SECTION
-
-SECTION: MODE *RULE
-
-RULE: +TYPE VECTOR ?VECTOR
-
-MODE: &#39;mode&#39; +SEP (&#39;local&#39; | &#39;remote&#39;) *SEP EOL
-
-TYPE: DATA *SEP EOL
-
-VECTOR: +SEP DATA *(+SEP NDATA) *SEP EOL
-
-DATA: CHAR *NCHAR
-NDATA: +NCHAR
-
-EOL: NL *COMMENT
-COMMENT: *SEP CMT *(SEP | NCHAR) NL
-
-NL: &#39;\x0a&#39;
-SEP: &#39;\x20&#39; | &#39;\x09&#39;
-CMT: &#39;#&#39;
-CHAR: &#39;\x00&#39;..&#39;\x08&#39; | &#39;\x0b&#39;..&#39;\x1f&#39; | &#39;\x21&#39; | &#39;\x22&#39; | &#39;\x24&#39;..&#39;\xff&#39;
-NCHAR: CMT | CHAR</code></pre>
-<p>Here is a sample of configuration file for defining how to launch an application of types <em>application/x-executable</em>, <em>text/x-shellscript</em> and <em>text/html</em> in local mode:</p>
-<pre><code>mode local
-
-application/x-executable
-text/x-shellscript
- %r/%c
-
-text/html
- /usr/bin/afb-daemon --mode=local --readyfd=%R --alias=/icons:%I --port=%P --rootdir=%r --token=%S --sessiondir=%D/.afb-daemon
- /usr/bin/web-runtime http://localhost:%P/%c?token=%S</code></pre>
-<p>This shows that:</p>
-<ul>
-<li>within a section, several rules can be defined</li>
-<li>within a rule, several types can be defined</li>
-<li>within a rule, one or two vectors can be defined</li>
-<li>vectors are using %substitution</li>
-<li>launched binaries must be defined with their full path</li>
-</ul>
-<h3 id="mode-local">mode local</h3>
-<p>Within this mode, the launchers have either one or two description vectors. All of those vectors are treated as programs and are executed with 'execve' system call.</p>
-<p>The first vector is the leader vector and it defines the process group. The second vector (if any) is attached to the group defined by this first vector.</p>
-<h3 id="mode-remote">mode remote</h3>
-<p>Within this mode, the launchers have either one or two vectors describing them.</p>
-<p>The first vector is process as a program and is executed with system call 'execve'.</p>
-<p>The second vector (if any) defines a text that is returned to the caller. This mechanism can be used to return a uri for remote UI to connect on the newly launched application.</p>
-<p>The daemon <strong><em>afm-user-daemon</em></strong> allocates a port for each new remote application. The current implementation port allocation is incremental. A smarter (cacheable and discoverable) allocation should be defined.</p>
-<h3 id="substitutions">%substitutions</h3>
-<p>Vectors can include sequences of 2 characters that have a special meaning. These sequences are named <em>%substitution</em> because their first character is the percent sign (%) and because each occurrence of the sequence is replaced, at launch time, by the value associated to sequences.</p>
-<p>Here is the list of <em>%substitutions</em>:</p>
-<ul>
-<li><strong><em>%%</em></strong>: %.</li>
-</ul>
-<p>This simply emits the percent sign %</p>
-<ul>
-<li><strong><em>%a</em></strong>: appid</li>
-</ul>
-<p>Holds application Id of launched application.</p>
-<p>Defined by the attribute <strong>id</strong> of the element <strong><widget></strong> of <strong>config.xml</strong>.</p>
-<ul>
-<li><strong><em>%b</em></strong>: bindings</li>
-</ul>
-<p>In the future should represent the list of bindings and bindings directory separated by ','. Warning: not supported in current version.</p>
-<ul>
-<li><strong><em>%c</em></strong>: content</li>
-</ul>
-<p>The file within the widget directory that is the entry point.</p>
-<p>For HTML applications, it represents the relative path to main page (aka index.html).</p>
-<p>Defined by attribute <strong>src</strong> of the element <strong><content></strong> within <strong>config.xml</strong>.</p>
-<ul>
-<li><strong><em>%D</em></strong>: datadir</li>
-</ul>
-<p>Path of the directory where the application runs (cwd) and stores its data.</p>
-<p>It is equal to %h/%a.</p>
-<ul>
-<li><strong><em>%H</em></strong>: height</li>
-</ul>
-<p>Requested height for the widget.</p>
-<p>Defined by the attribute <strong>height</strong> of the element <strong><widget></strong> of <strong>config.xml</strong>.</p>
-<ul>
-<li><strong><em>%h</em></strong>: homedir</li>
-</ul>
-<p>Path of the home directory for all applications.</p>
-<p>It is generally equal to $HOME/app-data</p>
-<ul>
-<li><strong><em>%I</em></strong>: icondir</li>
-</ul>
-<p>Path of the directory were the icons of the applications can be found.</p>
-<ul>
-<li><strong><em>%m</em></strong>: mime-type</li>
-</ul>
-<p>Mime type of the launched application.</p>
-<p>Defined by the attribute <strong>type</strong> of the element <strong><content></strong> of <strong>config.xml</strong>.</p>
-<ul>
-<li><strong><em>%n</em></strong>: name</li>
-</ul>
-<p>Name of the application as defined by the content of the element <strong><name></strong> of <strong>config.xml</strong>.</p>
-<ul>
-<li><strong><em>%P</em></strong>: port</li>
-</ul>
-<p>A port to use. It is currently a kind of random port. The precise model is to be defined later.</p>
-<ul>
-<li><strong><em>%R</em></strong>: readyfd</li>
-</ul>
-<p>Number of file descriptor to use for signaling readiness of launched process.</p>
-<ul>
-<li><strong><em>%r</em></strong>: rootdir</li>
-</ul>
-<p>Path of directory containing the widget and its data.</p>
-<ul>
-<li><strong><em>%S</em></strong>: secret</li>
-</ul>
-<p>An hexadecimal number that can be used to initialize pairing of client and application binder.</p>
-<ul>
-<li><strong><em>%W</em></strong>: width</li>
-</ul>
-<p>Requested width for the widget.</p>
-<p>Defined by the attribute <strong>width</strong> of the element <strong><widget></strong> of <strong>config.xml</strong>.</p>
-<h2 id="the-d-bus-interface">The D-Bus interface</h2>
-<h3 id="overview-of-the-dbus-interface">Overview of the dbus interface</h3>
-<p><strong><em>afm-user-daemon</em></strong> takes its orders from the session instance of D-Bus. D-Bus is nice to use in this context because it allows discovery and signaling.</p>
-<p>The dbus session is by default addressed by environment variable <strong><em>DBUS_SESSION_BUS_ADDRESS</em></strong>. Using <strong>systemd</strong> variable <em>DBUS_SESSION_BUS_ADDRESS</em> is automatically set for user sessions.</p>
-<p>The <strong>afm-user-daemon</strong> is listening on destination name <strong><em>org.AGL.afm.user</em></strong> at object path <strong><em>/org/AGL/afm/user</em></strong> on interface <strong><em>org.AGL.afm.user</em></strong> for following members: <strong><em>runnables</em></strong>, <strong><em>detail</em></strong>, <strong><em>start</em></strong>, <strong><em>terminate</em></strong>, <strong><em>stop</em></strong>, <strong><em>continue</em></strong>, <strong><em>runners</em></strong>, <strong><em>state</em></strong>, <strong><em>install</em></strong> and <strong><em>uninstall</em></strong>.</p>
-<p>D-Bus is mainly used for signaling and discovery. Its optimized typed protocol is not used except for transmission of standalone strings.</p>
-<p>Clients and Services are using JSON serialisation to exchange data.</p>
-<p>The D-Bus interface is defined by:</p>
-<ul>
-<li><p>DESTINATION: <strong>org.AGL.afm.user</strong></p></li>
-<li><p>PATH: <strong>/org/AGL/afm/user</strong></p></li>
-<li><p>INTERFACE: <strong>org.AGL.afm.user</strong></p></li>
-</ul>
-<p>The signature of any member of the interface is <strong><em>string -&gt; string</em></strong> for <strong><em>JSON -&gt; JSON</em></strong>.</p>
-<p>This is the normal case. In case of error, the current implementation returns a dbus error as a string.</p>
-<p>Here an example using <em>dbus-send</em> to query data on installed applications.</p>
-<pre><code>dbus-send --session --print-reply \
- --dest=org.AGL.afm.user \
- /org/AGL/afm/user \
- org.AGL.afm.user.runnables string:true</code></pre>
-<h3 id="using-afm-util">Using <strong><em>afm-util</em></strong></h3>
-<p>The command line tool <strong><em>afm-util</em></strong> uses dbus-send to send orders to <strong>afm-user-daemon</strong>. This small scripts allows to send command to <strong><em>afm-user-daemon</em></strong> either interactively at shell prompt or scriptically.</p>
-<p>The syntax is simple: it accept a command and when requires attached arguments.</p>
-<p>Here is the summary of <strong><em>afm-util</em></strong>:</p>
-<ul>
-<li><strong>afm-util runnables </strong>:</li>
-</ul>
-<p>list the runnable widgets installed</p>
-<ul>
-<li><strong>afm-util install wgt </strong>:</li>
-</ul>
-<p>install the wgt file</p>
-<ul>
-<li><strong>afm-util uninstall id </strong>:</li>
-</ul>
-<p>remove the installed widget of id</p>
-<ul>
-<li><strong>afm-util detail id </strong>:</li>
-</ul>
-<p>print detail about the installed widget of id</p>
-<ul>
-<li><strong>afm-util runners </strong>:</li>
-</ul>
-<p>list the running instance</p>
-<ul>
-<li><strong>afm-util start id </strong>:</li>
-</ul>
-<p>start an instance of the widget of id</p>
-<ul>
-<li><strong>afm-util terminate rid </strong>:</li>
-</ul>
-<p>terminate the running instance rid</p>
-<ul>
-<li><strong>afm-util stop rid </strong>:</li>
-</ul>
-<p>stop the running instance rid</p>
-<ul>
-<li><strong>afm-util continue rid </strong>:</li>
-</ul>
-<p>continue the previously rid</p>
-<ul>
-<li><strong>afm-util state rid </strong>:</li>
-</ul>
-<p>get status of the running instance rid</p>
-<p>Here is how to list applications using <strong><em>afm-util</em></strong>:</p>
-<pre><code>afm-util runnables</code></pre>
-<hr />
-<h3 id="the-protocol-over-d-bus">The protocol over D-Bus</h3>
-<p>Recall:</p>
-<ul>
-<li><p><strong>DESTINATION</strong>: org.AGL.afm.user</p></li>
-<li><p><strong>PATH</strong>: /org/AGL/afm/user</p></li>
-<li><p><strong>INTERFACE</strong>: org.AGL.afm.user</p></li>
-</ul>
-<hr />
-<h4 id="method-org.agl.afm.user.detail">Method org.AGL.afm.user.detail</h4>
-<p><strong>Description</strong>: Get details about an application from its id.</p>
-<p><strong>Input</strong>: the id of the application as below.</p>
-<p>Either just a string:</p>
-<pre><code>&quot;appli@x.y&quot;</code></pre>
-<p>Or an object having the field &quot;id&quot; of type string:</p>
-<pre><code>{&quot;id&quot;:&quot;appli@x.y&quot;}</code></pre>
-<p><strong>Output</strong>: A JSON object describing the application containing the fields described below.</p>
-<pre><code>{
- &quot;id&quot;: string, the application id (id@version)
- &quot;version&quot;: string, the version of the application
- &quot;width&quot;: integer, requested width of the application
- &quot;height&quot;: integer, resqueted height of the application
- &quot;name&quot;: string, the name of the application
- &quot;description&quot;: string, the description of the application
- &quot;shortname&quot;: string, the short name of the application
- &quot;author&quot;: string, the author of the application
-}</code></pre>
-<hr />
-<h4 id="method-org.agl.afm.user.runnables">Method org.AGL.afm.user.runnables</h4>
-<p><strong>Description</strong>: Get the list of applications that can be run.</p>
-<p><strong>Input</strong>: any valid json entry, can be anything except null.</p>
-<p><strong>output</strong>: An array of description of the runnable applications. Each item of the array contains an object containing the detail of an application as described above for the method <em>org.AGL.afm.user.detail</em>.</p>
-<hr />
-<h4 id="method-org.agl.afm.user.install">Method org.AGL.afm.user.install</h4>
-<p><strong>Description</strong>: Install an application from its widget file.</p>
-<p>If an application of the same <em>id</em> and <em>version</em> exists, it is not reinstalled except when <em>force=true</em>.</p>
-<p>Applications are installed in the subdirectories of the common directory reserved for applications. If <em>root</em> is specified, the application is installed under sub-directories of defined <em>root</em>.</p>
-<p>Note that this methods is a simple accessor to the method <strong><em>org.AGL.afm.system.install</em></strong> of <strong><em>afm-system-daemon</em></strong>.</p>
-<p>After the installation and before returning to the sender, <strong><em>afm-user-daemon</em></strong> sends the signal <strong><em>org.AGL.afm.user.changed</em></strong>.</p>
-<p><strong>Input</strong>: The <em>path</em> of widget file to be installed. Optionally, a flag to <em>force</em> reinstallation and/or a <em>root</em> directory.</p>
-<p>Simple form a simple string containing the absolute widget path:</p>
-<pre><code>&quot;/a/path/driving/to/the/widget&quot;</code></pre>
-<p>Or an object:</p>
-<pre><code>{
- &quot;wgt&quot;: &quot;/a/path/to/the/widget&quot;,
- &quot;force&quot;: false,
- &quot;root&quot;: &quot;/a/path/to/the/root&quot;
-}</code></pre>
-<p>&quot;wgt&quot; and &quot;root&quot; MUST be absolute paths.</p>
-<p><strong>output</strong>: An object containing field &quot;added&quot; to use as application ID.</p>
-<pre><code>{&quot;added&quot;:&quot;appli@x.y&quot;}</code></pre>
-<hr />
-<h4 id="method-org.agl.afm.user.uninstall">Method org.AGL.afm.user.uninstall</h4>
-<p><strong>Description</strong>: Uninstall an application from its id.</p>
-<p>Note that this methods is a simple accessor to <strong><em>org.AGL.afm.system.uninstall</em></strong> method from <strong><em>afm-system-daemon</em></strong>.</p>
-<p>After the uninstallation and before returning to the sender, <strong><em>afm-user-daemon</em></strong> sends the signal <strong><em>org.AGL.afm.user.changed</em></strong>.</p>
-<p><strong>Input</strong>: the <em>id</em> of the application and, optionally, the path to application <em>root</em>.</p>
-<p>Either a string:</p>
-<pre><code>&quot;appli@x.y&quot;</code></pre>
-<p>Or an object:</p>
-<pre><code>{
- &quot;id&quot;: &quot;appli@x.y&quot;,
- &quot;root&quot;: &quot;/a/path/to/the/root&quot;
-}</code></pre>
-<p><strong>output</strong>: the value 'true'.</p>
-<hr />
-<h4 id="method-org.agl.afm.user.start">Method org.AGL.afm.user.start</h4>
-<p><strong>Description</strong>:</p>
-<p><strong>Input</strong>: the <em>id</em> of the application and, optionally, the start <em>mode</em> as below.</p>
-<p>Either just a string:</p>
-<pre><code>&quot;appli@x.y&quot;</code></pre>
-<p>Or an object containing field &quot;id&quot; of type string and optionally a field mode:</p>
-<pre><code>{&quot;id&quot;:&quot;appli@x.y&quot;,&quot;mode&quot;:&quot;local&quot;}</code></pre>
-<p>The field &quot;mode&quot; is a string equal to either &quot;local&quot; or &quot;remote&quot;.</p>
-<p><strong>output</strong>: The <em>runid</em> of the application launched. <em>runid</em> is an integer.</p>
-<hr />
-<h4 id="method-org.agl.afm.user.terminate">Method org.AGL.afm.user.terminate</h4>
-<p><strong>Description</strong>: Terminates the application attached to <em>runid</em>.</p>
-<p><strong>Input</strong>: The <em>runid</em> (an integer) of running instance to terminate.</p>
-<p><strong>output</strong>: the value 'true'.</p>
-<hr />
-<h4 id="method-org.agl.afm.user.stop">Method org.AGL.afm.user.stop</h4>
-<p><strong>Description</strong>: Stops the application attached to <em>runid</em> until terminate or continue.</p>
-<p><strong>Input</strong>: The <em>runid</em> (integer) of the running instance to stop.</p>
-<p><strong>output</strong>: the value 'true'.</p>
-<hr />
-<h4 id="method-org.agl.afm.user.continue">Method org.AGL.afm.user.continue</h4>
-<p><strong>Description</strong>: Continues the application attached to <em>runid</em> previously stopped.</p>
-<p><strong>Input</strong>: The <em>runid</em> (integer) of the running instance to continue.</p>
-<p><strong>output</strong>: the value 'true'.</p>
-<hr />
-<h4 id="method-org.agl.afm.user.state">Method org.AGL.afm.user.state</h4>
-<p><strong>Description</strong>: Get informations about a running instance of <em>runid</em>.</p>
-<p><strong>Input</strong>: The <em>runid</em> (integer) of the running instance inspected.</p>
-<p><strong>output</strong>: An object describing instance state. It contains: the runid (integer), the id of the running application (string), the state of the application (string either: &quot;starting&quot;, &quot;running&quot;, &quot;stopped&quot;).</p>
-<p>Example of returned state:</p>
-<pre><code>{
- &quot;runid&quot;: 2,
- &quot;state&quot;: &quot;running&quot;,
- &quot;id&quot;: &quot;appli@x.y&quot;
-}</code></pre>
-<hr />
-<h4 id="method-org.agl.afm.user.runners">Method org.AGL.afm.user.runners</h4>
-<p><strong>Description</strong>: Get the list of currently running instances.</p>
-<p><strong>Input</strong>: anything.</p>
-<p><strong>output</strong>: An array of states, one per running instance, as returned by the methodd <strong><em>org.AGL.afm.user.state</em></strong>.</p>
-</body>
-</html>