description: >
    Implement to provide user password set functionality. Since this
    needs an authenticated session, there is no need of old password.
    User ID is part of the dbus object.
methods:
    - name: SetPassword
      description: >
          Set the user password. If the user already had a password, it will
          be updated, else sets the password.

          InsufficientPermission error doing so would mean that, the caller
          does not have required permission to update the password.

          InternalFailure error would mean that, caller had required
          permissions, but, there was a software error.
          Errorlog metadata would need to be looked into when this happens.
          Re-try once on this error and if that fails, do not try anymore.
      parameters:
        - name: NewPassword
          type: string
          description: >
              new password string
      errors:
        - xyz.openbmc_project.Common.Error.InternalFailure
        - xyz.openbmc_project.Common.Error.InsufficientPermission

# vim: tabstop=8 expandtab shiftwidth=4 softtabstop=4