1 ConnMan policy file format
2 **************************
4 The session policy plugin allows to configure/provision a session.
5 ConnMan will be looking for policy files in STORAGEDIR/session_policy_local
6 which by default points to /var/lib/connman. Policy file names must
7 not include other characters than letters or numbers and must have
8 a .policy suffix. Policy files are text files.
10 It is possible to add, remove or update a policy file during run-time.
11 The corresponding sessions will be updated accordingly.
13 Policy group [policy_*]
14 =======================
16 Each policy group must start with as [policy_*] tag. '*' has no
17 semantic meaning but should consist just out of characters.
21 Exactly one and only one of the required fields need to be present
24 - uid: This policy group will be applied to any session
27 - gid: This policy group will be applied to any session
30 - selinux: This policy group will be applied to any session
31 with given SELinux context.
35 - AllowedBearers: see session-api.txt
36 The policy AllowedBearers overrules the settings done via
37 D-Bus. For example the policy AllowedBearers is 'ethernet' then
38 the D-Bus API will only accept an empty string or 'ethernet'.
40 - ConnectionType: see session-api.txt
41 The policy ConnectionType overrules the settings done via
44 - Priority: A boolean which tells ConnMan to prefer the session
45 over other Sessions. This priority value is more for applications
46 that want to push themselves up in the asychronization notification
47 queue once a bearer becomes online.
49 This actual priority order also depends on the allowed bearers and
50 other factors. This setting is just a little indicator for one
51 application being notified before another one.
53 - RoamingPolicy: The allowed roaming behavior.
55 Valid policies are "national", "international", "default", "always"
58 "national" allows roaming within a country. "international" allows
59 roaming in a country and between countries.
61 "default" is used to tell the session to use the global roaming
64 "always" will overwrite the default "forbidden" value which is
65 useful for emergency application.
67 Default value is "forbidden".
69 - EmergencyCall: A boolean which tells ConnMan whenever the
70 Connect() method is called for this session, all other
71 session are disconnected.
73 Note only services matching the AllowedBearers rule will be
79 example@example:[~]$ cat /var/lib/connman/session_policy_local/auser.policy
82 AllowedBearers = wifi cellular
83 RoamingPolicy = forbidden