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 ;----        F O R E A C H   T A R G E T                                    ----
  79 ;-------------------------------------------------------------------------------
  80 {{#targets}}
  81 ;-------------------------------------------------------------------------------
  82 ;-------------------------------------------------------------------------------
  83 ;----         M A I N    P A R T    O F   T H E   S E R V I C E             ----
  84 ;-------------------------------------------------------------------------------
  85 %begin systemd-unit
  86 # auto generated by wgtpkg-unit for {{:id}} version {{:version}} target {{:#target}} of {{:idaver}}
  87 %nl
  88 %systemd-unit system
  89 %systemd-unit service afm-{{#required-permission.@afm_prefix@permission::public:hidden}}service{{/required-permission.@afm_prefix@permission::public:hidden}}{{^required-permission.@afm_prefix@permission::public:hidden}}appli{{/required-permission.@afm_prefix@permission::public:hidden}}-{{:id}}--{{:ver}}--{{:#target}}@
  90 [Unit]
  91 Description={{description}}
  92 X-AFM-description={{description}}
  93 X-AFM-name={{name.content}}
  94 X-AFM-shortname={{name.short}}
  95 X-AFM-id={{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}}
  96 X-AFM-version={{:version}}
  97 X-AFM-author={{author.content}}
  98 X-AFM-author-email={{author.email}}
  99 X-AFM-width={{width}}
 100 X-AFM-height={{height}}
 101 {{#icon}}
 102 X-AFM-icon={{:#metadata.install-dir}}/{{:src}}
 103 {{/icon}}
 104 X-AFM--ID={{:id}}
 105 X-AFM--target-name={{:#target}}
 106 X-AFM--content={{content.src}}
 107 X-AFM--type={{content.type}}
 108 X-AFM--wgtdir={{:#metadata.install-dir}}
 109 X-AFM--workdir=/home/%i/app-data/{{:id}}
 110 X-AFM--visibility={{#required-permission.@afm_prefix@permission::public:hidden}}hidden{{/required-permission.@afm_prefix@permission::public:hidden}}{{^required-permission.@afm_prefix@permission::public:hidden}}visible{{/required-permission.@afm_prefix@permission::public:hidden}}
 111 %nl
 112 Requires=afm-user-session@%i.target
 113 After=user@%i.service
 114 After=Network.target
 115 # Adds check to smack
 116 ConditionSecurity=smack
 117 %nl
 118 # Automatic bound to required api
 119 {{#required-binding}}
 120 {{#value=extern}}
 121 BindsTo=afm-link-{{name}}@%i.service
 122 After=afm-link-{{name}}@%i.service
 123 {{/value=extern}}
 124 {{/required-binding}}
 125 {{#required-api}}
 126 {{#value=auto|ws}}
 127 BindsTo=afm-api-{{name}}@%i.service
 128 After=afm-api-{{name}}@%i.service
 129 {{/value=auto|ws}}
 130 {{/required-api}}
 131 {{#provided-api}}
 132 {{#value=ws|auto}}
 133 Requires=afm-api-{{name}}@%i.socket
 134 After=afm-api-{{name}}@%i.socket
 135 {{/value=ws|auto}}
 136 {{/provided-api}}
 137 %nl
 138 [Service]
 139 EnvironmentFile=-@afm_confdir@/unit.env.d/*
 140 EnvironmentFile=-@afm_confdir@/widget.env.d/{{:id}}/*
 141 SmackProcessLabel=User::App::{{:id}}
 142 SuccessExitStatus=0 SIGKILL
 143 User=%i
 144 Slice=user-%i.slice
 145 CapabilityBoundingSet=
 146 #AmbientCapabilities=
 147 {{#required-permission.@afm_prefix@permission::platform:no-oom}}OOMScoreAdjust=-500{{/required-permission.@afm_prefix@permission::platform:no-oom}}
 148 {{#required-permission.@afm_prefix@permission::partner:real-time}}IOSchedulingClass=realtime{{/required-permission.@afm_prefix@permission::partner:real-time}}
 149 {{#required-permission.@afm_prefix@permission::public:display}}SupplementaryGroups=display{{/required-permission.@afm_prefix@permission::public:display}}
 150 {{^required-permission.@afm_prefix@permission::public:syscall:clock}}SystemCallFilter=~@clock{{/required-permission.@afm_prefix@permission::public:syscall:clock}}
 151 %nl
 152 WorkingDirectory=-/home/%i/app-data/{{:id}}
 153 ExecStartPre=/bin/mkdir -p /home/%i/app-data/{{:id}}
 154 Environment=AFM_ID={{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}}
 155 Environment=AFM_APP_INSTALL_DIR={{:#metadata.install-dir}}
 156 Environment=AFM_WORKDIR=/home/%i/app-data/{{:id}}
 157 Environment=AFM_WSAPI_DIR=@afm_users_rundir@/%i/apis/ws
 158 Environment=PATH=/usr/sbin:/usr/bin:/sbin:/bin:{{:#metadata.install-dir}}/bin
 159 Environment=LD_LIBRARY_PATH={{:#metadata.install-dir}}/lib
 160 Environment=XDG_DATA_HOME=/home/%i/app-data/{{:id}}
 161 Environment=XDG_CONFIG_HOME=/home/%i/app-data/{{:id}}
 162 Environment=XDG_CACHE_HOME=/home/%i/app-data/{{:id}}
 163 Environment=XDG_RUNTIME_DIR=@afm_users_rundir@/%i
 164 Environment=DBUS_SESSION_BUS_ADDRESS=unix:path=@afm_users_rundir@/%i/bus
 165 ; Needed to enable debug
 166 EnvironmentFile=-@afm_platform_rundir@/debug/{{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}}.env
 167 SyslogIdentifier=afbd-{{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}}
 168 StandardInput=null
 169 StandardOutput=journal
 170 StandardError=journal
 171 ;-------------------------------------------------------------------------------
 172 ;----   text/html  application/vnd.agl.native  application/vnd.agl.service  ----
 173 ;-------------------------------------------------------------------------------
 174 {{#content.type=text/html|application/vnd.agl.native|application/vnd.agl.service}}
 175 X-AFM-http-port={{:#metatarget.http-port}}
 176 Type=notify
 177 ExecStart=/usr/bin/afb-daemon \
 178         --name afbd-{{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}} \
 179         --rootdir={{:#metadata.install-dir}} \
 180         --workdir=/home/%i/app-data/{{id}} \
 181         --verbose \
 182         --verbose \
 183         --monitoring \
 184         --port={{:#metatarget.http-port}} \
 185         --token=HELLO \
 186         --roothttp={{#content.type=application/vnd.agl.service}}.{{/content.type=application/vnd.agl.service}}{{^content.type=application/vnd.agl.service}}{{#required-permission.@afm_prefix@permission::public:no-htdocs}}.{{/required-permission.@afm_prefix@permission::public:no-htdocs}}{{^required-permission.@afm_prefix@permission::public:no-htdocs}}htdocs{{/required-permission.@afm_prefix@permission::public:no-htdocs}}{{/content.type=application/vnd.agl.service}} \
 187         {{#required-permission.@afm_prefix@permission::public:applications:read}}--alias=/icons:{{:#metadata.icons-dir}}{{/required-permission.@afm_prefix@permission::public:applications:read}} \
 188         {{#required-api}} \
 189                 {{#value=auto|ws}}--ws-client=unix:@afm_users_rundir@/%i/apis/ws/{{name}}{{/value=auto|ws}} \
 190                 {{#value=dbus}}--dbus-client={{name}}{{/value=dbus}} \
 191                 {{#value=cloud}}--cloud-client={{name}}{{/value=cloud}} \
 192                 {{#value=local}}--binding={{:#metadata.install-dir}}/{{name}}{{/value=local}} \
 193                 {{#value=tcp}}--ws-client=tcp:{{name}}{{/value=tcp}} \
 194         {{/required-api}} \
 195         {{#required-binding}} \
 196                 {{#value=local}}--binding={{:#metadata.install-dir}}/{{name}}{{/value=local}} \
 197                 {{#value=extern}}--binding=@afm_users_rundir@/%i/apis/link/{{name}}{{/value=extern}} \
 198         {{/required-binding}} \
 199         {{#provided-api}} \
 200                 {{#value=auto|ws}}--ws-server=sd:{{name}}{{/value=auto|ws}} \
 201                 {{#value=dbus}}--dbus-server={{name}}{{/value=dbus}} \
 202                 {{#value=tcp}}--ws-server=tcp:{{name}}{{/value=tcp}} \
 203         {{/provided-api}} \
 204         {{#content.type=text/html}}--exec /usr/bin/web-runtime http://localhost:@p/{{content.src}}?token=@t{{/content.type=text/html}} \
 205         {{#content.type=application/vnd.agl.native}}--exec {{:#metadata.install-dir}}/{{content.src}} @p @t{{/content.type=application/vnd.agl.native}}
 206 {{/content.type=text/html|application/vnd.agl.native|application/vnd.agl.service}}
 207 ;-------------------------------------------------------------------------------
 208 ;----                 application/x-executable                              ----
 209 ;-------------------------------------------------------------------------------
 210 {{#content.type=application/x-executable}}
 211 ExecStart={{:#metadata.install-dir}}/{{content.src}}
 212 {{/content.type=application/x-executable}}
 213 {{#required-permission.@afm_prefix@permission::system:run-by-default}}
 214 ;-------------------------------------------------------------------------------
 215 ; auto start
 216 ;-------------------------------------------------------------------------------
 217 [Install]
 218 WantedBy=afm-user-session@.target
 219 %systemd-unit wanted-by afm-user-session@.target
 220 {{/required-permission.@afm_prefix@permission::system:run-by-default}}
 221 %end systemd-unit
 222 ;-------------------------------------------------------------------------------
 223 ;----        F O R E A C H   P R O V I D E D   A P I S                      ----
 224 ;-------------------------------------------------------------------------------
 225 {{#provided-api}}
 226 {{#value=ws|auto}}
 227 ;-------------------------------------------------------------------------------
 228 ;----        T H E   S E R V I C E   O F   T H E   A P I                    ----
 229 ;-------------------------------------------------------------------------------
 230 %begin systemd-unit
 231 # auto generated by wgtpkg-unit for {{:id}} version {{:version}} target {{:#target}} of {{:idaver}}
 232 %systemd-unit system
 233 %systemd-unit service afm-api-{{name}}@
 234 [Unit]
 235 Description=Provides api {{name}} for user %i
 236 X-AFM-API-TYPE={{value}}
 237 Requires=afm-user-setup@%i.service
 238 After=afm-user-setup@%i.service
 239 Requires=afm-api-{{name}}@%i.socket
 240 After=afm-api-{{name}}@%i.socket
 241 [Service]
 242 Type=oneshot
 243 RemainAfterExit=yes
 244 ExecStart=/bin/true
 245 %end systemd-unit
 246 ;-------------------------------------------------------------------------------
 247 ;----        T H E   S O C K E T   O F   T H E   A P I                      ----
 248 ;-------------------------------------------------------------------------------
 249 %begin systemd-unit
 250 # auto generated by wgtpkg-unit for {{:id}} version {{:version}} target {{:#target}} of {{:idaver}}
 251 %systemd-unit system
 252 %systemd-unit socket afm-api-{{name}}@
 253 [Unit]
 254 Description=Provides websocket api {{name}} for user %i
 255 Requires=afm-user-setup@%i.service
 256 After=afm-user-setup@%i.service
 257 DefaultDependencies=no
 258 [Socket]
 259 SmackLabel=*
 260 SmackLabelIPIn=System
 261 SmackLabelIPOut=System
 262 ListenStream=@afm_users_rundir@/%i/apis/ws/{{name}}
 263 FileDescriptorName={{name}}
 264 Service=afm-{{#required-permission.@afm_prefix@permission::public:hidden}}service{{/required-permission.@afm_prefix@permission::public:hidden}}{{^required-permission.@afm_prefix@permission::public:hidden}}appli{{/required-permission.@afm_prefix@permission::public:hidden}}-{{:id}}--{{:ver}}--{{:#target}}@%i.service
 265 %end systemd-unit
 266 {{/value=ws|auto}}
 267 {{/provided-api}}
 268 ;-------------------------------------------------------------------------------
 269 ;----        F O R E A C H   P R O V I D E D   B I N D I N G                ----
 270 ;-------------------------------------------------------------------------------
 271 {{#provided-binding}}
 272 ;-------------------------------------------------------------------------------
 273 ;----        T H E   S E R V I C E   O F   T H E   B I N D I N G            ----
 274 ;-------------------------------------------------------------------------------
 275 %begin systemd-unit
 276 # auto generated by wgtpkg-unit for {{:id}} version {{:version}} target {{:#target}} of {{:idaver}}
 277 %systemd-unit system
 278 %systemd-unit service afm-link-{{name}}@
 279 [Unit]
 280 Description=Provides binding {{name}} for user %i
 281 Requires=afm-user-setup@%i.service
 282 After=afm-user-setup@%i.service
 283 [Service]
 284 Type=oneshot
 285 RemainAfterExit=yes
 286 ExecStart=/bin/ln -sf {{:#metadata.install-dir}}/{{value}} @afm_users_rundir@/%i/apis/link/{{name}}
 287 %end systemd-unit
 288 {{/provided-binding}}
 289 ;-------------------------------------------------------------------------------
 290 {{/targets}}
 291 ;-------------------------------------------------------------------------------
 292 ; End of file afm-unit.conf mode DEVEL
 293 ;-------------------------------------------------------------------------------