Child pages
  • Permission Flags

Contents


Permission flags can be added to each parameter in a XML provisioning file, to define whether that setting is read only, read/write, or read/write protected. Valid values for the permission flag are:

  • perm="!": The configuration parameter can be changed by the user. In case the user changed the value from the default, the value will not be overwritten during the auto provisioning.
    perm="!" is not recommended for credential related settings like http_pass or admin_mode_password, as the phone does not track the interface used for first time configuration. Because of this, any sequential provisioning of those settings with new values will fail as current values is considered as changed by the user. Please also see the hint related to this type of settings.

    NOTE: If administrators want to be able to overwrite user parameter definitions, they need to use perm="$". With perm="!", the settings can be changed by mass provisioning but only if the end user did not made any changes to the configuration on the phone itself or on its web interface, if the user changed a parameter, this will not be overwritten by mass provisioning.
  • perm="R" or perm="&" or perm=" ": The configuration parameter becomes write-protected (read only).
  • perm="RW", perm="" or perm="$" The configuration parameter can be changed but will be overwritten on reboot.

  • perm="V":  (since version 10.1.79.0) Setting is volatile. This means the setting will not be saved to flash. Any setting so marked will revert to its default value after a reboot. This flag may be combined with other flags. Using the flag on its own makes the setting write-protected.