// Copyright 2024 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef COMPONENTS_DBUS_XDG_SYSTEMD_H_
#define COMPONENTS_DBUS_XDG_SYSTEMD_H_

#include "base/functional/callback_forward.h"

namespace dbus {
class Bus;
}

namespace dbus_xdg::internal {

enum class SystemdUnitStatus {
  kUnitStarted,
  kUnitNotNecessary,
  kInvalidPid,
  kNoSystemdService,
  kFailedToStart,
};

using SystemdUnitCallback = base::OnceCallback<void(SystemdUnitStatus)>;

// xdg-desktop-portal obtains the application name from the systemd unit name
// (except in Flatpak or Snap environments). The name is passed as an ID to
// backends like Secret and GlobalShortcuts, so it's effectively required to set
// a systemd unit name for those, otherwise it will use an empty string as the
// ID which is problematic because it may collide with other apps that don't run
// under a unit. Also, if using a desktop environment like GNOME or KDE, a
// systemd scope gets created when spawning via the application launcher. Child
// processes also inherit the scope, so if the app launcher creates a terminal
// which the user launches the browser with, then the browser will incorrectly
// get the terminal name. This function is internal and is only used for portal
// initialization in RequestXdgDesktopPortal.
void SetSystemdScopeUnitNameForXdgPortal(dbus::Bus* bus,
                                         SystemdUnitCallback callback);

}  // namespace dbus_xdg::internal

#endif  // COMPONENTS_DBUS_XDG_SYSTEMD_H_