conf/afm-unit.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 #***************
  90 # use X-AFM-id={{:id}}--{{:ver}}--{{:#target}}
  91 # instead of:
  92 X-AFM-id={{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}}
  93 # when home screen will use real ids
  94 #**************
  95 X-AFM-version={{:version}}
  96 X-AFM-author={{author.content}}
  97 X-AFM-author-email={{author.email}}
  98 X-AFM-width={{width}}
  99 X-AFM-height={{height}}
 100 {{#icon}}
 101 X-AFM-icon={{:#metadata.install-dir}}/{{:src}}
 102 {{/icon}}
 103 X-AFM--ID={{:id}}
 104 X-AFM--target-name={{:#target}}
 105 X-AFM--content={{content.src}}
 106 X-AFM--type={{content.type}}
 107 X-AFM--wgtdir={{:#metadata.install-dir}}
 108 X-AFM--workdir={{&#metadata.app-data-dir}}/{{:id}}
 109 %nl
 110
 111 Wants=sockets.target
 112
 113 # Adds check to smack
 114 ConditionSecurity=smack
 115 %nl
 116
 117 # Automatic bound to required api
 118 {{#required-api}}
 119 {{#value=auto|ws}}
 120 BindsTo=afm-api-ws-{{name}}@%i.socket
 121 After=afm-api-ws-{{name}}@%i.socket
 122 {{/value=auto|ws}}
 123 {{/required-api}}
 124 %nl
 125
 126 [Service]
 127 EnvironmentFile=-@afm_confdir@/unit.env.d/*
 128 SmackProcessLabel=User::App::{{:id}}
 129 SuccessExitStatus=0 SIGKILL
 130
 131 PAMName=su
 132 User=%i
 133 Slice=user-%i.slice
 134
 135 CapabilityBoundingSet=
 136 AmbientCapabilities=
 137
 138 {{#required-permission}}
 139   {{#urn:AGL:permission::platform:no-oom}}      OOMScoreAdjust=-500             {{/urn:AGL:permission::platform:no-oom}}
 140   {{#urn:AGL:permission::partner:real-time}}    IOSchedulingClass=realtime      {{/urn:AGL:permission::partner:real-time}}
 141 #  {{^urn:AGL:permission::partner:real-time}}    RestrictRealtime=on             {{/urn:AGL:permission::partner:real-time}}
 142   {{#urn:AGL:permission::public:display}}       SupplementaryGroups=display     {{/urn:AGL:permission::public:display}}
 143   {{^urn:AGL:permission::public:syscall:clock}} SystemCallFilter=~@clock        {{/urn:AGL:permission::public:syscall:clock}}
 144 {{/required-permission}}
 145 %nl
 146
 147 WorkingDirectory=-{{&#metadata.app-data-dir}}/{{:id}}
 148 ExecStartPre=/bin/mkdir -p {{&#metadata.app-data-dir}}/{{:id}}
 149 Environment=AFM_APP_INSTALL_DIR={{:#metadata.install-dir}}
 150 Environment=PATH=/usr/sbin:/usr/bin:/sbin:/bin:{{:#metadata.install-dir}}
 151 Environment=XDG_RUNTIME_DIR=/run/user/%i
 152 Environment=DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/%i/bus
 153
 154 %systemd-unit system
 155 {{#required-permission.urn:AGL:permission::public:hidden}}\
 156 %systemd-unit service afm-service-{{:id}}--{{:ver}}--{{:#target}}@
 157 {{/required-permission.urn:AGL:permission::public:hidden}}\
 158 {{^required-permission.urn:AGL:permission::public:hidden}}\
 159 %systemd-unit service afm-appli-{{:id}}--{{:ver}}--{{:#target}}@
 160 {{/required-permission.urn:AGL:permission::public:hidden}}\
 161
 162 Environment=LD_LIBRARY_PATH=$ORIGIN/lib
 163
 164 SyslogIdentifier=afbd-{{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}}
 165 StandardInput=null
 166 StandardOutput=journal
 167 StandardError=journal
 168
 169 ;---------------------------------------------------------------------------------
 170 ;----   text/html  application/vnd.agl.native  application/vnd.agl.service    ----
 171 ;---------------------------------------------------------------------------------
 172 {{#content.type=text/html|application/vnd.agl.native|application/vnd.agl.service}}
 173
 174 {{^content.type=application/vnd.agl.service}}
 175 X-AFM--http-port={{:#metadata.http-port}}
 176 {{/content.type=application/vnd.agl.service}}
 177
 178 ExecStart=/usr/bin/afb-daemon \
 179         --name afbd-{{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}} \
 180         --rootdir={{:#metadata.install-dir}} \
 181         --workdir={{&#metadata.app-data-dir}}/{{id}} \
 182         {{^content.type=application/vnd.agl.service}} \
 183                 --port={{:#metadata.http-port}} \
 184                 --random-token \
 185                 {{#required-permission.urn:AGL:permission::public:no-htdocs}}\
 186                         --roothttp=. \
 187                 {{/required-permission.urn:AGL:permission::public:no-htdocs}}\
 188                 {{^required-permission.urn:AGL:permission::public:no-htdocs}}\
 189                         --roothttp=htdocs \
 190                 {{/required-permission.urn:AGL:permission::public:no-htdocs}}\
 191         {{/content.type=application/vnd.agl.service}} \
 192         {{#content.type=application/vnd.agl.service}} \
 193                 --no-httpd \
 194         {{/content.type=application/vnd.agl.service}} \
 195         {{#required-permission.urn:AGL:permission::public:applications:read}}\
 196                 --alias=/icons:{{:#metadata.icons-dir}} \
 197         {{/required-permission.urn:AGL:permission::public:applications:read}}\
 198         {{#required-api}}\
 199                 {{#value=auto}}\
 200                         --ws-client=unix:%t/apis/ws/{{name}} \
 201                 {{/value=auto}}\
 202                 {{#value=ws}}\
 203                         --ws-client=unix:%t/apis/ws/{{name}} \
 204                 {{/value=ws}}\
 205                 {{#value=dbus}}\
 206                         --dbus-client={{name}} \
 207                 {{/value=dbus}}\
 208                 {{#value=link}}\
 209                         --binding=%t/apis/lib/{{name}} \
 210                 {{/value=link}}\
 211                 {{#value=cloud}}\
 212                         --cloud-client={{name}} \
 213                 {{/value=cloud}}\
 214                 {{#value=local}}\
 215                         --binding={{:#metadata.install-dir}}/{{name}} \
 216                 {{/value=local}}\
 217         {{/required-api}}\
 218         {{#provided-api}}\
 219                 {{#value=auto}}\
 220                         {{^required-permission.urn:AGL:permission::partner:service:no-ws}}\
 221                                 --ws-server=sd:{{name}} \
 222                         {{/required-permission.urn:AGL:permission::partner:service:no-ws}}\
 223                         {{^required-permission.urn:AGL:permission::partner:service:no-dbus}}\
 224                                 --dbus-server={{name}} \
 225                         {{/required-permission.urn:AGL:permission::partner:service:no-dbus}}\
 226                 {{/value=auto}}\
 227                 {{#value=ws}}\
 228                         --ws-server=sd:{{name}} \
 229                 {{/value=ws}}\
 230                 {{#value=dbus}}\
 231                         --dbus-server={{name}} \
 232                 {{/value=dbus}}\
 233         {{/provided-api}}\
 234         {{#content.type=text/html}}\
 235                 --exec /usr/bin/web-runtime http://localhost:@p/{{content.src}}?token=@t
 236         {{/content.type=text/html}}\
 237         {{#content.type=application/vnd.agl.native}}\
 238                 --exec {{:#metadata.install-dir}}/{{content.src}} @p @t
 239         {{/content.type=application/vnd.agl.native}}
 240
 241 {{/content.type=text/html|application/vnd.agl.native|application/vnd.agl.service}}
 242
 243
 244 ;---------------------------------------------------------------------------------
 245 ;----                 application/x-executable                                ----
 246 ;---------------------------------------------------------------------------------
 247 {{#content.type=application/x-executable}}
 248
 249 ExecStart={{:#metadata.install-dir}}/{{content.src}}
 250
 251 {{/content.type=application/x-executable}}
 252
 253 ;---------------------------------------------------------------------------------
 254 ; auto start
 255 ;---------------------------------------------------------------------------------
 256 {{#required-permission.urn:AGL:permission::system:run-by-default}}
 257 %nl
 258 [Install]
 259 WantedBy=default.target
 260 %systemd-unit wanted-by default.target
 261 {{/required-permission.urn:AGL:permission::system:run-by-default}}
 262
 263 %end systemd-unit
 264
 265
 266 ;---------------------------------------------------------------------------------
 267 ;----        P R O V I D E D   A P I S                                        ----
 268 ;---------------------------------------------------------------------------------
 269
 270 {{#provided-api}}
 271 {{#value=ws|auto}}
 272
 273 %begin systemd-unit
 274
 275 # auto generated by wgtpkg-unit for {{:id}} version {{:version}} target {{:#target}} of {{:idaver}}
 276 #
 277 %systemd-unit system
 278 %systemd-unit socket afm-api-ws-{{name}}@
 279
 280 [Socket]
 281 SmackLabel=*
 282 ListenStream=%t/apis/ws/{{name}}
 283 FileDescriptorName={{name}}
 284
 285 {{#required-permission.urn:AGL:permission::public:hidden}}\
 286 Service=afm-service-{{:id}}--{{:ver}}--{{:#target}}@%i.service
 287 {{/required-permission.urn:AGL:permission::public:hidden}}\
 288 {{^required-permission.urn:AGL:permission::public:hidden}}\
 289 Service=afm-appli-{{:id}}--{{:ver}}--{{:#target}}@%i.service
 290 {{/required-permission.urn:AGL:permission::public:hidden}}\
 291
 292 ;---------------------------------------------------------------------------------
 293 %nl
 294 [Install]
 295 WantedBy=sockets.target
 296 %systemd-unit wanted-by sockets.target
 297 ;---------------------------------------------------------------------------------
 298
 299 %end systemd-unit
 300
 301 {{/value=ws|auto}}
 302 {{/provided-api}}
 303
 304 {{/targets}}
 305