Merge "afm-unit: add autoapi in required-api feature"
[src/app-framework-main.git] / conf / unit / afm-unit-debug.conf.in
1 ;---------------------------------------------------------------------------------
2 ; File:
3 ;
4 ;    afm-unit.conf
5 ;
6 ; Mode:
7 ;
8 ;    DEVEL
9 ;
10 ; Role:
11 ;
12 ;    Configure how installation of widget produces unit files for systemd
13 ;
14 ; Processing and format:
15 ;
16 ;    1. File load
17 ;
18 ;           Lines beginning with ; are firstly removed
19 ;
20 ;    2. File instantiation
21 ;
22 ;           Mustache (extended) substitutions are applied using JSON
23 ;           data deduced from config.xml file of the widget.
24 ;
25 ;    3. Extraction of units
26 ;
27 ;           Extract produced units, pack it (remove empty lines and directives)
28 ;
29 ; Directives:
30 ;
31 ;    Any directive occupy one whole line starting with %
32 ;
33 ;     - %nl
34 ;
35 ;             produce an empty line at the end
36 ;
37 ;     - %begin systemd-unit
38 ;     - %end systemd-unit
39 ;
40 ;             delimit the produced unit
41 ;
42 ;     - %systemd-unit user
43 ;     - %systemd-unit system
44 ;
45 ;             tells the kind of unit (user/system)
46 ;
47 ;     - %systemd-unit service NAME
48 ;     - %systemd-unit socket NAME
49 ;
50 ;             gives the name and type of the unit
51 ;
52 ;     - %systemd-unit wanted-by NAME
53 ;
54 ;             tells to install a link to unit in the wants of NAME
55 ;
56 ; Setting variables:
57 ;
58 ;    AFM uses the feature of systemd that completely ignores options prefixed
59 ;    with X-
60 ;
61 ;    Consequently, options starting with X-AFM- are recorded as public data
62 ;    about the application and options starting starting with X-AFM-- are
63 ;    recorded as private data.
64 ;
65 ;    Examples:
66 ;
67 ;        X-AFM-description={{description}}
68 ;
69 ;              Records the description of the unit in the field "description"
70 ;              of both the public and private object describing the unit.
71 ;
72 ;        X-AFM--wgtdir={{:#metadata.install-dir}}
73 ;
74 ;              Records the installation directory path in the field "wgtdir"
75 ;              of the private object only.
76 ;
77 ;---------------------------------------------------------------------------------
78 {{#targets}}
79 ;---------------------------------------------------------------------------------
80 ;----         M A I N    P A R T    O F   T H E   S E R V I C E               ----
81 ;---------------------------------------------------------------------------------
82 %begin systemd-unit
83 # auto generated by wgtpkg-unit for {{:id}} version {{:version}} target {{:#target}} of {{:idaver}}
84 %nl
85 %systemd-unit system
86 %systemd-unit service afm-{{#required-permission.urn:AGL:permission::public:hidden}}service{{/required-permission.urn:AGL:permission::public:hidden}}{{^required-permission.urn:AGL:permission::public:hidden}}appli{{/required-permission.urn:AGL:permission::public:hidden}}-{{:id}}--{{:ver}}--{{:#target}}@
87 [Unit]
88 Description={{description}}
89 X-AFM-description={{description}}
90 X-AFM-name={{name.content}}
91 X-AFM-shortname={{name.short}}
92 X-AFM-id={{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}}
93 X-AFM-version={{:version}}
94 X-AFM-author={{author.content}}
95 X-AFM-author-email={{author.email}}
96 X-AFM-width={{width}}
97 X-AFM-height={{height}}
98 {{#icon}}
99 X-AFM-icon={{:#metadata.install-dir}}/{{:src}}
100 {{/icon}}
101 X-AFM--ID={{:id}}
102 X-AFM--target-name={{:#target}}
103 X-AFM--content={{content.src}}
104 X-AFM--type={{content.type}}
105 X-AFM--wgtdir={{:#metadata.install-dir}}
106 X-AFM--workdir=/home/%i/app-data/{{:id}}
107 %nl
108 Requires=afm-user-session@%i.target
109 After=user@%i.service
110 After=Network.target
111 # Adds check to smack
112 ConditionSecurity=smack
113 %nl
114 # Automatic bound to required api
115 {{#required-binding}}
116 {{#value=extern}}
117 BindsTo=afm-link-{{name}}@%i.service
118 After=afm-link-{{name}}@%i.service
119 {{/value=extern}}
120 {{/required-binding}}
121 {{#required-api}}
122 {{#value=auto|ws}}
123 BindsTo=afm-api-{{name}}@%i.service
124 After=afm-api-{{name}}@%i.service
125 {{/value=auto|ws}}
126 {{/required-api}}
127 {{#provided-api}}
128 {{#value=ws|auto}}
129 Requires=afm-api-{{name}}@%i.socket
130 After=afm-api-{{name}}@%i.socket
131 {{/value=ws|auto}}
132 {{/provided-api}}
133 %nl
134 [Service]
135 EnvironmentFile=-@afm_confdir@/unit.env.d/*
136 SmackProcessLabel=User::App::{{:id}}
137 SuccessExitStatus=0 SIGKILL
138 User=%i
139 Slice=user-%i.slice
140 CapabilityBoundingSet=
141 #AmbientCapabilities=
142 {{#required-permission.urn:AGL:permission::platform:no-oom}}OOMScoreAdjust=-500{{/required-permission.urn:AGL:permission::platform:no-oom}}
143 {{#required-permission.urn:AGL:permission::partner:real-time}}IOSchedulingClass=realtime{{/required-permission.urn:AGL:permission::partner:real-time}}
144 {{^required-permission.urn:AGL:permission::public:syscall:clock}}SystemCallFilter=~@clock{{/required-permission.urn:AGL:permission::public:syscall:clock}}
145 #{{#required-permission.urn:AGL:permission::public:display}}SupplementaryGroups=display{{/required-permission.urn:AGL:permission::public:display}}
146 SupplementaryGroups=display
147 %nl
148 WorkingDirectory=-/home/%i/app-data/{{:id}}
149 ExecStartPre=/bin/mkdir -p /home/%i/app-data/{{:id}}
150 Environment=AFM_ID={{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}}
151 Environment=AFM_APP_INSTALL_DIR={{:#metadata.install-dir}}
152 Environment=AFM_WORKDIR=/home/%i/app-data/{{:id}}
153 Environment=AFM_WSAPI_DIR=@afm_users_rundir@/%i/apis/ws
154 Environment=PATH=/usr/sbin:/usr/bin:/sbin:/bin:{{:#metadata.install-dir}}/bin
155 Environment=LD_LIBRARY_PATH={{:#metadata.install-dir}}/lib
156 Environment=XDG_DATA_HOME=/home/%i/app-data/{{:id}}
157 Environment=XDG_CONFIG_HOME=/home/%i/app-data/{{:id}}
158 Environment=XDG_CACHE_HOME=/home/%i/app-data/{{:id}}
159 Environment=XDG_RUNTIME_DIR=@afm_users_rundir@/%i
160 Environment=DBUS_SESSION_BUS_ADDRESS=unix:path=@afm_users_rundir@/%i/bus
161 ; Needed to enable debug
162 EnvironmentFile=-@afm_platform_rundir@/debug/{{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}}.env
163 SyslogIdentifier=afbd-{{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}}
164 StandardInput=null
165 StandardOutput=journal
166 StandardError=journal
167 ;---------------------------------------------------------------------------------
168 ;----   text/html  application/vnd.agl.native  application/vnd.agl.service    ----
169 ;---------------------------------------------------------------------------------
170 {{#content.type=text/html|application/vnd.agl.native|application/vnd.agl.service}}
171 X-AFM-http-port={{:#metatarget.http-port}}
172 Type=notify
173 ExecStart=/usr/bin/afb-daemon \
174         --name afbd-{{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}} \
175         --rootdir={{:#metadata.install-dir}} \
176         --workdir=/home/%i/app-data/{{id}} \
177         --verbose \
178         --verbose \
179         --monitoring \
180         --port={{:#metatarget.http-port}} \
181         --token=HELLO \
182         --roothttp={{#content.type=application/vnd.agl.service}}.{{/content.type=application/vnd.agl.service}}{{^content.type=application/vnd.agl.service}}{{#required-permission.urn:AGL:permission::public:no-htdocs}}.{{/required-permission.urn:AGL:permission::public:no-htdocs}}{{^required-permission.urn:AGL:permission::public:no-htdocs}}htdocs{{/required-permission.urn:AGL:permission::public:no-htdocs}}{{/content.type=application/vnd.agl.service}} \
183         {{#required-permission.urn:AGL:permission::public:applications:read}}--alias=/icons:{{:#metadata.icons-dir}}{{/required-permission.urn:AGL:permission::public:applications:read}} \
184         {{#required-api}} \
185                 {{#value=auto|ws}}--ws-client=unix:@afm_users_rundir@/%i/apis/ws/{{name}}{{/value=auto|ws}} \
186                 {{#value=autoapi}}--auto-api=@afm_users_rundir@/%i/apis/ws{{/value=autoapi}} \
187                 {{#value=dbus}}--dbus-client={{name}}{{/value=dbus}} \
188                 {{#value=cloud}}--cloud-client={{name}}{{/value=cloud}} \
189                 {{#value=local}}--binding={{:#metadata.install-dir}}/{{name}}{{/value=local}} \
190                 {{#value=tcp}}--ws-client=tcp:{{name}}{{/value=tcp}} \
191         {{/required-api}} \
192         {{#required-binding}} \
193                 {{#value=local}}--binding={{:#metadata.install-dir}}/{{name}}{{/value=local}} \
194                 {{#value=extern}}--binding=@afm_users_rundir@/%i/apis/link/{{name}}{{/value=extern}} \
195         {{/required-binding}} \
196         {{#provided-api}} \
197                 {{#value=auto|ws}}--ws-server=sd:{{name}}{{/value=auto|ws}} \
198                 {{#value=dbus}}--dbus-server={{name}}{{/value=dbus}} \
199                 {{#value=tcp}}--ws-server=tcp:{{name}}{{/value=tcp}} \
200         {{/provided-api}} \
201         {{#content.type=text/html}}--exec /usr/bin/web-runtime http://localhost:@p/{{content.src}}?token=@t{{/content.type=text/html}} \
202         {{#content.type=application/vnd.agl.native}}--exec {{:#metadata.install-dir}}/{{content.src}} @p @t{{/content.type=application/vnd.agl.native}}
203 {{/content.type=text/html|application/vnd.agl.native|application/vnd.agl.service}}
204 ;---------------------------------------------------------------------------------
205 ;----                 application/x-executable                                ----
206 ;---------------------------------------------------------------------------------
207 {{#content.type=application/x-executable}}
208 ExecStart={{:#metadata.install-dir}}/{{content.src}}
209 {{/content.type=application/x-executable}}
210 {{#required-permission.urn:AGL:permission::system:run-by-default}}
211 ;---------------------------------------------------------------------------------
212 ; auto start
213 ;---------------------------------------------------------------------------------
214 [Install]
215 WantedBy=afm-user-session@.target
216 %systemd-unit wanted-by afm-user-session@.target
217 {{/required-permission.urn:AGL:permission::system:run-by-default}}
218 %end systemd-unit
219 ;-------------------------------------------------------------------------------
220 ;----        P R O V I D E D   A P I S                                      ----
221 ;-------------------------------------------------------------------------------
222 {{#provided-api}}
223 {{#value=ws|auto}}
224 ;-------------------------------------------------------------------------------
225 ;----        T H E   S E R V I C E   O F   T H E   A P I                    ----
226 ;-------------------------------------------------------------------------------
227 %begin systemd-unit
228 # auto generated by wgtpkg-unit for {{:id}} version {{:version}} target {{:#target}} of {{:idaver}}
229 %systemd-unit system
230 %systemd-unit service afm-api-{{name}}@
231 [Unit]
232 Description=Provides api {{name}} for user %i
233 X-AFM-API-TYPE={{value}}
234 Requires=afm-user-setup@%i.service
235 After=afm-user-setup@%i.service
236 {{#value=ws|auto}}
237 Requires=afm-api-{{name}}@%i.socket
238 After=afm-api-{{name}}@%i.socket
239 {{/value=ws|auto}}
240 [Service]
241 Type=oneshot
242 RemainAfterExit=yes
243 {{#value=ws|auto}}
244 ExecStart=/bin/true
245 {{/value=ws|auto}}
246 %end systemd-unit
247 ;-------------------------------------------------------------------------------
248 ;----        T H E   S O C K E T   O F   T H E   A P I                      ----
249 ;-------------------------------------------------------------------------------
250 %begin systemd-unit
251 # auto generated by wgtpkg-unit for {{:id}} version {{:version}} target {{:#target}} of {{:idaver}}
252 %systemd-unit system
253 %systemd-unit socket afm-api-{{name}}@
254 [Unit]
255 Description=Provides websocket api {{name}} for user %i
256 Requires=afm-user-setup@%i.service
257 After=afm-user-setup@%i.service
258 DefaultDependencies=no
259 [Socket]
260 SmackLabel=*
261 SmackLabelIPIn=System
262 SmackLabelIPOut=System
263 ListenStream=@afm_users_rundir@/%i/apis/ws/{{name}}
264 FileDescriptorName={{name}}
265 Service=afm-{{#required-permission.urn:AGL:permission::public:hidden}}service{{/required-permission.urn:AGL:permission::public:hidden}}{{^required-permission.urn:AGL:permission::public:hidden}}appli{{/required-permission.urn:AGL:permission::public:hidden}}-{{:id}}--{{:ver}}--{{:#target}}@%i.service
266 %end systemd-unit
267 {{/value=ws|auto}}
268 {{/provided-api}}
269 ;-------------------------------------------------------------------------------
270 ;----        P R O V I D E D   B I N D I N G                                ----
271 ;-------------------------------------------------------------------------------
272 {{#provided-binding}}
273 ;-------------------------------------------------------------------------------
274 ;----        T H E   S E R V I C E   O F   T H E   B I N D I N G            ----
275 ;-------------------------------------------------------------------------------
276 %begin systemd-unit
277 # auto generated by wgtpkg-unit for {{:id}} version {{:version}} target {{:#target}} of {{:idaver}}
278 %systemd-unit system
279 %systemd-unit service afm-link-{{name}}@
280 [Unit]
281 Description=Provides binding {{name}} for user %i
282 Requires=afm-user-setup@%i.service
283 After=afm-user-setup@%i.service
284 [Service]
285 Type=oneshot
286 RemainAfterExit=yes
287 ExecStart=/bin/ln -sf {{:#metadata.install-dir}}/{{value}} @afm_users_rundir@/%i/apis/link/{{name}}
288 %end systemd-unit
289 {{/provided-binding}}
290 {{/targets}}
291 ;---------------------------------------------------------------------------------
292 ; End of file afm-unit.conf mode DEVEL
293 ;---------------------------------------------------------------------------------