update markdown documentation
[src/app-framework-binder.git] / docs / afb-daemon-options.md
index 84f7ce9..28aff6b 100644 (file)
-
-Launching options of afb-daemon
----------------------
+# Launching options of afb-daemon
 
 The launch options for binder **afb-daemon** are:
 
-         --help
+      --help
 
-               Prints help with available options
+        Prints help with available options
 
-         --version
+      --version
 
-               Display version and copyright
+        Display version and copyright
 
-         --verbose
+      --verbose
 
-               Increases the verbosity, can be repeated
+        Increases the verbosity, can be repeated
 
-         --quiet
+      --quiet
 
-               Decreases the verbosity, can be repeated
+        Decreases the verbosity, can be repeated
 
-         --port=xxxx
+      --port=xxxx
 
-               HTTP listening TCP port  [default 1234]
+        HTTP listening TCP port  [default 1234]
 
-         --workdir=xxxx
+      --workdir=xxxx
 
-               Directory where the daemon must run [default: $PWD if defined
-               or the current working directory]
+        Directory where the daemon must run [default: $PWD if defined
+        or the current working directory]
 
-         --uploaddir=xxxx
+      --uploaddir=xxxx
 
-               Directory where uploaded files are temporarily stored [default: workdir]
+        Directory where uploaded files are temporarily stored [default: workdir]
 
-         --rootdir=xxxx
+      --rootdir=xxxx
 
-               Root directory of the application to serve [default: workdir]
+        Root directory of the application to serve [default: workdir]
 
-         --roothttp=xxxx
+      --roothttp=xxxx
 
-               Directory of HTTP served files. If not set, files are not served
-               but apis are still accessible.
+        Directory of HTTP served files. If not set, files are not served
+        but apis are still accessible.
 
-         --rootbase=xxxx
+      --rootbase=xxxx
 
-               Angular Base Root URL [default /opa]
+        Angular Base Root URL [default /opa]
 
-               This is used for any application of kind OPA (one page application).
-               When set, any missing document whose url has the form /opa/zzz
-               is translated to /opa/#!zzz
+        This is used for any application of kind OPA (one page application).
+        When set, any missing document whose url has the form /opa/zzz
+        is translated to /opa/#!zzz
 
-         --rootapi=xxxx
+      --rootapi=xxxx
 
-               HTML Root API URL [default /api]
+        HTML Root API URL [default /api]
 
-               The bindings are available within that url.
+        The bindings are available within that url.
 
-         --alias=xxxx
+      --alias=xxxx
 
-               Maps a path located anywhere in the file system to the
-               a subdirectory. The syntax for mapping a PATH to the
-               subdirectory NAME is: --alias=/NAME:PATH.
+        Maps a path located anywhere in the file system to the
+        a subdirectory. The syntax for mapping a PATH to the
+        subdirectory NAME is: --alias=/NAME:PATH.
 
-               Example: --alias=/icons:/usr/share/icons maps the
-               content of /usr/share/icons within the subpath /icons.
+        Example: --alias=/icons:/usr/share/icons maps the
+        content of /usr/share/icons within the subpath /icons.
 
-               This option can be repeated.
+        This option can be repeated.
 
-         --apitimeout=xxxx
+      --apitimeout=xxxx
 
-               binding API timeout in seconds [default 20]
+        binding API timeout in seconds [default 20]
 
-               Defines how many seconds maximum a method is allowed to run.
-               0 means no limit.
+        Defines how many seconds maximum a method is allowed to run.
+        0 means no limit.
 
-         --cntxtimeout=xxxx
+      --cntxtimeout=xxxx
 
-               Client Session Timeout in seconds [default 3600]
+        Client Session Timeout in seconds [default 3600]
 
-         --cache-eol=xxxx
+      --cache-eol=xxxx
 
-               Client cache end of live [default 100000 that is 27,7 hours]
+        Client cache end of live [default 100000 that is 27,7 hours]
 
-         --session-max=xxxx
+      --session-max=xxxx
 
-               Maximum count of simultaneous sessions [default 10]
+        Maximum count of simultaneous sessions [default 10]
 
-         --ldpaths=xxxx
+      --ldpaths=xxxx
 
-               Load bindings from given paths separated by colons
-               as for dir1:dir2:binding1.so:... [default = $libdir/afb]
+        Load bindings from given paths separated by colons
+        as for dir1:dir2:binding1.so:... [default = $libdir/afb]
 
-               You can mix path to directories and to bindings.
-               The sub-directories of the given directories are searched
-               recursively.
+        You can mix path to directories and to bindings.
+        The sub-directories of the given directories are searched
+        recursively.
 
-               The bindings are the files terminated by '.so' (the extension
-               so denotes shared object) that contain the public entry symbol.
+        The bindings are the files terminated by '.so' (the extension
+        so denotes shared object) that contain the public entry symbol.
 
-         --binding=xxxx
+      --binding=xxxx
 
-               Load the binding of given path.
+        Load the binding of given path.
 
-         --token=xxxx
+      --token=xxxx
 
-               Initial Secret token to authenticate.
+        Initial Secret token to authenticate.
 
-               If not set, no client can authenticate.
+        If not set, no client can authenticate.
 
-               If set to the empty string, then any initial token is accepted.
+        If set to the empty string, then any initial token is accepted.
 
-         --random-token
+      --random-token
 
-               Generate a random starting token. See option --exec.
+        Generate a random starting token. See option --exec.
 
-         --mode=xxxx
+      --mode=xxxx
 
-               Set the mode: either local, remote or global.
+        Set the mode: either local, remote or global.
 
-               The mode indicate if the application is run locally on the host
-               or remotely through network.
+        The mode indicate if the application is run locally on the host
+        or remotely through network.
 
-         --dbus-client=xxxx
+      --dbus-client=xxxx
 
-               Transparent binding to a binder afb-daemon service through dbus.
+        Transparent binding to a binder afb-daemon service through dbus.
 
-               It creates an API of name xxxx that is implemented remotely
-               and queried via DBUS.
+        It creates an API of name xxxx that is implemented remotely
+        and queried via DBUS.
 
-         --dbus-server=xxxx
+      --dbus-server=xxxx
 
-               Provides a binder afb-daemon service through dbus.
+        Provides a binder afb-daemon service through dbus.
 
-               The name xxxx must be the name of an API defined by a binding.
-               This API is exported through DBUS.
+        The name xxxx must be the name of an API defined by a binding.
+        This API is exported through DBUS.
 
-         --ws-client=xxxx
+      --ws-client=xxxx
 
-               Transparent binding to a binder afb-daemon service through a WebSocket.
+        Transparent binding to a binder afb-daemon service through a WebSocket.
 
-               The value of xxxx is either a unix naming socket, of the form "unix:path/api",
-               or an internet socket, of the form "host:port/api".
+        The value of xxxx is either a unix naming socket, of the form "unix:path/api",
+        or an internet socket, of the form "host:port/api".
 
-         --ws-server=xxxx
+      --ws-server=xxxx
 
-               Provides a binder afb-daemon service through WebSocket.
+        Provides a binder afb-daemon service through WebSocket.
 
-               The value of xxxx is either a unix naming socket, of the form "unix:path/api",
-               or an internet socket, of the form "host:port/api".
+        The value of xxxx is either a unix naming socket, of the form "unix:path/api",
+        or an internet socket, of the form "host:port/api".
 
-         --foreground
+      --foreground
 
-               Get all in foreground mode (default)
+        Get all in foreground mode (default)
 
-         --daemon
+      --daemon
 
-               Get all in background mode
+        Get all in background mode
 
-         --no-httpd
+      --no-httpd
 
-               Forbids HTTP serve
+        Forbids HTTP serve
 
-         --exec
+      --exec
 
-               Must be the last option for afb-daemon. The remaining
-               arguments define a command that afb-daemon will launch.
-               The sequences @p, @t and @@ of the arguments are replaced
-               with the port, the token and @.
+        Must be the last option for afb-daemon. The remaining
+        arguments define a command that afb-daemon will launch.
+        The sequences @p, @t and @@ of the arguments are replaced
+        with the port, the token and @.
 
-         --tracereq=xxxx
+      --tracereq=xxxx
 
-               Trace the processing of requests in the log file.
+        Trace the processing of requests in the log file.
 
-               Valid values are 'no' (default), 'common', 'extra' or 'all'.
+        Valid values are 'no' (default), 'common', 'extra' or 'all'.
 
-         --traceditf=xxxx
+      --traceditf=xxxx
 
-               Trace the accesses to functions of class daemon.
+        Trace the accesses to functions of class daemon.
 
-               Valid values are 'no' (default), 'common', 'extra' or 'all'.
+        Valid values are 'no' (default), 'common', 'extra' or 'all'.
 
-         --tracesvc=xxxx
+      --tracesvc=xxxx
 
-               Trace the accesses to functions of class service.
+        Trace the accesses to functions of class service.
 
-               Valid values are 'no' (default) or 'all'.
+        Valid values are 'no' (default) or 'all'.
 
-         --traceevt=xxxx
+      --traceevt=xxxx
 
-               Trace the accesses to functions of class event.
+        Trace the accesses to functions of class event.
 
-               Valid values are 'no' (default), 'common', 'extra' or 'all'.
+        Valid values are 'no' (default), 'common', 'extra' or 'all'.
 
     --call=xxx
 
-               Call a binding at start (can be be repeated).
-               The values are given in the form API/VERB:json-args.
+        Call a binding at start (can be be repeated).
+        The values are given in the form API/VERB:json-args.
 
-               Example: --call 'monitor/set:{"verbosity":{"api":"debug"}}'
+        Example: --call 'monitor/set:{"verbosity":{"api":"debug"}}'