Interface DebugControllerDBus.OnAuthorize

Enclosing class:
DebugControllerDBus
Functional Interface:
This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface public static interface DebugControllerDBus.OnAuthorize
  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    Emitted when a D-Bus peer is trying to change the debug settings and used
    to determine if that is authorized.
  • Method Details

    • onAuthorize

      boolean onAuthorize(@Nonnull DBusMethodInvocation invocation)
      Emitted when a D-Bus peer is trying to change the debug settings and used
      to determine if that is authorized.

      This signal is emitted in a dedicated worker thread, so handlers are
      allowed to perform blocking I/O. This means that, for example, it is
      appropriate to call `polkit_authority_check_authorization_sync()` to check
      authorization using polkit.

      If %FALSE is returned then no further handlers are run and the request to
      change the debug settings is rejected.

      Otherwise, if %TRUE is returned, signal emission continues. If no handlers
      return %FALSE, then the debug settings are allowed to be changed.

      Signal handlers must not modify @invocation, or cause it to return a value.

      The default class handler just returns %TRUE.
      Parameters:
      invocation - A #GDBusMethodInvocation.
      Returns:
      %TRUE if the call is authorized, %FALSE otherwise.