aboutsummaryrefslogtreecommitdiffstats
path: root/hook-plugin/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'hook-plugin/README.md')
-rw-r--r--hook-plugin/README.md14
1 files changed, 7 insertions, 7 deletions
diff --git a/hook-plugin/README.md b/hook-plugin/README.md
index 0472c7b..748f66f 100644
--- a/hook-plugin/README.md
+++ b/hook-plugin/README.md
@@ -6,8 +6,8 @@ Author: Fulup Ar Foll fulup@iot.bzh
Date : August-2017
Functionalities:
- - Execute a set of websocket RPC request again AGL binders to allow/deny access
- - Keep websocket open in an idepandant thread on order to monitor event receive from AGL audio agent
+ - Execute a set of unix/ws RPC request again AGL binders to allow/deny access
+ - Keep websocket open in an idependant thread in order to monitor event received from AGL audio agent
Installation
- Alsaplugins are typically search in /usr/share/alsa-lib. Nevertheless a full path might be given
@@ -41,12 +41,12 @@ pcm.MyNavigationHook {
# Every Call should return OK in order PCM to open (default timeout 100ms)
uri "ws://localhost:1234/api?token='audio-agent-token'"
+ ws-client="unix:/var/tmp/pol4a"
request {
# Request authorisation to write on navigation
navigation-ctl {
- api "pol4a"
request "navigation-role"
- release "navigation-role"
+ release "release-role"
args "{'uid':'alsa-hook-navigation'}"
}
# subscribe to Audio Agent Event map them to signal
@@ -69,9 +69,9 @@ pcm.MyNavigationHook {
NOTE:
-* Hook plugin is loaded by Alsa libasound within player context. It inherits client process attributes, as UID/GID or
-the SMACK label on AGL. This smack label is tested by AGL security framework when requested a call on the audio-agent binder.
-As a result the call will only succeed it the permission attached the application in Cynara matches.
+* Hook plugin is loaded by Alsa libasound within client context. It inherits client process attributes, as UID/GID and
+SMACK label when running on AGL. The smack label is control by AGL security framework.
+As a result a control request succeeds only when client application permission match requested audio role inside Cynara security database.
* Hook plugin keep a connection with the Audio-Agent until PCM is closed by the application. This connection allow the
Audio-Agent to send events. eg: pause, quit, mute, ... \ No newline at end of file