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