summaryrefslogtreecommitdiffstats
path: root/docs/afb-daemon-options.md
diff options
context:
space:
mode:
authorRonan Le Martret <ronan.lemartret@iot.bzh>2017-07-27 16:28:22 +0200
committerJosé Bollo <jose.bollo@iot.bzh>2017-08-02 13:52:11 +0200
commitdf383333a53e62234b8999269834e08291326be7 (patch)
tree86b5407f13042dcfb47f1774a0facca0ec44d9fc /docs/afb-daemon-options.md
parent5de0b9d895d196976b8a4d90f495b8cd34fe30c0 (diff)
update markdown documentation
Change-Id: I4f466ff4b965022998d2418a9c1310d4f5e0188e Signed-off-by: Ronan Le Martret <ronan.lemartret@iot.bzh>
Diffstat (limited to 'docs/afb-daemon-options.md')
-rw-r--r--docs/afb-daemon-options.md218
1 files changed, 108 insertions, 110 deletions
diff --git a/docs/afb-daemon-options.md b/docs/afb-daemon-options.md
index 84f7ce98..28aff6b2 100644
--- a/docs/afb-daemon-options.md
+++ b/docs/afb-daemon-options.md
@@ -1,200 +1,198 @@
-
-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"}}'